Unblock release verification build

.github/workflows/app-host-test-rerun.yml

@@ -233,6 +233,12 @@ jobs:
           CMUX_CI_RUNTIME_SOURCE_ROOT=/private/tmp/cmux-test-source \
             "$GITHUB_WORKSPACE/.rerun-tools/scripts/ci/canonical-build-root.sh" \
             --runtime-source "$PWD"
+          # Some compiled XCTest bundles still contain the producer's
+          # canonical `#filePath`; keep that path available alongside the
+          # portable source alias for direct resource fixtures.
+          CMUX_CI_RUNTIME_SOURCE_ROOT="${CMUX_CI_CANONICAL_ROOT:-/private/tmp/cmux-ci}" \
+            "$GITHUB_WORKSPACE/.rerun-tools/scripts/ci/canonical-build-root.sh" \
+            --runtime-source "$PWD"
           echo "CMUX_CI_RUNTIME_SOURCE_ROOT=/private/tmp/cmux-test-source" >> "$GITHUB_ENV"
           receipt="$COMPILE_DERIVED_DATA/Build/Products/cmux-test-products.json"
           cat "$receipt"

Packages/macOS/CmuxSettings/Sources/CmuxSettings/CustomSidebarTemplateCatalog.swift

@@ -92,7 +92,7 @@ public struct CustomSidebarTemplateCatalog: Sendable {
         }
         let installedSource = source
             .split(separator: "\n", omittingEmptySubsequences: false)
-            .filter { !$0.trimmingCharacters(in: .whitespaces).hasPrefix("//   cp Examples/CustomSidebars/") }
+            .filter { !$0.contains("cp Examples/CustomSidebars/") }
             .joined(separator: "\n")
         return CustomSidebarTemplate(descriptor: descriptor, source: installedSource)
     }

Packages/macOS/CmuxSettingsUI/Sources/CmuxSettingsUI/Environment/SettingsHostActions.swift

@@ -10,13 +10,14 @@ public extension Notification.Name {
 
 /// Holds a gallery request until the progressively mounted Custom Sidebars
 /// section is ready to present it.
+// lint:allow namespace-type - one-shot main-actor handoff from a host menu to the lazily mounted Custom Sidebars section.
 @MainActor
 public enum CustomSidebarTemplateGalleryRequest {
     private static var pending = false
 
     public static func request() {
         pending = true
-        NotificationCenter.default.post(name: .customSidebarTemplateGalleryRequested)
+        NotificationCenter.default.post(name: .customSidebarTemplateGalleryRequested, object: nil)
     }
 
     public static func consume() -> Bool {

Sources/CmuxExtensionSidebarSelection.swift

@@ -2,6 +2,7 @@ import AppKit
 import CmuxExtensionSidebarExamples
 import CmuxFoundation
 import CmuxSettings
+import CmuxSettingsUI
 import CmuxSidebarProviderKit
 import Foundation
 

cmuxTests/SidebarProviderMenuRegressionTests.swift

@@ -446,7 +446,7 @@ struct SidebarProviderMenuRegressionTests {
         let directory = root.appendingPathComponent("sidebars", isDirectory: true)
         defer { try? FileManager.default.removeItem(at: root) }
 
-        let template = try #require(CustomSidebarOnboardingAssets().exampleTemplate(id: "focus"))
+        let template = try #require(CustomSidebarOnboardingAssets().exampleTemplate(id: "agents-board"))
         let first = CmuxExtensionSidebarSelection.writeCustomSidebar(
             named: template.suggestedName,
             fileExtension: template.fileExtension,
@@ -468,14 +468,14 @@ struct SidebarProviderMenuRegressionTests {
             return
         }
 
-        #expect(firstName == "focus")
-        #expect(secondName == "focus-2")
+        #expect(firstName == "agents-board")
+        #expect(secondName == "agents-board-2")
         #expect(firstURL != secondURL)
         #expect(CustomSidebarValidator().validate(fileURL: firstURL).errorMessage == nil)
         #expect(CustomSidebarValidator().validate(fileURL: secondURL).errorMessage == nil)
         #expect(
             CmuxExtensionSidebarSelection.discoveredCustomSidebarNames(sidebarsDirectory: directory)
-                == ["focus", "focus-2"]
+                == ["agents-board", "agents-board-2"]
         )
     }
 

scripts/ci/restore-app-host-test-product.sh

@@ -110,3 +110,9 @@ if [ -n "${GITHUB_ENV:-}" ]; then
   echo "CMUX_CI_RUNTIME_SOURCE_ROOT=$CMUX_CI_RUNTIME_SOURCE_ROOT" >> "$GITHUB_ENV"
 fi
 scripts/ci/canonical-build-root.sh --runtime-source "$PWD"
+# `#filePath` literals keep the producer's canonical path even though the
+# compiler's prefix map makes the rest of the test metadata portable. Keep a
+# second alias at that exact path for tests that still open repository files
+# directly (for example bundled CLI scripts).
+CMUX_CI_RUNTIME_SOURCE_ROOT="${CMUX_CI_CANONICAL_ROOT:-/private/tmp/cmux-ci}" \
+  scripts/ci/canonical-build-root.sh --runtime-source "$PWD"

tests/test_ci_change_areas.py

@@ -5767,8 +5767,12 @@ def test_static_preflight_rejects_stale_embedded_schema_before_native_work() ->
                               else 'print("Ran 1 test in 0.001s\\nOK")\n' if category == "tests"
                               else "pass\n")
             target.chmod(0o755)
-        for name in ("verify-local.py", "verification_receipt.py"):
+        for name in ("verify-local.py", "verification_receipt.py", "check-agent-hook-docs.py"):
             shutil.copy2(ROOT / "scripts" / name, repo / "scripts" / name)
+        for path in ("CLI/CMUXCLI+AgentHookCatalog.swift", "docs/agent-hooks.md"):
+            target = repo / path
+            target.parent.mkdir(parents=True, exist_ok=True)
+            shutil.copy2(ROOT / path, target)
         generator = repo / "scripts/generate-cmux-config-schema.py"
         generator.parent.mkdir(parents=True, exist_ok=True)
         shutil.copy2(ROOT / "scripts/generate-cmux-config-schema.py", generator)