fix: address PR #407 review issues and build failure

- Remove legacy build.yaml and analyze.yaml workflows (superseded by ci.yml
  and codeql.yml); fixes 'Missing default script' CI build error
- Use $PSScriptRoot-based paths in pipeline.build.ps1 CopyModule task for
  reliable path resolution regardless of working directory
- Add error handling for Get-LocalPSDocsModule return value in build.ps1
- Guard vscode-ci.yml publish step with VSCE_PAT secret existence check
- Document workflow migration in MONOREPO_MIGRATION.md

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: vicperdana

.github/workflows/analyze.yaml

@@ -157,6 +157,7 @@ jobs:
           echo "Found VSIX: $VSIX_FILE"
 
       - name: Publish to VS Marketplace (Pre-release)
+        if: env.VSCE_PAT != ''
         working-directory: packages/vscode-extension/out/package
         env:
           VSCE_PAT: ${{ secrets.VSCE_PAT }}

.github/workflows/build.yaml

@@ -145,6 +145,22 @@ git subtree pull --prefix=packages/psdocs https://github.com/microsoft/PSDocs.gi
 git subtree pull --prefix=packages/vscode-extension https://github.com/microsoft/PSDocs-vscode.git main --squash
 ```
 
+## Workflow Migration
+
+The following legacy workflows were removed as part of the monorepo migration, replaced by new workflows with path-based filtering:
+
+| Removed Workflow | Replacement | Reason |
+|-----------------|-------------|--------|
+| `build.yaml` | `ci.yml` | Old single-package build; incompatible with monorepo `build.ps1` orchestrator |
+| `analyze.yaml` | `codeql.yml` | Replaced with updated CodeQL security scanning workflow |
+
+The following workflows were **kept** as they are independent of the build structure:
+
+| Kept Workflow | Purpose |
+|--------------|---------|
+| `docs.yaml` | Documentation site generation (publishes to GitHub Pages) |
+| `stale.yaml` | Stale issue management (automated issue lifecycle) |
+
 ## Questions?
 
 For questions about:

.github/workflows/vscode-ci.yml

@@ -98,7 +98,10 @@ foreach ($pkg in $packages) {
 
     # After building psdocs, set up module path for psdocs-azure
     if ($pkg -eq 'psdocs' -and $Build) {
-        Get-LocalPSDocsModule | Out-Null
+        $moduleInitialized = Get-LocalPSDocsModule
+        if (-not $moduleInitialized) {
+            Write-Error "Failed to locate or initialize the local PSDocs module. Cannot continue building dependent packages."
+        }
     }
 }
 

MONOREPO_MIGRATION.md

@@ -197,11 +197,11 @@ task ModuleDependencies NuGet, PSDocs
 task CopyModule {
     CopyModuleFiles -Path src/PSDocs.Azure -DestinationPath out/modules/PSDocs.Azure;
 
-    # Copy LICENSE from repo root
-    Copy-Item -Path ../../LICENSE -Destination out/modules/PSDocs.Azure;
+    # Copy LICENSE from repo root (use $PSScriptRoot for reliable path resolution)
+    Copy-Item -Path (Join-Path $PSScriptRoot '../../LICENSE') -Destination out/modules/PSDocs.Azure;
 
-    # Copy third party notices from repo root
-    Copy-Item -Path ../../ThirdPartyNotices.txt -Destination out/modules/PSDocs.Azure;
+    # Copy third party notices from repo root (use $PSScriptRoot for reliable path resolution)
+    Copy-Item -Path (Join-Path $PSScriptRoot '../../ThirdPartyNotices.txt') -Destination out/modules/PSDocs.Azure;
 }
 
 task BuildDotNet {