Integrate the new nf-lang formatter (comment preservation, fmt directives, line wrapping)

[ewels]

Prepares the language server to consume the nf-lang formatter overhaul from nextflow-io/nextflow#7346: exposes the new nextflow.formatting.maxLineLength option, passes the open document text to the formatting visitors, adds the same refuse-to-format-on-comment-loss guard as nextflow lint, and updates the test suite for the new canonical style.

Do not merge as-is: the first commit temporarily points build.gradle at a locally-built nf-lang 26.07.0-edge via mavenLocal(). It must be amended to a released nf-lang version once PR #7346 merges and a release is cut.

Changes

maxLineLength option

• New maxLineLength field on LanguageServerConfiguration (default FormattingOptions.DEFAULT_MAX_LINE_LENGTH = 120, 0 disables wrapping), read from the nextflow.formatting.maxLineLength setting alongside the existing harshilAlignment/maheshForm wiring.
• Passed explicitly into every FormattingOptions construction (NextflowLanguageServer.formatting(), ScriptService.formattingOptions()) rather than relying on the 5-arg constructor's implicit default.
• The VS Code extension will need the corresponding setting added separately.

Source text and safety guard

• ScriptFormattingProvider and ConfigFormattingProvider now use the new 3-arg visitor constructors, passing the open buffer text so comment reattachment always sees exactly the document being formatted instead of re-reading the SourceUnit.
• Adopted the same safety check as nextflow lint -format, via a shared FormattingProvider.commentsPreserved() helper built on the public CommentReattacher.commentTexts: if formatting would remove or alter any comment, the provider shows an error and returns no edits.
• Formatting an already-canonical document now returns no edits instead of a byte-identical whole-document edit.

Code lens conversion (verified, no change needed)

convertScriptToTyped/convertProcessToTyped format freshly-built AST nodes via visitProcess/visitParams directly; CommentReattacher.apply only runs inside visit(), so reattached comment metadata never touches the mutated ASTs and reattached leading comments cannot be duplicated into the replacement text. Pinned with a format-then-convert regression test.

Tests

• Pinned the new canonical style at the LS level: K&R if/else, blank-line normalization, comment preservation (trailing, dangling, commented-out declarations), line wrapping, fmt: skip / fmt: off / fmt: on, include sorting, multi-line string re-indentation, and CRLF comment handling.
• New integration tests for the LS trigger scenarios: formatting the same cached AST repeatedly yields identical output (comment-metadata re-derivation must be idempotent), maxLineLength=0 disables wrapping, and fmt-directive regions round-trip unchanged.
• New TestUtils.openOnDisk()/deleteOnDisk() helpers: tests issuing multiple requests against the same file must have it on disk, or the deferred workspace scan evicts the in-memory-only file from the AST cache.
• ConfigFormattingTest rebuilt on the shared TestUtils harness.
• Updated hover-doc expectations for the upstream docs migration to docs.seqera.io (a side effect of the nf-lang bump, independent of the formatter).

Issue verification

The following issues are fixed by nextflow-io/nextflow#7346 and verified here with LS-level tests; GitHub does not auto-close cross-repo references, so they need manual closing once this ships: #26, #54, #75, #111, #115, #116, #127, #140, #150, #153.

Release ordering

1. Formatter overhaul: never remove comments, fmt directives, line wrapping, K&R style nextflow#7346 merges (re-validate this branch against any review changes)
2. nf-lang release is cut
3. Amend the temporary build.gradle commit here to the released version
4. Language server release (+ VS Code extension setting for maxLineLength)
5. Manually close the ten issues above

Testing

Full suite: 271 tests, all passing except the pre-existing PluginSpecCacheTest network fetch, which fails identically on main in the sandbox used for development (blocked network egress).

🤖 Generated with Claude Code

https://claude.ai/code/session_01L6xXG4ocbea6AW3f9hYsJb

---

Generated by Claude Code