feat(cli): add Windows support and automated CI test coverage

.gitattributes

@@ -0,0 +1 @@
+* text=auto eol=lf

.github/workflows/test.yaml

@@ -0,0 +1,105 @@
+name: Test
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  # Lint, unit and integration tests run on Cloud Build (cloudbuild-test.yaml); this job only
+  # builds the packages and the smoke test bundle that the Windows job needs.
+  build-linux:
+    name: Build packages and smoke test bundle (Linux)
+    runs-on: ubuntu-latest
+    timeout-minutes: 60
+    permissions:
+      contents: read
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+
+      - name: Setup Bazel
+        uses: bazelbuild/setup-bazelisk@b39c379c82683a5f25d34f0d062761f62693e0b2 # v3.0.0
+
+      # MODULE.bazel sets `use_home_npmrc = True`, so aspect_rules_js requires ~/.npmrc to exist.
+      # An empty file keeps the default public npm registry (Cloud Build writes its own).
+      - name: Create an empty ~/.npmrc
+        run: touch ~/.npmrc
+
+      - name: Build package tarballs and the Windows smoke test bundle
+        run: |
+          bazel build \
+            //packages/@dataform/cli:package_tar \
+            //packages/@dataform/core:package_tar \
+            //cli/tests/windows:smoke_test_bundle
+
+      - name: Upload CLI tarball
+        uses: actions/upload-artifact@4cec3d8aa04e39d1a68397de0c4cd6fb9dce8ec1 # v4.6.1
+        with:
+          name: dataform-cli-tarball
+          path: bazel-bin/packages/@dataform/cli/package.tar.gz
+
+      - name: Upload Core tarball
+        uses: actions/upload-artifact@4cec3d8aa04e39d1a68397de0c4cd6fb9dce8ec1 # v4.6.1
+        with:
+          name: dataform-core-tarball
+          path: bazel-bin/packages/@dataform/core/package.tar.gz
+
+      - name: Upload Windows smoke test bundle
+        uses: actions/upload-artifact@4cec3d8aa04e39d1a68397de0c4cd6fb9dce8ec1 # v4.6.1
+        with:
+          name: windows-smoke-test
+          path: bazel-bin/cli/tests/windows/smoke_test_bundle.js
+
+  test-windows:
+    name: CLI smoke tests (Windows, Node ${{ matrix.node-version }})
+    needs: build-linux
+    runs-on: windows-latest
+    timeout-minutes: 30
+    strategy:
+      fail-fast: false
+      matrix:
+        # Oldest supported Node.js LTS and the current one (also used by the Bazel toolchain).
+        node-version: [22, 24]
+    permissions:
+      contents: read
+    steps:
+      - name: Setup Node.js
+        uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
+        with:
+          node-version: ${{ matrix.node-version }}
+
+      - name: Download CLI tarball
+        uses: actions/download-artifact@cc203385981b70ca67e1cc392babf9cc229d5806 # v4.1.9
+        with:
+          name: dataform-cli-tarball
+          path: dist/cli
+
+      - name: Download Core tarball
+        uses: actions/download-artifact@cc203385981b70ca67e1cc392babf9cc229d5806 # v4.1.9
+        with:
+          name: dataform-core-tarball
+          path: dist/core
+
+      - name: Download Windows smoke test bundle
+        uses: actions/download-artifact@cc203385981b70ca67e1cc392babf9cc229d5806 # v4.1.9
+        with:
+          name: windows-smoke-test
+          path: dist/smoke
+
+      - name: Install @dataform/cli globally from tarball
+        run: npm install -g dist/cli/package.tar.gz
+
+      - name: Run Windows smoke tests in PowerShell
+        shell: powershell
+        run: |
+          node dist/smoke/smoke_test_bundle.js --shell powershell --core-tarball dist/core/package.tar.gz
+
+      - name: Run Windows smoke tests in cmd.exe
+        shell: cmd
+        run: |
+          node dist\smoke\smoke_test_bundle.js --shell cmd --core-tarball dist\core\package.tar.gz

cli/api/commands/base_worker.ts

@@ -19,7 +19,7 @@ export abstract class BaseWorker<TResponse, TMessage = any> {
   ): Promise<TResponse> {
     const forkScript = this.resolveScript();
     const child = fork(forkScript, [], {
-      stdio: [0, 1, 2, "ipc", "pipe"],
+      stdio: [0, 1, 2, "ipc"],
     });
 
     return new Promise((resolve, reject) => {

cli/api/commands/compile.ts

@@ -96,7 +96,7 @@ export async function compile(
   compiledGraph = dataform.CompiledGraph.create(decodedResult.compile.compiledGraph);
 
   if (workflowSettingsDataformCoreVersion) {
-    fs.rmSync(temporaryProjectPath, { recursive: true });
+    fs.rmSync(temporaryProjectPath, { recursive: true, force: true, maxRetries: 3 });
   }
 
   return compiledGraph;

cli/commands/format_command.ts

@@ -14,6 +14,8 @@ import { printError, printFormatFilesResult, printSuccess } from "df/cli/console
 import { ICommand, INamedOption } from "df/cli/yargswrapper";
 import { formatFile } from "df/sqlx/format";
 
+const normalizeLineEndings = (text: string) => text.replace(/\r\n/g, "\n");
+
 export interface IFormatArgs extends IProjectDirArgs, IActionsArgs {
   ignoreJsFiles: boolean;
   check: boolean;
@@ -50,7 +52,13 @@ export const formatCommand: ICommand<IFormatArgs> = {
       actions = argv.actions;
     }
     const filenames = actions
-      .map((action: string) => glob.sync(action, { cwd: argv.projectDir }))
+      .map((action: string) =>
+        glob.sync(action, {
+          cwd: argv.projectDir,
+          // Treat "\" as a path separator only on Windows; on POSIX it remains a glob escape.
+          windowsPathsNoEscape: process.platform === "win32",
+        }),
+      )
       .flat();
 
     const isCheckMode = argv.check;
@@ -70,7 +78,8 @@ export const formatCommand: ICommand<IFormatArgs> = {
             });
             return {
               filename,
-              needsFormatting: fileContent !== formattedContent,
+              needsFormatting:
+                normalizeLineEndings(fileContent) !== normalizeLineEndings(formattedContent),
             };
           } else {
             // Normal formatting mode

cli/index_project_test.ts

@@ -110,5 +110,31 @@ modules.exports = {
       const bufFromContents = Buffer.from(jsContents, "utf-8");
       expect(bufFromContents.equals(bufFromFile)).equals(true);
     });
+
+    test("format --check accepts correctly formatted files with CRLF line endings", async () => {
+      const projectDir = tmpDirFixture.createNewTmpDir();
+      await setupProject(tmpDirFixture, projectDir);
+      writeDefinitionFile(
+        projectDir,
+        "crlf.sqlx",
+        `
+config {   type:  "table"   }
+SELECT  1  as   test
+`,
+      );
+      expect((await runCli("format", [projectDir])).exitCode).equals(0);
+
+      // Same formatted content, but with Windows line endings (e.g. a Git checkout with
+      // core.autocrlf=true).
+      const crlfFilePath = path.join(projectDir, "definitions", "crlf.sqlx");
+      const formattedContent = fs.readFileSync(crlfFilePath, "utf8");
+      expect(formattedContent).not.contains("\r\n");
+      fs.writeFileSync(crlfFilePath, formattedContent.replace(/\n/g, "\r\n"));
+
+      const checkResult = await runCli("format", [projectDir, "--check"]);
+
+      expect(checkResult.exitCode).equals(0);
+      expect(checkResult.stdout).contains("All files are formatted correctly");
+    });
   });
 });

cli/tests/windows/BUILD

@@ -0,0 +1,22 @@
+load("//packages:index.bzl", "pkg_bundle")
+load("//tools:ts_library.bzl", "ts_library")
+
+package(default_visibility = ["//visibility:public"])
+
+ts_library(
+    name = "smoke_test_lib",
+    srcs = ["smoke_test.ts"],
+    deps = [
+        "//:node_modules/@types/node",
+    ],
+)
+
+# Self-contained CommonJS bundle (Node built-ins only) that the Windows CI runner executes with
+# plain `node`; it is built on the Linux job and shipped as a workflow artifact.
+pkg_bundle(
+    name = "smoke_test_bundle",
+    allow_node_builtins = True,
+    entry_point = "smoke_test.js",
+    externals = [],
+    deps = [":smoke_test_lib"],
+)