@lensmcp/cluster 1.17.2 → 1.17.4

package/create-webpack-dev.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-webpack-dev.d.ts","sourceRoot":"","sources":["../../../libs/cluster/src/create-webpack-dev.ts"],"names":[],"mappings":"AAIA,OAAO,EAAsB,KAAK,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAQtF,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,qBAAqB,CAAC,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kFAAkF;IAClF,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AA2CD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAgKtF"}
+{"version":3,"file":"create-webpack-dev.d.ts","sourceRoot":"","sources":["../../../libs/cluster/src/create-webpack-dev.ts"],"names":[],"mappings":"AAIA,OAAO,EAAsB,KAAK,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAatF,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,qBAAqB,CAAC,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kFAAkF;IAClF,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AA2CD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAyKtF"}

package/create-webpack-dev.js

@@ -49,12 +49,22 @@ function createDevWebpackConfig(options) {
     // Type-checking mode (LENSMCP_TYPECHECK): default = the resident fork-ts-checker pair (async,
     // feeds the lens `error TS` service-error signal); 'off' = none (fastest, quietest — the signal
     // is traded away); 'tsgo' = zero-resident cold re-checks via @typescript/native-preview (same
-    // signal, no idle memory — see tsgo-check-plugin.ts). tsgo falls back to fork-ts-checker when
-    // the binary isn't installed in the workspace, so the flag can ship ahead of the devDep.
+    // signal, no idle memory — see tsgo-check-plugin.ts).
+    //
+    // tsgo still falls back to fork-ts-checker when no binary resolves — degrading gracefully beats
+    // failing a dev server — but that fallback is now an ANOMALY, not the expected "the flag shipped
+    // ahead of the devDep" state: @lensmcp/cluster DEPENDS on the compiler. So it also reports itself
+    // onto the lens bus. fork-ts-checker publishes to the CONSOLE only, so without this the
+    // `typecheck://` resources would sit at `producer: 'none'` with nothing naming the reason —
+    // the precise "looks healthy because nobody is watching" state this producer exists to end.
     const typecheckMode = process.env.LENSMCP_TYPECHECK;
     const tsgoBin = typecheckMode === 'tsgo' ? (0, tsgo_check_plugin_1.resolveTsgoBin)(workspaceRoot, process.env.LENSMCP_TSGO_BIN) : null;
     if (typecheckMode === 'tsgo' && !tsgoBin) {
-        console.warn(`[serve] ${options.appName}: LENSMCP_TYPECHECK=tsgo but no tsgo binary (yarn add -D @typescript/native-preview) — falling back to fork-ts-checker`);
+        // No trailing period: `summariseProducers` renders this INSIDE a sentence it terminates itself.
+        const detail = `${tsgo_check_plugin_1.TSGO_MISSING_CAUSE}. Fell back to fork-ts-checker, which reports to the console only — ` +
+            `so typecheck:// has no producer for this project until it is fixed`;
+        console.warn(`[serve] ${options.appName}: LENSMCP_TYPECHECK=tsgo but ${detail}.`);
+        (0, tsgo_check_plugin_1.reportTsgoUnavailable)({ appName: options.appName, tsConfig, workspaceRoot, detail });
     }
     const useTsgo = !!tsgoBin;
     // Build combined allowlist: orgScopes + bundlePackages + user-provided

package/executors/gateway/gateway.lib.d.ts

@@ -13,7 +13,7 @@
 export { hostMatches } from './manifest';
 export { startGateway } from './runtime/server';
 export { verifyDevJwt, stampIdentity } from './runtime/dev-auth';
-export { baseDomainOf, readLensScope } from './runtime/scope';
+export { baseDomainOf, deriveMcpHttpPort, readLensScope, type LensScope } from './runtime/scope';
 export { pickSock, discoverRoutes } from './runtime/discovery';
 export type { GatewayContext, ClusterProjectDecl, SockPool, Route, LensFrontend, ServiceCtl, GatewayRuntimeOptions, GatewayHandle, GatewayHooks, GatewayPhase, HookHandler, HookContext, } from './runtime/types';
 //# sourceMappingURL=gateway.lib.d.ts.map

package/executors/gateway/gateway.lib.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gateway.lib.d.ts","sourceRoot":"","sources":["../../../../../libs/cluster/src/executors/gateway/gateway.lib.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE/D,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,QAAQ,EACR,KAAK,EACL,YAAY,EACZ,UAAU,EACV,qBAAqB,EACrB,aAAa,EAEb,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,WAAW,GACZ,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"gateway.lib.d.ts","sourceRoot":"","sources":["../../../../../libs/cluster/src/executors/gateway/gateway.lib.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjG,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE/D,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,QAAQ,EACR,KAAK,EACL,YAAY,EACZ,UAAU,EACV,qBAAqB,EACrB,aAAa,EAEb,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,WAAW,GACZ,MAAM,iBAAiB,CAAC"}

package/executors/gateway/gateway.lib.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.discoverRoutes = exports.pickSock = exports.readLensScope = exports.baseDomainOf = exports.stampIdentity = exports.verifyDevJwt = exports.startGateway = exports.hostMatches = void 0;
+exports.discoverRoutes = exports.pickSock = exports.readLensScope = exports.deriveMcpHttpPort = exports.baseDomainOf = exports.stampIdentity = exports.verifyDevJwt = exports.startGateway = exports.hostMatches = void 0;
 /**
  * Public facade for the dev gateway runtime.
  *
@@ -22,6 +22,7 @@ Object.defineProperty(exports, "verifyDevJwt", { enumerable: true, get: function
 Object.defineProperty(exports, "stampIdentity", { enumerable: true, get: function () { return dev_auth_1.stampIdentity; } });
 var scope_1 = require("./runtime/scope");
 Object.defineProperty(exports, "baseDomainOf", { enumerable: true, get: function () { return scope_1.baseDomainOf; } });
+Object.defineProperty(exports, "deriveMcpHttpPort", { enumerable: true, get: function () { return scope_1.deriveMcpHttpPort; } });
 Object.defineProperty(exports, "readLensScope", { enumerable: true, get: function () { return scope_1.readLensScope; } });
 var discovery_1 = require("./runtime/discovery");
 Object.defineProperty(exports, "pickSock", { enumerable: true, get: function () { return discovery_1.pickSock; } });

package/executors/gateway/runtime/lens-children.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lens-children.d.ts","sourceRoot":"","sources":["../../../../../../libs/cluster/src/executors/gateway/runtime/lens-children.ts"],"names":[],"mappings":"AASA,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,kCAAkC,CAAC;AAI1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAuB,MAAM,SAAS,CAAC;AAiB1F,OAAO,EAA0B,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AA0B7E,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAalE;AAyBD;;;;;;mDAMmD;AACnD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAG1F;AAMD;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE;IAAE,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GAClF,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED;;;iFAGiF;AACjF,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAQvE;AAED,MAAM,WAAW,YAAY;IAC3B,iBAAiB,EAAE,UAAU,CAAC;IAC9B;;gFAE4E;IAC5E,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC;;6GAEyG;IACzG,sBAAsB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;IACvF;;yGAEqG;IACrG,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;IACpE;gHAC4G;IAC5G,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,cAAc,EAClB,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,qBAAqB,EAE9B,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,GACzD,YAAY,CAmbd"}
+{"version":3,"file":"lens-children.d.ts","sourceRoot":"","sources":["../../../../../../libs/cluster/src/executors/gateway/runtime/lens-children.ts"],"names":[],"mappings":"AASA,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,kCAAkC,CAAC;AAI1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAuB,MAAM,SAAS,CAAC;AAiB1F,OAAO,EAA0B,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AA0B7E,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAalE;AAyBD;;;;;;mDAMmD;AACnD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAG1F;AAMD;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE;IAAE,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GAClF,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED;;;iFAGiF;AACjF,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAQvE;AAED,MAAM,WAAW,YAAY;IAC3B,iBAAiB,EAAE,UAAU,CAAC;IAC9B;;gFAE4E;IAC5E,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC;;6GAEyG;IACzG,sBAAsB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;IACvF;;yGAEqG;IACrG,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;IACpE;gHAC4G;IAC5G,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,cAAc,EAClB,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,qBAAqB,EAE9B,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,GACzD,YAAY,CA4bd"}

package/executors/gateway/runtime/lens-children.js

@@ -399,11 +399,20 @@ deps) {
                 console.warn("[gateway] MCP server bundle not found — skipping (lens apps will still publish to the bus; an external `lensmcp mcp` can read it). Install: `npm i -D lensmcp`.");
             }
             else {
-                console.log(`[gateway] starting lens MCP server (${mcpBundle})`);
+                // The workspace's OWN port, not a shared default. This used to be a
+                // hardcoded 3000 for EVERY workspace: with two gateways (or one daemon
+                // hosting two workspaces) whichever bound first served the other's
+                // sessions too — one project's agent reading another project's events.
+                // The port is also the contract the MCP shim resolves from
+                // `.lensmcp/config.json`, so it must not be stepped up on collision:
+                // a shim pointed at 4543 cannot find a server that quietly moved to 4544.
+                const scope = (0, scope_1.readLensScope)(rt.root);
+                const mcpPort = Number(process.env['LENSMCP_PORT'] ?? scope.mcpHttpPort);
+                console.log(`[gateway] starting lens MCP server on 127.0.0.1:${mcpPort} (${mcpBundle})`);
                 spawnManagedChild('lens-mcp', process.execPath, [mcpBundle], {
                     LENSMCP_EVENT_FILE: rt.eventFile,
                     LENSMCP_TRANSPORT: process.env['LENSMCP_TRANSPORT'] ?? 'http',
-                    LENSMCP_PORT: process.env['LENSMCP_PORT'] ?? '3000',
+                    LENSMCP_PORT: String(mcpPort),
                 });
             }
         }

package/executors/gateway/runtime/scope.d.ts

@@ -3,14 +3,26 @@
  *  'tetros.ai.local'] → 'tetros.ai.local'). Falls back to the first host, then
  *  to 'lens.local' if no host is declared. */
 export declare function baseDomainOf(hosts: string[]): string;
-/** Per-workspace lens scope (key + dashboard port + mount path). Prefers the
- *  CLI-written `.lensmcp/config.json` (so the gateway agrees with `lensmcp gateway`
- *  / `lensmcp dashboard`); falls back to deriving from the workspace. */
-export declare function readLensScope(root: string): {
+export interface LensScope {
     key: string;
     dashboardPort: number;
+    /**
+     * The MCP server's HTTP port for THIS workspace.
+     *
+     * This is the ISOLATION BOUNDARY for the shared MCP server. One daemon hosts
+     * several workspaces; if their MCP children shared a port, a session in one
+     * workspace would read the other's observability data. It used to be the
+     * hardcoded `3000` for every workspace — see `lens-children.ts`.
+     */
+    mcpHttpPort: number;
     basePath: string;
-};
+}
+/** Per-workspace lens scope (key + ports + mount path). Prefers the
+ *  CLI-written `.lensmcp/config.json` (so the gateway agrees with `lensmcp gateway`
+ *  / `lensmcp dashboard` / the MCP shim); falls back to deriving from the workspace. */
+export declare function readLensScope(root: string): LensScope;
+/** The workspace's MCP HTTP port, derived from its key. In lock-step with the CLI. */
+export declare function deriveMcpHttpPort(key: string): number;
 /**
  * Per-workspace extra SOURCE-SET excludes (`.lensmcp/config.json` →
  * `sourceSet.exclude: string[]`) — top-level dir names the staleness scanner

package/executors/gateway/runtime/scope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../../../../../libs/cluster/src/executors/gateway/runtime/scope.ts"],"names":[],"mappings":"AAOA;;;8CAG8C;AAC9C,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAUpD;AAED;;yEAEyE;AACzE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAmBpG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAa9D;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQhD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ9C"}
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../../../../../libs/cluster/src/executors/gateway/runtime/scope.ts"],"names":[],"mappings":"AAOA;;;8CAG8C;AAC9C,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAUpD;AAeD,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB;;;;;;;OAOG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;wFAEwF;AACxF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CA2BrD;AAED,sFAAsF;AACtF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAa9D;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQhD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ9C"}

package/executors/gateway/runtime/scope.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.baseDomainOf = baseDomainOf;
 exports.readLensScope = readLensScope;
+exports.deriveMcpHttpPort = deriveMcpHttpPort;
 exports.readSourceSetExclude = readSourceSetExclude;
 exports.lensKeyFrom = lensKeyFrom;
 exports.lensSlug = lensSlug;
@@ -29,16 +30,30 @@ function baseDomainOf(hosts) {
     const parts = shortest.split('.');
     return parts.slice(-Math.min(parts.length, 3)).join('.');
 }
-/** Per-workspace lens scope (key + dashboard port + mount path). Prefers the
+/** Lens-infra port bases — must equal `BASE_PORTS` in the CLI's workspace-scope. */
+const BASE_PORTS = { dashboard: 4321, mcpHttp: 4500 };
+/** FNV-1a → 0..(range-1). Same derivation as the CLI's `hashToRange`. */
+function hashToRange(s, range) {
+    let h = 0x811c9dc5;
+    for (let i = 0; i < s.length; i++) {
+        h ^= s.charCodeAt(i);
+        h = Math.imul(h, 0x01000193);
+    }
+    return Math.abs(h | 0) % range;
+}
+/** Per-workspace lens scope (key + ports + mount path). Prefers the
  *  CLI-written `.lensmcp/config.json` (so the gateway agrees with `lensmcp gateway`
- *  / `lensmcp dashboard`); falls back to deriving from the workspace. */
+ *  / `lensmcp dashboard` / the MCP shim); falls back to deriving from the workspace. */
 function readLensScope(root) {
     try {
         const cfg = JSON.parse(fs.readFileSync(path.join(root, '.lensmcp', 'config.json'), 'utf8'));
         if (cfg && typeof cfg.key === 'string') {
             return {
                 key: cfg.key,
-                dashboardPort: cfg.ports?.dashboard ?? 4321,
+                dashboardPort: cfg.ports?.dashboard ?? BASE_PORTS.dashboard,
+                // Derive rather than fall back to a constant: a constant would put two
+                // config-less workspaces on ONE port, which is the cross-feed bug.
+                mcpHttpPort: cfg.ports?.mcpHttp ?? deriveMcpHttpPort(cfg.key),
                 basePath: cfg.dashboardBasePath ?? '/' + cfg.key,
             };
         }
@@ -47,7 +62,16 @@ function readLensScope(root) {
         /* no config yet — derive below */
     }
     const key = lensKeyFrom(root);
-    return { key, dashboardPort: 4321, basePath: '/' + key };
+    return {
+        key,
+        dashboardPort: BASE_PORTS.dashboard,
+        mcpHttpPort: deriveMcpHttpPort(key),
+        basePath: '/' + key,
+    };
+}
+/** The workspace's MCP HTTP port, derived from its key. In lock-step with the CLI. */
+function deriveMcpHttpPort(key) {
+    return BASE_PORTS.mcpHttp + hashToRange(key, 200);
 }
 /**
  * Per-workspace extra SOURCE-SET excludes (`.lensmcp/config.json` →

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lensmcp/cluster",
-  "version": "1.17.2",
+  "version": "1.17.4",
   "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.17.2",
-    "@lensmcp/nx-plugin": "1.17.2",
+    "@lensmcp/node-instrumentation": "1.17.4",
+    "@lensmcp/nx-plugin": "1.17.4",
+    "@typescript/native-preview": "^7.0.0-dev.20260707.2",
     "fork-ts-checker-webpack-plugin": "^9.0.0",
     "glob": "^11.0.0",
     "http-proxy": "^1.18.0",

package/tsgo-check-plugin.d.ts

@@ -21,8 +21,15 @@
  * `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 and falls back to fork-ts-checker
- * when the binary is absent.
+ * 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.
  */
 import { spawn } from 'node:child_process';
 export interface TsgoCheckPluginOptions {
@@ -31,7 +38,7 @@ export interface TsgoCheckPluginOptions {
     tsConfig: string;
     workspaceRoot: string;
     debounceMs?: number;
-    /** Binary override (LENSMCP_TSGO_BIN); default: <workspaceRoot>/node_modules/.bin/tsgo. */
+    /** Binary override (LENSMCP_TSGO_BIN); otherwise resolved by {@link resolveTsgoBin}. */
     binPath?: string;
     /** Injectable for tests. */
     spawnImpl?: typeof spawn;
@@ -44,8 +51,70 @@ export interface TsgoCheckPluginOptions {
     /** Set false to skip publishing to the lens bus (console output is unchanged). */
     publishEvents?: boolean;
 }
-/** The workspace's tsgo binary, or null when not installed (caller falls back to fork-ts-checker). */
-export declare function resolveTsgoBin(workspaceRoot: string, override?: string): string | null;
+/** The npm package that ships the tsgo compiler — a real `dependency` of `@lensmcp/cluster`. */
+export declare const TSGO_PACKAGE = "@typescript/native-preview";
+/** Seams for {@link resolveTsgoBin}, so every branch of the precedence is testable without an install. */
+export interface TsgoResolutionDeps {
+    /** Locate OUR `@typescript/native-preview`. Default: {@link resolveTsgoPackageDir}. */
+    ownPackageDir?: () => string | null;
+    /** Probe a candidate. Default: exists && is a file && is executable. */
+    isExecutable?: (candidate: string) => boolean;
+    /** Default: `process.platform`. */
+    platform?: NodeJS.Platform;
+}
+/**
+ * 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.
+ */
+export declare function resolveTsgoPackageDir(): string | null;
+/**
+ * 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.
+ */
+export declare function resolveTsgoBin(workspaceRoot: string, override?: string, deps?: TsgoResolutionDeps): string | 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.
+ */
+export declare const TSGO_MISSING_CAUSE: string;
+/**
+ * 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.
+ */
+export declare function reportTsgoUnavailable(args: {
+    appName: string;
+    tsConfig: string;
+    workspaceRoot: string;
+    /** Full sentence: {@link TSGO_MISSING_CAUSE} plus this site's consequence. */
+    detail: string;
+    /** Override the lens bus file. Injectable for tests. */
+    eventFile?: string;
+}): void;
 /**
  * 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

package/tsgo-check-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tsgo-check-plugin.d.ts","sourceRoot":"","sources":["../../../libs/cluster/src/tsgo-check-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAC;AAK9D,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2FAA2F;IAC3F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,sGAAsG;AACtG,wBAAgB,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGtF;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CA0BlG;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAyB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,QAAQ,CAAS;gBAEb,IAAI,EAAE,sBAAsB;IAMxC,KAAK,CAAC,QAAQ,EAAE,GAAG,GAAG,IAAI;IAO1B,sGAAsG;IACtG,QAAQ,IAAI,IAAI;IAOhB;;;;OAIG;IACH,OAAO,CAAC,OAAO;IAkBf,OAAO,CAAC,GAAG;CA4DZ"}
+{"version":3,"file":"tsgo-check-plugin.d.ts","sourceRoot":"","sources":["../../../libs/cluster/src/tsgo-check-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,OAAO,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAC;AAK9D,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wFAAwF;IACxF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,gGAAgG;AAChG,eAAO,MAAM,YAAY,+BAA+B,CAAC;AAEzD,0GAA0G;AAC1G,MAAM,WAAW,kBAAkB;IACjC,uFAAuF;IACvF,aAAa,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACpC,wEAAwE;IACxE,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;IAC9C,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;CAC5B;AAmCD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,IAAI,CA6BrD;AA6BD;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAC5B,aAAa,EAAE,MAAM,EACrB,QAAQ,CAAC,EAAE,MAAM,EACjB,IAAI,GAAE,kBAAuB,GAC5B,MAAM,GAAG,IAAI,CAcf;AAED;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,QAG2C,CAAC;AAE3E;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,IAAI,CAeP;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CA0BlG;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAyB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,QAAQ,CAAS;gBAEb,IAAI,EAAE,sBAAsB;IAMxC,KAAK,CAAC,QAAQ,EAAE,GAAG,GAAG,IAAI;IAO1B,sGAAsG;IACtG,QAAQ,IAAI,IAAI;IAOhB;;;;OAIG;IACH,OAAO,CAAC,OAAO;IAkBf,OAAO,CAAC,GAAG;CA8DZ"}

package/tsgo-check-plugin.js

@@ -1,7 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TsgoCheckPlugin = void 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");
 /**
@@ -27,17 +29,191 @@ const tslib_1 = require("tslib");
  * `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 and falls back to fork-ts-checker
- * when the binary is absent.
+ * 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 workspace's tsgo binary, or null when not installed (caller falls back to fork-ts-checker). */
-function resolveTsgoBin(workspaceRoot, override) {
-    const candidate = override || path.join(workspaceRoot, 'node_modules', '.bin', 'tsgo');
-    return fs.existsSync(candidate) ? candidate : null;
+/** 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
@@ -120,12 +296,14 @@ class TsgoCheckPlugin {
         if (!bin) {
             // The binary vanished after config time (e.g. a reinstall mid-serve) — warn once, go quiet.
             this.disabled = true;
-            console.warn(`[tsgo] ${this.opts.appName}: tsgo binary not found — type checking disabled for this session`);
+            // 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: `tsgo binary not found — type checking disabled` });
+            this.publish({ output: '', durationMs: 0, toolError: detail });
             return;
         }
         if (this.inflight) {