fix(extension): add workspace extension kind and script fallback patterns

.github/agents/pr-review.agent.md

@@ -43,7 +43,7 @@ All PR review tracking artifacts reside in `.copilot-tracking/pr/review/{{normal
     review/
       {{normalized_branch_name}}/
         in-progress-review.md      # Living PR review document
-        pr-reference.xml           # Generated via scripts/dev-tools/pr-ref-gen.sh
+        pr-reference.xml           # Generated via pr-ref-gen.sh (see script location in Phase 1)
         handoff.md                 # Finalized PR comments and decisions
 ```
 
@@ -148,7 +148,7 @@ Repeat phases as needed when new information or user direction warrants deeper a
 
 ### Phase 1: Initialize Review
 
-Key tools: `git`, `scripts/dev-tools/pr-ref-gen.sh`, workspace file operations
+Key tools: `git`, `pr-ref-gen.sh` (with fallback resolution), workspace file operations
 
 #### Step 1: Normalize Branch Name
 
@@ -160,7 +160,33 @@ Create the PR tracking directory `.copilot-tracking/pr/review/{{normalized_branc
 
 #### Step 3: Generate PR Reference
 
-Generate `pr-reference.xml` using `./scripts/dev-tools/pr-ref-gen.sh --output "{{tracking_directory}}/pr-reference.xml"`. Pass additional flags such as `--base` when the user specifies one.
+Locate and execute the PR reference script using environment-specific fallback patterns.
+
+**For Unix-like shells (bash/zsh)**:
+
+```bash
+# Try local first, then extension
+SCRIPT_PATH="./scripts/dev-tools/pr-ref-gen.sh"
+if [ ! -f "$SCRIPT_PATH" ]; then
+  SCRIPT_PATH=$(find ~/.vscode*/extensions -name "pr-ref-gen.sh" 2>/dev/null | head -1)
+fi
+
+"$SCRIPT_PATH" --output "{{tracking_directory}}/pr-reference.xml"
+```
+
+**For Windows PowerShell**:
+
+```powershell
+# Try local first, then extension
+$ScriptPath = "./scripts/dev-tools/Generate-PrReference.ps1"
+if (-not (Test-Path $ScriptPath)) {
+  $ScriptPath = Get-ChildItem -Path "$HOME/.vscode*/extensions" -Filter "Generate-PrReference.ps1" -Recurse -ErrorAction SilentlyContinue | Select-Object -First 1 -ExpandProperty FullName
+}
+
+pwsh -File $ScriptPath -Output "{{tracking_directory}}/pr-reference.xml"
+```
+
+Pass additional flags such as `--base` (bash) or `-BaseBranch` (PowerShell) when the user specifies one.
 
 #### Step 4: Seed Tracking Document
 

.github/instructions/ado-create-pull-request.instructions.md

@@ -60,6 +60,32 @@ Git operations via `run_in_terminal`:
 
 Workspace utilities: `list_dir`, `read_file`, `grep_search`
 
+**Script path resolution**: Use environment-specific fallback patterns.
+
+**For Unix-like shells (bash/zsh)**:
+
+```bash
+# Try local first, then extension
+SCRIPT_PATH="./scripts/dev-tools/pr-ref-gen.sh"
+if [ ! -f "$SCRIPT_PATH" ]; then
+  SCRIPT_PATH=$(find ~/.vscode*/extensions -name "pr-ref-gen.sh" 2>/dev/null | head -1)
+fi
+
+"$SCRIPT_PATH" --base-branch origin/main --output pr-reference.xml
+```
+
+**For Windows PowerShell**:
+
+```powershell
+# Try local first, then extension
+$ScriptPath = "./scripts/dev-tools/Generate-PrReference.ps1"
+if (-not (Test-Path $ScriptPath)) {
+  $ScriptPath = Get-ChildItem -Path "$HOME/.vscode*/extensions" -Filter "Generate-PrReference.ps1" -Recurse -ErrorAction SilentlyContinue | Select-Object -First 1 -ExpandProperty FullName
+}
+
+pwsh -File $ScriptPath -BaseBranch origin/main -Output pr-reference.xml
+```
+
 Persist all tool output into planning files per ado-wit-planning.instructions.md.
 
 ## Tracking Directory Structure
@@ -367,7 +393,7 @@ Execute without presenting details to user:
 3. Initialize `planning-log.md` with Phase-1 status.
 4. Check if `pr-reference.xml` exists:
    * If exists: Use existing file silently.
-   * If not exists: Generate using `scripts/dev-tools/pr-ref-gen.sh` with optional `--no-md-diff` flag if `${input:includeMarkdown}` is false.
+   * If not exists: Generate using script path resolution with fallback patterns (see Tooling section) with optional `--no-md-diff` flag if `${input:includeMarkdown}` is false.
 5. Read complete `pr-reference.xml`. For files exceeding 2000 lines, read in 1000-2000 line chunks, capturing complete commit boundaries before advancing to the next chunk.
 6. Log artifact in `planning-log.md` with status `Complete`.
 

.github/instructions/ado-wit-discovery.instructions.md

@@ -64,8 +64,32 @@ Add an **External References** section to work item descriptions when authoritat
 
 **Git context** (when `${input:includeBranchChanges}` is `true` and no documents exist):
 
-* `run_in_terminal`: Generate diff XML via `scripts/dev-tools/pr-ref-gen.sh --base-branch "${input:baseBranch}" --output "<planning-folder>/git-branch-diff.xml"`
 * Sync remote first: `git fetch <remote> <branch> --prune`
+* `run_in_terminal`: Generate diff XML using environment-specific fallback patterns:
+
+  **For Unix-like shells (bash/zsh)**:
+
+  ```bash
+  # Try local first, then extension
+  SCRIPT_PATH="./scripts/dev-tools/pr-ref-gen.sh"
+  if [ ! -f "$SCRIPT_PATH" ]; then
+    SCRIPT_PATH=$(find ~/.vscode*/extensions -name "pr-ref-gen.sh" 2>/dev/null | head -1)
+  fi
+
+  "$SCRIPT_PATH" --base-branch "${input:baseBranch}" --output "<planning-folder>/git-branch-diff.xml"
+  ```
+
+  **For Windows PowerShell**:
+
+  ```powershell
+  # Try local first, then extension
+  $ScriptPath = "./scripts/dev-tools/Generate-PrReference.ps1"
+  if (-not (Test-Path $ScriptPath)) {
+    $ScriptPath = Get-ChildItem -Path "$HOME/.vscode*/extensions" -Filter "Generate-PrReference.ps1" -Recurse -ErrorAction SilentlyContinue | Select-Object -First 1 -ExpandProperty FullName
+  }
+
+  pwsh -File $ScriptPath -BaseBranch "${input:baseBranch}" -Output "<planning-folder>/git-branch-diff.xml"
+  ```
 
 **Workspace utilities**: `list_dir`, `read_file`, `grep_search` for artifact location.
 

extension/package.json

@@ -1,6 +1,7 @@
 {
   "name": "hve-core",
   "displayName": "HVE Core",
+  "extensionKind": ["workspace", "ui"],
   "version": "2.0.1",
   "description": "AI-powered chat agents, prompts, and instructions for hybrid virtual environments",
   "publisher": "ise-hve-essentials",