Skip to content

chore: sync spark4.0 with master - #2646

Merged
Rana Singh (ranadeepsingh) merged 123 commits into
spark4.0from
sync/spark4.0-with-master
Aug 17, 2026
Merged

chore: sync spark4.0 with master#2646
Rana Singh (ranadeepsingh) merged 123 commits into
spark4.0from
sync/spark4.0-with-master

Conversation

@ranadeepsingh

@ranadeepsingh Rana Singh (ranadeepsingh) commented Aug 16, 2026

Copy link
Copy Markdown
Collaborator

What

Brings the spark4.0 release branch up to date with master (eb76ff6bd0). The branch had drifted 547 files behind.

spark4.0 was cut from master at a833941704 and has exactly one unique commit — b76c391be4, the Spark 4.0 / Java 17 / Scala 2.13 / Python 3.12 upgrade. So every "ours" side of this merge is by definition part of that upgrade, which made attribution unambiguous.

15 files conflicted. Each was resolved individually — never with a whole-file checkout --ours/--theirs, which would have silently discarded cleanly auto-merged content in the same files.

Resolution rule: keep the Spark 4 side where the difference exists because of the Spark 4 / Scala 2.13 / Java 17 / Python 3.12 upgrade; take master's side otherwise; combine when both sides changed for different reasons.

Conflict resolutions

Combined (both sides changed, for different reasons)

File Resolution
OpenAIChatCompletion.scala Scala 2.13 collection handling + master's withV1DeploymentModel
PyCodegen.scala spark4.0's helper structure + master's isOpenAICompletionStub filter and initFileExtra
DatabricksUtilities.scala DBR 17.3 / Scala 2.13 + master's Gpu* constants
website/doctest.py synapseml_2.13 + master's blob.core.windows.net CDN

Taken from master

SARModel.scala (dfToRDDMatrxEntry was dead code; recommendForAll now uses master's recommendationOutputMapping) · Secrets.scala · tools/docker/{demo,minimal}/Dockerfile (ENV k=v syntax, keeping the Java 17 path) · templates/update_cli.yml (Python 3.11 + disableDownloadFromRegistry, with Java 8 replaced by java_setup.yml) · both notebooks · MultivariateAnomalyDetection.scaladeleted, master retired the service.

Kept from spark4.0

init_spark.py block placement · pyspark==4.0.1 · python=3.12.11 · openjdk=17 · torch 2.2.0/torchvision 0.17.0 (no cp312 wheels for 2.1.x) · the cp312 pandas wheel · protobuf>=4.25,<5 · sbt-scoverage 2.3.0 · pip=25.2 (master downgrades to 21.3, which predates Python 3.12 support).

Corrections beyond a mechanical merge

A purely mechanical merge would have left these broken or stale:

  • mlflow 1.26.1 → 2.21.3. spark4.1 descends from spark4.0 and had already moved off this pin onto master's 2.21.3. Adopting it converges all three branches on one MLflow.
  • pyarrow 22.0.0 → 18.0.0, required in lockstep: mlflow 2.21.3 declares pyarrow<20 (verified against PyPI metadata), so 22.0.0 is unsatisfiable with it. 18.0.0 ships cp312 manylinux wheels, so the original "newer PyArrow for cp312 wheels" rationale still holds. Same pair spark4.1 validated.
  • numpy unpinned → ==1.26.4 (master's pin). Left unpinned, resolution picks NumPy 2.x and breaks the cp312 pandas 2.0.3 wheel's 1.x ABI. 1.26.4 ships cp312 wheels, so unlike spark4.1/Python 3.13 this branch can adopt master's pin directly.
  • requests 2.26.0 → 2.32.5 — the branch still carried the pre-fork base value; LangChain Community (in the auto-merged section) needs the upgrade.
  • init_spark.py line 184: azureedge.netblob.core.windows.net — a stale CDN reference the mechanical merge would have left behind.

CI

pipeline.yaml adopts the reconciliation already validated on spark4.1 (#2645), differing only in SPARK_VERSION=4.0.1 and the FabricE2E comment. FabricE2E is disabled here, as it also is on spark4.1, but for a different reason — Fabric has no Spark 4.0 managed runtime at all, so there is nothing for this branch to target. (Fabric Runtime 2.0 did reach general availability on Spark 4.1, so the original claim that Fabric supported neither version was wrong for 4.1; see the corrections below.) Nothing green is lost: spark4.0 was never in the ADO trigger list, so this job has never run.

This PR also carries the branch-filter changes from #2644, so it validates itself — GitHub reads workflow files from the PR merge commit, so the new filters take effect on this very PR rather than only after it lands.

Enabling that CI immediately surfaced a real defect: pr-validation.yml still selected JDK 11 (master's value, correct for Spark 3.5). That job runs sbt compile "Test / compile", which cannot build Spark 4.0.1 on Scala 2.13 — it would have failed on the first spark4.0 PR that triggered it. Fixed to JDK 17 with workflow-level JAVA_TOOL_OPTIONS, matching spark4.1.

test_pipeline_yaml.py also needed a fix: condition: false on the disabled FabricE2E job parses as a YAML boolean, so "succeeded()" in condition raised TypeError rather than failing an assertion. Added spark4.0 guards for the runtime settings a future master sync could silently revert.

Validation

Executed locally on Spark 4.0.1 / Scala 2.13.16 / Java 17 (this branch had never been compiled or CI-tested before):

Check Result
sbt compile (all 6 modules) ✅ SUCCESS
sbt Test/compile ✅ SUCCESS
sbt scalastyle Test/scalastyle ✅ 14/14 modules, 0 errors
core/testOnly serialize + logging + train + stages 327 / 328 passed (see below)
pytest tools/ci/tests/test_pipeline_yaml.py ✅ 20 passed
black 22.3.0 (whole repo, as CI runs it) ✅ clean
YAML parse: pipeline + environment + 3 workflows
Conflict markers tree-wide ✅ 0

Two failures appeared and both were run to ground:

  1. EnsembleByKeySuitefixed. Spark 3.5 rejected the downstream VectorAssembler because it resolved input columns with a case-sensitive StructType lookup; Spark 4 routes that through SQLConf.get.resolver and so applies the same session-less case-insensitive fallback EnsembleByKey itself uses. The two now agree, making the old intercept unreachable. The assertion is retargeted at the transformed schema — the stable contract on both versions, and it still passes on Spark 3.5. Same fix as chore: sync spark4.1 with master #2645, keeping the release branches converged.

  2. VerifyTrainClassifierpre-existing, not caused by this merge. Proven by checking out the pre-merge branch tip b76c391be4 and running the same test: it fails there with the identical error ([USER_RAISED_EXCEPTION] Vector values MUST NOT be NaN or Infinity, but got [3.0,NaN,0.2,-1.23,0.12,0.34,4.0]). The same test passes on Spark 4.1.1, so this is a Spark 4.0.1-specific behaviour that 4.1 changed; the message is not in SynapseML source. Deliberately left out of scope — bundling an ML behaviour change into a 431-file sync would obscure both. Worth a follow-up issue against the spark4.0 branch.

Follow-ups

  • Add spark4.0 to the ReleaseBranchCompat matrix now that the branch is current (it was left spark4.1-only in ci: run PR validation on the spark3.5, spark4.0 and spark4.1 branches #2644 because a 547-file-behind branch would have been permanently red).
  • Apply the same EnsembleByKeySuite assertion to master so all three branches carry an identical test.
  • Investigate the pre-existing VerifyTrainClassifier NaN failure on Spark 4.0.1. Fixed in this PR — see the update below.

Updates since the description above

Corrections to this description

Two statements above were wrong and are corrected in place:

  • Fabric. This description originally said Fabric "supports neither 4.0 nor 4.1". That is wrong for 4.1 — Fabric Runtime 2.0 reached general availability on Apache Spark 4.1. It remains correct for 4.0, which is why the job stays disabled here; the difference, and what enabling it on spark4.1 would require, is recorded in AGENTS_spark4.1.md on chore: sync spark4.1 with master #2645.
  • VerifyTrainClassifier. Listed as an open follow-up. It has since been fixed in this PR.

Additional fixes

Found by auditing this branch against spark4.1 — which, being a descendant of this branch's upgrade commit and more actively maintained, had already solved most of them.

Fix Why it mattered How it was verified
Bind generated OpenAIPrompt overrides via MRO instead of a hardcoded class name pyInternalWrapper makes codegen emit class _OpenAIPrompt, so super(OpenAIPrompt, self) raises NameError — that name does not exist in the generated module inspected generated output
Stop shipping a stale hand-written __init__ for synapse.ml.io.http PythonInitMerger arrived from master and now preserves these files rather than overwriting them, so its listing of HTTPFunctions/ServingFunctions (modules of free functions, no same-named class) became a live ImportError regression test added
Enable ANSI double-quoted identifiers for generated R tests sparklyr emits SELECT 0L AS "class"; without the flag Spark 4 reads that as a string literal and fails with PARSE_SYNTAX_ERROR
Retarget the local-setup skill at this branch's toolchain it was byte-identical to master's, so it configured JDK 11 / Scala 2.12 on a JDK 17 / Scala 2.13.16 branch ran synapseml-doctor.sh against a real clone: jdk17, sparkVersion "4.0.1", scalaVersion "2.13.16", doctor_status=ok, exit 0
Correct the GPU smoke-test runtime in the Phi RAG quickstart said DBR 14.3 LTS ML; CI runs 17.3 notebook re-parsed as valid JSON
Drop the NaN feature value that breaks vector-column training the VerifyTrainClassifier failure above. Spark 4.0.1 rejects a NaN feature reaching logistic regression. The test is about training on a vector column, not about NaN, so the fixture value was changed rather than the assertion weakened ran the test on Spark 4.0.1: Tests: succeeded 1, failed 0
Drop duplicate vw and services/openai __init__ shims same PythonInitMerger change: these redefined __all__, narrowing from ... import * to a hand-maintained list that goes stale silently ran vw/pyCodegen before and after — before showed the spliced body with __all__ = []; after showed only the header and 15 import * lines

Documentation

Adds AGENTS_spark4.0.md recording every divergence on this branch and why, plus the shared AGENTS.md / CONTRIBUTING.md pair (byte-identical across master, spark4.0 and spark4.1; proposed for master in #2648).

This also surfaced a bug: .gitignore has ignored AGENTS.md and .agents/ since b76c391be4, the Spark 4.0 upgrade commit. Master ignores neither. The failure mode is the quiet kind — git add AGENTS.md prints a hint and exits zero, so the file is simply absent from the commit. .agents/ is worse: it holds tracked repo content, and a probe confirmed any new file under it is silently dropped. Both rules removed.

Completeness audit

Reachability was not treated as sufficient evidence that the sync landed — an empty git log master ^branch only proves the commits are ancestors, and a conflict resolution can discard master's side while leaving the merge commit intact. Every file master changed since the merge base was compared line by line:

Level Result
master commits unreachable from this branch 0
files added by master, missing here 0
files master has that this branch deleted 0
master-added lines absent from this branch 26 across 11 files — all classified

Of those 26: most were false positives where master's intent survived a refactor (for example init_spark.py, where master's CDN change is present via a new remote_repo variable), several were deliberate documented adaptations (environment.yml pins, the CMS GC flags that are invalid on Java 17), and two were real gaps — the local-setup skill and the notebook runtime, both fixed above.

smamindl and others added 30 commits April 17, 2026 17:09
Add a ReleaseBranchCompat job that runs on every PR to master.
It rebases each release branch (starting with spark4.0) onto
the PR HEAD and runs sbt compile test:compile to catch breakage
before it lands in master.

- Non-blocking (continueOnError: true)
- Matrix-based for easy expansion to more release branches
- Reports merge conflicts and compile failures as warnings

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…ease demo image (#2557)

Addresses MSRC case 110886 / incident 31000000570827.

The mmlspark/release image (built from tools/docker/demo/Dockerfile) ships
Spark 3.5.4, which pins netty 4.1.96.Final. That version is flagged for
multiple CVEs (CVE-2023-44487, CVE-2024-29025, CVE-2025-24970, ...). Spark
has not bumped netty in any 3.5.x release.

netty 4.1.x is binary-compatible, so we replace all netty-*-4.1.96.Final*.jar
files in /opt/spark/jars/ with 4.1.118.Final right after the Spark extract.
This includes netty-codec-http2 (the specific artifact named by the finder).

Also removes 'pyspark' from the conda install line. It was pulling a
complete second Spark install (PySpark 4.0.1) into
/usr/local/lib/python*/site-packages/pyspark/ that nothing in the demo image
actually used (SPARK_HOME points at /opt/spark) and that doubled the surface
area scanners report on.

Validated locally:
- /opt/spark/jars/netty-*-4.1.96.Final*.jar: 0 matches after build
- /opt/spark/jars/netty-*-4.1.118.Final*.jar: full set present
- /usr/local/lib/.../pyspark: no longer exists
- spark-submit --version: works
- spark.range(5).count(): returns 5

Jetty (shaded inside hadoop-client-runtime-3.3.4.jar at 9.4.43) is OUT OF
SCOPE for this PR; that requires a Spark/Hadoop swap and will be tracked
separately.
* chore: add SynapseML local setup skill

## Summary
Add a project-scoped SynapseML agent skill that diagnoses local toolchain state, selects JDK 11 for SBT commands, runs a safe local Spark smoke test, and flags live-service tests before agents run them.

## Prompting Intent
The engineer asked the agent to create a skill that helps any future agent get SynapseML working locally after the PR 2556 review exposed a local Java 21 and Scala 2.12 compiler-bridge failure. The engineer also asked to create a PR for the skill addition before continuing the original external PR review.

## Linked Sources
- User request in current session: create a skill that will help any agent be able to get SynapseML working locally.
- Follow-up user request in current session: create a PR for that skill addition and continue using it to review PR 2556.
- Existing project-scoped skill convention: .agents/skills/code-review/SKILL.md.
- Local validation output: doctor_status=ok, JDK 11 dry-run selected JAVA_HOME, smoke test passed, Azure Search tests flagged review_required.

## Rationale
A project-scoped SynapseML skill keeps local setup guidance with the repository where future agents need it. The scripts use explicit parameters rather than session state, force JDK 11 for Scala 2.12 SBT commands, and include a live-service guard so agents do not accidentally create or delete Azure Search resources while validating changes.

* chore: move SynapseML setup skill to Copilot path

## Summary
Move the SynapseML local setup skill from `.agents/skills/` to `.github/skills/` so it uses the documented Copilot project-skill discovery path.

## Prompting Intent
The engineer asked whether the `.agents` folder was correct and whether Copilot would pick it up. Investigation found that the local skill-authoring reference documents `.github/skills/<name>/` and `.claude/skills/<name>/` as project skill locations, so the open skill PR needed a path correction.

## Linked Sources
- User question in current session: is this .agent folder correct? will copilot pick this up?
- Skill-authoring reference: /home/brwals/.copilot/installed-plugins/copilot-toolkit-marketplace/common/skills/create-skill/references/REFERENCE.md
- Existing PR: #2558

## Rationale
The existing `.agents/skills/code-review` directory was only evidence of a repo-local convention, not evidence of Copilot discovery. Moving the new skill to `.github/skills/synapseml-local-setup/` keeps the same skill content while placing it in the documented project-skill path.
#2560)

* Add v1 OpenAI Endpoint support and remove legacy completions API

* Fix FuzzingUnitTest

* Add test to increase code coverage

* Make v1 api assumption cleaner

* Add OpenAICompletion deprecation

* Remove deprecation warnings

* Fix RAI test for OpenAIPrompt

* Revert "Add OpenAICompletion deprecation"

This reverts commit fa708e2.

* Revert "Fix RAI test for OpenAIPrompt"

This reverts commit 3ed6044.

* Revert "Remove deprecation warnings"

This reverts commit 9a40c5c.

* Reapply "Remove deprecation warnings"

This reverts commit 987484c.

* Reapply "Fix RAI test for OpenAIPrompt"

This reverts commit f06f1ad.

* Reapply "Add OpenAICompletion deprecation"

This reverts commit 10715cd.
## Summary
Move the remaining SynapseML repo skill from `.agents/skills/` to `.github/skills/` so Copilot CLI can discover all repo-versioned skills from the documented project-skill path. Add README pointers under `.agents/` for tools or agents that inspect the older convention.

## Prompting Intent
The engineer asked to migrate everything to the correct Copilot CLI path and suggested keeping a generic agents pointer. The goal was to make existing skills discoverable by Copilot while avoiding future confusion about `.agents/skills`.

## Linked Sources
- User request in current session: migrate everything to the correct path for Copilot CLI and keep a generic agents pointer.
- Skill location reference: /home/brwals/.copilot/installed-plugins/copilot-toolkit-marketplace/common/skills/create-skill/references/REFERENCE.md
- Prior merged skill PR: #2558

## Rationale
`.github/skills/<name>/` is the documented Copilot CLI project-skill location. Keeping only README pointers under `.agents/` preserves a breadcrumb for other agent conventions without leaving duplicate or stale `SKILL.md` files in a path Copilot CLI may not load.
* add speechtotextsdk improvements

* Fix ffmpeg output args

* add ffmpeg url check

* fix: address speech recording review feedback

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* test: make OpenAIPrompt RAI test resilient

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Revert "test: make OpenAIPrompt RAI test resilient"

This reverts commit fccce86.

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* chore: remove Acrolinx integration config

AB#5391146 AB#5391147

## Summary
Remove the retired Acrolinx repository configuration from SynapseML and add the Feature Registry pointer and repo-specific design notes for Feature 5391136.

## Prompting Intent
Engineer asked the agent to complete the Acrolinx removal request from the Microsoft Learn authoring tools PM. The repository cleanup needed to remove stale source-controlled Acrolinx state while preserving Feature Registry traceability for the administrative webhook removal and the June 30 contract-expiration risk.

## Linked Sources
- ADO Feature: https://msdata.visualstudio.com/A365/_workitems/edit/5391136
- Design Spec task: https://msdata.visualstudio.com/A365/_workitems/edit/5391146
- Deployment task: https://msdata.visualstudio.com/A365/_workitems/edit/5391147
- Feature Registry specs: https://msdata.visualstudio.com/A365/_git/FeatureRegistry?path=/Features/active/5391136
- Teams request: https://teams.microsoft.com/l/message/19:81ff723c-eac9-4b2a-ba9f-844542135555_cc1adbf9-6510-43d6-a849-adba51e66d59@unq.gbl.spaces/1782314980087?context=%7B%22contextType%22%3A%22chat%22%7D
- Acrolinx config before cleanup: https://github.com/microsoft/SynapseML/blob/b0fa222cfdde5d0a2cbb2bc6a35630bbb61bc0e3/.acrolinx-config.edn

## Rationale
Deleting `.acrolinx-config.edn` is the least invasive source change because the Acrolinx contract is ending and the repo-level webhook was already removed through GitHub administration. Keeping the Feature Registry folder in the repo gives future maintainers a durable pointer to the reason for the cleanup without adding runtime or build behavior.

* chore: keep Feature Registry metadata out of SynapseML

AB#5391146 AB#5391147

## Summary
Remove the Feature Registry scaffold files from the SynapseML cleanup branch so the public repository PR only deletes the retired Acrolinx config.

## Prompting Intent
Engineer clarified that Feature Registry metadata must not be included in the external SynapseML repository. The agent adjusted the existing cleanup PR to keep registry tracking in FeatureRegistry only while preserving the Acrolinx source cleanup.

## Linked Sources
- ADO Feature: https://msdata.visualstudio.com/A365/_workitems/edit/5391136
- SynapseML PR: #2570
- FeatureRegistry PR: https://msdata.visualstudio.com/A365/_git/FeatureRegistry/pullrequest/2169703
- User correction: do not include Feature Registry metadata in the external repo

## Rationale
Keeping the public SynapseML PR scoped to `.acrolinx-config.edn` avoids adding internal Feature Registry process artifacts to an external repository. Feature-level tracking remains in the FeatureRegistry PR and ADO work items.
* fix: route AnalyzeText document errors to errorCol

Move Azure AI Language document-level errors returned inside HTTP 200 AnalyzeText responses from the response payload into the configured error column after auto-batch flattening. Preserve transport error precedence and add a no-network regression test for mixed document success/error responses.

AB#4638662

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* ci: pin PR validation sbt launcher

Use the sbt launcher version from project/build.properties instead of installing the latest apt sbt package. This keeps the JDK 11 PR validation job on the repository's sbt 1.10.11 launcher and avoids sbt 2.x rejecting JDK 11 before scalastyle can run.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* ci: use pinned sbt wrapper in PR validation

Invoke the downloaded sbt launcher explicitly so the GitHub runner does not resolve its preinstalled sbt 2.x binary under JDK 11.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* ci: prefer pinned sbt on PATH

Keep PR validation commands as plain sbt while placing the repository-version launcher first on PATH for subsequent workflow steps.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* test: avoid ordering assumption in AnalyzeText error test

Partition collected rows by error nullability instead of relying on collect order, addressing PR review feedback about Spark DataFrames being unordered.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Pin the shared Python test environment to MLflow 2.21.3, matching the Databricks test dependency. This constrains protobuf to a compatible major version and invalidates the stale conda cache that breaks Python test collection.
test: migrate OpenAI tests and examples to GPT-5.1
ci: migrate Databricks GPU pool to T4
fix: correct LightGBM improvement tolerance semantics
Bumps [amannn/action-semantic-pull-request](https://github.com/amannn/action-semantic-pull-request) from 5.4.0 to 6.1.1.
- [Release notes](https://github.com/amannn/action-semantic-pull-request/releases)
- [Changelog](https://github.com/amannn/action-semantic-pull-request/blob/main/CHANGELOG.md)
- [Commits](amannn/action-semantic-pull-request@v5.4.0...v6.1.1)

---
updated-dependencies:
- dependency-name: amannn/action-semantic-pull-request
  dependency-version: 6.1.1
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: Rana Singh <ranadeep.dtu@gmail.com>
Bumps [ossf/scorecard-action](https://github.com/ossf/scorecard-action) from 2.3.1 to 2.4.4.
- [Release notes](https://github.com/ossf/scorecard-action/releases)
- [Changelog](https://github.com/ossf/scorecard-action/blob/main/RELEASE.md)
- [Commits](ossf/scorecard-action@0864cf1...2d11466)

---
updated-dependencies:
- dependency-name: ossf/scorecard-action
  dependency-version: 2.4.4
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Bumps [actions/setup-java](https://github.com/actions/setup-java) from 5.6.0 to 5.7.0.
- [Release notes](https://github.com/actions/setup-java/releases)
- [Commits](actions/setup-java@03ad4de...b6effb0)

---
updated-dependencies:
- dependency-name: actions/setup-java
  dependency-version: 5.7.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Rana Singh <ranadeep.dtu@gmail.com>
* docs: add T4 GPU local RAG quickstart

## Summary
Add an end-to-end local RAG notebook that performs sentence embedding, exact retrieval, and Phi-4-mini generation on a Databricks T4 worker. Register the notebook in the active GPU smoke suite and documentation sidebar with pinned model dependencies.

## Prompting Intent
Reassess the unmerged GPU demo from PR #2271 against current master. Add a maintainable integration example only if it fills a gap beyond the standalone GPU KNN, Hugging Face CausalLM/Phi, and PDF Q&A notebooks; use current T4 assumptions, avoid TensorRT-LLM and custom CUDA setup, provide deterministic smoke assertions, and make no unrelated pipeline changes.

## Linked Sources
- Original proposal: #2271
- GPU KNN component: #2157
- Local embedding component: #2236
- Hugging Face CausalLM/Phi component: #2301
- Current Databricks T4 validation platform: #2579
- PDF Q&A reference: https://github.com/microsoft/SynapseML/blob/master/docs/Explore%20Algorithms/AI%20Services/Quickstart%20-%20Document%20Question%20and%20Answering%20with%20PDFs.ipynb

## Rationale
The existing notebooks document the individual building blocks but not their local, service-free composition. Exact PyTorch cosine scoring keeps the tutorial small and fully testable on the active T4 suite without reviving the disabled RAPIDS pipeline or its obsolete CUDA/TensorRT initialization. The notebook uses supported current-master models, max_new_tokens rather than conflicting sequence limits, and a PR smoke mode that exercises every GPU stage.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs: harden GPU RAG reproducibility checks

## Summary
Pin both Hugging Face repositories to immutable commit snapshots, load the Phi model and tokenizer from the same local snapshot with remote code disabled, and strengthen retrieval validation against input-order fallback.

## Prompting Intent
Address independent review findings on PR #2588 by removing mutable model resolution and trust_remote_code, then make the smoke test prove that GPU similarity ranking—not corpus order—selects the answer document.

## Linked Sources
- Follow-up pull request: #2588
- Original proposal: #2271
- Pinned embedding snapshot: https://huggingface.co/sentence-transformers/all-MiniLM-L6-v2/tree/1110a243fdf4706b3f48f1d95db1a4f5529b4d41
- Pinned Phi snapshot: https://huggingface.co/microsoft/Phi-4-mini-instruct/tree/cfbefacb99257ffa30c83adab238a50856ac3083

## Rationale
SentenceTransformer accepts an immutable revision for its complete model/tokenizer snapshot. HuggingFaceCausalLM loads its tokenizer separately, so Phi is first resolved to one pinned worker-local snapshot and both loaders receive that path. Transformers 4.49 natively supports the checkpoint's phi3 architecture, allowing remote model code to remain disabled. A persisted corpus ordinal and independent Python sort over all GPU scores prove the top-k result differs from the first input rows and has strict score ordering.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* style: format GPU RAG notebook cells

## Summary
Apply the repository-pinned Black 22.3 Jupyter formatter to the updated GPU RAG notebook cells.

## Prompting Intent
Resolve the Python Style CI failure on PR #2588 without changing notebook behavior or broadening the patch.

## Linked Sources
- Pull request: #2588
- Failed Azure build: https://msdata.visualstudio.com/b9b2accc-2d1c-45b3-9d24-0eb5d78cc47f/_build/results?buildId=229241355

## Rationale
Black's Jupyter formatter omits the terminal newline stored in each code cell. Formatting only the touched notebook aligns its JSON representation with the CI environment while preserving all model-pinning and retrieval assertions.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs: pin GPU RAG hub client and FP16

## Summary
Pin huggingface-hub 0.26.0 in the Databricks GPU libraries and notebook setup, verify the Hugging Face dependency set in unit tests, and force Phi model loading to FP16 on T4 hardware.

## Prompting Intent
Address the second independent re-review of PR #2588 by making snapshot_download's client version reproducible and preventing Phi's BF16 checkpoint metadata from selecting an unsupported native dtype on T4 GPUs.

## Linked Sources
- Pull request: #2588
- Repository environment pin: environment.yml
- Hugging Face Hub 0.26.0: https://pypi.org/project/huggingface-hub/0.26.0/
- Pinned Phi configuration: https://huggingface.co/microsoft/Phi-4-mini-instruct/blob/cfbefacb99257ffa30c83adab238a50856ac3083/config.json

## Rationale
Version 0.26.0 is already the repository-pinned lower bound used with Transformers 4.49.0, so installing that exact version on the GPU cluster makes snapshot resolution deterministic without introducing a new dependency choice. Phi advertises bfloat16 in its configuration, while NVIDIA T4 compute capability 7.5 lacks native BF16; passing the supported float16 dtype explicitly avoids architecture-dependent auto selection.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* test: guard accelerate GPU dependency pin

## Summary
Assert that the Databricks GPU library manifest retains accelerate==0.26.0 alongside the pinned Hugging Face dependencies.

## Prompting Intent
Address the remaining actionable review feedback on PR #2588 by preventing the runtime dependency used for distributed Phi loading from drifting without a focused unit-test failure.

## Linked Sources
- Pull request: #2588
- Reviewed GPU library manifest: core/src/test/scala/com/microsoft/azure/synapse/ml/nbtest/DatabricksUtilities.scala

## Rationale
The package is already explicitly pinned in GPULibraries, so extending the existing parsed-manifest test is the smallest regression guard and avoids duplicating library configuration or changing runtime behavior.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
#2601)

* chore(deps): bump github/codeql-action/autobuild from 4.37.3 to 4.37.5

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: ranadeepsingh <16433904+ranadeepsingh@users.noreply.github.com>
Co-authored-by: Rana Singh <ranadeep.dtu@gmail.com>
Bumps [postcss](https://github.com/postcss/postcss) from 8.5.19 to 8.5.25.
- [Release notes](https://github.com/postcss/postcss/releases)
- [Changelog](https://github.com/postcss/postcss/blob/main/CHANGELOG.md)
- [Commits](postcss/postcss@8.5.19...8.5.25)

---
updated-dependencies:
- dependency-name: postcss
  dependency-version: 8.5.25
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Rana Singh <ranadeep.dtu@gmail.com>
* chore: migrate artifact links off retiring Azure CDN

## Summary
Replace all 400 current-master references to mmlspark.azureedge.net with the repository-owned mmlspark Blob Storage origin across runtime package configuration, release output, examples, documentation, notebooks, and every published documentation version.

## Prompting Intent
Recreate the intent of the stale CDN-removal PR on current master only after verifying the supported artifact destination and Azure CDN retirement path. Audit each endpoint use by semantics, preserve package and content paths, validate live artifacts and package resolution, and avoid changing or closing the original PR.

## Linked Sources
- Original proposal: #2326
- Azure CDN retirement FAQ: https://learn.microsoft.com/en-us/azure/cdn/classic-cdn-retirement-faq
- Azure CDN migration guidance: https://learn.microsoft.com/en-us/azure/cdn/migrate-tier
- Azure Front Door/CDN comparison: https://learn.microsoft.com/en-us/azure/frontdoor/front-door-cdn-comparison

## Rationale
SynapseML's release pipeline publishes artifacts directly to the mmlspark storage account, the repository already uses that public Blob Storage origin extensively, and byte-for-byte URL checks confirmed the CDN currently proxies the same content. Using the verified origin removes the retiring CDN hostname without inventing an unverified Front Door name, while preserving Maven, documentation, R-package, model, dataset, and icon path semantics. Historical links that already return 404 retain the same status and are not broadened into unrelated artifact-repair work.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs: make R setup independent of retired CDN

## Summary
Repair current and versioned R setup guidance so each release installs its six published, version-matched component archives and resolves SynapseML JVM artifacts through Blob Storage. Document the compatibility bypass required by already-published wrappers, correct the Databricks setup and LightGBM example, remove invalid HTML-page Maven repositories from the Docker demo, and add generator/docs regressions.

## Prompting Intent
Investigate the review finding that published R archives still register the retired Azure CDN resolver. Make repository-controlled R installation work with that hostname unavailable, avoid claiming that externally published archives were rewritten, validate local and Databricks-oriented resolution paths, and state the exact external publishing prerequisite for a full artifact migration.

## Linked Sources
- Original migration PR: #2326
- Current migration PR: #2589
- Maven repository review: #2589 (comment)
- Azure CDN retirement FAQ: https://learn.microsoft.com/en-us/azure/cdn/classic-cdn-retirement-faq
- Azure Front Door migration guidance: https://learn.microsoft.com/en-us/azure/cdn/migrate-tier
- Apache Spark package repository configuration: https://spark.apache.org/docs/3.5.0/configuration.html#runtime-environment

## Rationale
Existing release archives cannot be repaired by a source-only change because their generated sparklyr metadata is already published. Version-matched component downloads plus an explicit Blob resolver and `extensions = character()` provide a tested repository-controlled path without racing or misrepresenting external publication. Future generated archives inherit the corrected resolver from PackageUtils; fully repairing historical metadata still requires an authorized regeneration and publish to the `mmlspark/rrr` container (or a replacement release).

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs: correct Spark 3.4 compatibility guidance

## Summary
Correct the Spark Packages and Python installation snippets so both identify SynapseML 1.0.15 as the compatible release for Spark 3.4 while retaining SynapseML 1.1.3 for Spark 3.5.

## Prompting Intent
Address the remaining actionable review feedback on PR #2589 in the existing branch, verify the surrounding compatibility guidance stays consistent, run targeted website validation and code review, and rerun the full PR checks.

## Linked Sources
- Pull request and review feedback: #2589
- Original migration context: #2326

## Rationale
The Databricks, Fabric, and SBT guidance already distinguishes SynapseML 1.1.3 for Spark 3.5 from 1.0.15 for Spark 3.4. Updating only the two stale explanatory references restores consistency without changing the Spark 3.5 commands that the snippets demonstrate.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
feat: add backward-compatible AAD auth for Azure Search
## Summary
Count rows on the original DataFrame RDD so adaptive execution cannot coalesce a projected counting query into a different partition topology. Add a regression that exposes the old 20-to-fewer-partitions drift and verifies exact per-partition counts.

## Prompting Intent
Recreate the valid intent behind ancient PR #2282 from current master only after reproducing issue #2278. Isolate distributed startup, feature-width bounds, and native pointer lifetime separately; use TDD and submit only a proven root cause with real regression coverage.

## Linked Sources
- Reported failure: #2278
- Superseded ancient proposal: #2282

## Rationale
The literal-only projection was cheaper, but AQE could optimize it to fewer partitions than the training DataFrame. LightGBM then indexed that shortened count array with real task partition IDs, causing the primary ArrayIndexOutOfBoundsException and secondary connection failures. Counting the exact DataFrame RDD trades projection pruning for topology correctness. Feature-width validation and innerPredict cleanup were deliberately excluded because neither was demonstrated as the cause of #2278 or backed by a stable leak regression.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Bumps [github/codeql-action/upload-sarif](https://github.com/github/codeql-action) from 4.37.3 to 4.37.4.
- [Release notes](https://github.com/github/codeql-action/releases)
- [Changelog](https://github.com/github/codeql-action/blob/main/CHANGELOG.md)
- [Commits](github/codeql-action@e4fba86...f205ea1)

---
updated-dependencies:
- dependency-name: github/codeql-action/upload-sarif
  dependency-version: 4.37.4
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Bumps [github/codeql-action/upload-sarif](https://github.com/github/codeql-action) from 4.37.4 to 4.37.5.
- [Release notes](https://github.com/github/codeql-action/releases)
- [Changelog](https://github.com/github/codeql-action/blob/main/CHANGELOG.md)
- [Commits](github/codeql-action@f205ea1...d1ba80a)

---
updated-dependencies:
- dependency-name: github/codeql-action/upload-sarif
  dependency-version: 4.37.5
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
The Azure AI Anomaly Detector service has been retired by Microsoft. Every
`anomalydetector` REST endpoint now answers HTTP 410 (Gone), verified across
paths, API versions and regions.
* fix: correct LightGBM improvement tolerance semantics

## Summary
Require lower-is-better validation metrics to improve by more than improvementTolerance before resetting the early-stopping counter. Clarify the parameter documentation and add focused regression coverage for both metric directions and zero tolerance.

## Prompting Intent
Investigate GitHub issue #2565 from a new branch based on master, determine whether the report is valid, and implement a complete fix suitable for an upstream SynapseML pull request.

## Linked Sources
- GitHub issue: #2565

## Rationale
The existing higher-is-better comparison already treats improvementTolerance as a minimum delta, while lower-is-better metrics accepted small regressions. A package-internal comparison helper makes the intended symmetric behavior directly testable without adding a slow native LightGBM fixture or changing public APIs.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* fix: harden LightGBM early stopping parameters

## Summary
Expand improvement-tolerance coverage across representative LightGBM metrics and tolerance values. Preserve disabled early stopping when earlyStoppingRound is zero, validate both early-stopping parameters, and document their accepted ranges.

## Prompting Intent
The engineer requested broader parameter testing to ensure the issue #2565 fix does not introduce downstream regressions. Cover related defaults, boundaries, metric families, invalid values, and early-stopping-round interactions before updating the pull request.

## Linked Sources
- GitHub issue: #2565
- Pull request: #2578
- LightGBM 3.3.5 parameters: https://lightgbm.readthedocs.io/en/v3.3.5/Parameters.html#early-stopping-round

## Rationale
Correct tolerance semantics classify more rounds as non-improving, so the wrapper must explicitly preserve LightGBM's zero-means-disabled behavior. Shared Spark parameter validators reject values that LightGBM does not support, while deterministic matrix tests cover the decision logic without depending on platform-specific native binaries.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* ci: prevent sbt bootstrap Maven rate limits

SynapseML's Azure Pipelines fans out ~30 hosted-agent matrix jobs that each
cold-bootstrap the sbt launcher (org.scala-sbt:sbt:1.10.11, pinned in
project/build.properties) and resolve Ivy dependencies from public Maven
Central. When many fresh agents -- and several overlapping PR builds -- do this
simultaneously, Maven Central returns HTTP 429 (rate limit) and "Setup repo"
fails before any test runs (e.g. ADO build 229124511, UnitTests flaky). The
pre-existing jittered retries only widened the window against a sustained
throttle; they did not remove the thundering herd.

Durable fix (cache-first, stagger as supplement):

* templates/sbt_cache.yml (primary): Azure Cache@2 for the sbt launcher boot
  dir (~/.sbt/boot -- the artifact that 429s) and the Ivy cache (~/.ivy2/cache).
  In steady state, jobs restore these from Azure's cache service and never touch
  Maven Central. Keys derive from the bootstrap inputs (project/build.properties,
  project/plugins.sbt, build.sbt) so they invalidate exactly when those change;
  restoreKeys give a safe partial fallback and continueOnError keeps a cache
  miss/corruption non-fatal.
* BuildAndCacheSbt prewarm job: warms those caches once per run, mirroring the
  existing BuildAndCacheCondaEnv job.
* tools/ci/sbt_retry.sh: single tested helper replacing the duplicated inline
  retry blocks. Smooths only the cold-cache path with a bounded random start
  stagger (desynchronises concurrent cold bootstraps) plus bounded jittered
  exponential-backoff retries. Fails visibly on exhaustion -- no success
  fallback masking.

Wired the shared cache template into every sbt-running job (Style, Publish,
Databricks/Fabric E2E, BuildDocker, PythonTests, RTests, WebsiteSamplesTests,
UnitTests, ReleaseBranchCompat) by reviving the dormant ivy_cache placeholders,
and routed all `sbt setup` bootstraps through the helper.

Tests (python -m pytest tools/ci/tests/): deterministically exercise the
retry/backoff/stagger + visible-failure behaviour with a fake sbt, and assert
pipeline.yaml parses, the cache keys invalidate on bootstrap inputs, and every
sbt job is wired to the cache template + prewarm job.

No LightGBM, Isolation Forest, GPU, or application changes. TLS verification,
job coverage, and all tests are preserved.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* ci: serialize sbt cache prewarm before fan-out

## Summary
Make the sbt bootstrap prewarm a mandatory gate before Azure Pipeline matrix jobs start. Add Coursier caching, require exact hits on the boot, Ivy, and Coursier caches before disabling the cold-cache stagger, wire the conditional release job, and strengthen pipeline tests around the dependency graph and cache lifecycle.

## Prompting Intent
The engineer asked to fix Maven Central HTTP 429 setup failures in a new stacked PR. The solution must prevent fresh hosted agents from cold-bootstrapping sbt concurrently, allow at least the existing job fan-out after bootstrap is safe, retain bounded retry behavior for cache-service failures, and keep bootstrap failures visible rather than masking them.

## Linked Sources
- Failing Azure job: https://msdata.visualstudio.com/b9b2accc-2d1c-45b3-9d24-0eb5d78cc47f/_build/results?buildId=229124511&view=logs&jobId=e97036a1-bcdb-5cd5-905e-b0cf2c8f33cf
- Parent PR investigation: #2578 (comment)
- Stacked PR: #2581
- Prewarm concurrency review: #2581 (comment)

## Rationale
A best-effort prewarm running beside the matrix does not protect the first run for a new dependency key, so every sbt-running job now waits for one successful warm job. Cache-service errors remain non-fatal and fall back to staggered retries, but a failed warm blocks fan-out to avoid recreating the thundering herd. Coursier is cached alongside sbt boot and Ivy because modern resolution uses all three stores, and the stagger is suppressed only when every cache is an exact hit so dependency-only changes remain desynchronized.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* ci: skip Databricks E2E for non-impacting PRs

## Summary
Add conservative pull-request impact detection for the six-leg Databricks E2E matrix. Clearly non-impacting documentation, website, GitHub metadata, CI helper, and isolated test-source changes skip Databricks, while all uncertain or runtime-affecting changes continue to run it.

## Prompting Intent
The engineer asked to extend PR #2581 so expensive Databricks Azure Pipeline jobs are skipped when the pull request cannot affect notebook execution. The gate must preserve scheduled and branch coverage, avoid brittle CPU-shard mapping, and default to running whenever impact detection is incomplete or uncertain.

## Linked Sources
- Stacked CI PR: #2581
- Full green baseline build: https://msdata.visualstudio.com/b9b2accc-2d1c-45b3-9d24-0eb5d78cc47f/_build/results?buildId=229164855
- Azure multi-job output variables: https://learn.microsoft.com/en-us/azure/devops/pipelines/process/conditions?view=azure-devops#job-output-variables-used-in-other-job-conditions

## Rationale
Use one fail-open decision for the complete Databricks matrix because the five CPU partitions mix notebooks across modules and are not stable ownership boundaries. The detector skips only a narrow allowlist of clearly inert paths; runtime code, notebooks, build and pipeline files, Databricks test utilities, shared TestBase infrastructure, unknown paths, empty diffs, and fetch or classifier failures all keep E2E enabled. Non-PR builds always run to preserve scheduled and release coverage.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* ci: gate Databricks CPU and GPU tests independently (#2582)

* Gate Databricks CPU and GPU tests independently

## Summary
Classify changed paths against the actual Databricks CPU and GPU runtime surfaces, emit separate fail-open decisions, and gate each matrix leg independently.

## Prompting Intent
The engineer asked to determine exactly when Databricks tests should run, lock down the path rules, and deliver the work as a stacked pull request above PR #2581.

## Linked Sources
- Base CI hardening PR: #2581
- GitHub stacked PR documentation: https://docs.github.com/en/pull-requests/how-tos/create-pull-requests/creating-stacked-pull-requests
- ADO timing audit: build 229176406

## Rationale
CPU and GPU decisions are separated because most module changes cannot affect the expensive GPU notebooks. Unknown paths and shared build or test infrastructure remain fail-open, while explicit test-only and unrelated tooling paths skip safely. This preserves coverage while avoiding unrelated GPU capacity waits.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* ci: fix and streamline release branch compatibility (#2583)

* Fix and streamline release branch compatibility checks

## Summary
Run release compatibility checks for both GitHub target-branch formats and replace redundant compile, setup, credential, and per-package SBT tasks with one cached, project-scoped validation process.

## Prompting Intent
The engineer asked to fix the silently skipped ReleaseBranchCompat job and simplify it before enabling it so the check is both reliable and efficient.

## Linked Sources
- Base CI hardening PR: #2581
- Evidence build with skipped phase: ADO build 229176406
- Parent stack layer: ci/databricks-impact-gating

## Rationale
The target condition accepts both values observed across Azure Repos and GitHub PR providers. A single SBT process retains full test compilation and the intended core, VW, and OpenCV compatibility suites while removing repeated build loading, root-wide IntelliJ setup, unnecessary Key Vault access, and Azure CLI authentication.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* ci: use Entra authentication for ACR cleanup (#2584)

* Use Entra authentication for ACR cleanup

Make the weekly ACR cleanup schedule-only, switch it to the dedicated cleanup service connection, replace storage connection-string authentication with Azure CLI Entra authentication, and add fail-safe cleanup tests.

The engineer asked to repair the weekly cleanup failures caused by disabled key-based storage authentication, use the declared least-privileged identity, and prevent accidental CI or PR execution.

- Failed scheduled build: ADO build 228250033
- Base CI hardening PR: #2581
- Azure CLI pipeline-run reference: https://learn.microsoft.com/en-us/cli/azure/acr/pipeline-run
- Parent stack layer: ci/release-branch-compat

Using az storage blob exists with auth-mode login keeps all operations inside the AzureCLI task identity and removes runtime SDK installation, Key Vault access, and storage keys. Images are deleted only after the archive is confirmed, and subprocess argument lists avoid shell interpolation of registry-controlled names.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Remove redundant CI authentication and Conda work (#2585)

## Summary
Run non-Azure setup and coverage commands as Bash steps, install pinned Black without restoring the 8.6 GB Conda environment, and remove the ineffective standalone Conda cache consumer.

## Prompting Intent
The engineer asked for additional improvements that should ship with the requested CI fixes to make builds faster and more reliable without broad behavioral changes.

## Linked Sources
- CI efficiency audit from ADO build 229176406
- Base CI hardening PR: #2581
- Parent stack layer: ci/fix-acr-cleanup-auth

## Rationale
AzureCLI tasks create an isolated login for every invocation, so setup and coverage steps that never call az gain no authentication benefit. The Style job only needs pinned Black, not the full cached environment. The standalone Conda job was not a dependency and therefore could not prewarm consumers or prevent cold-cache fan-out.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* ci: extend Docker validation timeout

## Summary
Raise the BuildDocker job timeout from 60 to 120 minutes and add a pipeline
regression test that preserves enough time for both sequential image builds.

## Prompting Intent
The engineer asked to diagnose and fix the remaining failure on #2581 and to
continue full validation until the parent PR is ready, without hiding genuine
test failures.

## Linked Sources
- Parent PR: #2581
- Failed PR build: https://msdata.visualstudio.com/b9b2accc-2d1c-45b3-9d24-0eb5d78cc47f/_build/results?buildId=229579403
- Matching master failure: https://msdata.visualstudio.com/b9b2accc-2d1c-45b3-9d24-0eb5d78cc47f/_build/results?buildId=229578121
- Matching master failure: https://msdata.visualstudio.com/b9b2accc-2d1c-45b3-9d24-0eb5d78cc47f/_build/results?buildId=229580525
- Matching master failure: https://msdata.visualstudio.com/b9b2accc-2d1c-45b3-9d24-0eb5d78cc47f/_build/results?buildId=229576499

## Rationale
The Dockerfiles and image behavior were unchanged, but recent hosted-agent
builds required roughly 51 minutes when successful and exceeded the default
one-hour job cap in multiple master and PR runs. A 120-minute job budget keeps
both image validations mandatory while tolerating current registry and package
download latency. This is safer and more targeted than skipping an image or
doubling agent usage by splitting the builds into parallel jobs.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* ci: address PR review and protect package publishing

## Summary
Resolve the blocking PR #2581 review findings by making ACR archival digest-safe, correcting PipelineRun names and sbt cache invalidation, warming cold agents before direct sbt calls, and validating the canonical package version before publishing.

## Prompting Intent
The engineer asked to rebase PR #2581 onto current master, audit the new review feedback, fix valid actions, ensure the pipelines continue to publish package versions safely, review the complete change, and rerun Azure validation.

## Linked Sources
- Integration PR and review threads: #2581
- Stacked CI changes: #2582
- Stacked CI changes: #2583
- Stacked CI changes: #2584
- Stacked CI changes: #2585
- ACR transfer guidance: https://learn.microsoft.com/azure/container-registry/container-registry-transfer-images
- ACR image deletion behavior: https://learn.microsoft.com/azure/container-registry/container-registry-delete

## Rationale
Immutable manifest digests prevent mutable tags such as latest from reusing the wrong backup or deleting an unarchived manifest. Per-agent warming is limited to unavailable or inexact cache restores so exact hits remain fast, while the prewarm job still verifies dependency resolution. Package versions are resolved from the SBT source of truth and release publication fails before side effects when the v-tag disagrees.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* feat: Add lossless string identifier support to SAR

Refs #2275
Refs #2283

## Summary
Add deterministic, reversible user and item identifier mappings to SAR so string and wide numeric IDs are never cast into lossy caller-visible values. Persist mappings with the model, preserve identifier types in scores and recommendations, define null and unknown-ID behavior, restore typed item recommendation APIs, and add Scala and Python regression coverage.

## Prompting Intent
Recreate the intent of the stale SAR string-ID change on current master without copying its lossy casts. Keep the SparkML API coherent and backward compatible for numeric users, use TDD, validate serialization and schema behavior, expose Python wrappers, and exercise targeted compile, style, code generation, Scala, and Python/JVM checks before opening a replacement PR.

## Linked Sources
- Feature request: #2275
- Original pull request: #2283
- Current SAR implementation at the starting revision: https://github.com/microsoft/SynapseML/tree/7d9fabcc/core/src/main/scala/com/microsoft/azure/synapse/ml/recommendation
- Repository review policy: .github/skills/code-review/SKILL.md

## Rationale
Use model-owned typed mappings instead of composing RecommendationIndexer because that stage stringifies numeric identifiers, exposes index columns, and cannot recover every original type. Contiguous deterministic indices keep the existing matrix implementation viable, while persisted DataFrame parameters make decoding reversible after save/load. Inner mapping joins intentionally drop null or unseen scoring IDs, strict type validation prevents ambiguous conversions, and legacy numeric models fall back to identity mappings. The approach accepts a deterministic global sort and persisted mapping storage in exchange for lossless, reproducible SparkML behavior.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* fix: Address SAR identifier compatibility review

Refs #2275
Refs #2594

## Summary
Resolve the four independent review findings on SAR string identifier support. Preserve typed IDs in ranking train/validation splits, accept only round-trip-safe numeric scoring casts, retain established integer recommendation schemas for safely representable numeric IDs, and rank only factor IDs that have real mappings. Add focused Scala and Python regressions and remove unnecessary mapping cache and interaction-count work identified during review.

## Prompting Intent
The engineer asked to fix all medium correctness and compatibility findings on PR #2594, add a regression for each, rerun targeted Scala, code generation, formatting, and Python/JVM validation, then update the existing PR and request re-review without weakening lossless string or wide numeric behavior.

## Linked Sources
- Pull request and review context: #2594
- Feature request: #2275
- Original pull request: #2283
- Repository review policy: .github/skills/code-review/SKILL.md

## Rationale
Use Spark structs and array functions instead of Double UDF payloads so split schemas remain typed. Numeric scoring IDs are temporarily cast only when casting back reproduces the input, preventing overflow and fractional aliasing while retaining unknown-ID drop semantics. Recommendation decoding conditionally uses the historical integer schema only when every ID round-trips through Int; strings and wide or fractional numeric IDs remain lossless. Candidate indices are intersected with both factors and mappings before top-K so gaps cannot consume recommendation slots.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* fix: Make SAR numeric identifier handling ANSI-safe

Refs #2275
Refs #2594

## Summary
Use ANSI-safe try_cast expressions for numeric identifier compatibility and legacy mappings. Persist whether model-owned user and item mappings safely round-trip through IntegerType, reuse those flags when selecting recommendation output schemas, and limit destination-index collection to mapping-less legacy models. Add ANSI overflow, persisted-flag, legacy-default, and recommendation-planning regressions.

## Prompting Intent
The engineer asked to resolve the second independent review of PR #2594: prevent CAST_OVERFLOW under spark.sql.ansi.enabled=true, eliminate repeated mapped-model recommendation scans and index collection, add focused regressions, rerun Scala/codegen/Python validation, update the existing PR, trigger Azure Pipelines, and request another re-review.

## Linked Sources
- Pull request and review context: #2594
- Feature request: #2275
- Original pull request: #2283
- Repository review policy: .github/skills/code-review/SKILL.md

## Rationale
Use Spark SQL try_cast in both cast directions rather than pre-cast comparisons so out-of-range values become null and are filtered even with ANSI mode enabled. Compute compatibility once while fitting and persist it with conservative false defaults for legacy models, avoiding full mapping scans on every recommendation call. New model mappings are contiguous, so mapped models rank the score vector directly; only mapping-less legacy models collect actual candidate indices to preserve gapped-ID correctness.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Configure a deterministic repository-local Git committer identity before replaying PR commits onto the Spark 3.5 and Spark 4.1 release branches. Distinguish genuine merge conflicts from rebase infrastructure failures and preserve successful rebase diagnostics.
* ci: preserve sbt retry helper during release replay

## Summary
Stage the sbt retry helper outside the repository before switching to Spark release branches, and parameterize the shared cache template so it can invoke that stable path after rebase.

## Prompting Intent
Investigate why Spark 3.5 and Spark 4.1 compatibility checks still failed after PR #2608, reproduce the failure with PR #2595 changes, implement the complete hotfix, and validate the real release replay path.

## Linked Sources
- Failing PR: #2595
- Prior identity hotfix: #2608
- Failed Azure build: https://msdata.visualstudio.com/b9b2accc-2d1c-45b3-9d24-0eb5d78cc47f/_build/results?buildId=229969678

## Rationale
The rebased working tree intentionally comes from the Spark release branch, so master-only CI helpers cannot remain repository-relative. Copying the helper to Agent.TempDirectory preserves release-specific dependency resolution and avoids moving cache warming ahead of the rebase, where exact cache hits could hide missing release dependencies.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* ci: replay only release-relevant PR changes

## Summary
Replace commit-history rebasing with a three-way application of the synthetic PR merge tree's release-relevant patch onto each Spark release branch.

## Prompting Intent
Validate the compatibility hotfix with PR #2595's real source changes while ensuring CI-only commits do not conflict with old Spark branches that predate the current pipeline and helper files.

## Linked Sources
- Validation PR source: #2595
- Prior identity hotfix: #2608
- Failed Azure build: https://msdata.visualstudio.com/b9b2accc-2d1c-45b3-9d24-0eb5d78cc47f/_build/results?buildId=229969678

## Rationale
The compatibility job needs the effective PR content on the release tree, not unrelated CI and documentation commits. Building the patch from the synthetic merge commit preserves GitHub's merge result, handles source branches behind master, retains three-way conflict detection, and avoids requiring commit identity.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* ci: focus release compatibility on Spark 4.1 compilation

## Summary
Remove the redundant Spark 3.5 release matrix leg and replace broad Spark 4.1 runtime suites with full test compilation of the effective PR patch.

## Prompting Intent
Explain why the release compatibility jobs exist and keep fixing the failures exposed by validation PR #2610, accounting for master already targeting Spark 3.5.

## Linked Sources
- Original compatibility PR: #2550
- Streamlining PR: #2583
- Integration validation PR: #2610
- Azure validation build: https://msdata.visualstudio.com/b9b2accc-2d1c-45b3-9d24-0eb5d78cc47f/_build/results?buildId=229984834

## Rationale
Normal PR validation already compiles and tests master on Spark 3.5, so replaying onto the older spark3.5 maintenance snapshot duplicates coverage and introduces unrelated JVM drift. Spark 4.1 test compilation catches cross-version source and test API breakage, while the existing master test fan-out supplies runtime coverage without rerunning broad, memory-heavy suites on a constrained compatibility agent.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: SynapseML CI <synapseml-ci@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@ranadeepsingh

Copy link
Copy Markdown
Collaborator Author

/azp run

@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines:
Successfully started running 1 pipeline(s).

Rana Singh (ranadeepsingh) pushed a commit that referenced this pull request Aug 17, 2026
Both suppressed Copilot comments on 4a1190b were worth acting on, and
measuring them turned up something the text had missed.

test_http_package.py and test_package_exports.py: the reviewer is right that
they do not exist, on master. They are on spark4.1 and reach spark4.0 through
#2646, but master carries PythonInitMerger without either test. Stating them
unqualified in a master-resident file implied a guard that is not there, so the
text now names the full paths, says which branches have them, and calls out
that master has the merger without the tests -- a real gap rather than just a
wording fix.

FabricE2E condition: the claim was accurate for spark4.1, which does use a bare
`condition: false`, but the reviewer checked master and found the parameterised
form, which is exactly the confusion a master-resident file describing another
branch invites. The text now scopes the claim and records all three forms, since
they differ on every branch: master has and(succeeded(), eq(...)), spark4.0 has
eq(...) with no succeeded(), spark4.1 has false. The restore target is named as
master's form rather than quoted loose.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…ll (#2651)

* docs: preserve Spark 4 branch operating knowledge in the branches skill

The `spark4.0` and `spark4.1` sync PRs (#2646, #2645) each carry a branch-local
`AGENTS_spark4.*.md`. Those files are being deleted, so this moves the detail
that had not yet been transferred into `.github/skills/synapseml-branches/`,
where it is reachable from master and applies to future rebases.

Transferred into the shared reference:

- The hand-written `__init__.py` policy. `PythonInitMerger` made these files
  live code instead of inert text, so a stale one is a real bug; the per-path
  table records which are empty, removed, or kept, and why.
- Scala 2.13's `ClassCastException` on `ArraySeq`, which fails at runtime rather
  than compile time, and `toIndexedSeq` as the O(1) fix.
- The GPU suite split and re-merge: #2538 split it into three clusters of two
  workers, #2573 reverted it because that needs six GPU nodes against a pool
  sized for three, and the split's hardcoded notebook indices silently skip any
  fourth notebook. Recorded so it is not reintroduced.
- `DatabricksCPUStreamingTests` is scheduled only on live `spark4.0`; master and
  `spark4.1` define the class but do not schedule it. This is a convergence, not
  a regression the sync introduced.
- `requestedFor=GitHub` alongside `reason=pullRequest` for telling a
  trigger-driven build from a hand-queued one.

Transferred into `branch-spark4p0.md`:

- Runtime strings, and why the DBR version is not a free knob: 17.3 LTS ML ships
  Spark 4.0 and 18.0 ML ships Spark 4.1, so bumping it stops testing the branch.
- The sparklyr 1.9.3 failure, which is live on the branch today. Under dbplyr
  2.6 its `tidyselect_data_proxy.tbl_spark` drops the Spark connection, so
  failures surface as `invoke_static` on `NULL` and read like a dead session.
  Interleaving is the tell: 21 of 69 failed scattered among passes.
- The `SPARK_HOME` connect form, recorded honestly as alignment with 4.1 rather
  than a fix, because the previous form measured identically.
- The Horovod wheel gap, with the `ensure_petastorm_compatibility()` ordering
  marked explicitly unproven so it is not quoted as a cause.
- That the GPU notebook denominator moves from three to four after the sync.

Transferred into `branch-spark4p1.md`: runtime strings, the two halves of the
Petastorm layer, the `LongOffset` importers, the `np.asarray` `ValueError`, and
the exact line needed to re-enable Fabric E2E.

Two claims in the branch-local files were deliberately not carried over because
measurement contradicts them: the Petastorm shim is a pyarrow compatibility
layer with no version gating rather than a Python 3.13/cloudpickle workaround,
and NumPy is unpinned on both live branches rather than pinned on `spark4.0`.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs: drop the fabricated central Seq conversion claim

The Copilot review on #2651 is correct and the text it flagged was wrong.
�sImmutableCollection exists in no branch, and CognitiveServiceBase.getValueOpt
returns the row or default value with no Seq conversion at all.

The claim came from the branch-local AGENTS notes, which described a design that
never shipped: the helper appears only in two abandoned commits (745b342,
6cab133) that are contained in no tip. Carrying it into the skill would have
preserved the error in the place people are told to trust.

Keeps what is verifiable and useful -- the ClassCastException surfaces at runtime
rather than compile time, and toIndexedSeq preserves O(1) indexing -- and records
that there is no central conversion today, with the command to re-check.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs: scope the guard-test and Fabric-condition claims to their branches

Both suppressed Copilot comments on 4a1190b were worth acting on, and
measuring them turned up something the text had missed.

test_http_package.py and test_package_exports.py: the reviewer is right that
they do not exist, on master. They are on spark4.1 and reach spark4.0 through
#2646, but master carries PythonInitMerger without either test. Stating them
unqualified in a master-resident file implied a guard that is not there, so the
text now names the full paths, says which branches have them, and calls out
that master has the merger without the tests -- a real gap rather than just a
wording fix.

FabricE2E condition: the claim was accurate for spark4.1, which does use a bare
`condition: false`, but the reviewer checked master and found the parameterised
form, which is exactly the confusion a master-resident file describing another
branch invites. The text now scopes the claim and records all three forms, since
they differ on every branch: master has and(succeeded(), eq(...)), spark4.0 has
eq(...) with no succeeded(), spark4.1 has false. The restore target is named as
master's form rather than quoted loose.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs: fix line length and punctuation review comments

Addresses the two remaining review items on this PR.

- branch-spark4-common.md: the __init__.py table had two rows of 248 and 153
  characters, over the repo's 120-char limit. Moved the long explanations out
  of the Why cells into the prose immediately below, so the table stays a
  quick index and no line exceeds 120.
- branch-spark4p1.md:41: replaced the bare double hyphen with a sentence break.

Also fixed the check that missed these. The earlier length lint skipped lines
starting with a pipe, on the assumption that table rows were exempt, which is
exactly why these two slipped through. Re-linted every line of every file in
the skill: 0 lines now exceed 120 characters, and the only remaining double
hyphen is the git pathspec separator inside backticks in a code example.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs: record where the Java version is declared and how to resolve its sync conflict

The Java version is declared in up to five files per branch and none of that
was captured. Adds a measured table and, more importantly, the conflict rule.

Corrects a wrong claim while doing it. The old text said Spark 4's
.github/workflows/pr-validation.yml uses JDK 17. That holds for spark4.1 but
spark4.0 pins java-version: 11 there while the rest of the branch is on 17, so
the workflow is not evidence of a branch's Java version. Measured across
ms/master, ms/spark4.0 and ms/spark4.1 rather than taken from the old notes.

The part that can actually break a sync: PR #2652 adds
templates/java_setup.yml to master at versionSpec 11, and both Spark 4
branches already have that file at 17. Verified with git merge-tree that this
is an add/add conflict which leaves markers rather than silently overwriting,
so the sync stops and asks. The hazard is that the intuitive resolution --
take master, it is newer -- is the wrong one and drops the branch to Java 11,
reintroducing the 'Class java.lang.Record not found' failure #2652 exists to
fix. Documented the rule as always keep the branch's own 17, noted that the
conflict is one-time, and gave a one-line command to verify the result.

Also records that spark4.0 has no JAVA_VERSION because it is not yet in the
ReleaseBranchCompat matrix, and that spark4.1 has java_setup.yml but nothing
includes it yet, so neither absence is mistaken for a regression later.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs: close the gaps found by an independent transfer audit

Ran two independent audits, one per source file, against the whole skill
directory, to check that AGENTS_spark4.0.md and AGENTS_spark4.1.md can be
deleted without losing anything. Both flagged the same top two gaps. Verified
every claim before writing it, because the source files are already known to
contain three false ones.

Closed:

1. The CI trigger lives on the ADO definition, not in pipeline.yaml. Both
   audits ranked this first and it verified more sharply than the source put
   it. Definition 17563 reports triggers[].branchFilters = +master, +spark3.5,
   +spark4.0, +spark4.1 and settingsSourceType 2, meaning UI-defined. The proof
   that the YAML is a red herring is on the branch itself: spark4.0's own
   pipeline.yaml pr: block lists master, spark3.3 and spark3.5 and does not
   list spark4.0, yet PRs targeting spark4.0 build. Recorded with the REST call
   to re-read it, and the consequence that a future release branch gets no PR
   builds from a pipeline.yaml edit alone.

2. Root cause of the VerifyTrainClassifier fixture change: Spark 4 does not
   tolerate a NaN feature reaching logistic regression the way 3.5 did. The
   destination had kept the "value was replaced rather than the assertion
   weakened" reasoning but dropped the reason. Confirmed Double.NaN is still on
   master at VerifyTrainClassifier.scala:121 and absent on spark4.1, so a sync
   will try to restore it; that is now stated.

3. Why re-enabling Fabric E2E belongs in its own PR: the pipeline run is the
   test, and a Fabric provisioning failure should not block an unrelated merge.

4. The pyarrow rationale, with measured values rather than the audit's. The
   audit reported "bumped to 18.0.0 for cp312 wheels", which conflates the two
   branches. Measured: spark4.0 is pyarrow 22.0.0 on Python 3.12.11, spark4.1
   is 18.0.0 on Python 3.13, master is held down at 10.0.1 because Petastorm
   uses Parquet and fsspec APIs removed after PyArrow 10. Added the table and
   noted each branch reached its value by a different route, so the reasoning
   does not carry across. Also recorded spark4.0's unexplained, unvalidated
   mlflow downgrade to 1.26.1 against master's 2.21.3.

Both audits independently confirmed the destination is otherwise a superset of
the source, and that the three deliberate corrections (asImmutableCollection,
the Petastorm shim's real cause, and the pr-validation.yml Java version) read
as intended rather than as losses.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs: address review on Java/Dockerfile scope and java_setup.yml state

Scope the Dockerfile JAVA_HOME claim explicitly to the Spark 4 branches and state master's value (11) for contrast; the bullet sat under a Spark-4 heading but read as a repo-wide claim. Fixes the plural-subject grammar in the same sentence. Add tools/docker/*/Dockerfile as a sixth row to the Java declaration table (master 11, both Spark 4 branches 17).

Phrase templates/java_setup.yml on master conditionally: it does not exist there until #2652 merges, so tell readers to expect it absent and give the command to confirm on the live branch.

Reflow two paragraphs where an earlier edit left a mid-sentence fragment on its own line.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: SynapseML CI <synapseml-ci@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: ranadeepsingh <ranadeepsingh@users.noreply.github.com>
* fix: pin the JDK for InternalCompat to the branch under test

The SynapseML-Internal compatibility check never set a JDK, so it ran on the
agent default. That works for master and spark3.5 but cannot compile the Spark 4
branches, which target Java 17: build 231477746 (#2645, spark4.1) failed
publishing the OSS tree and build 231456784 (#2646, spark4.0) failed compiling
the Internal tree, both with 'Class java.lang.Record not found', a type that
arrived in Java 16.

This is structural rather than intermittent. Across recent builds of definition
17563 the job succeeds on every master-targeting PR and fails on both Spark 4
PRs, so it would be a permanent red on those branches. The job is advisory by
design, and an advisory check that is always red is one people stop reading,
which loses the signal it exists to carry.

The JDK now follows the branch under test, derived in the step that already
parses and validates System.PullRequest.TargetBranch to pick the Internal
branch, since both sides of the comparison are built from that branch's Spark
line. Java 17 also needs the java.prefs --add-opens flag for sbt, mirroring the
ReleaseBranchCompat job above, which builds the same branches with the same task
and flag on the same pool.

Only Spark 4 branches are pinned. master and spark3.5 pass on the agent default,
so pinning them would change working behaviour to fix a problem they do not
have; an empty value skips the JDK step and leaves that path unchanged.

The two variables are declared with empty job-level defaults because an
undefined ADO macro is passed to the script verbatim, and an unexpanded
COMPAT_SBT_OPTS macro would be read by bash as a command substitution rather
than an empty argument. Two later steps run under succeededOrFailed(), so they
can execute even when the step that sets the variables did not.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* fix: pin InternalCompat JDK per branch via templates/java_setup.yml

Replaces the runtime target-branch mapping from the first commit on this PR
with the pin the repository already uses.

Why the first approach was wrong
--------------------------------
It read the target branch at runtime and mapped spark4.* to JDK 17 inside
pipeline.yaml. That added a fifth place where a branch's Java version is
declared, alongside .github/workflows/pr-validation.yml, environment.yml,
templates/java_setup.yml and the ReleaseBranchCompat matrix. It also carried
a hardcoded spark4.* glob that a future spark5.0 would silently fall through,
and two job-level variables that existed only to keep an undefined ADO macro
from reaching bash as a command substitution.

What this does instead
----------------------
templates/java_setup.yml is already this repo's per-branch JDK pin: it exists
on spark4.0 and spark4.1 with versionSpec 17, and spark4.0's pipeline.yaml
already includes it. This commit adds master's copy with versionSpec 11 --
measured as master's current effective JDK, so master's behaviour does not
change -- and includes the template from InternalCompat.

The include is the same single line on every branch, so the sync never has to
reconcile pipeline.yaml for this, and the per-branch value lives in exactly
one file that already carries the right value on the branches that need it.
A future release branch is correct by construction: it gets its JDK from its
own java_setup.yml rather than from a glob in master's pipeline.

The sbt --add-opens flag is now passed unconditionally rather than through a
variable. It is only required on 17, but --add-opens has existed since Java 9
and an unknown module is a warning rather than an error, so it is inert on 11.
That removes both job-level variables and the macro-expansion hazard with them.

Verification
------------
- master's InternalCompat runs Temurin 11.0.32 today (build 231341458 echoes
  JAVA_HOME and java -version), so versionSpec 11 is a no-op there.
- templates/java_setup.yml is byte-identical to spark4.1's copy apart from the
  two version tokens.
- build.sbt declares nothing about Java on any branch, so sbt cannot make this
  choice; it runs on whatever JDK is on PATH.
- Net change is 23 insertions against master, 47 deletions against the previous
  commit; 11 of the insertions are the explanatory comment.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* fix: cover every JVM in InternalCompat with JAVA_TOOL_OPTIONS

The Copilot review on this PR was right and my previous commit was wrong.

I claimed "all four sbt invocations carry the flag". There are not four. The
review identified two more, and both checks out:

  * templates/sbt_cache.yml runs `bash tools/ci/sbt_retry.sh update`, an sbt
    invocation in a template this job includes, which no per-command flag in
    pipeline.yaml can reach.
  * the `Run Internal Scala tests` loop runs
    `if ! sbt "testOnly com.microsoft...$pkg.**"`, which my grep for lines
    starting with `sbt ` missed because of the `if ! ` prefix.

Per-command flags are the wrong shape for this regardless of how many I find,
because they also cannot reach a JVM the tests fork. Replaced them with a
single job-level JAVA_TOOL_OPTIONS, which every JVM started anywhere in the
job picks up.

This is not a new mechanism for the repo. spark4.0's pipeline.yaml already
does `export JAVA_TOOL_OPTIONS="--add-opens=java.prefs/java.util.prefs=ALL-UNNAMED"`
in two places for the same reason.

Set unconditionally rather than behind a Spark 4 condition: --add-opens has
existed since Java 9 and an unknown module is a warning rather than an error,
so it is inert on master's Java 11. That keeps a branch conditional out of the
file entirely.

Checked the one hazard this introduces. JAVA_TOOL_OPTIONS makes every JVM
print "Picked up JAVA_TOOL_OPTIONS: ..." to stderr, and this job captures sbt
output with 2>&1 and parses a version out of it. The parse greps
'^\[info\] ([0-9]+\.[0-9]+|HEAD-)', anchored to the start of the line, which
the "Picked up" line cannot match. Safe.

Also worth recording: spark4.0's Style job runs `sbt scalastyle test:scalastyle`
on Java 17 with no --add-opens and passes, so the flag is not needed for sbt
startup, only for particular tasks. That is why the failure showed up where it
did rather than immediately.

Net result against master is now 34 insertions and zero deletions, 25 of them
comment, so the functional change is 10 lines: the new template file, one
template include, and one variable.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs: correct the rationale comment for setting JAVA_TOOL_OPTIONS unconditionally

The review is right: the previous comment justified this as 'inert on master's
Java 11' on the grounds that an unknown module only warns. That reasoning
describes a case that does not apply here. java.prefs has existed since Java 9,
so on Java 11 the option is genuinely applied, not ignored.

The conclusion is unchanged -- it is still safe to set unconditionally -- but
for the correct reason: it opens a package that nothing on master's path
reflects into, which is harmless, and setting it for every target keeps a
branch conditional out of pipeline.yaml.

Comment-only change; no behavioural difference.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: SynapseML CI <synapseml-ci@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Brings in #2651 (Spark 4 branch operating knowledge under .github/skills/synapseml-branches/) and #2652 (InternalCompat now pins its JDK via templates/java_setup.yml instead of the agent default, which was compiling this branch's Scala 2.13 tree on a pre-16 JDK and failing with 'Class java.lang.Record not found').

Conflict: templates/java_setup.yml add/add. Master added it at versionSpec 11 (master's already-effective JDK); this branch already carried it at 17. Resolved by keeping this branch's 17 -- taking master's side would silently downgrade the branch and reintroduce the Record failure. This conflict is one-time; the file histories are now connected.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…ranches skill

#2651 moved this branch's operating knowledge onto master under .github/skills/synapseml-branches/, which the merge above brings here: references/branch-spark4-common.md for what both Spark 4 branches share and references/branch-spark4p0.md for this branch's specifics.

The skill is the better home: it is resolved automatically by branch, it lives on master so it no longer has to survive every sync, and its content was checked against this file by two independent audits before the move. Three claims were deliberately corrected rather than copied, because measurement contradicted them.

Verified before deleting: nothing in the tree references AGENTS_spark4.0.md, and the base AGENTS.md is untouched.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@ranadeepsingh

Copy link
Copy Markdown
Collaborator Author

/azp run microsoft.SynapseML

@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines:
Successfully started running 1 pipeline(s).

@ranadeepsingh

Copy link
Copy Markdown
Collaborator Author

Sync completeness audit — spark4.0 ← master

Posting the evidence behind "everything from master is in, and everything branch-specific survived", since a sync PR of this size can't be eyeballed.

1. Ancestry — every master commit is in

git rev-list ms/master ^HEAD --count   ->   0

Zero master commits are unreachable from this head. Structurally complete.

Ancestry alone isn't proof, though — a conflict resolution can keep ancestry while dropping master's content. So:

2. Content — master's added lines are present

Collected every line master added in the last 120 days for the files that still differ, and checked each is present in the branch. Everything came back 95–100% except two files, both investigated:

File Finding
lightgbm/.../NetworkManager.scala Real diff vs master is 1 line: duration.isFinite()duration.isFinite. Required by Scala 2.13 (no-paren method). The low score was a measurement artifact — the window counts lines master itself later rewrote.
core/src/main/python/synapse/ml/core/init_spark.py Deliberate branch adaptation, not a drop. Branch version swaps synapseml_2.122.13 and spark-avro_2.12:3.4.1spark-avro_2.13:4.0.1, plus SNAPSHOT/local-m2 resolution.

The three recent LightGBM fixes were confirmed present by ancestry:

3. Test parity

DatabricksUtilitiesSuite: 23 tests on master, 23 here — identical set, nothing dropped.

An earlier pass flagged missing stockout/gpuWorkerCount assertions; that was a false positive — master renamed those tests ("stockout" → "capacity") within the measurement window.

4. Branch-unique values preserved

The merge did not overwrite what makes this branch a Spark 4.0 branch:

master here
scalaVersion 2.12.17 2.13.16
sparkVersion 3.5.0 4.0.1
python 3.11.8 3.12.11
openjdk (unset) 17
r-sparklyr 1.8.1 1.9.5

templates/java_setup.yml conflicted add/add (master added it at 11 in #2652; this branch already had 17). Resolved keeping 17 — taking master's side would reintroduce Class java.lang.Record not found. Histories are now connected, so future syncs merge it cleanly.

5. AGENTS file removal

AGENTS_spark4.0.md (313 lines) is deleted; its content now lives in .github/skills/synapseml-branches/ (7 files) which arrived via #2651. Verified 0 dangling references to the deleted file, and base AGENTS.md untouched.

6. Note on automated review

Copilot cannot review this PR — at 73,188 changed lines it is past the 20,000-line reviewer limit, so it returns "exceeds the maximum number of lines" rather than findings. That is inherent to a sync PR and not something shrinking the diff can fix.

Worth noting for reviewers: the bulk of this diff is master's own already-reviewed code. The genuinely new work here is the merge resolution plus the doc deletion — 5 files, +275/−349 versus the previous head, which is reviewable on its own.

Currently unresolved review threads: 0. Suppressed review comments across all reviews: 0.

The shim-removal commit deleted these two files outright. master,
spark3.5 and spark4.1 all keep them as 0-byte files instead, so
spark4.0 was the only branch missing a file that master has.

This restores them as empty files (blob e69de29, byte-identical to
master and spark4.1). It does not restore the stale shim content
that was removed - the 1100-byte openai and 1401-byte vw bodies
that duplicated codegen output and redefined __all__ stay gone.

PythonInitMerger treats an absent manual __init__.py and an empty
one identically: initFiles() never visits an absent file, and an
empty one hits the manualContent.isEmpty branch which writes the
generated content back unchanged. So behaviour is unchanged, and
the export regression tests assert behaviour rather than file
presence.

The reason to prefer empty over absent:

- git diff --diff-filter=D ms/master HEAD is now empty, matching
  spark4.1. A file master has and the branch lacks otherwise shows
  up as a finding in every future sync audit.
- It removes a latent modify/delete conflict: if master ever adds
  content to either file, a deleted file conflicts on the next sync
  whereas an empty file merges cleanly.
- It makes the two Spark 4 branches consistent, which the sync
  checklist requires.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@ranadeepsingh

Copy link
Copy Markdown
Collaborator Author

Per-commit scan of master → this branch, and one fix

Following up on the concern that a file-level diff can't see a file master has and the branch simply lacks. It can't — so I ran three checks that can, and one of them found something.

Check 1 — files master has that this branch does not

git diff --name-status ms/master HEAD | grep '^D'

Found 2:

file master spark3.5 spark4.0 spark4.1 this PR (before)
cognitive/.../services/openai/__init__.py 0 B 0 B 1100 B 0 B absent
vw/.../vw/__init__.py 0 B 0 B 1401 B 0 B absent

af9052268d dropped the stale shims — correct, and the skill doc records it. But every other branch keeps these as 0-byte files; only this branch removed them entirely. #2645 has zero such files.

Behaviour is identical either way, from PythonInitMerger:

  • absent → initFiles() walks the manual tree, never visits it, generated output untouched
  • empty → manualContent.isEmptymergedContent = generatedContent, written back unchanged

So this isn't a bug. But empty is the better end state:

  • --diff-filter=D becomes empty, matching chore: sync spark4.1 with master #2645. Otherwise this shows up as a finding in every future sync audit.
  • It removes a latent modify/delete conflict — if master ever puts content in either file, a deleted file conflicts on the next sync; an empty one merges cleanly.
  • It makes the two Spark 4 branches consistent, which the sync checklist requires.

Fixed in 034ab33914: both restored as 0-byte files, blob e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 — byte-identical to master and spark4.1. The removed shim bodies stay removed. The export regression tests assert behaviour, not file presence, so they are unaffected.

Check 2 — per-commit line-level validation

For all 165 master commits in the last year: take the lines each commit added, keep only those still present in master's current content (this controls for master later rewriting its own lines, which otherwise produces false alarms), then verify each against this branch.

live master lines checked : 18,215
still missing from branch :     48   (0.26%)

All 48 are deliberate adaptations. A representative sample:

missing line why
spark-avro_2.12:3.5.0 branch uses spark-avro_2.13:4.0.1
isolation-forest_3.5.0 branch uses the Spark 4 build
horovod-0.28.1-cp311-...whl branch targets cp312
spark-3.5.0-bin-hadoop3.tgz branch downloads the Spark 4 tarball
from pyspark.serializers import PickleSerializer renamed in Spark 4
scala.jdk.CollectionConverters.seqAsJavaListConverter Scala 2.13 converter API
assert(rCode.contains("ml_stages")) branch asserts new_ml_pipeline_stage
duration.isFinite() Scala 2.13 no-paren method

Two that looked like drops and are not:

  • DatabricksUtilities.scala — the branch renamed the val to CPUNotebooksParallel; master's actual logic (sortBy(_.getAbsolutePath), zipWithIndex.filter) is fully present.
  • SAR.scala — the branch uses a typed SAR.ItemAffinity case class where master and spark4.1 use Seq[Row]. A deliberate Spark 4.0 variant; UnitTests recommendation passes here and on chore: sync spark4.1 with master #2645.

Check 3 — silent content loss

Every file differing from master, comparing blob sizes: no file is below 60% of master's size. Nothing was quietly gutted.

Result

check before after
master commits unreachable 0 0
files master has, branch lacks 2 0
live master lines missing 48 (0.26%), all explained same
files shrunk vs master 0 0

@ranadeepsingh

Copy link
Copy Markdown
Collaborator Author

/azp run microsoft.SynapseML

@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines:
Successfully started running 1 pipeline(s).

…L stack

Databricks Runtime ML 16.0+ removed Horovod, HorovodRunner, and Petastorm.
spark4.0 targets DBR 17.3.x-gpu-ml but still carried master's DBR 14.3-era deep
learning stack (pytorch_lightning 1.5.0 / torch 2.2.0) and had no Petastorm
compatibility shim, so both GPU fine-tune notebooks failed every run:

  - Quickstart - Fine-tune a Text Classifier.ipynb
  - Quickstart - Fine-tune a Vision Classifier.ipynb

spark4.1 already solved this for DBR 18.0. Backport that work so deep-learning/
is byte-identical to spark4.1, substituting cp312 wheels for spark4.1's cp313
builds of the same versions:

  - synapse/ml/dl/_petastorm_compat.py: patches pq.ParquetDataset so Petastorm
    works against the PyArrow this branch pins
  - synapse/ml/dl/_petastorm_process_entrypoint.py
  - synapse/ml/dl/_horovod.py: cloudpickles the shim so executors apply it too
  - test_petastorm_compat.py plus test_deep_vision_model.py, which moves the
    Lightning callbacks to PL 2.x signatures (on_init_start/on_epoch_end were
    removed in PL 2.0)
  - environment.yml: torch 2.9.1+cpu, torchvision 0.24.1+cpu and
    horovod 0.28.1-1 (all cp312), pytorch_lightning 2.4.0

The production DL sources were already identical to spark4.1, which runs them
green on pytorch_lightning 2.4.0, so this only adds the missing compat layer
and moves the pins to match.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@ranadeepsingh

Copy link
Copy Markdown
Collaborator Author

/azp run microsoft.SynapseML

@ranadeepsingh

Copy link
Copy Markdown
Collaborator Author

Fixed: GPU fine-tuning now actually ships on spark4.0

Databricks GPU E2E was the only genuine blocker on this PR, failing exactly 2 of 4 notebooks on every run:

  • Quickstart - Fine-tune a Text Classifier.ipynb
  • Quickstart - Fine-tune a Vision Classifier.ipynb

Root cause

Databricks removed Horovod, HorovodRunner, and Petastorm in DBR ML 16.0+. This branch targets 17.3.x-gpu-ml, so the runtime supplies neither — but it still carried master's DBR 14.3-era deep learning stack and had no Petastorm compatibility layer:

ref DBR GPU runtime pytorch_lightning torch petastorm shim GPU E2E
master 14.3.x-gpu-ml 1.5.0 2.1.2 – (DBR 14.3 ships it) n/a
spark4.0 (before) 17.3.x-gpu-ml 1.5.0 2.2.0 none 2 pass / 2 fail
spark4.1 18.0.x-gpu-ml 2.4.0 2.9.1 yes 4 pass

spark4.1 already solved this. spark4.0 was the only branch pairing a modern DBR with an old DL stack.

Fix

Backported spark4.1's DL work so deep-learning/ is now byte-identical to sync/spark4.1-with-master-2, substituting cp312 wheels for spark4.1's cp313 builds of the same versions:

  • synapse/ml/dl/_petastorm_compat.py (new) — patches pq.ParquetDataset, which modern PyArrow removed and Petastorm still calls
  • synapse/ml/dl/_petastorm_process_entrypoint.py (new)
  • synapse/ml/dl/_horovod.py — cloudpickles the shim so executors apply it too
  • test_petastorm_compat.py (new, 629 lines) and test_deep_vision_model.py — Lightning callbacks moved to PL 2.x signatures (on_init_start/on_epoch_end were removed in PL 2.0)
  • environment.ymltorch 2.9.1+cpu, torchvision 0.24.1+cpu, horovod 0.28.1-1 (all cp312, hashes verified against the PyTorch CPU index), pytorch_lightning 2.4.0

The production DL sources were already identical to spark4.1, which runs them green on PL 2.4.0 — so this adds only the missing compat layer and moves the pins to match.

Why not a partial port

Copying just the shim would have been a bug: spark4.1's accompanying test change rewrites the Lightning callbacks to PL 2.x signatures, which are wrong under spark4.0's previous pytorch_lightning==1.5.0. The pins and the code had to move together.

Verification

  • All 5 ported files confirmed byte-identical to spark4.1 (git hash-object vs git rev-parse <ref>:<path>)
  • Formatting inherited from spark4.1, whose Python Style Check / Compile & Style Check / microsoft.SynapseML (Style) are all green on these exact blobs
  • environment.yml re-parsed as valid YAML; all 5 files byte-compile cleanly
  • cp312 wheel hashes resolved from download.pytorch.org/whl/cpu; the cp312 horovod wheel is the same build the notebooks already %pip install

Note on the other two red checks

  • SynapseML-Internal Compatibility Check — advisory, not a merge gate (continueOnError: true). It fails with unresolved dependency: ...-internal_2.13 ... not found, the exact signature master's own pipeline.yaml documents as a known Internal-side flake (build 230974877 hit it on a PR touching only pipeline.yaml). The Java 17 pin from fix: pin the JDK for InternalCompat to the branch under test #2652 and the spark4.0 -> spark4.0 branch matching from ci: add advisory SynapseML-Internal compatibility check to OSS pipeline #2542 both worked correctly here.
  • Review Dependencies — first-time introduction of website/package-lock.json on this branch (spark4.0 was still on yarn.lock), so the scanner reads the whole tree as newly added. The flagged image-size advisories have first_patched_version: null upstream — no fix exists.

@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines:
Successfully started running 1 pipeline(s).

Dependency Review fails on the spark4.0 sync with two high-severity
image-size advisories:

  GHSA-5p2g-fcmc-qvqq  JXL/HEIF parsers allow DoS via infinite loop
  GHSA-w3rx-r6r6-pgpr  ICNS parser allows DoS via infinite loop

Neither is newly introduced risk. image-size@2.0.2 is already present in
master's and spark4.1's website/package-lock.json with the identical
integrity hash, and their Dependency Review runs are green. It only fires
here because the spark4.0 base branch predates the yarn -> npm migration
and has no website/package-lock.json at all, so the sync adds the whole
lockfile and every entry in it reads as a newly added dependency.

The advisories cannot be fixed by upgrading: both cover "<= 2.0.2" and
2.0.2 is the latest published release. image-size is a transitive
dependency of @docusaurus/mdx-loader, which runs only at docs build time
to measure images committed to this repository. It is not part of the
published static site and never parses user-supplied uploads, so a
malformed image could at worst hang our own build.

Applied to the shared workflow rather than only this branch so master,
spark3.5, spark4.0 and spark4.1 stay identical and the exception does not
get reverted by the next sync.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@ranadeepsingh

Copy link
Copy Markdown
Collaborator Author

/azp run microsoft.SynapseML

@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines:
Successfully started running 1 pipeline(s).

Rana Singh (ranadeepsingh) added a commit that referenced this pull request Aug 17, 2026
#2654)

Dependency Review blocks the spark4.0 sync PR (#2646) on two high-severity
image-size advisories:

  GHSA-5p2g-fcmc-qvqq  JXL/HEIF parsers allow DoS via infinite loop
  GHSA-w3rx-r6r6-pgpr  ICNS parser allows DoS via infinite loop

Neither represents newly introduced risk. image-size@2.0.2 is already in
this branch's website/package-lock.json with the same integrity hash, so
master and spark4.1 are green today only because the package predates
their diff base. spark4.0 still had website/yarn.lock, so its sync adds
the entire package-lock.json and every entry reads as newly added.

The advisories cannot be resolved by upgrading: both cover "<= 2.0.2" and
2.0.2 is the latest published release. image-size is a transitive
dependency of @docusaurus/mdx-loader, which runs only at docs build time
to measure images committed to this repository. It is not shipped in the
generated static site and never parses user-supplied uploads, so a
malformed image could at worst hang our own docs build.

Landing this on master keeps the workflow identical across master,
spark3.5, spark4.0 and spark4.1 instead of leaving a branch-only
exception that future syncs would have to preserve by hand.

Co-authored-by: SynapseML CI <synapseml-ci@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@ranadeepsingh
Rana Singh (ranadeepsingh) merged commit 3f9795c into spark4.0 Aug 17, 2026
72 of 76 checks passed
@ranadeepsingh
Rana Singh (ranadeepsingh) deleted the sync/spark4.0-with-master branch August 17, 2026 19:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

7 participants