Skip to content

armgit / Pulse

Public Imported from GitHub
0

Real-time monitoring dashboard for Proxmox VE, PBS, Docker, Kubernetes, TrueNAS and vSphere. Self-hosted, with alerts for failed backups, full disks, unhealthy containers and offline nodes.

Build real API-linked assets before native agent tests

pulse-triage[bot]11d4dff20da6
diff --git a/.github/workflows/unified-agent-native.yml b/.github/workflows/unified-agent-native.yml
index ec5fa82dc2..8adf002aaa 100644
--- a/.github/workflows/unified-agent-native.yml
+++ b/.github/workflows/unified-agent-native.yml
@@ -84,6 +84,21 @@ jobs:
go-version-file: go.mod
cache: true
+ - name: Set up Node.js for native runtime test assets
+ uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+ with:
+ node-version: '24'
+ cache: 'npm'
+ cache-dependency-path: 'frontend-modern/package-lock.json'
+
+ - name: Install frontend test dependencies
+ working-directory: frontend-modern
+ run: npm ci
+
+ - name: Build real frontend assets for API-linked native tests
+ working-directory: frontend-modern
+ run: npm run build
+
- name: Supply GNU timeout for macOS guidance checks
if: runner.os == 'macOS'
shell: bash
@@ -123,19 +138,6 @@ jobs:
if: ${{ !matrix.unix }}
run: go test ./scripts/installtests -run '^Test(InstallPS1|WindowsAgentLifecycle)'
- - name: Set up Node.js for Windows command proof
- if: ${{ !matrix.unix }}
- uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
- with:
- node-version: '24'
- cache: 'npm'
- cache-dependency-path: 'frontend-modern/package-lock.json'
-
- - name: Install frontend test dependencies
- if: ${{ !matrix.unix }}
- working-directory: frontend-modern
- run: npm ci
-
- name: Execute generated command with Windows PowerShell 5.1
if: ${{ !matrix.unix }}
working-directory: frontend-modern
diff --git a/docs/release-control/v6/internal/subsystems/deployment-installability.md b/docs/release-control/v6/internal/subsystems/deployment-installability.md
index 58d77370c2..bb8653c5a1 100644
--- a/docs/release-control/v6/internal/subsystems/deployment-installability.md
+++ b/docs/release-control/v6/internal/subsystems/deployment-installability.md
@@ -6257,6 +6257,18 @@ workflow trust controls and the retained native Windows command/lifecycle proof
steps. Native Windows execution remains a hosted check, not a local Linux claim.
This upgrade is independent of the grouped signing/Docker/Tailscale updates.
+### Native agent API-linked test assets
+
+Every native agent runtime matrix job prepares the locked frontend dependencies
+and runs the real embedded-asset build before Go tests. Connected Docker-agent
+tests import the API package, whose embed is a compile-time prerequisite; an
+empty directory or placeholder page is not a substitute. Windows reuses that
+same dependency installation for its generated PowerShell command proof.
+`TestNativeAgentWorkflowBuildsRealFrontendBeforeRuntime` checks ordering and
+all-platform coverage, with missing, conditional, late and stub-build controls.
+Linux source checks and Windows cross-compilation do not establish hosted
+Windows runtime or service-lifecycle acceptance.
+
### Published MSP evaluation bundle guidance
The MSP guide and its shipped mirror select the signed v6.4.1 provider archive,
diff --git a/scripts/installtests/native_agent_frontend_test.go b/scripts/installtests/native_agent_frontend_test.go
new file mode 100644
index 0000000000..4d6b60dc5b
--- /dev/null
+++ b/scripts/installtests/native_agent_frontend_test.go
@@ -0,0 +1,96 @@
+package installtests
+
+import (
+ "fmt"
+ "os"
+ "strings"
+ "testing"
+
+ "gopkg.in/yaml.v3"
+)
+
+type nativeAgentFrontendStep struct {
+ Name string
+ If string
+ Uses string
+ With map[string]string
+ WorkingDirectory string `yaml:"working-directory"`
+ Run string
+}
+
+func validateNativeAgentFrontendPreparation(steps []nativeAgentFrontendStep) error {
+ indices := map[string]int{}
+ for i, step := range steps {
+ indices[step.Name] = i
+ }
+ names := []string{
+ "Set up Node.js for native runtime test assets",
+ "Install frontend test dependencies",
+ "Build real frontend assets for API-linked native tests",
+ "Test native agent runtime",
+ }
+ previous := -1
+ for _, name := range names {
+ i, ok := indices[name]
+ if !ok || i <= previous || steps[i].If != "" {
+ return fmt.Errorf("%s must cover every native platform, in preparation order", name)
+ }
+ previous = i
+ }
+ node, dependencies, build := steps[indices[names[0]]], steps[indices[names[1]]], steps[indices[names[2]]]
+ if node.Uses != "actions/setup-node@820762786026740c76f36085b0efc47a31fe5020" ||
+ node.With["node-version"] != "24" || node.With["cache"] != "npm" ||
+ node.With["cache-dependency-path"] != "frontend-modern/package-lock.json" {
+ return fmt.Errorf("native frontend preparation must use the pinned Node tool and locked cache")
+ }
+ if dependencies.WorkingDirectory != "frontend-modern" || strings.TrimSpace(dependencies.Run) != "npm ci" ||
+ build.WorkingDirectory != "frontend-modern" || strings.TrimSpace(build.Run) != "npm run build" {
+ return fmt.Errorf("native tests need the locked real frontend build, not placeholder assets")
+ }
+ return nil
+}
+
+func TestNativeAgentWorkflowBuildsRealFrontendBeforeRuntime(t *testing.T) {
+ content, err := os.ReadFile(repoFile(".github", "workflows", "unified-agent-native.yml"))
+ if err != nil {
+ t.Fatal(err)
+ }
+ var workflow struct {
+ Jobs map[string]struct{ Steps []nativeAgentFrontendStep }
+ }
+ if err := yaml.Unmarshal(content, &workflow); err != nil {
+ t.Fatal(err)
+ }
+ steps := workflow.Jobs["native-agent"].Steps
+ if err := validateNativeAgentFrontendPreparation(steps); err != nil {
+ t.Fatal(err)
+ }
+
+ for _, scenario := range []string{"missing build", "Windows-only preparation", "late build", "stub build"} {
+ t.Run(scenario, func(t *testing.T) {
+ changed := append([]nativeAgentFrontendStep(nil), steps...)
+ buildIndex, runtimeIndex := -1, -1
+ for i, step := range changed {
+ switch step.Name {
+ case "Build real frontend assets for API-linked native tests":
+ buildIndex = i
+ case "Test native agent runtime":
+ runtimeIndex = i
+ }
+ }
+ switch scenario {
+ case "missing build":
+ changed = append(changed[:buildIndex], changed[buildIndex+1:]...)
+ case "Windows-only preparation":
+ changed[buildIndex].If = "${{ !matrix.unix }}"
+ case "late build":
+ changed[buildIndex], changed[runtimeIndex] = changed[runtimeIndex], changed[buildIndex]
+ case "stub build":
+ changed[buildIndex].Run = "mkdir -p ../internal/api/frontend-modern/dist && touch ../internal/api/frontend-modern/dist/index.html"
+ }
+ if err := validateNativeAgentFrontendPreparation(changed); err == nil {
+ t.Fatalf("accepted %s instead of real all-platform preparation", scenario)
+ }
+ })
+ }
+}