Skip to content

Self-hosted, Self-Improving, Federated Everything App — dev management, agent orchestration, persistent mind, digital twin, second brain, and creative pipeline from a single dashboard over Tailscale to port the user into the OS

ci: escalate Windows only for the workflow and pipeline scripts it runs

[._.]/ Adam Eivy643116391284
diff --git a/docs/GITHUB_ACTIONS.md b/docs/GITHUB_ACTIONS.md
index 610df6ef71..732b387787 100644
--- a/docs/GITHUB_ACTIONS.md
+++ b/docs/GITHUB_ACTIONS.md
@@ -805,6 +805,14 @@ edits `App.jsx` *and* bumps a lockfile escalates. Otherwise the job drops to **o
`WINDOWS_CONTRACT_TESTS`** — reduced, never skipped, and exactly the depth a
Windows-risk scoped PR already gets.
+**Workflows and pipeline scripts decide by what runs on `windows-latest`.** Only
+`ci.yml` defines the windows-server job, so only it escalates Windows; `release.yml`,
+`eidoverse-acceptance.yml` and `ci-cancel-recovery.yml` still force a full Linux plan but
+Windows runs the baseline. Likewise only the pipeline scripts the Windows job executes
+(`ci-base-sha`, `run-ci-tests`, and `lib/githubOutput` which the runner imports) escalate it;
+`ci-test-plan`, `run-ci-lint`, `scan-diff-hidden-content` and `verify-ci-status` run on Linux jobs
+only. The nightly run and the `main` → `release` PR keep the complete matrix as the net.
+
**Dependency manifests decide per package.** The planner's 32-PR sample in
October 2026 traced every full plan to a lockfile/manifest change (4),
`server/lib/validation.js` (2) or `.github/workflows/ci.yml` (2). A lockfile
diff --git a/scripts/ci-test-plan.js b/scripts/ci-test-plan.js
index de5a95e866..da1e4d35dc 100644
--- a/scripts/ci-test-plan.js
+++ b/scripts/ci-test-plan.js
@@ -231,8 +231,10 @@ const describeDependencyVerdict = (path, { escalate, reason, packages }) => {
// package, an `engines`/`overrides`/non-dependency field change, or a manifest
// the planner could not read and compare escalates Windows.
const FULL_TRIGGER_RULES = [
- // Defines the windows-server job itself.
- { re: /^\.github\/workflows\//, reason: 'workflow definition changed', windowsEscalates: true },
+ // ci.yml defines the windows-server job itself. The other workflows (release,
+ // acceptance, cancel recovery) never run on windows-latest.
+ { re: /^\.github\/workflows\/ci\.yml$/, reason: 'workflow definition changed', windowsEscalates: true },
+ { re: /^\.github\/workflows\//, reason: 'workflow definition changed', windowsEscalates: false },
{ re: DEPENDENCY_MANIFEST_RE, reason: 'dependency manifest changed', windowsEscalates: 'dependencies' },
// Every workspace's .npmrc pins ignore-scripts and install behavior; npm reads
// it on the Windows install too.
@@ -265,9 +267,13 @@ const FULL_TRIGGER_RULES = [
{ re: /^server\/sockets\/logs\.js$/, reason: 'log socket source changed (broad import fanout)', windowsEscalates: true },
// The scripts that decide what CI runs, run it, and gate the release on it.
// A bug in any of them can make a scoped plan silently test nothing, so they
- // prove themselves against the complete suite rather than their own scope —
- // including on Windows, whose shard matrix ci-test-plan.js itself emits.
- { re: /^scripts\/(?:lib\/githubOutput|ci-base-sha|ci-test-plan|run-ci-(?:lint|tests)|scan-diff-hidden-content|verify-ci-status)(?:\.test)?\.js$/, reason: 'CI pipeline script changed', windowsEscalates: true },
+ // prove themselves against the complete suite rather than their own scope.
+ // Only the ones the windows-server job itself executes (ci-base-sha,
+ // run-ci-tests and the githubOutput helper it imports) escalate Windows; the
+ // planner, lint runner, hidden-content scan and status verifier run on Linux
+ // jobs only, so a Windows run would observe nothing they change.
+ { re: /^scripts\/(?:lib\/githubOutput|ci-base-sha|run-ci-tests)(?:\.test)?\.js$/, reason: 'CI pipeline script changed', windowsEscalates: true },
+ { re: /^scripts\/(?:ci-test-plan|run-ci-lint|scan-diff-hidden-content|verify-ci-status)(?:\.test)?\.js$/, reason: 'CI pipeline script changed', windowsEscalates: false },
];
// Files whose Windows behavior is not faithfully exercised by pinPlatform()
diff --git a/scripts/ci-test-plan.test.js b/scripts/ci-test-plan.test.js
index 398e636570..8e45c0caa5 100644
--- a/scripts/ci-test-plan.test.js
+++ b/scripts/ci-test-plan.test.js
@@ -1309,6 +1309,36 @@ describe('CI test impact planner', () => {
}
});
+ it('escalates Windows only for the workflow and pipeline scripts the windows-server job runs', () => {
+ const windowsModeOf = (path) => buildCiTestPlan([path], { trackedFiles: TRACKED }).windowsMode;
+ // Defined by / executed on windows-latest.
+ for (const path of [
+ '.github/workflows/ci.yml',
+ 'scripts/ci-base-sha.js',
+ 'scripts/lib/githubOutput.js',
+ 'scripts/run-ci-tests.js',
+ 'scripts/run-ci-tests.test.js',
+ ]) expect(windowsModeOf(path), path).toBe('full');
+ // Still a full Linux plan, but nothing on windows-latest loads them: the
+ // baseline runs and the nightly / release PR keep the complete matrix.
+ for (const path of [
+ '.github/workflows/release.yml',
+ '.github/workflows/eidoverse-acceptance.yml',
+ 'scripts/ci-test-plan.js',
+ 'scripts/ci-test-plan.test.js',
+ 'scripts/run-ci-lint.js',
+ 'scripts/scan-diff-hidden-content.js',
+ 'scripts/verify-ci-status.js',
+ ]) {
+ const plan = buildCiTestPlan([path], { trackedFiles: TRACKED });
+ expect(plan.full, path).toBe(true);
+ expect(plan.windowsMode, path).toBe('files');
+ }
+ // Any matching trigger still wins: ci.yml next to a Linux-only script escalates.
+ expect(windowsModeOf('.github/workflows/ci.yml')).toBe('full');
+ expect(buildCiTestPlan(['scripts/ci-test-plan.js', '.github/workflows/ci.yml'], { trackedFiles: TRACKED }).windowsMode).toBe('full');
+ });
+
it('routes worktree-manager source to a full plan instead of a broad nominal scoped plan (#9999)', () => {
const plan = buildCiTestPlan(['server/services/worktreeManager.js'], { trackedFiles: TRACKED });
expect(plan.full).toBe(true);