@lensmcp/cluster 1.18.4 → 1.18.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lensmcp/cluster",
-  "version": "1.18.4",
+  "version": "1.18.6",
   "description": "Run your Nx workspace as a local production cluster: pods on unix sockets with true HMR, one https gateway with per-project domains, scale-from-zero, autoscale, idle-kill, local-CA TLS — observed by the LensMCP lens.",
   "main": "./index.js",
   "types": "./index.d.ts",
@@ -65,8 +65,9 @@
     }
   },
   "dependencies": {
-    "@lensmcp/node-instrumentation": "1.18.4",
-    "@lensmcp/nx-plugin": "1.18.4",
+    "@lensmcp/core": "1.18.6",
+    "@lensmcp/node-instrumentation": "1.18.6",
+    "@lensmcp/nx-plugin": "1.18.6",
     "@typescript/native-preview": "^7.0.0-dev.20260707.2",
     "fork-ts-checker-webpack-plugin": "^9.0.0",
     "glob": "^11.0.0",

package/tsgo-check-plugin.js

@@ -1,364 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TsgoCheckPlugin = exports.TSGO_MISSING_CAUSE = exports.TSGO_PACKAGE = void 0;
-exports.resolveTsgoPackageDir = resolveTsgoPackageDir;
-exports.resolveTsgoBin = resolveTsgoBin;
-exports.reportTsgoUnavailable = reportTsgoUnavailable;
-exports.writeShimTsconfig = writeShimTsconfig;
-const tslib_1 = require("tslib");
-/**
- * TsgoCheckPlugin — dev type checking with ZERO resident memory (`LENSMCP_TYPECHECK=tsgo`).
- *
- * The default fork-ts-checker keeps an incremental tsc PROGRAM resident between saves — a
- * 2-worker pair (~80MB+) per service, ~1GB across a 13-service cluster, alive even when nobody
- * saves. tsgo (@typescript/native-preview, the native TS compiler) full-checks one of these
- * services cold in ~1-3s, so instead of holding a program we re-check COLD after each successful
- * rebuild (debounced, killing any in-flight check): idle cost is exactly zero.
- *
- * The output CONTRACT is the point: `--pretty false` prints classic `file.ts(1,2): error TS1234:`
- * lines to the executor's console, which the gateway sniffs (`error TS\d+`) into the lens
- * "service error" signal — the same wire the fork-ts-checker fed. Advisory like
- * `typeCheckOptions.async: true`: a type error never fails or blocks the webpack build.
- *
- * SHIM tsconfig: tsgo is TS7 — `moduleResolution: node10` (what node-app tsconfigs often pin) is
- * REMOVED there, so the check runs against a generated shim extending the app tsconfig with
- * `{ module: 'preserve', moduleResolution: 'bundler', isolatedModules: false }`. `extends` is an
- * ABSOLUTE path and tsconfig path-options resolve relative to the file they ORIGINATE in, so the
- * shim lives in the workspace's git-ignored `tmp/` (in-tree, so @types resolution still walks up to
- * the workspace node_modules — see writeShimTsconfig). `isolatedModules: false` because
- * `module: preserve` + `emitDecoratorMetadata` otherwise flags TS1272 on decorated signatures —
- * an emit-safety rule that doesn't apply here (this checker never emits; webpack owns emit).
- * Parity was verified per adopting workspace (0-error parity with tsc on all spot-checked apps);
- * tsgo is a PREVIEW compiler, which is why this MODE is opt-in.
- *
- * OWNERSHIP: `@lensmcp/cluster` DEPENDS on `@typescript/native-preview` — this is our feature, so we
- * ship the compiler that powers it rather than asking every consumer to remember a devDep. That was
- * the old contract, and it made the feature (and, once this plugin became the `typecheck://`
- * producer, the whole typecheck health signal) die quietly in any workspace that forgot. Resolution
- * still PREFERS a workspace's own copy (a workspace pinning a tsgo version keeps winning), and a
- * missing binary is now an ANOMALY: it degrades gracefully — never crashing the dev server — but it
- * reports itself onto the lens bus instead of only warning into a log nobody reads.
- */
-const node_child_process_1 = require("node:child_process");
-const fs = tslib_1.__importStar(require("node:fs"));
-const path = tslib_1.__importStar(require("node:path"));
-const typecheck_bus_1 = require("./typecheck-bus");
-/** The npm package that ships the tsgo compiler — a real `dependency` of `@lensmcp/cluster`. */
-exports.TSGO_PACKAGE = '@typescript/native-preview';
-/**
- * The spawnable shim names inside a `node_modules/.bin`.
- *
- * On win32 the only shims `child_process.spawn` can execute directly are `tsgo.cmd` / `tsgo.exe`;
- * the EXTENSIONLESS `tsgo` npm writes beside them is a POSIX shell script for git-bash, and
- * spawning it without a shell fails. So win32 never considers the bare name.
- */
-function shimNames(platform) {
-    return platform === 'win32' ? ['tsgo.cmd', 'tsgo.exe'] : ['tsgo'];
-}
-/**
- * Existence is not enough — a directory, a dangling symlink, or a non-`+x` file all "exist" and
- * then fail at spawn time as an opaque EACCES/ENOENT mid-serve. Probe once, here.
- * `statSync` follows symlinks on purpose (`.bin/tsgo` IS one).
- */
-function isExecutableFile(candidate, platform) {
-    try {
-        if (!fs.statSync(candidate).isFile())
-            return false;
-    }
-    catch {
-        return false; // missing, or a dangling symlink
-    }
-    // X_OK is meaningless on win32 (it reports every readable file executable), so the extension
-    // check in `shimNames` is the real gate there.
-    if (platform === 'win32')
-        return true;
-    try {
-        fs.accessSync(candidate, fs.constants.X_OK);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Where OUR copy of {@link TSGO_PACKAGE} lives, or null when it isn't installed.
- *
- * `require.resolve` walks up from THIS module, so it finds the copy installed for
- * `@lensmcp/cluster` whether the consumer's installer HOISTED it
- * (`<root>/node_modules/@typescript/native-preview`) or NESTED it
- * (`<root>/node_modules/@lensmcp/cluster/node_modules/@typescript/native-preview`, the shape you
- * get on a version conflict) or used pnpm's virtual store. A hand-written `../../node_modules/…`
- * relative guess gets exactly one of those right.
- */
-function resolveTsgoPackageDir() {
-    try {
-        // The package maps `"./package.json"` in its `exports`, which is the cheap, exact answer.
-        return path.dirname(require.resolve(`${exports.TSGO_PACKAGE}/package.json`));
-    }
-    catch {
-        /* an `exports` map without ./package.json — fall through to the entry-point walk */
-    }
-    try {
-        let dir = path.dirname(require.resolve(exports.TSGO_PACKAGE));
-        // The entry may sit a few levels below the package root (`<pkg>/lib/version.cjs`), so walk up
-        // to the manifest that actually NAMES the package rather than assuming a depth.
-        for (let i = 0; i < 6; i++) {
-            const manifest = path.join(dir, 'package.json');
-            if (fs.existsSync(manifest)) {
-                try {
-                    const { name } = JSON.parse(fs.readFileSync(manifest, 'utf8'));
-                    if (name === exports.TSGO_PACKAGE)
-                        return dir;
-                }
-                catch {
-                    /* unreadable manifest — keep walking */
-                }
-            }
-            const parent = path.dirname(dir);
-            if (parent === dir)
-                break;
-            dir = parent;
-        }
-    }
-    catch {
-        /* not installed */
-    }
-    return null;
-}
-/** `bin.tsgo` (or a string `bin`) from a package dir, as an absolute path. */
-function packageDeclaredBin(pkgDir) {
-    try {
-        const { bin } = JSON.parse(fs.readFileSync(path.join(pkgDir, 'package.json'), 'utf8'));
-        const rel = typeof bin === 'string' ? bin : bin?.['tsgo'];
-        return rel ? path.join(pkgDir, rel) : null;
-    }
-    catch {
-        return null;
-    }
-}
-/** Candidate binaries for an installed {@link TSGO_PACKAGE}, best first. */
-function ownBinCandidates(pkgDir, platform) {
-    // `<…>/node_modules/@typescript/native-preview` ⇒ `<…>/node_modules/.bin` — two levels up holds
-    // for a hoisted install, a nested one, and pnpm's store alike (a scoped package is always
-    // `<node_modules>/<scope>/<name>`).
-    const binDir = path.resolve(pkgDir, '..', '..', '.bin');
-    const shims = shimNames(platform).map((n) => path.join(binDir, n));
-    // The package's OWN `bin/tsgo` is present whenever the package is, regardless of whether the
-    // installer wrote shims — but it is a `#!/usr/bin/env node` script, so it is directly spawnable
-    // on POSIX only. On win32 the `.cmd`/`.exe` shims are the only usable entry.
-    const declared = platform === 'win32' ? null : packageDeclaredBin(pkgDir);
-    return declared ? [declared, ...shims] : shims;
-}
-/**
- * The tsgo binary to run, or null when none is usable.
- *
- * Precedence — first usable wins:
- *  1. `override` (LENSMCP_TSGO_BIN). Deliberately NOT a fallthrough: an override pointing at a
- *     missing/non-executable file is an operator mistake to SURFACE, not to paper over by silently
- *     running a different compiler than the one that was asked for.
- *  2. The consuming workspace's `node_modules/.bin/tsgo` — a workspace that pins its own tsgo
- *     version still beats the one we ship.
- *  3. OURS, via {@link resolveTsgoPackageDir}. `@lensmcp/cluster` depends on {@link TSGO_PACKAGE},
- *     so this is the branch that normally answers, and the reason the feature no longer depends on
- *     every consumer independently remembering a devDep.
- */
-function resolveTsgoBin(workspaceRoot, override, deps = {}) {
-    const platform = deps.platform ?? process.platform;
-    const isExecutable = deps.isExecutable ?? ((c) => isExecutableFile(c, platform));
-    if (override)
-        return isExecutable(override) ? override : null;
-    for (const name of shimNames(platform)) {
-        const candidate = path.join(workspaceRoot, 'node_modules', '.bin', name);
-        if (isExecutable(candidate))
-            return candidate;
-    }
-    const pkgDir = (deps.ownPackageDir ?? resolveTsgoPackageDir)();
-    if (!pkgDir)
-        return null;
-    return ownBinCandidates(pkgDir, platform).find(isExecutable) ?? null;
-}
-/**
- * Why tsgo could not run, and what to do — the CAUSE half, shared by both sites that can hit it.
- *
- * Phrased for the new ownership: `@lensmcp/cluster` DEPENDS on the compiler, so "not installed" is
- * no longer an expected opt-out state, it is a broken install (or an unsupported platform, or a bad
- * override). Callers append the CONSEQUENCE, which differs by site.
- */
-exports.TSGO_MISSING_CAUSE = `tsgo binary not found — @lensmcp/cluster depends on ${exports.TSGO_PACKAGE}, so an absent binary means an ` +
-    `incomplete install (reinstall node_modules), a platform with no ${exports.TSGO_PACKAGE} build, or a ` +
-    `LENSMCP_TSGO_BIN override pointing at a missing or non-executable file`;
-/**
- * Report — onto the LENS BUS, not just the console — that tsgo cannot run.
- *
- * A `console.warn` is invisible to anything reading `typecheck://current`, which is precisely the
- * failure this whole area exists to eliminate: a resource that looks healthy because nobody is
- * watching. Published as a `toolError` run, so the reducer records the producer as reporting with
- * `lastRunStatus: 'error'` — `status` degrades to `unknown` (never a false `clean`) and `detail`
- * names the cause and the fix.
- *
- * Strictly passive: fully swallowed, never blocks or fails the host build.
- */
-function reportTsgoUnavailable(args) {
-    try {
-        (0, typecheck_bus_1.publishTypecheckRun)({
-            workspaceRoot: args.workspaceRoot,
-            project: args.appName,
-            tool: 'tsgo',
-            tsConfig: args.tsConfig,
-            output: '',
-            durationMs: 0,
-            toolError: args.detail,
-            ...(args.eventFile ? { eventFile: args.eventFile } : {}),
-        });
-    }
-    catch {
-        /* never let instrumentation disturb a build */
-    }
-}
-/**
- * Write the shim tsconfig (absolute `extends`; see the header) and return its path. It lives under
- * the WORKSPACE's git-ignored `tmp/` — NOT os.tmpdir(): `types: ['node']` (and every other @types
- * lookup) resolves typeRoots by walking node_modules UP FROM THE CONFIG FILE's directory, so a shim
- * outside the tree fails every service with `TS2688: Cannot find type definition file for 'node'`.
- */
-function writeShimTsconfig(appName, tsConfig, workspaceRoot) {
-    const dir = path.join(workspaceRoot, 'tmp', 'lensmcp-tsgo');
-    fs.mkdirSync(dir, { recursive: true });
-    const file = path.join(dir, `${appName}.tsconfig.json`);
-    fs.writeFileSync(file, JSON.stringify({
-        extends: tsConfig,
-        // baseUrl: null UNSETS an inherited baseUrl — TS7 removed the option outright (TS5102), and
-        // a workspace that anchors its inherited `paths` with baseUrl still resolves them fine
-        // without it: TS7 anchors non-relative `paths` at the config file that DECLARES them (the
-        // workspace-root base tsconfig — the same directory baseUrl pointed at). A no-op where
-        // baseUrl was never set.
-        compilerOptions: {
-            module: 'preserve',
-            moduleResolution: 'bundler',
-            isolatedModules: false,
-            baseUrl: null,
-        },
-    }, null, 2));
-    return file;
-}
-class TsgoCheckPlugin {
-    constructor(opts) {
-        this.timer = null;
-        this.inflight = null;
-        this.shimPath = null;
-        this.disabled = false;
-        this.opts = opts;
-        this.spawnImpl = opts.spawnImpl ?? node_child_process_1.spawn;
-    }
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- webpack Compiler (untyped here like DevServerReloadPlugin)
-    apply(compiler) {
-        compiler.hooks.done.tap('TsgoCheckPlugin', (stats) => {
-            if (stats.hasErrors())
-                return; // webpack already printed build errors — don't pile on
-            this.schedule();
-        });
-    }
-    /** Debounced: rapid successive rebuilds collapse into one check; an in-flight check is superseded. */
-    schedule() {
-        if (this.disabled)
-            return;
-        if (this.timer)
-            clearTimeout(this.timer);
-        this.timer = setTimeout(() => this.run(), this.opts.debounceMs ?? 500);
-        this.timer.unref?.();
-    }
-    /**
-     * Publish one completed check onto the lens bus so `typecheck://*` reflects
-     * it. Strictly passive + fully swallowed: the console output above is the
-     * contract webpack/the gateway rely on, this is pure observation on top.
-     */
-    publish(args) {
-        if (this.opts.publishEvents === false)
-            return;
-        try {
-            (0, typecheck_bus_1.publishTypecheckRun)({
-                workspaceRoot: this.opts.workspaceRoot,
-                project: this.opts.appName,
-                tool: 'tsgo',
-                tsConfig: this.opts.tsConfig,
-                output: args.output,
-                durationMs: args.durationMs,
-                ...(args.toolError ? { toolError: args.toolError } : {}),
-                ...(this.opts.eventFile ? { eventFile: this.opts.eventFile } : {}),
-            });
-        }
-        catch {
-            /* never let instrumentation disturb a build */
-        }
-    }
-    run() {
-        const bin = resolveTsgoBin(this.opts.workspaceRoot, this.opts.binPath);
-        if (!bin) {
-            // The binary vanished after config time (e.g. a reinstall mid-serve) — warn once, go quiet.
-            this.disabled = true;
-            // No trailing period: `summariseProducers` renders this INSIDE a sentence it terminates itself.
-            const detail = `${exports.TSGO_MISSING_CAUSE}. Type checking is disabled for the rest of this session`;
-            console.warn(`[tsgo] ${this.opts.appName}: ${detail}.`);
-            // A checker that stopped checking must SAY so: without this the resource
-            // would keep serving the last (possibly clean) verdict forever, which is
-            // exactly the "looks healthy, nobody is watching" state this work exists
-            // to make impossible.
-            this.publish({ output: '', durationMs: 0, toolError: detail });
-            return;
-        }
-        if (this.inflight) {
-            this.inflight.kill('SIGTERM'); // superseded by a newer build
-            this.inflight = null;
-        }
-        if (!this.shimPath)
-            this.shimPath = writeShimTsconfig(this.opts.appName, this.opts.tsConfig, this.opts.workspaceRoot);
-        const startedAt = Date.now();
-        const child = this.spawnImpl(bin, ['--noEmit', '--pretty', 'false', '-p', this.shimPath], {
-            cwd: this.opts.workspaceRoot,
-            stdio: ['ignore', 'pipe', 'pipe'],
-        });
-        this.inflight = child;
-        let out = '';
-        child.stdout?.on('data', (d) => { out += d.toString(); });
-        child.stderr?.on('data', (d) => { out += d.toString(); });
-        child.on('error', () => {
-            if (this.inflight === child)
-                this.inflight = null;
-            console.warn(`[tsgo] ${this.opts.appName}: failed to spawn ${bin}`);
-            // A spawn failure is NOT a clean check — report it as a tool error so the
-            // resource says "the checker died", never "your types are fine".
-            this.publish({ output: '', durationMs: Date.now() - startedAt, toolError: `failed to spawn ${bin}` });
-        });
-        child.on('close', (code, signal) => {
-            if (this.inflight === child)
-                this.inflight = null;
-            if (signal)
-                return; // superseded — a newer check owns the verdict
-            const durationMs = Date.now() - startedAt;
-            const secs = (durationMs / 1000).toFixed(1);
-            if (code === 0) {
-                console.log(`[tsgo] ${this.opts.appName}: types clean (${secs}s)`);
-                this.publish({ output: '', durationMs });
-                return;
-            }
-            // Print the raw `file.ts(1,2): error TSxxxx:` lines — the gateway's `error TS\d+` sniff
-            // turns these into the lens service-error signal, exactly like fork-ts-checker output did.
-            if (out.trim())
-                process.stdout.write(out.endsWith('\n') ? out : `${out}\n`);
-            const count = (out.match(/error TS\d+/g) ?? []).length;
-            console.log(`[tsgo] ${this.opts.appName}: ${count} type error${count === 1 ? '' : 's'} (${secs}s)`);
-            // A non-zero exit with NO parseable diagnostic is the checker itself
-            // failing (bad shim tsconfig, OOM) — `publishTypecheckRun` would
-            // otherwise read "0 errors" and report CLEAN on a failed run.
-            this.publish({
-                output: out,
-                durationMs,
-                ...(count === 0 ? { toolError: `tsgo exited ${code} with no diagnostics: ${firstLine(out)}` } : {}),
-            });
-        });
-    }
-}
-exports.TsgoCheckPlugin = TsgoCheckPlugin;
-function firstLine(s) {
-    return s.trim().split('\n')[0]?.slice(0, 300) ?? '';
-}
+"use strict";var d=Object.defineProperty;var l=(s,t)=>d(s,"name",{value:t,configurable:!0});var u=Object.defineProperty,r=l((s,t)=>u(s,"name",{value:t,configurable:!0}),"r");Object.defineProperty(exports,"__esModule",{value:!0}),exports.TsgoCheckPlugin=exports.TSGO_MISSING_CAUSE=exports.TSGO_PACKAGE=void 0,exports.resolveTsgoPackageDir=resolveTsgoPackageDir,exports.resolveTsgoBin=resolveTsgoBin,exports.reportTsgoUnavailable=reportTsgoUnavailable,exports.writeShimTsconfig=writeShimTsconfig;const tslib_1=require("tslib"),node_child_process_1=require("node:child_process"),fs=tslib_1.__importStar(require("node:fs")),path=tslib_1.__importStar(require("node:path")),typecheck_bus_1=require("./typecheck-bus");exports.TSGO_PACKAGE="@typescript/native-preview";function shimNames(s){return s==="win32"?["tsgo.cmd","tsgo.exe"]:["tsgo"]}l(shimNames,"shimNames"),r(shimNames,"shimNames");function isExecutableFile(s,t){try{if(!fs.statSync(s).isFile())return!1}catch{return!1}if(t==="win32")return!0;try{return fs.accessSync(s,fs.constants.X_OK),!0}catch{return!1}}l(isExecutableFile,"isExecutableFile"),r(isExecutableFile,"isExecutableFile");function resolveTsgoPackageDir(){try{return path.dirname(require.resolve(`${exports.TSGO_PACKAGE}/package.json`))}catch{}try{let s=path.dirname(require.resolve(exports.TSGO_PACKAGE));for(let t=0;t<6;t++){const i=path.join(s,"package.json");if(fs.existsSync(i))try{const{name:e}=JSON.parse(fs.readFileSync(i,"utf8"));if(e===exports.TSGO_PACKAGE)return s}catch{}const o=path.dirname(s);if(o===s)break;s=o}}catch{}return null}l(resolveTsgoPackageDir,"resolveTsgoPackageDir"),r(resolveTsgoPackageDir,"resolveTsgoPackageDir");function packageDeclaredBin(s){try{const{bin:t}=JSON.parse(fs.readFileSync(path.join(s,"package.json"),"utf8")),i=typeof t=="string"?t:t?.tsgo;return i?path.join(s,i):null}catch{return null}}l(packageDeclaredBin,"packageDeclaredBin"),r(packageDeclaredBin,"packageDeclaredBin");function ownBinCandidates(s,t){const i=path.resolve(s,"..","..",".bin"),o=shimNames(t).map(n=>path.join(i,n)),e=t==="win32"?null:packageDeclaredBin(s);return e?[e,...o]:o}l(ownBinCandidates,"ownBinCandidates"),r(ownBinCandidates,"ownBinCandidates");function resolveTsgoBin(s,t,i={}){const o=i.platform??process.platform,e=i.isExecutable??(p=>isExecutableFile(p,o));if(t)return e(t)?t:null;for(const p of shimNames(o)){const a=path.join(s,"node_modules",".bin",p);if(e(a))return a}const n=(i.ownPackageDir??resolveTsgoPackageDir)();return n?ownBinCandidates(n,o).find(e)??null:null}l(resolveTsgoBin,"resolveTsgoBin"),r(resolveTsgoBin,"resolveTsgoBin"),exports.TSGO_MISSING_CAUSE=`tsgo binary not found \u2014 @lensmcp/cluster depends on ${exports.TSGO_PACKAGE}, so an absent binary means an incomplete install (reinstall node_modules), a platform with no ${exports.TSGO_PACKAGE} build, or a LENSMCP_TSGO_BIN override pointing at a missing or non-executable file`;function reportTsgoUnavailable(s){try{(0,typecheck_bus_1.publishTypecheckRun)({workspaceRoot:s.workspaceRoot,project:s.appName,tool:"tsgo",tsConfig:s.tsConfig,output:"",durationMs:0,toolError:s.detail,...s.eventFile?{eventFile:s.eventFile}:{}})}catch{}}l(reportTsgoUnavailable,"reportTsgoUnavailable"),r(reportTsgoUnavailable,"reportTsgoUnavailable");function writeShimTsconfig(s,t,i){const o=path.join(i,"tmp","lensmcp-tsgo");fs.mkdirSync(o,{recursive:!0});const e=path.join(o,`${s}.tsconfig.json`);return fs.writeFileSync(e,JSON.stringify({extends:t,compilerOptions:{module:"preserve",moduleResolution:"bundler",isolatedModules:!1,baseUrl:null}},null,2)),e}l(writeShimTsconfig,"writeShimTsconfig"),r(writeShimTsconfig,"writeShimTsconfig");class TsgoCheckPlugin{static{l(this,"TsgoCheckPlugin")}static{r(this,"TsgoCheckPlugin")}constructor(t){this.timer=null,this.inflight=null,this.shimPath=null,this.disabled=!1,this.opts=t,this.spawnImpl=t.spawnImpl??node_child_process_1.spawn}apply(t){t.hooks.done.tap("TsgoCheckPlugin",i=>{i.hasErrors()||this.schedule()})}schedule(){this.disabled||(this.timer&&clearTimeout(this.timer),this.timer=setTimeout(()=>this.run(),this.opts.debounceMs??500),this.timer.unref?.())}publish(t){if(this.opts.publishEvents!==!1)try{(0,typecheck_bus_1.publishTypecheckRun)({workspaceRoot:this.opts.workspaceRoot,project:this.opts.appName,tool:"tsgo",tsConfig:this.opts.tsConfig,output:t.output,durationMs:t.durationMs,...t.toolError?{toolError:t.toolError}:{},...this.opts.eventFile?{eventFile:this.opts.eventFile}:{}})}catch{}}run(){const t=resolveTsgoBin(this.opts.workspaceRoot,this.opts.binPath);if(!t){this.disabled=!0;const n=`${exports.TSGO_MISSING_CAUSE}. Type checking is disabled for the rest of this session`;console.warn(`[tsgo] ${this.opts.appName}: ${n}.`),this.publish({output:"",durationMs:0,toolError:n});return}this.inflight&&(this.inflight.kill("SIGTERM"),this.inflight=null),this.shimPath||(this.shimPath=writeShimTsconfig(this.opts.appName,this.opts.tsConfig,this.opts.workspaceRoot));const i=Date.now(),o=this.spawnImpl(t,["--noEmit","--pretty","false","-p",this.shimPath],{cwd:this.opts.workspaceRoot,stdio:["ignore","pipe","pipe"]});this.inflight=o;let e="";o.stdout?.on("data",n=>{e+=n.toString()}),o.stderr?.on("data",n=>{e+=n.toString()}),o.on("error",()=>{this.inflight===o&&(this.inflight=null),console.warn(`[tsgo] ${this.opts.appName}: failed to spawn ${t}`),this.publish({output:"",durationMs:Date.now()-i,toolError:`failed to spawn ${t}`})}),o.on("close",(n,p)=>{if(this.inflight===o&&(this.inflight=null),p)return;const a=Date.now()-i,h=(a/1e3).toFixed(1);if(n===0){console.log(`[tsgo] ${this.opts.appName}: types clean (${h}s)`),this.publish({output:"",durationMs:a});return}e.trim()&&process.stdout.write(e.endsWith(`
+`)?e:`${e}
+`);const c=(e.match(/error TS\d+/g)??[]).length;console.log(`[tsgo] ${this.opts.appName}: ${c} type error${c===1?"":"s"} (${h}s)`),this.publish({output:e,durationMs:a,...c===0?{toolError:`tsgo exited ${n} with no diagnostics: ${firstLine(e)}`}:{}})})}}exports.TsgoCheckPlugin=TsgoCheckPlugin;function firstLine(s){return s.trim().split(`
+`)[0]?.slice(0,300)??""}l(firstLine,"firstLine"),r(firstLine,"firstLine");

package/typecheck-bus.js

@@ -1,256 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MAX_DIAGNOSTICS_PER_RUN = void 0;
-exports.stripAnsi = stripAnsi;
-exports.parseTscDiagnosticLine = parseTscDiagnosticLine;
-exports.parseTscOutput = parseTscOutput;
-exports.buildTypecheckRunEvents = buildTypecheckRunEvents;
-exports.resolveEventFile = resolveEventFile;
-exports.appendTypecheckEvents = appendTypecheckEvents;
-exports.publishTypecheckRun = publishTypecheckRun;
-const tslib_1 = require("tslib");
-/**
- * The tsgo checker's bus writer — turns a completed type check into the
- * `typescript`/`typecheck` events `installTypecheckReducer` materialises into
- * `typecheck://*`.
- *
- * ── The failure this fixes ──────────────────────────────────────────────────
- * `typecheck://current` answered `{"status":"unknown","errorCount":0,
- * "revision":0}` on a workspace whose dev cluster was type-checking on every
- * single rebuild. `revision: 0` means no event had EVER arrived: the reducer
- * had no producer at all. The checks were running — `[tsgo] engine: types
- * clean (2.6s)`, and on failure real diagnostics like
- * `…/hazard-analyst.agent.ts(52,12): error TS2416: …` — but that output went
- * to the executor's stdout and nowhere else.
- *
- * The gateway's console sniff (`runtime/lifecycle.ts`, `/error TS\d+/`) does
- * see those lines, but it emits `source:'gateway' / category:'cluster'` with
- * the whole line stuffed verbatim into `raw.line` — no file, no position, no
- * code, no per-project status, throttled to one line per 5s, and filtered out
- * by all three check reducers. It is a crash-banner, not a typecheck feed.
- *
- * So the checker publishes directly. `TsgoCheckPlugin` runs INSIDE the nx
- * serve executor process, which the gateway already spawns with
- * `LENSMCP_EVENT_FILE` and `LENSMCP_PROJECT` in its env
- * (`executors/gateway/runtime/lifecycle.ts`) — the same JSONL rendezvous the
- * MCP server tails at 50 ms. No new transport, no new wiring.
- *
- * ── Why this file MIRRORS `@lensmcp/session` ────────────────────────────────
- * The canonical parser + event builder is
- * `libs/session/src/lib/collectors/typecheck-events.ts`. `@lensmcp/cluster` is
- * PUBLISHED and `@lensmcp/session` is private/bundled-into-the-CLI, so cluster
- * cannot depend on it. This is the same deliberate mirror
- * `libs/bridge/src/lib/env-sink.ts` makes of node-instrumentation's emit
- * contract. Drift is pinned by `TSC_PARITY_FIXTURE`, asserted byte-for-byte in
- * BOTH projects' specs — change one parser without the other and a test fails.
- *
- * Strictly passive: every write is best-effort inside try/catch, the host
- * build is never blocked, delayed, or failed by it.
- */
-const fs = tslib_1.__importStar(require("node:fs"));
-const path = tslib_1.__importStar(require("node:path"));
-const busHygiene = (() => {
-    try {
-        // eslint-disable-next-line @typescript-eslint/no-require-imports
-        return require('@lensmcp/node-instrumentation');
-    }
-    catch {
-        return undefined;
-    }
-})();
-/** MIRROR of session's regex — `path(line,col): error TS1234: message`. */
-const DIAG_LINE_REGEX = /^(.+?)\((\d+),(\d+)\):\s+(error|warning)\s+(TS\d+):\s+(.+)$/;
-// CSI/ANSI escape, built from String.fromCharCode so the literal control char
-// never appears in source (no-control-regex).
-const ANSI_CSI = new RegExp(`${String.fromCharCode(27)}\\[[0-9;]*[A-Za-z]`, 'g');
-function stripAnsi(s) {
-    return s.replace(ANSI_CSI, '');
-}
-/** MIRROR of session's `parseTscDiagnosticLine`. */
-function parseTscDiagnosticLine(raw) {
-    const line = stripAnsi(raw).trim();
-    if (!line)
-        return null;
-    const m = DIAG_LINE_REGEX.exec(line);
-    if (!m)
-        return null;
-    const [, file, lineStr, colStr, severity, code, message] = m;
-    if (!file || !lineStr || !colStr || !severity || !code || !message)
-        return null;
-    return {
-        file,
-        line: Number(lineStr),
-        column: Number(colStr),
-        severity: severity === 'warning' ? 'warning' : 'error',
-        code,
-        message,
-    };
-}
-/** MIRROR of session's `parseTscOutput`. */
-function parseTscOutput(output) {
-    const out = [];
-    for (const line of output.split('\n')) {
-        const d = parseTscDiagnosticLine(line);
-        if (d)
-            out.push(d);
-    }
-    return out;
-}
-/** MIRROR of session's cap — a broken tsconfig can cascade into thousands. */
-exports.MAX_DIAGNOSTICS_PER_RUN = 200;
-let idCounter = 0;
-function makeId() {
-    idCounter = (idCounter + 1) % 0xffff;
-    return `${Date.now().toString(36)}${idCounter.toString(36)}${Math.random().toString(36).slice(2, 8)}`;
-}
-/**
- * Build the ordered event list for one completed check.
- * MIRROR of session's `buildTypecheckRunEvents` — see it for the protocol
- * (START carries the legacy `tsc clear` prefix an older reducer resets on;
- * END deliberately does not, or it would wipe what was just published).
- */
-function buildTypecheckRunEvents(args) {
-    const at = (args.now ?? Date.now)();
-    const id = args.idImpl ?? makeId;
-    const sessionId = 'pending'; // stamped by the ingesting session, as every file-bus producer does
-    const base = {
-        sessionId,
-        source: 'typescript',
-        category: 'typecheck',
-        context: { sessionId, projectName: args.project },
-    };
-    const rawBase = {
-        project: args.project,
-        tool: args.tool,
-        ...(args.tsConfig ? { tsConfig: args.tsConfig } : {}),
-    };
-    const errors = args.diagnostics.filter((d) => d.severity === 'error');
-    const forwarded = args.diagnostics.slice(0, exports.MAX_DIAGNOSTICS_PER_RUN);
-    const events = [];
-    // A run that produced NO verdict emits NO clear: wiping the previous state
-    // and replacing it with zero diagnostics would read as a clean check.
-    if (!args.toolError) {
-        events.push({
-            ...base,
-            id: id(),
-            timestamp: at,
-            severity: 'info',
-            title: `tsc clear: ${args.project}`,
-            message: `typecheck run starting for ${args.project}`,
-            fingerprint: `tsc:${args.project}:run-start`,
-            raw: { ...rawBase, kind: 'typecheck-run', phase: 'start' },
-        });
-        for (const d of forwarded) {
-            events.push({
-                ...base,
-                id: id(),
-                timestamp: at,
-                severity: d.severity,
-                title: `${d.code}: ${d.message}`,
-                message: d.message,
-                location: { file: d.file, line: d.line, column: d.column },
-                // MIRROR of session's `diagnosticFingerprint` — position included so N
-                // hits of one code in one file stay N, not 1.
-                fingerprint: `tsc:${args.project}:${d.file}:${d.line}:${d.column}:${d.code}`,
-                raw: { ...rawBase, kind: 'typecheck-diagnostic', code: d.code },
-            });
-        }
-    }
-    const status = args.toolError ? 'error' : errors.length > 0 ? 'failing' : 'clean';
-    events.push({
-        ...base,
-        id: id(),
-        timestamp: at,
-        severity: 'info',
-        title: `typecheck run: ${args.project} — ${args.toolError ? 'tool error' : `${errors.length} error${errors.length === 1 ? '' : 's'}`} (${args.durationMs}ms)`,
-        ...(args.toolError ? { message: args.toolError } : {}),
-        fingerprint: `tsc:${args.project}:run-end`,
-        raw: {
-            ...rawBase,
-            kind: 'typecheck-run',
-            phase: 'end',
-            status,
-            durationMs: args.durationMs,
-            errorCount: errors.length,
-            warningCount: args.diagnostics.length - errors.length,
-            ...(args.diagnostics.length > forwarded.length
-                ? { truncatedDiagnostics: args.diagnostics.length - forwarded.length }
-                : {}),
-            ...(args.toolError ? { error: args.toolError } : {}),
-        },
-    });
-    return events;
-}
-/**
- * Where the bus lives for this process. Same resolution order the serve
- * executor uses for the pod env, so the checker and the pods it type-checks
- * always land on ONE file.
- */
-function resolveEventFile(workspaceRoot) {
-    return process.env['LENSMCP_EVENT_FILE'] || path.join(workspaceRoot, '.lensmcp', 'events.jsonl');
-}
-/**
- * Last directory we successfully created, so the common case costs no syscall.
- *
- * Deliberately NOT a boolean: a `dirReady` flag latches TRUE for the life of
- * the process, so if `.lensmcp/` is later removed (a clean, a `rm -rf tmp`, a
- * different bus path) every subsequent append fails ENOENT and the producer
- * goes silent FOREVER — reporting nothing, which is the precise failure mode
- * this whole file exists to make impossible. Keyed by path + re-ensured on
- * ENOENT instead.
- */
-let ensuredDir = null;
-function ensureDir(eventFile) {
-    const dir = path.dirname(eventFile);
-    if (ensuredDir === dir)
-        return;
-    fs.mkdirSync(dir, { recursive: true });
-    ensuredDir = dir;
-}
-/**
- * Append events as NDJSON, honouring the shared rotation contract
- * (`maybeRotateEventFile` is exported from node-instrumentation precisely so
- * every OTHER writer to the bus enforces the same caps — the gateway once was
- * the one writer without it, and the bus outgrew every consumer).
- *
- * Never throws: a lens that cannot write must not break a build.
- */
-function appendTypecheckEvents(eventFile, events) {
-    if (events.length === 0)
-        return;
-    const payload = events.map((e) => JSON.stringify(e)).join('\n') + '\n';
-    try {
-        ensureDir(eventFile);
-        busHygiene?.maybeRotateEventFile(eventFile, payload.length);
-        fs.appendFileSync(eventFile, payload);
-    }
-    catch (err) {
-        // The directory vanished under us (clean / rotate race). Re-create it once
-        // and retry — self-healing beats going permanently quiet.
-        if (err?.code === 'ENOENT') {
-            try {
-                ensuredDir = null;
-                ensureDir(eventFile);
-                fs.appendFileSync(eventFile, payload);
-            }
-            catch {
-                /* lens offline — never break the host build */
-            }
-            return;
-        }
-        /* lens offline — never break the host build */
-    }
-}
-/** Parse a raw tsgo/tsc run and publish it. Returns the events written (for tests). */
-function publishTypecheckRun(args) {
-    const events = buildTypecheckRunEvents({
-        project: args.project,
-        tool: args.tool,
-        ...(args.tsConfig ? { tsConfig: args.tsConfig } : {}),
-        diagnostics: args.toolError ? [] : parseTscOutput(args.output),
-        durationMs: args.durationMs,
-        ...(args.toolError ? { toolError: args.toolError } : {}),
-    });
-    appendTypecheckEvents(args.eventFile ?? resolveEventFile(args.workspaceRoot), events);
-    return events;
-}
+"use strict";var g=Object.defineProperty;var s=(t,e)=>g(t,"name",{value:e,configurable:!0});var f=Object.defineProperty,i=s((t,e)=>f(t,"name",{value:e,configurable:!0}),"i");Object.defineProperty(exports,"__esModule",{value:!0}),exports.MAX_DIAGNOSTICS_PER_RUN=void 0,exports.stripAnsi=stripAnsi,exports.parseTscDiagnosticLine=parseTscDiagnosticLine,exports.parseTscOutput=parseTscOutput,exports.buildTypecheckRunEvents=buildTypecheckRunEvents,exports.resolveEventFile=resolveEventFile,exports.appendTypecheckEvents=appendTypecheckEvents,exports.publishTypecheckRun=publishTypecheckRun;const tslib_1=require("tslib"),fs=tslib_1.__importStar(require("node:fs")),path=tslib_1.__importStar(require("node:path")),busHygiene=(()=>{try{return require("@lensmcp/node-instrumentation")}catch{return}})(),DIAG_LINE_REGEX=/^(.+?)\((\d+),(\d+)\):\s+(error|warning)\s+(TS\d+):\s+(.+)$/,ANSI_CSI=new RegExp("\x1B\\[[0-9;]*[A-Za-z]","g");function stripAnsi(t){return t.replace(ANSI_CSI,"")}s(stripAnsi,"stripAnsi"),i(stripAnsi,"stripAnsi");function parseTscDiagnosticLine(t){const e=stripAnsi(t).trim();if(!e)return null;const n=DIAG_LINE_REGEX.exec(e);if(!n)return null;const[,o,l,u,c,a,p]=n;return!o||!l||!u||!c||!a||!p?null:{file:o,line:Number(l),column:Number(u),severity:c==="warning"?"warning":"error",code:a,message:p}}s(parseTscDiagnosticLine,"parseTscDiagnosticLine"),i(parseTscDiagnosticLine,"parseTscDiagnosticLine");function parseTscOutput(t){const e=[];for(const n of t.split(`
+`)){const o=parseTscDiagnosticLine(n);o&&e.push(o)}return e}s(parseTscOutput,"parseTscOutput"),i(parseTscOutput,"parseTscOutput"),exports.MAX_DIAGNOSTICS_PER_RUN=200;let idCounter=0;function makeId(){return idCounter=(idCounter+1)%65535,`${Date.now().toString(36)}${idCounter.toString(36)}${Math.random().toString(36).slice(2,8)}`}s(makeId,"makeId"),i(makeId,"makeId");function buildTypecheckRunEvents(t){const e=(t.now??Date.now)(),n=t.idImpl??makeId,o="pending",l={sessionId:o,source:"typescript",category:"typecheck",context:{sessionId:o,projectName:t.project}},u={project:t.project,tool:t.tool,...t.tsConfig?{tsConfig:t.tsConfig}:{}},c=t.diagnostics.filter(r=>r.severity==="error"),a=t.diagnostics.slice(0,exports.MAX_DIAGNOSTICS_PER_RUN),p=[];if(!t.toolError){p.push({...l,id:n(),timestamp:e,severity:"info",title:`tsc clear: ${t.project}`,message:`typecheck run starting for ${t.project}`,fingerprint:`tsc:${t.project}:run-start`,raw:{...u,kind:"typecheck-run",phase:"start"}});for(const r of a)p.push({...l,id:n(),timestamp:e,severity:r.severity,title:`${r.code}: ${r.message}`,message:r.message,location:{file:r.file,line:r.line,column:r.column},fingerprint:`tsc:${t.project}:${r.file}:${r.line}:${r.column}:${r.code}`,raw:{...u,kind:"typecheck-diagnostic",code:r.code}})}const d=t.toolError?"error":c.length>0?"failing":"clean";return p.push({...l,id:n(),timestamp:e,severity:"info",title:`typecheck run: ${t.project} \u2014 ${t.toolError?"tool error":`${c.length} error${c.length===1?"":"s"}`} (${t.durationMs}ms)`,...t.toolError?{message:t.toolError}:{},fingerprint:`tsc:${t.project}:run-end`,raw:{...u,kind:"typecheck-run",phase:"end",status:d,durationMs:t.durationMs,errorCount:c.length,warningCount:t.diagnostics.length-c.length,...t.diagnostics.length>a.length?{truncatedDiagnostics:t.diagnostics.length-a.length}:{},...t.toolError?{error:t.toolError}:{}}}),p}s(buildTypecheckRunEvents,"buildTypecheckRunEvents"),i(buildTypecheckRunEvents,"buildTypecheckRunEvents");function resolveEventFile(t){return process.env.LENSMCP_EVENT_FILE||path.join(t,".lensmcp","events.jsonl")}s(resolveEventFile,"resolveEventFile"),i(resolveEventFile,"resolveEventFile");let ensuredDir=null;function ensureDir(t){const e=path.dirname(t);ensuredDir!==e&&(fs.mkdirSync(e,{recursive:!0}),ensuredDir=e)}s(ensureDir,"ensureDir"),i(ensureDir,"ensureDir");function appendTypecheckEvents(t,e){if(e.length===0)return;const n=e.map(o=>JSON.stringify(o)).join(`
+`)+`
+`;try{ensureDir(t),busHygiene?.maybeRotateEventFile(t,n.length),fs.appendFileSync(t,n)}catch(o){if(o?.code==="ENOENT"){try{ensuredDir=null,ensureDir(t),fs.appendFileSync(t,n)}catch{}return}}}s(appendTypecheckEvents,"appendTypecheckEvents"),i(appendTypecheckEvents,"appendTypecheckEvents");function publishTypecheckRun(t){const e=buildTypecheckRunEvents({project:t.project,tool:t.tool,...t.tsConfig?{tsConfig:t.tsConfig}:{},diagnostics:t.toolError?[]:parseTscOutput(t.output),durationMs:t.durationMs,...t.toolError?{toolError:t.toolError}:{}});return appendTypecheckEvents(t.eventFile??resolveEventFile(t.workspaceRoot),e),e}s(publishTypecheckRun,"publishTypecheckRun"),i(publishTypecheckRun,"publishTypecheckRun");