Align record columns at three scopes (record / file / deck) with grid-array exclusions

[magnesj]

Summary

Adds record-table column alignment at three scopes and fixes related behaviour.

Three alignment scopes (Command Palette + editor right-click)

• Align Record Columns in Record (opm-flow.alignRecordColumnsRecord) — aligns only the record group under the cursor.
• Align Record Columns in File (opm-flow.alignRecordColumns) — aligns the whole current file, or the selection when there is one.
• Align Record Columns in Deck (opm-flow.alignRecordColumnsInDeck) — starts from the active document, follows the INCLUDE chain (resolving PATHS aliases) recursively, and aligns every reachable file in one WorkspaceEdit. Reports how many record lines and files were changed, and surfaces an error if the edit cannot be applied.

Grid/array exclusions (deck sweep only)

A whole-deck sweep used to reformat per-cell grid/region/solution arrays (PORO, PERMX, COORD, SATNUM, …) and large VFPPROD/VFPINJ tables, collapsing their deliberate fixed-width layout and producing tens of thousands of edits across INCLUDEd files. These keywords are now skipped by default for the deck command only (src/align-exclusions.ts).

The in Record and in File commands do not apply these defaults — when you align text you explicitly targeted, everything is aligned. The user setting opm-flow.formatting.alignColumnsExcludedKeywords is honoured by all three commands and is added to the deck defaults.

Comments ignored when aligning / adding headers

Alignment and Add Column Headers no longer treat a preceding or interspersed comment as a column heading. A descriptive comment above a table (e.g. -- These values are taken from Killough's dataset:) was previously parsed into heading positions and the data aligned to the sentence's words, breaking the layout. Columns are now positioned from the record data alone; comments are left untouched, and Add Column Headers only replaces a heading it previously generated (words equal to the column names), staying idempotent.

Implementation notes

• collectDeckIncludeFiles is a pure helper in paths.ts (takes a readLines callback, no filesystem coupling) — unit tested for nested chains, cycle protection, non-INCLUDE keywords, missing files, and PATHS alias resolution. Only INCLUDE is followed; IMPORT / RESTART / GDFILE are not.
• examples/deck-align/ ships a small self-contained deck (root → $INC alias include → nested include) for exercising the deck command end-to-end.
• README documents the three scopes, the deck-only defaults, and the comment-ignoring behaviour.
• Full test suite passes (372 tests), including new align-exclusions.test.ts and paths.test.ts additions.