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.

Verify frontend graph changes on the native agent platforms

pulse-triage[bot]2155dfba7e34
diff --git a/.github/workflows/unified-agent-native.yml b/.github/workflows/unified-agent-native.yml
index 8b806ebde3..357674c43b 100644
--- a/.github/workflows/unified-agent-native.yml
+++ b/.github/workflows/unified-agent-native.yml
@@ -17,6 +17,10 @@ on:
- 'internal/remoteconfig/**'
- 'internal/updatesignature/**'
- 'pkg/agents/**'
+ # Every native platform installs/builds this graph, and Windows uses its
+ # Vitest runtime for the generated PowerShell 5.1 install command.
+ - 'frontend-modern/package.json'
+ - 'frontend-modern/package-lock.json'
- 'frontend-modern/src/utils/agentInstallCommand.ts'
- 'frontend-modern/src/utils/__tests__/agentInstallCommand.windows.test.ts'
- 'scripts/install.sh'
@@ -40,6 +44,8 @@ on:
- 'internal/remoteconfig/**'
- 'internal/updatesignature/**'
- 'pkg/agents/**'
+ - 'frontend-modern/package.json'
+ - 'frontend-modern/package-lock.json'
- 'frontend-modern/src/utils/agentInstallCommand.ts'
- 'frontend-modern/src/utils/__tests__/agentInstallCommand.windows.test.ts'
- 'scripts/install.sh'
diff --git a/docs/release-control/v6/internal/subsystems/deployment-installability.md b/docs/release-control/v6/internal/subsystems/deployment-installability.md
index 9bfbd8372e..2d5ffc46d3 100644
--- a/docs/release-control/v6/internal/subsystems/deployment-installability.md
+++ b/docs/release-control/v6/internal/subsystems/deployment-installability.md
@@ -6904,3 +6904,17 @@ Windows CI also executes the actual guards against failed and successful native
processes, including the unguarded masking control. An unavailable local
PowerShell is an explicit skip, not native acceptance. Installer behaviour,
service-state exclusions and the existing lifecycle checks are unchanged.
+
+### Native frontend graph admission (7 October 2026)
+
+The existing native-agent jobs install the locked frontend graph and build real
+API-linked assets on every platform. Windows additionally executes generated
+installation commands using that graph's test runtime in PowerShell 5.1. Both
+PR and main path filters therefore include the frontend manifest and lockfile,
+even when no Go or command-generator file changes. Ordinary UI-only edits do
+not gain a new full native matrix trigger.
+
+`TestNativeAgentWorkflowAdmitsFrontendGraphChanges` decodes each event and rejects
+either omitted graph input or a later exclusion. Existing real-build ordering,
+Linux helper, Windows exit/service and installer checks remain unchanged. This
+is admission coverage, not a local Windows/macOS verdict or installed recovery.
diff --git a/scripts/installtests/native_agent_frontend_test.go b/scripts/installtests/native_agent_frontend_test.go
index 4d6b60dc5b..8759a0de37 100644
--- a/scripts/installtests/native_agent_frontend_test.go
+++ b/scripts/installtests/native_agent_frontend_test.go
@@ -18,6 +18,87 @@ type nativeAgentFrontendStep struct {
Run string
}
+func validateNativeAgentFrontendTriggers(content []byte) error {
+ var workflow struct {
+ On map[string]struct{ Paths []string }
+ }
+ if err := yaml.Unmarshal(content, &workflow); err != nil {
+ return err
+ }
+ for _, event := range []string{"push", "pull_request"} {
+ paths := workflow.On[event].Paths
+ for _, required := range []string{"frontend-modern/package.json", "frontend-modern/package-lock.json"} {
+ found := false
+ for _, pattern := range paths {
+ if strings.HasPrefix(pattern, "!") {
+ return fmt.Errorf("%s must not exclude native frontend inputs", event)
+ }
+ found = found || pattern == required
+ }
+ if !found {
+ return fmt.Errorf("%s must admit native frontend graph changes in %s", event, required)
+ }
+ }
+ }
+ return nil
+}
+
+func TestNativeAgentWorkflowAdmitsFrontendGraphChanges(t *testing.T) {
+ content, err := os.ReadFile(repoFile(".github", "workflows", "unified-agent-native.yml"))
+ if err != nil {
+ t.Fatal(err)
+ }
+ if err := validateNativeAgentFrontendTriggers(content); err != nil {
+ t.Fatal(err)
+ }
+ // Decode each event, rather than accepting a matching path elsewhere in
+ // the file. Both PR qualification and containing-main checks need it.
+ for _, event := range []string{"push", "pull_request"} {
+ for _, required := range []string{"frontend-modern/package.json", "frontend-modern/package-lock.json"} {
+ t.Run(event+" missing "+required, func(t *testing.T) {
+ var workflow map[string]interface{}
+ if err := yaml.Unmarshal(content, &workflow); err != nil {
+ t.Fatal(err)
+ }
+ trigger := workflow["on"].(map[string]interface{})[event].(map[string]interface{})
+ paths := trigger["paths"].([]interface{})
+ var changed []interface{}
+ for _, pattern := range paths {
+ if pattern != required {
+ changed = append(changed, pattern)
+ }
+ }
+ if len(changed) != len(paths)-1 {
+ t.Fatal("control must remove exactly one original input")
+ }
+ trigger["paths"] = changed
+ mutant, err := yaml.Marshal(workflow)
+ if err != nil {
+ t.Fatal(err)
+ }
+ if err := validateNativeAgentFrontendTriggers(mutant); err == nil {
+ t.Fatal("accepted frontend graph change without native verification")
+ }
+ })
+ }
+ t.Run(event+" excluded frontend graph", func(t *testing.T) {
+ var workflow map[string]interface{}
+ if err := yaml.Unmarshal(content, &workflow); err != nil {
+ t.Fatal(err)
+ }
+ trigger := workflow["on"].(map[string]interface{})[event].(map[string]interface{})
+ trigger["paths"] = append(trigger["paths"].([]interface{}), "!frontend-modern/**")
+ mutant, err := yaml.Marshal(workflow)
+ if err != nil {
+ t.Fatal(err)
+ }
+ if err := validateNativeAgentFrontendTriggers(mutant); err == nil {
+ t.Fatal("accepted a later filter excluding the native frontend graph")
+ }
+ })
+ }
+}
+
func validateNativeAgentFrontendPreparation(steps []nativeAgentFrontendStep) error {
indices := map[string]int{}
for i, step := range steps {