@ngocsangairvds/vsaf 4.1.12 → 4.1.15

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

@@ -22,13 +22,13 @@ cd vds-scripts
 
 # Package-specific sync & tests
 uv sync --project confluence_orchestrator --extra dev
-./scripts/worktree_uv.sh run --project confluence_orchestrator pytest
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator pytest
 ```
 
 Run the CLI directly (uv automatically loads the project environment once it has been synced at least once):
 
 ```bash
-./scripts/worktree_uv.sh run --project confluence_orchestrator vds-cli confluence --help
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator vds-cli confluence --help
 ```
 
 ### Authentication preference
@@ -38,7 +38,7 @@ For SDK-backed Confluence access, prefer:
 1. `VDS_USERNAME` + `VDS_PASSWORD` as the primary authentication mechanism
 2. `INTERNAL_CONFLUENCE_TOKEN` / `EXTERNAL_CONFLUENCE_TOKEN` as fallback credentials
 
-This matches the current runtime/client behavior used by `vds-cli confluence` and `./scripts/worktree_uv.sh run --project vds_cli vds-cli audit query-checklist`.
+This matches the current runtime/client behavior used by `vds-cli confluence` and `uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli audit query-checklist`.
 
 **Agent-friendly output**
 - When using `vds-cli`, pass Typer flags after `--` (e.g. `vds-cli confluence -- --json-only content ...`).
@@ -47,15 +47,15 @@ This matches the current runtime/client behavior used by `vds-cli confluence` an
 
 Common commands (short form):
 ```bash
-./scripts/worktree_uv.sh run --project confluence_orchestrator vds-cli confluence content page 99647801 --server external --expand body.storage
-./scripts/worktree_uv.sh run --project confluence_orchestrator vds-cli confluence content child-pages 88716675 --server internal --expand body.storage
-./scripts/worktree_uv.sh run --project confluence_orchestrator vds-cli confluence export page --page-id 99647801 --output page.pdf
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator vds-cli confluence content page 99647801 --server external --expand body.storage
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator vds-cli confluence content child-pages 88716675 --server internal --expand body.storage
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator vds-cli confluence export page --page-id 99647801 --output page.pdf
 ```
 
 Via vds-cli router:
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence -- content page 99647801 --server external --expand body.storage
-./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence -- content child-pages 88716675 --server internal --expand body.storage
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence -- content page 99647801 --server external --expand body.storage
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence -- content child-pages 88716675 --server internal --expand body.storage
 ```
 
 For registry parsing workflows, prefer `content child-pages ... --expand body.storage` so child payloads include page bodies and downstream parsers can avoid extra per-page `get` calls.
@@ -63,74 +63,74 @@ For registry parsing workflows, prefer `content child-pages ... --expand body.st
 **Sync Commands** (new):
 ```bash
 # Sync PDFs to Confluence
-./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence sync pdfs \
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence sync pdfs \
   166465076 \
   --dir /path/to/pdf/directory \
   --server external
 
 # Sync PNGs to Confluence
-./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence sync pngs \
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence sync pngs \
   166465076 \
   --dir /path/to/png/directory \
   --server external
 
 # Or run scripts directly from confluence_orchestrator directory:
 cd vds-scripts/confluence_orchestrator
-./scripts/worktree_uv.sh run --project confluence_orchestrator python sync_pdfs_to_confluence.py sync 166465076 --dir /path/to/pdfs --server external
-./scripts/worktree_uv.sh run --project confluence_orchestrator python sync_png_attachments.py sync 166465076 --dir /path/to/pngs --server external
-./scripts/worktree_uv.sh run --project confluence_orchestrator python sync_pdfs_from_markdown.py /path/to/target-state --dry-run
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python sync_pdfs_to_confluence.py sync 166465076 --dir /path/to/pdfs --server external
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python sync_png_attachments.py sync 166465076 --dir /path/to/pngs --server external
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python sync_pdfs_from_markdown.py /path/to/target-state --dry-run
 ```
 
 See `SYNC_SCRIPTS.md` for complete sync script documentation.
 
 Full command examples:
 ```bash
-./scripts/worktree_uv.sh run --project confluence_orchestrator python -m confluence_orchestrator.cli --help
-./scripts/worktree_uv.sh run --project confluence_orchestrator python -m confluence_orchestrator.cli get 99647801 --server external -- --strip-markup
-./scripts/worktree_uv.sh run --project confluence_orchestrator python -m confluence_orchestrator.cli content page 99647801 --server external --expand body.storage
-./scripts/worktree_uv.sh run --project confluence_orchestrator python -m confluence_orchestrator.cli content create-page --space TTTC --title "Automation" --body-file ./examples/page_storage.html
-./scripts/worktree_uv.sh run --project confluence_orchestrator python -m confluence_orchestrator.cli content add-attachment 99647801 --file ./diagram.png --comment "Latest architecture diagram"
-./scripts/worktree_uv.sh run --project confluence_orchestrator python -m confluence_orchestrator.cli content delete-attachment 99647801 --filename Current_Architecture_Reference.pdf
-./scripts/worktree_uv.sh run --project confluence_orchestrator python -m confluence_orchestrator.cli content copy-tree 77470432 --target-page-id 96796900 --source-server external --target-server internal --target-space TTPMCOREPM --dry-run
-./scripts/worktree_uv.sh run --project confluence_orchestrator python -m confluence_orchestrator.cli content copy-tree 77470432 --target-page-id 96796900 --source-server external --target-server internal --target-space TTPMCOREPM
-./scripts/worktree_uv.sh run --project confluence_orchestrator python -m confluence_orchestrator.cli batch-native scan --cql "space = TTTC" --limit 10 --json
-./scripts/worktree_uv.sh run --project confluence_orchestrator python -m confluence_orchestrator.cli webhook-native create --name "Notify" --url https://example.com/hook --event page_created --json
-./scripts/worktree_uv.sh run --project confluence_orchestrator python -m confluence_orchestrator.cli space-permissions get --space-key TTTC --json
-./scripts/worktree_uv.sh run --project confluence_orchestrator python -m confluence_orchestrator.cli space-permissions set --space-key TTTC --group "confluence-users" --operation read --yes --json
-./scripts/worktree_uv.sh run --project confluence_orchestrator python -m confluence_orchestrator.cli space-management archive --space-key TTTC --yes --json
-./scripts/worktree_uv.sh run --project confluence_orchestrator python -m confluence_orchestrator.cli space-management trash-list --space-key TTTC --limit 25 --json
-./scripts/worktree_uv.sh run --project confluence_orchestrator python -m confluence_orchestrator.cli space-management trash-remove --space-key TTTC --yes --json
-./scripts/worktree_uv.sh run --project confluence_orchestrator python -m confluence_orchestrator.cli group list --limit 50 --json
-./scripts/worktree_uv.sh run --project confluence_orchestrator python -m confluence_orchestrator.cli group members --group "confluence-users" --limit 100 --json
-./scripts/worktree_uv.sh run --project confluence_orchestrator python -m confluence_orchestrator.cli user get --username testuser --json
-./scripts/worktree_uv.sh run --project confluence_orchestrator python -m confluence_orchestrator.cli user get --userkey key123 --expand status,details --json
-./scripts/worktree_uv.sh run --project confluence_orchestrator python -m confluence_orchestrator.cli user password --username testuser --new-password "newpass123" --yes --json
-./scripts/worktree_uv.sh run --project confluence_orchestrator python -m confluence_orchestrator.cli user group-add --username testuser --group "confluence-users" --yes --json
-./scripts/worktree_uv.sh run --project confluence_orchestrator python -m confluence_orchestrator.cli user group-remove --username testuser --group "confluence-users" --yes --json
-./scripts/worktree_uv.sh run --project confluence_orchestrator python -m confluence_orchestrator.cli export page --page-id 99647801 --output page.pdf
-./scripts/worktree_uv.sh run --project confluence_orchestrator python -m confluence_orchestrator.cli export space --space-key TTTC --export-type pdf --json
-./scripts/worktree_uv.sh run --project confluence_orchestrator python -m confluence_orchestrator.cli draft get --page-id 12345 --json
-./scripts/worktree_uv.sh run --project confluence_orchestrator python -m confluence_orchestrator.cli draft list --space-key TTTC --limit 50 --json
-./scripts/worktree_uv.sh run --project confluence_orchestrator python -m confluence_orchestrator.cli draft remove --page-id 12345 --yes --json
-./scripts/worktree_uv.sh run --project confluence_orchestrator python -m confluence_orchestrator.cli content ancestors 99647801 --json
-./scripts/worktree_uv.sh run --project confluence_orchestrator python -m confluence_orchestrator.cli content move 99647801 --target-title "Parent" --position append --yes --json
-./scripts/worktree_uv.sh run --project confluence_orchestrator python -m confluence_orchestrator.cli content tables 99647801 --json
-./scripts/worktree_uv.sh run --project confluence_orchestrator python -m confluence_orchestrator.cli content regex 99647801 --pattern "\d+" --json
-./scripts/worktree_uv.sh run --project confluence_orchestrator python -m confluence_orchestrator.cli content restrictions 99647801 --json
-./scripts/worktree_uv.sh run --project confluence_orchestrator python -m confluence_orchestrator.cli history get --page-id 99647801 --json
-./scripts/worktree_uv.sh run --project confluence_orchestrator python -m confluence_orchestrator.cli history version --page-id 99647801 --version 2 --json
-./scripts/worktree_uv.sh run --project confluence_orchestrator python -m confluence_orchestrator.cli history remove --page-id 99647801 --version 2 --yes --json
-./scripts/worktree_uv.sh run --project confluence_orchestrator python -m confluence_orchestrator.cli cache statistics --json
-./scripts/worktree_uv.sh run --project confluence_orchestrator python -m confluence_orchestrator.cli cache flush --yes --json
-./scripts/worktree_uv.sh run --project confluence_orchestrator python -m confluence_orchestrator.cli cache flush --cache-name "com.gliffy.cache.gon" --yes --json
-./scripts/worktree_uv.sh run --project confluence_orchestrator python -m confluence_orchestrator.cli cache size --json
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python -m confluence_orchestrator.cli --help
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python -m confluence_orchestrator.cli get 99647801 --server external -- --strip-markup
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python -m confluence_orchestrator.cli content page 99647801 --server external --expand body.storage
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python -m confluence_orchestrator.cli content create-page --space TTTC --title "Automation" --body-file ./examples/page_storage.html
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python -m confluence_orchestrator.cli content add-attachment 99647801 --file ./diagram.png --comment "Latest architecture diagram"
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python -m confluence_orchestrator.cli content delete-attachment 99647801 --filename Current_Architecture_Reference.pdf
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python -m confluence_orchestrator.cli content copy-tree 77470432 --target-page-id 96796900 --source-server external --target-server internal --target-space TTPMCOREPM --dry-run
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python -m confluence_orchestrator.cli content copy-tree 77470432 --target-page-id 96796900 --source-server external --target-server internal --target-space TTPMCOREPM
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python -m confluence_orchestrator.cli batch-native scan --cql "space = TTTC" --limit 10 --json
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python -m confluence_orchestrator.cli webhook-native create --name "Notify" --url https://example.com/hook --event page_created --json
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python -m confluence_orchestrator.cli space-permissions get --space-key TTTC --json
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python -m confluence_orchestrator.cli space-permissions set --space-key TTTC --group "confluence-users" --operation read --yes --json
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python -m confluence_orchestrator.cli space-management archive --space-key TTTC --yes --json
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python -m confluence_orchestrator.cli space-management trash-list --space-key TTTC --limit 25 --json
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python -m confluence_orchestrator.cli space-management trash-remove --space-key TTTC --yes --json
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python -m confluence_orchestrator.cli group list --limit 50 --json
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python -m confluence_orchestrator.cli group members --group "confluence-users" --limit 100 --json
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python -m confluence_orchestrator.cli user get --username testuser --json
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python -m confluence_orchestrator.cli user get --userkey key123 --expand status,details --json
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python -m confluence_orchestrator.cli user password --username testuser --new-password "newpass123" --yes --json
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python -m confluence_orchestrator.cli user group-add --username testuser --group "confluence-users" --yes --json
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python -m confluence_orchestrator.cli user group-remove --username testuser --group "confluence-users" --yes --json
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python -m confluence_orchestrator.cli export page --page-id 99647801 --output page.pdf
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python -m confluence_orchestrator.cli export space --space-key TTTC --export-type pdf --json
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python -m confluence_orchestrator.cli draft get --page-id 12345 --json
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python -m confluence_orchestrator.cli draft list --space-key TTTC --limit 50 --json
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python -m confluence_orchestrator.cli draft remove --page-id 12345 --yes --json
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python -m confluence_orchestrator.cli content ancestors 99647801 --json
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python -m confluence_orchestrator.cli content move 99647801 --target-title "Parent" --position append --yes --json
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python -m confluence_orchestrator.cli content tables 99647801 --json
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python -m confluence_orchestrator.cli content regex 99647801 --pattern "\d+" --json
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python -m confluence_orchestrator.cli content restrictions 99647801 --json
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python -m confluence_orchestrator.cli history get --page-id 99647801 --json
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python -m confluence_orchestrator.cli history version --page-id 99647801 --version 2 --json
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python -m confluence_orchestrator.cli history remove --page-id 99647801 --version 2 --yes --json
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python -m confluence_orchestrator.cli cache statistics --json
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python -m confluence_orchestrator.cli cache flush --yes --json
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python -m confluence_orchestrator.cli cache flush --cache-name "com.gliffy.cache.gon" --yes --json
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python -m confluence_orchestrator.cli cache size --json
 ```
 
 The unified `vds_cli` still routes `confluence` commands through this project, so the usual workflow is:
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli vds-cli env load
-./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence get 99647801 --server external -- --strip-markup
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli env load
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence get 99647801 --server external -- --strip-markup
 ```
 
 Run reports are written to `vds-scripts/reports/confluence_runs/YYYY/MM/DD/<timestamp>.json` (plus Markdown unless
@@ -166,13 +166,13 @@ uv run --extra dev ruff format
 
   ```bash
   # Basic CQL search
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence search --cql "type = page AND space = TTTC" --limit 25
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence search --cql "type = page AND space = TTTC" --limit 25
 
   # Advanced CQL search with excerpt and pagination
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence search --cql "type = page" --advanced --excerpt "highlighted" --start 10 --limit 50
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence search --cql "type = page" --advanced --excerpt "highlighted" --start 10 --limit 50
 
   # Advanced search with expand options
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence search --cql "title ~ 'test'" --advanced --expand "body.storage,space" --limit 25
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence search --cql "title ~ 'test'" --advanced --expand "body.storage,space" --limit 25
   ```
 
   > **Note**: Use `--advanced` flag or `--excerpt` parameter to enable advanced search with additional options like
@@ -182,16 +182,16 @@ uv run --extra dev ruff format
 
   ```bash
   # Search by space only
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence search-by-space-type --space TTTC --limit 50
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence search-by-space-type --space TTTC --limit 50
 
   # Search by content type only
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence search-by-space-type --type page --limit 25
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence search-by-space-type --type page --limit 25
 
   # Search by both space and type
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence search-by-space-type --space TTTC --type page --start 0 --limit 50
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence search-by-space-type --space TTTC --type page --start 0 --limit 50
 
   # With expand options
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence search-by-space-type --space TTTC --type blogpost --expand "body.storage,version"
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence search-by-space-type --space TTTC --type blogpost --expand "body.storage,version"
   ```
 
   > **Note**: At least one of `--space` or `--type` must be provided. This helper automatically builds the CQL query for
@@ -202,32 +202,32 @@ uv run --extra dev ruff format
 - **`group list`** - List all groups
 
   ```bash
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence group list --limit 50
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence group list --start 0 --limit 100
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence group list --limit 50
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence group list --start 0 --limit 100
   ```
 
 - **`group members`** - Get group members
 
   ```bash
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence group members --group "confluence-users"
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence group members --group "admins" --start 0 --limit 100
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence group members --group "confluence-users"
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence group members --group "admins" --start 0 --limit 100
   ```
 
 - **`user get`** - Get user details
 
   ```bash
   # By username
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence user get --username testuser
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence user get --username testuser --expand status,details
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence user get --username testuser
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence user get --username testuser --expand status,details
 
   # By user key
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence user get --userkey key123
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence user get --userkey key123
   ```
 
 - **`user password`** - Change user password (requires confirmation)
 
   ```bash
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence user password \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence user password \
     --username testuser \
     --new-password "newpass123" \
     --yes
@@ -239,7 +239,7 @@ uv run --extra dev ruff format
 - **`user group-add`** - Add user to group (requires confirmation)
 
   ```bash
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence user group-add \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence user group-add \
     --username testuser \
     --group "confluence-users" \
     --yes
@@ -248,7 +248,7 @@ uv run --extra dev ruff format
 - **`user group-remove`** - Remove user from group (requires confirmation)
 
   ```bash
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence user group-remove \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence user group-remove \
     --username testuser \
     --group "confluence-users" \
     --yes
@@ -260,13 +260,13 @@ uv run --extra dev ruff format
 
   ```bash
   # Export to file
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence export page --page-id 99647801 --output page.pdf
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence export page --page-id 99647801 --output page.pdf
 
   # Export to stdout (binary)
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence export page --page-id 99647801 > page.pdf
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence export page --page-id 99647801 > page.pdf
 
   # API version is auto-detected (Cloud vs Server based on URL)
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence export page --page-id 99647801 --output page.pdf
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence export page --page-id 99647801 --output page.pdf
   ```
 
   > **Note**: API version is automatically detected based on server URL (Cloud vs Server). The `--api-version` flag is
@@ -276,13 +276,13 @@ uv run --extra dev ruff format
 
   ```bash
   # PDF export
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence export space --space-key TTTC --export-type pdf
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence export space --space-key TTTC --export-type pdf
 
   # HTML export
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence export space --space-key TTTC --export-type html
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence export space --space-key TTTC --export-type html
 
   # XML export
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence export space --space-key TTTC --export-type xml
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence export space --space-key TTTC --export-type xml
   ```
 
   > **Note**: Export types supported: `pdf`, `html`, `xml`. The command returns a download URL that can be used to fetch
@@ -293,7 +293,7 @@ uv run --extra dev ruff format
 - **`draft get`** - Get draft page by ID
 
   ```bash
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence draft get --page-id 12345
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence draft get --page-id 12345
   ```
 
   > **Note**: Server/Data Center only. Not available in Cloud.
@@ -301,7 +301,7 @@ uv run --extra dev ruff format
 - **`draft list`** - List all draft pages in a space
 
   ```bash
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence draft list --space-key TTTC --limit 50
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence draft list --space-key TTTC --limit 50
   ```
 
   > **Note**: Server/Data Center only. Returns draft pages that haven't been published.
@@ -309,7 +309,7 @@ uv run --extra dev ruff format
 - **`draft remove`** - Remove a draft page
 
   ```bash
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence draft remove --page-id 12345 --yes
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence draft remove --page-id 12345 --yes
   ```
 
   > **Warning**: Server/Data Center only. Requires `--yes` flag for confirmation. This permanently removes the draft.
@@ -319,7 +319,7 @@ uv run --extra dev ruff format
 - **`content ancestors`** - Get page ancestors (parent pages)
 
   ```bash
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence content ancestors 99647801
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence content ancestors 99647801
   ```
 
   > Returns the hierarchy of parent pages for a given page.
@@ -328,13 +328,13 @@ uv run --extra dev ruff format
 
   ```bash
   # Move page as child of target page
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence content move 99647801 \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence content move 99647801 \
     --target-title "Parent Page" \
     --position append \
     --yes
 
   # Move page before target page
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence content move 99647801 \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence content move 99647801 \
     --target-title "Sibling Page" \
     --position before \
     --yes
@@ -350,7 +350,7 @@ uv run --extra dev ruff format
 - **`content tables`** - Extract tables from page
 
   ```bash
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence content tables 99647801
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence content tables 99647801
   ```
 
   > Extracts all tables from the page content and returns structured table data.
@@ -359,11 +359,11 @@ uv run --extra dev ruff format
 
   ```bash
   # Extract email addresses
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence content regex 99647801 \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence content regex 99647801 \
     --pattern "[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}"
 
   # Extract version numbers
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence content regex 99647801 \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence content regex 99647801 \
     --pattern "v\d+\.\d+\.\d+"
   ```
 
@@ -372,7 +372,7 @@ uv run --extra dev ruff format
 - **`content restrictions`** - Get content restrictions
 
   ```bash
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence content restrictions 99647801
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence content restrictions 99647801
   ```
 
   > Returns all viewing/editing restrictions configured for the content.
@@ -382,7 +382,7 @@ uv run --extra dev ruff format
 - **`history get`** - Get page history
 
   ```bash
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence history get --page-id 99647801
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence history get --page-id 99647801
   ```
 
   > Returns the complete version history of a page, including all versions and their metadata.
@@ -390,7 +390,7 @@ uv run --extra dev ruff format
 - **`history version`** - Get specific version
 
   ```bash
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence history version --page-id 99647801 --version 2
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence history version --page-id 99647801 --version 2
   ```
 
   > Returns the content of a specific version of a page.
@@ -398,7 +398,7 @@ uv run --extra dev ruff format
 - **`history remove`** - Remove history (experimental)
 
   ```bash
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence history remove --page-id 99647801 --version 2 --yes
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence history remove --page-id 99647801 --version 2 --yes
   ```
 
   > **Warning**: Experimental feature. Requires `--yes` flag for confirmation. Permanently removes a specific version
@@ -409,8 +409,8 @@ uv run --extra dev ruff format
 - **`cache statistics`** - Get cache statistics
 
   ```bash
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence cache statistics
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence cache statistics --server external
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence cache statistics
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence cache statistics --server external
   ```
 
   > **Note**: Server/Data Center only. Returns cache hit/miss statistics and performance metrics.
@@ -419,10 +419,10 @@ uv run --extra dev ruff format
 
   ```bash
   # Flush all caches
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence cache flush --yes
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence cache flush --yes
 
   # Flush specific cache package
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence cache flush --cache-name "com.gliffy.cache.gon" --yes
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence cache flush --cache-name "com.gliffy.cache.gon" --yes
   ```
 
   > **Warning**: Server/Data Center only. Requires `--yes` flag for confirmation. Flushes all caches or a specific cache
@@ -431,8 +431,8 @@ uv run --extra dev ruff format
 - **`cache size`** - Get cache size information
 
   ```bash
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence cache size
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence cache size --server external
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence cache size
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence cache size --server external
   ```
 
   > **Note**: Server/Data Center only. Returns total cache size and cache count information.
@@ -444,7 +444,7 @@ uv run --extra dev ruff format
 
 ```bash
 # Apply bulk permissions from a JSON file
-./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence -- --json-only space-permissions set \
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence -- --json-only space-permissions set \
   --space-key TTTC \
   --permissions-file ./permissions-bulk.json \
   --yes \

package/skills/vds-skill/runtime/confluence_orchestrator/SYNC_SCRIPTS.md

@@ -8,19 +8,19 @@ This directory contains standalone sync scripts for synchronizing local files wi
 
 ```bash
 # Sync PDFs to Confluence
-./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence sync pdfs \
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence sync pdfs \
   <page_id> \
   --dir /path/to/pdf/directory \
   --server external
 
 # Sync PNGs to Confluence
-./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence sync pngs \
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence sync pngs \
   <page_id> \
   --dir /path/to/png/directory \
   --server external
 
 # Regenerate PDFs from markdown (via PDF orchestrator)
-./scripts/worktree_uv.sh run --project vds_cli vds-cli pdf -- md2pdf file.md -o file.pdf
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli pdf -- md2pdf file.md -o file.pdf
 ```
 
 ## Standalone Script Execution
@@ -31,15 +31,15 @@ If you need to run scripts directly (e.g., for automation or debugging), use:
 cd /path/to/vds-scripts/confluence_orchestrator
 
 # Sync PDFs
-./scripts/worktree_uv.sh run --project confluence_orchestrator python sync_pdfs_to_confluence.py \
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python sync_pdfs_to_confluence.py \
   sync <page_id> --dir /path/to/pdfs --server external
 
 # Sync PNGs
-./scripts/worktree_uv.sh run --project confluence_orchestrator python sync_png_attachments.py \
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python sync_png_attachments.py \
   sync <page_id> --dir /path/to/pngs --server external
 
 # Regenerate PDFs from markdown
-./scripts/worktree_uv.sh run --project confluence_orchestrator python sync_pdfs_from_markdown.py \
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python sync_pdfs_from_markdown.py \
   /path/to/target-state
 ```
 
@@ -76,7 +76,7 @@ Regenerates PDF files from markdown sources using `vds-cli pdf md2pdf`.
 
 **Usage**:
 ```bash
-./scripts/worktree_uv.sh run --project confluence_orchestrator python sync_pdfs_from_markdown.py \
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python sync_pdfs_from_markdown.py \
   /path/to/directory \
   [--pattern "*.md"] \
   [--dry-run]
@@ -100,11 +100,11 @@ The sync commands are integrated into the unified VDS CLI:
 
 ```bash
 # List PDF attachments
-./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence content attachments \
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence content attachments \
   --page <page_id> --server external
 
 # Sync PDFs (via sync command)
-./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence sync pdfs \
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence sync pdfs \
   <page_id> --dir /path/to/pdfs --server external
 ```
 
@@ -112,15 +112,15 @@ The sync commands are integrated into the unified VDS CLI:
 
 **ModuleNotFoundError: No module named 'confluence_orchestrator'**:
 - Ensure you're running from `vds-scripts/confluence_orchestrator` directory
-- Or use `./scripts/worktree_uv.sh run --project confluence_orchestrator python <script>`
-- Or use the unified CLI: `./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence sync ...`
+- Or use `uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python <script>`
+- Or use the unified CLI: `uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence sync ...`
 
 **PDF generation fails**:
 - Ensure `vds_cli` package is installed: `uv sync --project vds_cli`
 - Check that `vds-cli pdf md2pdf` works independently
 
 **Confluence authentication fails**:
-- Run `./scripts/worktree_uv.sh run --project vds_cli vds-cli env load` to load credentials
+- Run `uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli env load` to load credentials
 - Verify the shared VDS env file contains the required tokens
 
 ns

package/skills/vds-skill/runtime/confluence_orchestrator/SYNC_STANDARDIZATION.md

@@ -20,7 +20,7 @@ Standardized PDF and PNG sync scripts to follow VDS CLI best practices. Sync scr
 - **Added** `sync` subcommand group to `confluence_orchestrator.cli`
 - **Added** `sync pdfs` command that delegates to `sync_pdfs_to_confluence.py`
 - **Added** `sync pngs` command that delegates to `sync_png_attachments.py`
-- **Accessible via**: `./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence sync pdfs/pngs`
+- **Accessible via**: `uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence sync pdfs/pngs`
 
 ### 3. Path Fixes
 
@@ -40,13 +40,13 @@ Standardized PDF and PNG sync scripts to follow VDS CLI best practices. Sync scr
 
 ```bash
 # Sync PDFs to Confluence
-./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence sync pdfs \
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence sync pdfs \
   <page_id> \
   --dir /path/to/pdf/directory \
   --server external
 
 # Sync PNGs to Confluence
-./scripts/worktree_uv.sh run --project vds_cli vds-cli confluence sync pngs \
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli confluence sync pngs \
   <page_id> \
   --dir /path/to/png/directory \
   --server external
@@ -58,15 +58,15 @@ Standardized PDF and PNG sync scripts to follow VDS CLI best practices. Sync scr
 cd vds-scripts/confluence_orchestrator
 
 # Sync PDFs
-./scripts/worktree_uv.sh run --project confluence_orchestrator python sync_pdfs_to_confluence.py \
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python sync_pdfs_to_confluence.py \
   sync <page_id> --dir <directory> --server external
 
 # Sync PNGs
-./scripts/worktree_uv.sh run --project confluence_orchestrator python sync_png_attachments.py \
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python sync_png_attachments.py \
   sync <page_id> --dir <directory> --server external
 
 # Regenerate PDFs from markdown
-./scripts/worktree_uv.sh run --project confluence_orchestrator python sync_pdfs_from_markdown.py \
+uv run --directory ~/.claude/vds-scripts --package confluence_orchestrator python sync_pdfs_from_markdown.py \
   /path/to/target-state --dry-run
 ```
 

package/skills/vds-skill/runtime/confluence_orchestrator/src/confluence_orchestrator/config.py

@@ -204,7 +204,7 @@ def load_settings(
             raise SettingsError(
                 "Missing Confluence credentials. Provide VDS_USERNAME+VDS_PASSWORD as the primary auth mechanism, "
                 "or INTERNAL_CONFLUENCE_TOKEN/EXTERNAL_CONFLUENCE_TOKEN as fallback in the shared VDS env file "
-                "(or run './scripts/worktree_uv.sh run --project vds_cli vds-cli env load')."
+                "(or run 'uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli env load')."
             )
 
     return settings

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

@@ -50,19 +50,19 @@ The diagram generator is integrated into the unified VDS CLI. This is the recomm
 
 ```bash
 # List available services
-./scripts/worktree_uv.sh run --project vds_cli vds-cli diagrams -- --project INSURANCE --list
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli diagrams -- --project INSURANCE --list
 
 # Generate for specific service
-./scripts/worktree_uv.sh run --project vds_cli vds-cli diagrams -- --project INSURANCE --service insurance-policy-business
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli diagrams -- --project INSURANCE --service insurance-policy-business
 
 # Generate all diagram types (C4, Mermaid, Use Case)
-./scripts/worktree_uv.sh run --project vds_cli vds-cli diagrams -- --project INSURANCE --c4 --mermaid --use-case
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli diagrams -- --project INSURANCE --c4 --mermaid --use-case
 
 # Full C4 hierarchy with Structurizr DSL export
-./scripts/worktree_uv.sh run --project vds_cli vds-cli diagrams -- --project INSURANCE --hierarchy --export-dsl
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli diagrams -- --project INSURANCE --hierarchy --export-dsl
 
 # Validate existing diagrams (CI-friendly)
-./scripts/worktree_uv.sh run --project vds_cli vds-cli diagrams -- --project INSURANCE --validate-existing
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli diagrams -- --project INSURANCE --validate-existing
 ```
 
 ### Direct Access (from diagram_generator directory)