@harness-fe/webpack 4.0.0-next.0 → 4.0.0-next.11

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 MorphixAI
+Copyright (c) 2026 MorphixAI
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -39,7 +39,12 @@ The plugin auto-disables in production builds — zero overhead in your shipped
 
 ## Options
 
-Same as [`@harness-fe/vite`](https://www.npmjs.com/package/@harness-fe/vite). All bundler-specific plugins share the same option surface via the underlying `unplugin`.
+Same as [`@harness-fe/vite`](https://www.npmjs.com/package/@harness-fe/vite) — including `projectId` / `mcpUrl` / `token` for [team mode](https://github.com/Morphicai/harness-fe/blob/main/docs/gateway-team-mode.md). All bundler plugins share the option surface via the underlying `unplugin`.
+
+```js
+// team mode: report as a distinct project into a shared daemon
+harnessFE({ projectId: 'my-app' })
+```
 
 ## Docs
 

package/dist/plugin.d.ts

@@ -27,6 +27,7 @@ export declare class HarnessFEWebpackPlugin {
     private projectRoot;
     private projectId;
     private readonly mcpUrl;
+    private readonly baseMcpUrl;
     private readonly token;
     private mcpClient?;
     private logCleanup?;
@@ -35,6 +36,7 @@ export declare class HarnessFEWebpackPlugin {
     apply(compiler: any): void;
     private installRuntimeEntry;
     private installMcpHooks;
+    private ensureSharedGateway;
     private installComponentMapAggregator;
     private installHtmlInjection;
     private installErrorForwarding;

package/dist/plugin.js

@@ -23,7 +23,7 @@
 import { createRequire } from 'node:module';
 import { fileURLToPath } from 'node:url';
 import { dirname, resolve as resolvePath } from 'node:path';
-import { createMcpClient, createBuildIdentity, installNodeLogCapture, appendTokenQuery, } from '@harness-fe/unplugin';
+import { createMcpClient, createBuildIdentity, installNodeLogCapture, appendTokenQuery, resolveSoloTarget, } from '@harness-fe/unplugin';
 import { DEFAULT_WS_PORT } from '@harness-fe/protocol';
 import { getOrCreateComponentMap } from './shared-state.js';
 const require = createRequire(import.meta.url);
@@ -41,6 +41,7 @@ export class HarnessFEWebpackPlugin {
     projectRoot = process.cwd();
     projectId;
     mcpUrl;
+    baseMcpUrl;
     token;
     mcpClient;
     logCleanup;
@@ -54,6 +55,7 @@ export class HarnessFEWebpackPlugin {
         const baseUrl = options.mcpUrl ??
             process.env.HARNESS_FE_URL ??
             `ws://127.0.0.1:${DEFAULT_WS_PORT}`;
+        this.baseMcpUrl = baseUrl;
         this.token = options.token ?? process.env.HARNESS_FE_TOKEN;
         this.mcpUrl = appendTokenQuery(baseUrl, this.token);
         this.identity = createBuildIdentity({
@@ -144,8 +146,18 @@ export class HarnessFEWebpackPlugin {
         compiler.hooks.afterEnvironment.tap('harness-fe', () => {
             const client = createMcpClient(ctx);
             this.mcpClient = client;
-            client.connect();
             this.logCleanup = installNodeLogCapture((name, payload) => client.emitEvent(name, payload));
+            // Solo (loopback + no token): ensure a shared local gateway is up, then
+            // connect. afterEnvironment is sync, so fire-and-forget and connect once
+            // the gateway answers (best-effort — if @harness-fe/cli isn't installed
+            // we just connect and let the client retry). Team never auto-spawns.
+            const solo = resolveSoloTarget(this.baseMcpUrl, Boolean(this.token));
+            if (solo) {
+                void this.ensureSharedGateway(solo).finally(() => client.connect());
+            }
+            else {
+                client.connect();
+            }
         });
         compiler.hooks.shutdown?.tap('harness-fe', () => {
             this.logCleanup?.();
@@ -154,6 +166,15 @@ export class HarnessFEWebpackPlugin {
             this.mcpClient = undefined;
         });
     }
+    async ensureSharedGateway(target) {
+        try {
+            const { ensureSharedGateway } = await import('@harness-fe/cli/sharedGateway');
+            await ensureSharedGateway({ host: target.host, port: target.port });
+        }
+        catch {
+            /* @harness-fe/cli not installed, or gateway slow — client.connect() retries */
+        }
+    }
     installComponentMapAggregator(compiler) {
         const pluginId = this.pluginId;
         compiler.hooks.compilation.tap('harness-fe', (compilation) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harness-fe/webpack",
-  "version": "4.0.0-next.0",
+  "version": "4.0.0-next.11",
   "description": "Native webpack plugin for Harness-FE: source-aware transforms, runtime injection, and MCP bridge. thread-loader compatible.",
   "type": "module",
   "license": "MIT",
@@ -32,8 +32,11 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@harness-fe/protocol": "4.0.0-next.0",
-    "@harness-fe/unplugin": "4.0.0-next.0"
+    "@harness-fe/protocol": "4.0.0-next.8",
+    "@harness-fe/unplugin": "4.0.0-next.11"
+  },
+  "optionalDependencies": {
+    "@harness-fe/cli": "4.0.0-next.11"
   },
   "peerDependencies": {
     "webpack": "^5.0.0"
@@ -41,7 +44,7 @@
   "devDependencies": {
     "typescript": "^5.6.0",
     "vitest": "^2.1.9",
-    "webpack": "^5.107.0"
+    "webpack": "^5.107.2"
   },
   "publishConfig": {
     "access": "public"

package/src/plugin.ts

@@ -29,6 +29,7 @@ import {
     createBuildIdentity,
     installNodeLogCapture,
     appendTokenQuery,
+    resolveSoloTarget,
     type ComponentLocation,
     type HarnessFEOptions,
     type McpClient,
@@ -59,6 +60,7 @@ export class HarnessFEWebpackPlugin {
     private projectRoot: string = process.cwd();
     private projectId: string;
     private readonly mcpUrl: string;
+    private readonly baseMcpUrl: string;
     private readonly token: string | undefined;
     private mcpClient?: McpClient;
     private logCleanup?: () => void;
@@ -74,6 +76,7 @@ export class HarnessFEWebpackPlugin {
             options.mcpUrl ??
             process.env.HARNESS_FE_URL ??
             `ws://127.0.0.1:${DEFAULT_WS_PORT}`;
+        this.baseMcpUrl = baseUrl;
         this.token = options.token ?? process.env.HARNESS_FE_TOKEN;
         this.mcpUrl = appendTokenQuery(baseUrl, this.token);
         this.identity = createBuildIdentity({
@@ -174,8 +177,17 @@ export class HarnessFEWebpackPlugin {
         compiler.hooks.afterEnvironment.tap('harness-fe', () => {
             const client = createMcpClient(ctx);
             this.mcpClient = client;
-            client.connect();
             this.logCleanup = installNodeLogCapture((name, payload) => client.emitEvent(name, payload));
+            // Solo (loopback + no token): ensure a shared local gateway is up, then
+            // connect. afterEnvironment is sync, so fire-and-forget and connect once
+            // the gateway answers (best-effort — if @harness-fe/cli isn't installed
+            // we just connect and let the client retry). Team never auto-spawns.
+            const solo = resolveSoloTarget(this.baseMcpUrl, Boolean(this.token));
+            if (solo) {
+                void this.ensureSharedGateway(solo).finally(() => client.connect());
+            } else {
+                client.connect();
+            }
         });
 
         compiler.hooks.shutdown?.tap('harness-fe', () => {
@@ -186,6 +198,15 @@ export class HarnessFEWebpackPlugin {
         });
     }
 
+    private async ensureSharedGateway(target: { host: string; port: number }): Promise<void> {
+        try {
+            const { ensureSharedGateway } = await import('@harness-fe/cli/sharedGateway');
+            await ensureSharedGateway({ host: target.host, port: target.port });
+        } catch {
+            /* @harness-fe/cli not installed, or gateway slow — client.connect() retries */
+        }
+    }
+
     private installComponentMapAggregator(compiler: any): void {
         const pluginId = this.pluginId;
         compiler.hooks.compilation.tap('harness-fe', (compilation: any) => {