Merge pull request #96 from TaskarCenterAtUW/feat/2026-06-24-update-run-utils

feat: update run-utils to support skipping internal or external links

Author: uw-amy-bordenave

CHANGELOG.md

@@ -6,6 +6,12 @@ Changes to the TCAT Wiki are documented here.
 
 This project adheres to [Semantic Versioning](https://semver.org/) and [Conventional Commits](https://www.conventionalcommits.org/).
 
+## v12.2.0 (2026-06-24)
+
+### Features
+
+- **Core**: Update `run-utils` utility to support skipping internal or external links
+
 ## v12.1.0 (2026-06-24)
 
 ### Fixes

utilities/run-utils.Tests.ps1

@@ -222,16 +222,20 @@ Describe "Script Structure" {
         $scriptContent | Should -Match '\[switch\]\$TestsOnly'
     }
 
-    It "Should have SkipLinkCheck parameter" {
-        $scriptContent | Should -Match '\[switch\]\$SkipLinkCheck'
+    It "Should have SkipInternalLinksCheck parameter" {
+        $scriptContent | Should -Match '\[switch\]\$SkipInternalLinksCheck'
+    }
+
+    It "Should have SkipExternalLinksCheck parameter" {
+        $scriptContent | Should -Match '\[switch\]\$SkipExternalLinksCheck'
     }
 
     It "Should have NoCache parameter" {
         $scriptContent | Should -Match '\[switch\]\$NoCache'
     }
 
-    It "Should validate mutual exclusivity of SkipLinkCheck and NoCache" {
-        $scriptContent | Should -Match 'SkipLinkCheck.*NoCache.*cannot be used together'
+    It "Should validate mutual exclusivity of SkipExternalLinksCheck and NoCache" {
+        $scriptContent | Should -Match 'SkipExternalLinksCheck.*NoCache.*cannot be used together'
     }
 
     It "Should reference generate-guides-lists.ps1" {

utilities/run-utils.ps1

@@ -35,13 +35,16 @@
 .PARAMETER TestsOnly
     Run only Phase 1 (Pester tests) without running the utilities.
 
-.PARAMETER SkipLinkCheck
+.PARAMETER SkipInternalLinksCheck
+    Skip internal link checking in Phase 2. Useful for quick iterations.
+
+.PARAMETER SkipExternalLinksCheck
     Skip external link checking in Phase 2 (internal links are still checked). Useful for quick iterations.
     Mutually exclusive with -NoCache.
 
 .PARAMETER NoCache
     Force fresh external link checks by bypassing the cache. Passes -NoCache to check-links.ps1.
-    Mutually exclusive with -SkipLinkCheck.
+    Mutually exclusive with -SkipExternalLinksCheck.
 
 .EXAMPLE
     .\run-utils.ps1
@@ -56,9 +59,13 @@
     Skips tests and runs utilities directly.
 
 .EXAMPLE
-    .\run-utils.ps1 -SkipLinkCheck
+    .\run-utils.ps1 -SkipExternalLinksCheck
     Runs tests and utilities, but skips external link checking (internal links still checked).
 
+.EXAMPLE
+    .\run-utils.ps1 -SkipInternalLinksCheck
+    Runs tests and utilities, but skips internal link checking (external links still checked).
+
 .EXAMPLE
     .\run-utils.ps1 -NoCache
     Runs tests and utilities, forcing fresh external link checks (bypasses cache).
@@ -67,14 +74,15 @@
 param(
     [switch]$SkipTests,
     [switch]$TestsOnly,
-    [switch]$SkipLinkCheck,
+    [switch]$SkipInternalLinksCheck,
+    [switch]$SkipExternalLinksCheck,
     [switch]$NoCache
 )
 
 # Validate mutually exclusive parameters
-if ($SkipLinkCheck -and $NoCache) {
-    Write-Host "ERROR: -SkipLinkCheck and -NoCache cannot be used together." -ForegroundColor Red
-    Write-Host "  -SkipLinkCheck: Skips external link checking entirely (only internal links checked)" -ForegroundColor Yellow
+if ($SkipExternalLinksCheck -and $NoCache) {
+    Write-Host "ERROR: -SkipExternalLinksCheck and -NoCache cannot be used together." -ForegroundColor Red
+    Write-Host "  -SkipExternalLinksCheck: Skips external link checking entirely" -ForegroundColor Yellow
     Write-Host "  -NoCache: Forces fresh external link checks (bypasses cache)" -ForegroundColor Yellow
     exit 1
 }
@@ -368,9 +376,12 @@ if (-not $TestsOnly) {
 
     # 3. Check links
     $linkCheckScript = Join-Path $utilPath "check-links.ps1"
-    if ($SkipLinkCheck) {
-        # Only check internal links when -SkipLinkCheck is used
-        Write-Host "  Step 3/3: Checking internal links only (-SkipLinkCheck)" -ForegroundColor Cyan
+    if ($SkipInternalLinksCheck -and $SkipExternalLinksCheck) {
+        # Skip link checking entirely
+        Write-Host "  Step 3/3: Skipping link check (-SkipInternalLinksCheck -SkipExternalLinksCheck)" -ForegroundColor Yellow
+    } elseif ($SkipExternalLinksCheck) {
+        # Only check internal links when -SkipExternalLinksCheck is used
+        Write-Host "  Step 3/3: Checking internal links only (-SkipExternalLinksCheck)" -ForegroundColor Cyan
         Write-Host ""
         & $linkCheckScript -internal
         if ($LASTEXITCODE -ne 0) {
@@ -379,6 +390,23 @@ if (-not $TestsOnly) {
             Write-Host "PHASE 2 FAILED at Step 3" -ForegroundColor Red
             exit 1
         }
+    } elseif ($SkipInternalLinksCheck) {
+        # Only check external links when -SkipInternalLinksCheck is used
+        if ($NoCache) {
+            Write-Host "  Step 3/3: Checking external links only (-SkipInternalLinksCheck -NoCache)" -ForegroundColor Cyan
+            Write-Host ""
+            & $linkCheckScript -external -NoCache
+        } else {
+            Write-Host "  Step 3/3: Checking external links only (-SkipInternalLinksCheck)" -ForegroundColor Cyan
+            Write-Host ""
+            & $linkCheckScript -external
+        }
+        if ($LASTEXITCODE -ne 0) {
+            Write-Host ""
+            Write-Host "==========================================="
+            Write-Host "PHASE 2 FAILED at Step 3" -ForegroundColor Red
+            exit 1
+        }
     } elseif ($NoCache) {
         # Check all links with fresh cache
         Write-Host "  Step 3/3: Checking all links (-NoCache)" -ForegroundColor Cyan

zensical.toml

@@ -734,7 +734,7 @@ nav = [
             {"Why is the dataset not global like OSM?" = "assistant/workspaces/why-is-the-dataset-not-global-like-osm.md"},
             {"Why is Workspaces compatible with OSM tools?" = "assistant/workspaces/why-is-workspaces-compatible-with-osm-tools.md"},
             {"Why must imagery use raw JSON links?" = "assistant/workspaces/why-must-imagery-use-raw-json-links.md"},
-            {"Policies" = [ "assistant/workspaces/policies/index.md" ]},
+            {"Policy" = [ "assistant/workspaces/policy/index.md" ]},
             {"Workflow" = [
                 "assistant/workspaces/workflow/index.md",
                 {"Configure imagery layers in a workspace" = "assistant/workspaces/workflow/configure-imagery-layers.md"},