Replace scripts/compile-parallel.sh with Lage

compile-parallel.sh ran all four tsc invocations concurrently on
every `npm run compile`, but it always spawned every process even
when nothing had changed, so a no-op compile still cost close to
2 seconds.

Lage adds a content-hash cache on top of that: unchanged workspaces
now skip invoking tsc entirely, dropping a no-op compile under half
a second. It also narrows how far a change propagates. mcp-server's
tsconfig reaches into two files under client/src for type-checking,
and that cross-package dependency was previously declared globally,
so editing either file invalidated client's and server's caches too,
even though neither uses them. It is now scoped to mcp-server alone.

compile:bin only type-checks CI helper scripts, not the extension
itself, so it stays out of Lage's task graph and runs as a plain
sequential step afterward instead.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

Author: npapagna

lage.config.js

@@ -0,0 +1,27 @@
+// @ts-check
+/** @type {import("lage").ConfigFileOptions} */
+const config = {
+  pipeline: {
+    compile: {
+      outputs: ['out/**/*'],
+    },
+    // mcp-server's tsconfig type-checks two files straight out of client/src
+    // (see mcp-server/tsconfig.json's "include") - they live outside its own
+    // package root, so lage's per-package hash wouldn't otherwise notice
+    // when they change. Scoped here (not in the global environmentGlob
+    // below) so editing them only invalidates mcp-server's cache, not
+    // client's and server's too.
+    'gemstone-mcp-server#compile': {
+      outputs: ['out/**/*'],
+      environmentGlob: ['client/src/gciLibrary.ts', 'client/src/gciConstants.ts'],
+    },
+  },
+  npmClient: 'npm',
+  cacheOptions: {
+    // Changes to any of these invalidate every package's cache: the first
+    // three affect how every tsconfig resolves (shared compiler options,
+    // dependency versions).
+    environmentGlob: ['package.json', 'package-lock.json', 'tsconfig.base.json', 'lage.config.js'],
+  },
+};
+module.exports = config;

mcp-server/package.json

@@ -5,6 +5,7 @@
   "description": "MCP server for GemStone database interaction",
   "main": "out/index.js",
   "scripts": {
+    "compile": "tsc -p tsconfig.json",
     "compile:clean": "rm -rf out ../node_modules/.cache/tsc/mcp.tsbuildinfo",
     "test": "vitest run"
   },

package-lock.json

@@ -2490,8 +2490,8 @@
   ],
   "scripts": {
     "vscode:prepublish": "npm run bundle",
-    "//compile": "The four projects run concurrently (scripts/compile-parallel.sh) and are each built incrementally; tsc skips unchanged files using .tsbuildinfo caches under node_modules/.cache/tsc/, keyed by compile:clean to force a full re-check.",
-    "compile": "bash scripts/compile-parallel.sh",
+    "//compile": "lage (lage.config.js) runs client/server/mcp's tsc invocations in parallel and caches results by content hash; tsc itself also skips unchanged files using .tsbuildinfo caches under node_modules/.cache/tsc/, keyed by compile:clean to force a full re-check. compile:bin only type-checks CI helper scripts, so its excluded",
+    "compile": "lage compile --continue",
     "compile:client": "npm run compile --workspace client",
     "compile:clean": "npm run compile:clean --workspaces",
     "compile:bin": "tsc -p client/tsconfig.bin.json",
@@ -2548,6 +2548,7 @@
     "eslint-config-flat-gitignore": "^2.3.0",
     "eslint-config-prettier": "^10.1.8",
     "globals": "^16.0.0",
+    "lage": "^2.15.17",
     "lefthook": "^2.1.10",
     "ovsx": "^0.10.5",
     "playwright-bdd": "^9.2.0",

package.json

@@ -3,6 +3,7 @@
   "version": "0.1.0",
   "private": true,
   "scripts": {
+    "compile": "tsc -p tsconfig.json",
     "compile:clean": "rm -rf out ../node_modules/.cache/tsc/server.tsbuildinfo",
     "test": "vitest run"
   },