@akira-tl/forgerelay 1.3.5 → 1.3.6-beta.1

package/CHANGELOG.md

@@ -4,6 +4,18 @@ All notable ForgeRelay changes are documented here.
 
 ## [Unreleased]
 
+## [1.3.6-beta.1] - 2026-11-05
+
+### Fixed
+
+- 语言服务回收前重新检查服务归属、活动请求和最近使用时间，避免并发文件修改重新使用服务后，清理任务仍按旧名单关闭它；服务整体关闭时等待已开始的操作完成。
+- Pyright 互操作验证直接使用真实语言服务器协议请求，避免因不支持 `--version` 而被误跳过。
+
+### Added
+
+- 默认在实例状态目录的 `logs/runtime.jsonl` 持久记录语言服务启动、关闭原因、信号发送位置、操作异常和主进程未捕获异常；同步写入、限制大小并轮换保存，不依赖终端滚屏。
+- 支持 beta 补丁版本，经现有发布验证后发布到 npm `next` 通道并标记为 GitHub 预发布。
+
 ## [1.3.5] - 2026-11-04
 
 ### Fixed

package/dist/cli.js

@@ -9,6 +9,7 @@ import { join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { loadConfig } from "./runtime/config/config.js";
 import { acquireRuntimeLease } from "./runtime/state/runtime-lease.js";
+import { diagnosticError, observeRuntimeExit, RuntimeDiagnostics } from "./runtime/logging/runtime-diagnostics.js";
 import { runInit } from "./cli/init.js";
 import { runConfigMigration } from "./cli/config/migrate.js";
 import { runConfigInspection } from "./cli/config/inspect.js";
@@ -198,11 +199,16 @@ async function serve(runtimePrivilege, runtimeOverrides = {}) {
     const config = loadConfig(process.env, { runtimeOverrides });
     config.runtimePrivilege = runtimePrivilege;
     const runtimeLease = acquireRuntimeLease(config.stateDir);
+    const diagnostics = new RuntimeDiagnostics(config.stateDir);
+    const stopObservingExit = observeRuntimeExit(diagnostics);
+    diagnostics.record("runtime_started", { version: installedForgeRelayVersion(), reason: process.version });
     let server;
     try {
-        server = createServer(config);
+        server = createServer(config, { runtimeDiagnostics: diagnostics });
     }
     catch (error) {
+        diagnostics.record("runtime_start_failed", diagnosticError(error));
+        stopObservingExit();
         runtimeLease.release();
         throw error;
     }
@@ -219,6 +225,7 @@ async function serve(runtimePrivilege, runtimeOverrides = {}) {
         console.log(`command shell: ${formatCommandShellRuntime(config.commandShellRuntime)}`);
         console.log(`runtime privilege: ${formatRuntimePrivilege(runtimePrivilege)}`);
         console.log(`logging: ${config.logging.level} ${config.logging.format}`);
+        console.log(`runtime diagnostics: ${diagnostics.path}`);
         if (config.subagents) {
             console.log(`subagent providers: ${formatSubagentProviderAvailabilitySummary(subagentProviders)}`);
         }
@@ -239,14 +246,15 @@ async function serve(runtimePrivilege, runtimeOverrides = {}) {
         }
         process.exit(0);
     };
-    const handleShutdown = () => {
+    const handleShutdown = (signal) => {
+        diagnostics.record("runtime_signal", { signal });
         void shutdown().catch((error) => {
             console.error("forgerelay shutdown failed", error);
             process.exit(1);
         });
     };
-    process.once("SIGINT", handleShutdown);
-    process.once("SIGTERM", handleShutdown);
+    process.once("SIGINT", () => handleShutdown("SIGINT"));
+    process.once("SIGTERM", () => handleShutdown("SIGTERM"));
 }
 async function runDoctor() {
     const files = loadForgeRelayFiles();

package/dist/lsp/code-intelligence.js

@@ -7,6 +7,8 @@ import { DefinitionRequest, DiagnosticTag, DocumentDiagnosticReportKind, Documen
 import { LanguageServerConfigurationError, } from "./language-server-config.js";
 import { terminateProcessTree } from "../mcp/process/process-platform.js";
 import { CodeIntelligenceError } from "./code-intelligence-error.js";
+import { randomUUID } from "node:crypto";
+import { diagnosticError, } from "../runtime/logging/runtime-diagnostics.js";
 import { DEFAULT_CODE_INTELLIGENCE_RESULT_LIMIT } from "./code-intelligence-types.js";
 import { normalizeHoverContents } from "./normalization/hover.js";
 import { normalizeDocumentSymbols, normalizeWorkspaceSymbols, } from "./normalization/symbols.js";
@@ -14,7 +16,7 @@ import { isWithin, locationEntries, normalizeLocations, workspaceDisplayPath, }
 import { lspPositionFromUser, rangeFromLsp } from "./position-encoding.js";
 import { DiagnosticSnapshotStore } from "./runtime/diagnostic-snapshots.js";
 import { DocumentSynchronizer } from "./runtime/document-synchronizer.js";
-import { languageServerCommandRequiresShell } from "./runtime/process-launch.js";
+import { languageServerCommandRequiresShell, waitForChildExit, waitForChildSpawn, withTimeout, } from "./runtime/process-launch.js";
 import { SemanticRequestCoordinator } from "./runtime/semantic-requests.js";
 export { CodeIntelligenceError } from "./code-intelligence-error.js";
 const STDERR_TAIL_BYTES = 64 * 1024;
@@ -36,6 +38,7 @@ export class LanguageService {
     semanticRequests;
     stderrTail = Buffer.alloc(0);
     closed = false;
+    serviceId = randomUUID();
     constructor(workspaceRoot, project, policy) {
         this.workspaceRoot = workspaceRoot;
         this.project = project;
@@ -279,9 +282,10 @@ export class LanguageService {
             throw new CodeIntelligenceError("code.server_crashed", `Language server ${this.project.definition.id} failed: ${errorMessage(error)}${this.stderrSuffix()}`);
         }
     }
-    async shutdown() {
+    async shutdown(reason = "server_shutdown") {
         if (this.closed)
             return;
+        this.recordDiagnostic("lsp_shutdown", { reason, ...diagnosticError(new Error()) });
         this.closed = true;
         const connection = this.connection;
         const child = this.child;
@@ -302,6 +306,7 @@ export class LanguageService {
         this.documents.clear();
         this.diagnosticSnapshots.clear();
         if (child && child.exitCode === null && child.signalCode === null) {
+            this.recordDiagnostic("lsp_terminate", { reason, signal: "SIGTERM", ...diagnosticError(new Error()) });
             terminateProcessTree(child, "SIGTERM", process.platform !== "win32");
         }
         this.child = undefined;
@@ -324,6 +329,7 @@ export class LanguageService {
         }
         catch (error) {
             this.initializePromise = undefined;
+            this.recordDiagnostic("lsp_start_failed", diagnosticError(error));
             this.cleanupFailedStart();
             if (error instanceof CodeIntelligenceError)
                 throw error;
@@ -348,6 +354,10 @@ export class LanguageService {
             throw new CodeIntelligenceError("code.language_service_start_failed", `Unable to start Language server ${definition.id}: ${errorMessage(error)}.`);
         }
         this.child = child;
+        this.recordDiagnostic("lsp_start");
+        child.on("exit", (exitCode, signal) => {
+            this.recordDiagnostic("lsp_exit", { childPid: child.pid, exitCode, signal });
+        });
         child.stderr.on("data", (chunk) => this.appendStderr(chunk));
         await waitForChildSpawn(child, definition.id);
         const connection = createMessageConnection(child.stdout, child.stdin);
@@ -430,6 +440,7 @@ export class LanguageService {
         try {
             const result = await withTimeout(Promise.race([initialize, startupFailure]), this.policy.startTimeoutMs, () => new CodeIntelligenceError("code.language_service_start_timeout", `Language server ${definition.id} did not initialize within ${this.policy.startTimeoutMs}ms.`));
             await connection.sendNotification(InitializedNotification.type, {});
+            this.recordDiagnostic("lsp_ready");
             return result;
         }
         finally {
@@ -441,6 +452,9 @@ export class LanguageService {
         this.connection?.dispose();
         const child = this.child;
         if (child && child.exitCode === null && child.signalCode === null) {
+            this.recordDiagnostic("lsp_terminate", {
+                reason: "initialization_failed", signal: "SIGTERM", ...diagnosticError(new Error()),
+            });
             terminateProcessTree(child, "SIGTERM", process.platform !== "win32");
         }
         this.connection = undefined;
@@ -448,6 +462,18 @@ export class LanguageService {
         this.documents.clear();
         this.diagnosticSnapshots.clear();
     }
+    recordDiagnostic(event, fields = {}) {
+        this.policy.diagnostics?.record(event, {
+            serviceId: this.serviceId,
+            serverId: this.project.definition.id,
+            projectRoot: this.project.projectRoot,
+            childPid: this.child?.pid,
+            operationsInFlight: this.inFlight,
+            semanticRequestsActive: this.semanticRequests.activeCount,
+            semanticRequestsQueued: this.semanticRequests.queuedCount,
+            ...fields,
+        });
+    }
     registerClientHandlers(connection) {
         connection.onRequest("workspace/configuration", (params) => Array.isArray(params?.items) ? params.items.map(() => null) : []);
         connection.onRequest("workspace/workspaceFolders", () => [{
@@ -502,53 +528,6 @@ async function workspaceSourcePath(workspaceRoot, inputPath) {
         throw new CodeIntelligenceError("code.language_service_unavailable", `Unable to read code-intelligence source ${inputPath}: ${errorMessage(error)}`);
     }
 }
-async function withTimeout(promise, timeoutMs, timeoutError) {
-    let timer;
-    try {
-        return await Promise.race([
-            promise,
-            new Promise((_resolve, reject) => {
-                timer = setTimeout(() => reject(timeoutError()), timeoutMs);
-                timer.unref();
-            }),
-        ]);
-    }
-    finally {
-        if (timer)
-            clearTimeout(timer);
-    }
-}
-async function waitForChildSpawn(child, serverId) {
-    await new Promise((resolvePromise, rejectPromise) => {
-        const onSpawn = () => {
-            child.off("error", onError);
-            resolvePromise();
-        };
-        const onError = (error) => {
-            child.off("spawn", onSpawn);
-            rejectPromise(new CodeIntelligenceError("code.language_service_start_failed", `Unable to start Language server ${serverId}: ${error.message}.`));
-        };
-        child.once("spawn", onSpawn);
-        child.once("error", onError);
-    });
-}
-async function waitForChildExit(child, timeoutMs) {
-    if (child.exitCode !== null || child.signalCode !== null)
-        return true;
-    return new Promise((resolvePromise) => {
-        let timer;
-        const finish = (exited) => {
-            child.off("exit", onExit);
-            if (timer)
-                clearTimeout(timer);
-            resolvePromise(exited);
-        };
-        const onExit = () => finish(true);
-        child.once("exit", onExit);
-        timer = setTimeout(() => finish(false), timeoutMs);
-        timer.unref();
-    });
-}
 function errorMessage(error) {
     return error instanceof Error ? error.message : String(error);
 }

package/dist/lsp/runtime/manager.js

@@ -1,6 +1,7 @@
 import { createHash } from "node:crypto";
 import { realpath } from "node:fs/promises";
 import { resolve, sep } from "node:path";
+import { diagnosticError } from "../../runtime/logging/runtime-diagnostics.js";
 import { CodeIntelligenceError, LanguageService, languageServiceKey, } from "../code-intelligence.js";
 import { LanguageServerConfigurationError, resolveLanguageProject, } from "../language-server-config.js";
 import { managedLanguageServerIdForCommand, managedLanguageServerRuntimeIdentity, managedTypeScriptTsserverPath, withManagedLanguageServerPath, } from "./managed-language-servers.js";
@@ -24,6 +25,9 @@ export class CodeIntelligenceManager {
     crashStates = new Map();
     retiredWorkspaceRoots = new Set();
     serviceCreationQueue = Promise.resolve();
+    activeRuns = 0;
+    runDrainWaiters = new Set();
+    shutdownPromise;
     cleanupTimer;
     policy;
     crashCooldownMs;
@@ -33,6 +37,7 @@ export class CodeIntelligenceManager {
         this.projectExecutionTrustPolicy = options.projectExecutionTrustPolicy ?? compatibilityAllowProjectExecutionTrustPolicy;
         this.crashCooldownMs = positiveInteger(options.crashCooldownMs, LANGUAGE_SERVICE_CRASH_COOLDOWN_MS, "crashCooldownMs");
         this.policy = {
+            diagnostics: options.diagnostics,
             idleMs: positiveInteger(options.idleMs, LANGUAGE_SERVICE_IDLE_MS, "idleMs"),
             cleanupIntervalMs: positiveInteger(options.cleanupIntervalMs, LANGUAGE_SERVICE_CLEANUP_INTERVAL_MS, "cleanupIntervalMs"),
             maxServices: positiveInteger(options.maxServices, MAX_LANGUAGE_SERVICES, "maxServices"),
@@ -50,6 +55,23 @@ export class CodeIntelligenceManager {
         this.cleanupTimer.unref();
     }
     async run(workspaceRoot, input, options = {}) {
+        if (this.shutdownPromise) {
+            throw new CodeIntelligenceError("code.language_service_unavailable", "Code intelligence is shutting down.");
+        }
+        this.activeRuns += 1;
+        try {
+            return await this.runActive(workspaceRoot, input, options);
+        }
+        finally {
+            this.activeRuns = Math.max(0, this.activeRuns - 1);
+            if (this.activeRuns === 0) {
+                for (const resolveDrain of this.runDrainWaiters)
+                    resolveDrain();
+                this.runDrainWaiters.clear();
+            }
+        }
+    }
+    async runActive(workspaceRoot, input, options) {
         const canonicalWorkspaceRoot = await realpath(resolve(workspaceRoot));
         this.assertWorkspaceRootAvailable(canonicalWorkspaceRoot);
         let project;
@@ -89,6 +111,7 @@ export class CodeIntelligenceManager {
                 return result;
             }
             catch (error) {
+                service.recordDiagnostic("lsp_operation_failed", { operation: input.operation, ...diagnosticError(error) });
                 if (!(error instanceof CodeIntelligenceError) || error.code !== "code.server_crashed") {
                     throw error;
                 }
@@ -113,7 +136,12 @@ export class CodeIntelligenceManager {
         throw lastCrash ?? new CodeIntelligenceError("code.server_crashed", `Language server ${project.definition.id} failed without a recoverable result.`);
     }
     async shutdown() {
+        this.shutdownPromise ??= this.performShutdown();
+        return this.shutdownPromise;
+    }
+    async performShutdown() {
         clearInterval(this.cleanupTimer);
+        await this.waitForActiveRuns();
         await Promise.allSettled(this.serviceCreations.values());
         this.serviceCreations.clear();
         const services = [...this.services.values()];
@@ -121,7 +149,14 @@ export class CodeIntelligenceManager {
         this.invalidatedServiceKeys.clear();
         this.crashStates.clear();
         this.retiredWorkspaceRoots.clear();
-        await Promise.allSettled(services.map((service) => service.shutdown()));
+        await Promise.allSettled(services.map((service) => service.shutdown("server_shutdown")));
+    }
+    waitForActiveRuns() {
+        if (this.activeRuns === 0)
+            return Promise.resolve();
+        return new Promise((resolveDrain) => {
+            this.runDrainWaiters.add(resolveDrain);
+        });
     }
     get size() {
         return this.services.size;
@@ -176,7 +211,7 @@ export class CodeIntelligenceManager {
                 this.services.delete(key);
             this.invalidatedServiceKeys.delete(key);
             this.crashStates.delete(key);
-            await service.shutdown();
+            await service.shutdown("workspace_retired");
             releasedServices += 1;
         }
         this.clearIdentityStateForWorkspaceRoot(canonicalRoot);
@@ -242,10 +277,11 @@ export class CodeIntelligenceManager {
                 invalidated.push([key, service]);
         }
         for (const [key, service] of invalidated) {
-            if (this.services.get(key) === service)
-                this.services.delete(key);
+            if (this.services.get(key) !== service || !service.isIdle)
+                continue;
+            this.services.delete(key);
             this.invalidatedServiceKeys.delete(key);
-            await service.shutdown();
+            await service.shutdown("configuration_unavailable");
         }
     }
     async invalidateChangedServices(project) {
@@ -262,10 +298,11 @@ export class CodeIntelligenceManager {
             }
         }
         for (const [key, service] of invalidated) {
-            if (this.services.get(key) === service)
-                this.services.delete(key);
+            if (this.services.get(key) !== service || !service.isIdle)
+                continue;
+            this.services.delete(key);
             this.invalidatedServiceKeys.delete(key);
-            await service.shutdown();
+            await service.shutdown("configuration_changed");
         }
     }
     async releaseService(service) {
@@ -275,13 +312,13 @@ export class CodeIntelligenceManager {
         if (this.services.get(service.key) === service)
             this.services.delete(service.key);
         this.invalidatedServiceKeys.delete(service.key);
-        await service.shutdown();
+        await service.shutdown("invalidated");
     }
     async discardService(service) {
         if (this.services.get(service.key) === service)
             this.services.delete(service.key);
         this.invalidatedServiceKeys.delete(service.key);
-        await service.shutdown();
+        await service.shutdown("crashed");
     }
     async acquireService(workspaceRoot, project) {
         const key = languageServiceKey(project);
@@ -335,8 +372,13 @@ export class CodeIntelligenceManager {
     async closeIdle(now = Date.now()) {
         const stale = [...this.services.entries()].filter(([, service]) => service.isIdle && now - service.lastUsedAt >= this.policy.idleMs);
         for (const [key, service] of stale) {
+            if (this.services.get(key) !== service ||
+                !service.isIdle ||
+                now - service.lastUsedAt < this.policy.idleMs) {
+                continue;
+            }
             this.services.delete(key);
-            await service.shutdown();
+            await service.shutdown("idle_timeout");
         }
     }
     async ensureCapacity() {
@@ -350,7 +392,7 @@ export class CodeIntelligenceManager {
             throw new CodeIntelligenceError("code.language_service_capacity", `Language service capacity reached (${this.policy.maxServices}) with no idle service available for eviction.`);
         }
         this.services.delete(candidate[0]);
-        await candidate[1].shutdown();
+        await candidate[1].shutdown("capacity_limit");
     }
 }
 function withManagedLanguageServerRuntime(project, configDir) {

package/dist/lsp/runtime/process-launch.js

@@ -1,3 +1,51 @@
+import { CodeIntelligenceError } from "../code-intelligence-error.js";
+export async function withTimeout(promise, timeoutMs, timeoutError) {
+    let timer;
+    try {
+        return await Promise.race([
+            promise,
+            new Promise((_resolve, reject) => {
+                timer = setTimeout(() => reject(timeoutError()), timeoutMs);
+                timer.unref();
+            }),
+        ]);
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+    }
+}
+export async function waitForChildSpawn(child, serverId) {
+    await new Promise((resolvePromise, rejectPromise) => {
+        const onSpawn = () => {
+            child.off("error", onError);
+            resolvePromise();
+        };
+        const onError = (error) => {
+            child.off("spawn", onSpawn);
+            rejectPromise(new CodeIntelligenceError("code.language_service_start_failed", `Unable to start Language server ${serverId}: ${error.message}.`));
+        };
+        child.once("spawn", onSpawn);
+        child.once("error", onError);
+    });
+}
+export async function waitForChildExit(child, timeoutMs) {
+    if (child.exitCode !== null || child.signalCode !== null)
+        return true;
+    return new Promise((resolvePromise) => {
+        let timer;
+        const finish = (exited) => {
+            child.off("exit", onExit);
+            if (timer)
+                clearTimeout(timer);
+            resolvePromise(exited);
+        };
+        const onExit = () => finish(true);
+        child.once("exit", onExit);
+        timer = setTimeout(() => finish(false), timeoutMs);
+        timer.unref();
+    });
+}
 export function languageServerCommandRequiresShell(command, platform = process.platform) {
     return platform === "win32" && /\.(?:cmd|bat)$/i.test(command);
 }

package/dist/mcp/server/transport/http-server.js

@@ -11,6 +11,7 @@ import { ActivityQueryService } from "../../../activity/history/query-service.js
 import { CodeIntelligenceManager } from "../../../lsp/runtime/manager.js";
 import { createOpenAIIncomingArtifactAdapter } from "../../artifacts/incoming-artifacts.js";
 import { logEvent, requestPath, transportSessionIdPrefix } from "../../../runtime/logging/logger.js";
+import { RuntimeDiagnostics } from "../../../runtime/logging/runtime-diagnostics.js";
 import { SingleUserOAuthProvider } from "../../oauth/oauth-provider.js";
 import { createForgeRelayAuthRouter } from "../../oauth/router.js";
 import { publicEndpointPaths, publicEndpointUrl } from "../../oauth/public-url.js";
@@ -80,7 +81,8 @@ export function createHttpServer(config, options, createMcpServer) {
         outputAudit: bashOutputStore,
         commandShellRuntime: config.commandShellRuntime,
     });
-    const codeIntelligence = new CodeIntelligenceManager(config);
+    const diagnostics = options.runtimeDiagnostics ?? new RuntimeDiagnostics(config.stateDir);
+    const codeIntelligence = new CodeIntelligenceManager(config, { diagnostics });
     const subagentProviders = config.subagents
         ? getSubagentProviderAvailabilitySnapshot()
         : [];

package/dist/runtime/logging/runtime-diagnostics.js

@@ -0,0 +1,92 @@
+import { closeSync, constants, fchmodSync, fstatSync, mkdirSync, openSync, renameSync, statSync, unlinkSync, writeSync, } from "node:fs";
+import { dirname, join } from "node:path";
+/** Keep error identities and call sites, without persisting messages or server stderr. */
+export function diagnosticError(error) {
+    if (!(error instanceof Error))
+        return { errorName: "NonError" };
+    return {
+        errorName: error.name,
+        errorCode: "code" in error && typeof error.code === "string" ? error.code : undefined,
+        stack: error.stack?.split("\n").filter((line) => /^\s+at /.test(line)).slice(0, 16),
+    };
+}
+/** Synchronous writes retain fatal-event evidence even when Node exits immediately afterwards. */
+export class RuntimeDiagnostics {
+    maxBytes;
+    path;
+    warned = false;
+    constructor(stateDir, maxBytes = 4 * 1024 * 1024) {
+        this.maxBytes = maxBytes;
+        this.path = join(stateDir, "logs", "runtime.jsonl");
+    }
+    record(event, fields = {}) {
+        let fd;
+        try {
+            const bounded = JSON.stringify({ ts: new Date().toISOString(), pid: process.pid, event, ...fields }, (_key, value) => typeof value === "string" ? value.slice(0, 1024) : value);
+            const line = Buffer.from(`${bounded}\n`);
+            if (line.length > this.maxBytes)
+                throw new Error("Diagnostic entry exceeds retention limit.");
+            mkdirSync(dirname(this.path), { recursive: true, mode: 0o700 });
+            let size = 0;
+            try {
+                size = statSync(this.path).size;
+            }
+            catch (error) {
+                if (!(error instanceof Error && "code" in error && error.code === "ENOENT"))
+                    throw error;
+            }
+            if (size + line.length > this.maxBytes)
+                this.rotate();
+            fd = openSync(this.path, constants.O_WRONLY | constants.O_CREAT | constants.O_APPEND |
+                (constants.O_NOFOLLOW ?? 0), 0o600);
+            if (!fstatSync(fd).isFile())
+                throw new Error("Runtime diagnostic destination must be a regular file.");
+            fchmodSync(fd, 0o600);
+            let offset = 0;
+            while (offset < line.length)
+                offset += writeSync(fd, line, offset, line.length - offset);
+        }
+        catch {
+            if (!this.warned) {
+                this.warned = true;
+                console.error("ForgeRelay could not persist runtime diagnostics; check state-directory permissions and disk space.");
+            }
+        }
+        finally {
+            if (fd !== undefined) {
+                try {
+                    closeSync(fd);
+                }
+                catch { /* Logging must never replace the original failure. */ }
+            }
+        }
+    }
+    rotate() {
+        for (let index = 3; index >= 0; index -= 1) {
+            const path = index === 0 ? this.path : `${this.path}.${index}`;
+            try {
+                if (index === 3)
+                    unlinkSync(path);
+                else
+                    renameSync(path, `${this.path}.${index + 1}`);
+            }
+            catch (error) {
+                if (!(error instanceof Error && "code" in error && error.code === "ENOENT"))
+                    throw error;
+            }
+        }
+    }
+}
+/** Observes fatal errors without converting an unhandled rejection into a recoverable event. */
+export function observeRuntimeExit(diagnostics) {
+    const onFatal = (error, origin) => {
+        diagnostics.record("runtime_uncaught_exception", { reason: origin, ...diagnosticError(error) });
+    };
+    const onExit = (exitCode) => diagnostics.record("runtime_exit", { exitCode });
+    process.on("uncaughtExceptionMonitor", onFatal);
+    process.on("exit", onExit);
+    return () => {
+        process.off("uncaughtExceptionMonitor", onFatal);
+        process.off("exit", onExit);
+    };
+}

package/dist/runtime/testing/server-fixture.js

@@ -87,7 +87,7 @@ export async function fixture(t, options = {}) {
         turnId: () => `turn_test_${++turnSequence}`,
         turnIdForConversation: (conversationScopeId, workspaceId) => activityQueries.currentTurnId(conversationScopeId, workspaceId),
     });
-    const codeIntelligence = new CodeIntelligenceManager(config);
+    const codeIntelligence = new CodeIntelligenceManager(config, options.codeIntelligenceOptions);
     const server = createMcpServer(config, workspaces, createReviewCheckpointManager(), processSessions, [], options.incomingArtifactAdapters ?? [], codeIntelligence, activityLifecycle, bashOutputStore, activityQueries);
     const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
     const client = new Client({ name: "forgerelay-test-client", version: "1.0.0" });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akira-tl/forgerelay",
-  "version": "1.3.5",
+  "version": "1.3.6-beta.1",
   "description": "Local development control plane for MCP coding agents.",
   "type": "module",
   "homepage": "https://github.com/Akira-TL/forgerelay#readme",
@@ -68,7 +68,7 @@
     "release:push-ready": "node scripts/release/push-ready.mjs",
     "postinstall": "node scripts/fix-node-pty-permissions.mjs",
     "start": "node dist/cli.js serve",
-    "test": "node --test scripts/debug/runtime.test.mjs scripts/config/schema-text.test.mjs scripts/release-proof.test.mjs scripts/release/release-gate.test.mjs scripts/release/push-ready.test.mjs scripts/release/release-version.test.mjs && tsx src/mcp/oauth/router.test.ts && tsx src/workspaces/relay/auth/remote-auth-cli.test.ts && tsx src/workspaces/relay/auth/remote-ssh-auth-cli.test.ts && tsx src/workspaces/relay/tests/lifecycle.test.ts && tsx src/workspaces/relay/tests/routing.test.ts && tsx src/workspaces/relay/tests/ssh.test.ts && tsx src/workspaces/relay/tests/process.test.ts && tsx src/workspaces/relay/tests/recovery.test.ts && tsx src/workspaces/relay/tests/checkpoint.test.ts && tsx src/workspaces/relay/tests/composite.test.ts && tsx src/runtime/config/definition/schema.test.ts && tsx src/runtime/config/resolution/resolver.test.ts && tsx src/runtime/security/project-execution-trust.test.ts && tsx src/runtime/config/resolution/hooks.test.ts && tsx src/workspaces/state/project-context.test.ts && tsx src/runtime/config/config.test.ts && tsx src/cli/config/general.test.ts && tsx src/cli/config/domains/domain-cli.test.ts && node --test --import tsx src/cli/config/domains/context-cli.test.ts && node --test --import tsx src/cli/config/inspect.test.ts src/cli/config/migrate.test.ts && tsx src/runtime/config/external-mcp-registry.test.ts && tsx src/runtime/config/external-mcp-auth-store.test.ts && tsx src/mcp/operations/external-mcp/external-mcp-oauth.test.ts && tsx src/cli/mcp/status.test.ts && tsx src/cli/mcp/diagnostics.test.ts && tsx src/cli/mcp/external-mcp.test.ts && tsx src/runtime/shell/command-shell-runtime.test.ts && tsx src/runtime/instructions/shell-instructions.test.ts && tsx src/runtime/instructions/powershell-skill.test.ts && tsx src/cli/shell/setup.test.ts && tsx src/lsp/language-server-config.test.ts && tsx src/lsp/runtime/managed-language-servers.test.ts && tsx src/lsp/normalization/hover.test.ts && tsx src/lsp/references.server.test.ts && tsx src/lsp/operations/document-symbols.server.test.ts && tsx src/lsp/operations/workspace-symbols.server.test.ts && tsx src/lsp/operations/diagnostics-push.server.test.ts && tsx src/lsp/operations/diagnostics-pull.server.test.ts && tsx src/lsp/operations/request-hardening.server.test.ts && tsx src/lsp/operations/recovery.server.test.ts && tsx src/lsp/operations/lifecycle.server.test.ts && tsx src/lsp/operations/project-trust.server.test.ts && tsx src/lsp/runtime/semantic-requests.test.ts && tsx src/runtime/logging/logger.test.ts && tsx src/runtime/logging/proxy-trust.test.ts && tsx src/runtime/state/lock/file-lock.test.ts && tsx src/runtime/state/runtime-lease.test.ts && tsx src/cli/system/status.test.ts && tsx src/mcp/panel/mcp-app-template.test.ts && tsx src/mcp/hooks/hooks.test.ts && tsx src/mcp/hooks/hooks-trust.test.ts && tsx src/mcp/operations/external-mcp/external-mcp-transform.test.ts && tsx src/mcp/hooks/external-mcp-transform-trust.test.ts && tsx src/mcp/operations/external-mcp/external-mcp-trust.test.ts && tsx src/mcp/server/core/capability-registry.test.ts && tsx src/mcp/server-instructions.test.ts && tsx src/mcp/request-context.test.ts && tsx src/mcp/request-meta.test.ts && tsx src/mcp/artifacts/incoming-artifacts.test.ts && tsx src/mcp/artifacts/artifact-download.test.ts && tsx src/ui/core/card-types.test.ts && tsx src/ui/activity/model.test.ts && tsx src/ui/activity/detail-card.test.ts && tsx src/ui/review/patch-display.test.ts && tsx src/ui/core/tool-display.test.ts && tsx src/mcp/filesystem/apply-patch.test.ts && tsx src/mcp/process/process-platform.test.ts && tsx src/mcp/process/process-sessions.test.ts && tsx src/mcp/server/transport/mcp-sessions.test.ts && tsx src/mcp/server/transport/server-shutdown.test.ts && tsx src/mcp/server/operations/mutation-diagnostics.test.ts && tsx src/mcp/server/operations/hooks.test.ts && tsx src/subagents/providers/adapters/codex.test.ts && tsx src/subagents/providers/adapters/pi.test.ts && tsx src/subagents/providers/registry.test.ts && tsx src/subagents/providers/availability.test.ts && tsx src/subagents/profiles.test.ts && tsx src/subagents/cli-target.test.ts && tsx src/subagents/sessions/store.test.ts && tsx src/subagents/sessions/manager.test.ts && tsx src/subagents/sessions/project-trust.test.ts && tsx src/subagents/sessions/mcp/capability.server.test.ts && tsx src/subagents/sessions/mcp/continuation.server.test.ts && tsx src/subagents/sessions/mcp/lifecycle.server.test.ts && tsx src/subagents/sessions/mcp/reconciliation.server.test.ts && tsx src/subagents/sessions/mcp/routing.server.test.ts && tsx src/mcp/filesystem/roots.test.ts && tsx src/mcp/filesystem/file-mutations.test.ts && tsx src/mcp/operations/edit-preflight.test.ts && tsx src/workspaces/resources/skills.test.ts && tsx src/runtime/state/db/migrations.test.ts && tsx src/workspaces/state/workspace-store.test.ts && tsx src/workspaces/tasks/workspace-tasks.test.ts && tsx src/workspaces/tasks/workspace-task-reminders.test.ts && tsx src/activity/history/audit-store.test.ts && tsx src/activity/history/bash-output-store.test.ts && tsx src/activity/runtime/lifecycle.test.ts && tsx src/activity/history/query-service.test.ts && tsx src/mcp/operations/core-operation-executor.test.ts && tsx src/mcp/operations/bulk-mutation.test.ts && tsx src/mcp/operations/batch/scheduler.test.ts && tsx src/mcp/operations/batch/executor-policy.test.ts && tsx src/workspaces.test.ts && tsx src/workspaces/conversation-checkout.test.ts && tsx src/workspaces/conversation-worktree.test.ts && tsx src/workspaces/git/worktree-recovery.test.ts && tsx src/mcp/server/workspace/workspace-inventory.test.ts && tsx src/mcp/server/workspace/workspace-recovery.test.ts && tsx src/mcp/server/workspace/workspace-checkpoint.test.ts && tsx src/workspaces/review/review-checkpoints.test.ts && tsx src/lsp/code-intelligence.server.test.ts && npm run build:app && tsx src/mcp/process/server.test.ts && tsx src/mcp/panel/server.test.ts && tsx src/mcp/server/server.test.ts && tsx src/mcp/oauth/oauth-store.test.ts && tsx src/cli/maintenance.test.ts && tsx src/cli/maintenance-prune.test.ts && tsx src/cli/cli.test.ts",
+    "test": "node --test scripts/debug/runtime.test.mjs scripts/config/schema-text.test.mjs scripts/release-proof.test.mjs scripts/release/release-gate.test.mjs scripts/release/push-ready.test.mjs scripts/release/release-version.test.mjs && tsx src/mcp/oauth/router.test.ts && tsx src/workspaces/relay/auth/remote-auth-cli.test.ts && tsx src/workspaces/relay/auth/remote-ssh-auth-cli.test.ts && tsx src/workspaces/relay/tests/lifecycle.test.ts && tsx src/workspaces/relay/tests/routing.test.ts && tsx src/workspaces/relay/tests/ssh.test.ts && tsx src/workspaces/relay/tests/process.test.ts && tsx src/workspaces/relay/tests/recovery.test.ts && tsx src/workspaces/relay/tests/checkpoint.test.ts && tsx src/workspaces/relay/tests/composite.test.ts && tsx src/runtime/config/definition/schema.test.ts && tsx src/runtime/config/resolution/resolver.test.ts && tsx src/runtime/security/project-execution-trust.test.ts && tsx src/runtime/config/resolution/hooks.test.ts && tsx src/workspaces/state/project-context.test.ts && tsx src/runtime/config/config.test.ts && tsx src/cli/config/general.test.ts && tsx src/cli/config/domains/domain-cli.test.ts && node --test --import tsx src/cli/config/domains/context-cli.test.ts && node --test --import tsx src/cli/config/inspect.test.ts src/cli/config/migrate.test.ts && tsx src/runtime/config/external-mcp-registry.test.ts && tsx src/runtime/config/external-mcp-auth-store.test.ts && tsx src/mcp/operations/external-mcp/external-mcp-oauth.test.ts && tsx src/cli/mcp/status.test.ts && tsx src/cli/mcp/diagnostics.test.ts && tsx src/cli/mcp/external-mcp.test.ts && tsx src/runtime/shell/command-shell-runtime.test.ts && tsx src/runtime/instructions/shell-instructions.test.ts && tsx src/runtime/instructions/powershell-skill.test.ts && tsx src/cli/shell/setup.test.ts && tsx src/lsp/language-server-config.test.ts && tsx src/lsp/runtime/managed-language-servers.test.ts && tsx src/lsp/normalization/hover.test.ts && tsx src/lsp/references.server.test.ts && tsx src/lsp/operations/document-symbols.server.test.ts && tsx src/lsp/operations/workspace-symbols.server.test.ts && tsx src/lsp/operations/diagnostics-push.server.test.ts && tsx src/lsp/operations/diagnostics-pull.server.test.ts && tsx src/lsp/operations/request-hardening.server.test.ts && tsx src/lsp/operations/recovery.server.test.ts && tsx src/lsp/operations/lifecycle.server.test.ts && tsx src/lsp/operations/project-trust.server.test.ts && tsx src/lsp/runtime/semantic-requests.test.ts && tsx src/runtime/logging/logger.test.ts && tsx src/runtime/logging/runtime-diagnostics.test.ts && tsx src/runtime/logging/proxy-trust.test.ts && tsx src/runtime/state/lock/file-lock.test.ts && tsx src/runtime/state/runtime-lease.test.ts && tsx src/cli/system/status.test.ts && tsx src/mcp/panel/mcp-app-template.test.ts && tsx src/mcp/hooks/hooks.test.ts && tsx src/mcp/hooks/hooks-trust.test.ts && tsx src/mcp/operations/external-mcp/external-mcp-transform.test.ts && tsx src/mcp/hooks/external-mcp-transform-trust.test.ts && tsx src/mcp/operations/external-mcp/external-mcp-trust.test.ts && tsx src/mcp/server/core/capability-registry.test.ts && tsx src/mcp/server-instructions.test.ts && tsx src/mcp/request-context.test.ts && tsx src/mcp/request-meta.test.ts && tsx src/mcp/artifacts/incoming-artifacts.test.ts && tsx src/mcp/artifacts/artifact-download.test.ts && tsx src/ui/core/card-types.test.ts && tsx src/ui/activity/model.test.ts && tsx src/ui/activity/detail-card.test.ts && tsx src/ui/review/patch-display.test.ts && tsx src/ui/core/tool-display.test.ts && tsx src/mcp/filesystem/apply-patch.test.ts && tsx src/mcp/process/process-platform.test.ts && tsx src/mcp/process/process-sessions.test.ts && tsx src/mcp/server/transport/mcp-sessions.test.ts && tsx src/mcp/server/transport/server-shutdown.test.ts && tsx src/mcp/server/operations/mutation-diagnostics.test.ts && tsx src/mcp/server/operations/mutation-diagnostics-stress.test.ts && tsx src/mcp/server/operations/hooks.test.ts && tsx src/subagents/providers/adapters/codex.test.ts && tsx src/subagents/providers/adapters/pi.test.ts && tsx src/subagents/providers/registry.test.ts && tsx src/subagents/providers/availability.test.ts && tsx src/subagents/profiles.test.ts && tsx src/subagents/cli-target.test.ts && tsx src/subagents/sessions/store.test.ts && tsx src/subagents/sessions/manager.test.ts && tsx src/subagents/sessions/project-trust.test.ts && tsx src/subagents/sessions/mcp/capability.server.test.ts && tsx src/subagents/sessions/mcp/continuation.server.test.ts && tsx src/subagents/sessions/mcp/lifecycle.server.test.ts && tsx src/subagents/sessions/mcp/reconciliation.server.test.ts && tsx src/subagents/sessions/mcp/routing.server.test.ts && tsx src/mcp/filesystem/roots.test.ts && tsx src/mcp/filesystem/file-mutations.test.ts && tsx src/mcp/operations/edit-preflight.test.ts && tsx src/workspaces/resources/skills.test.ts && tsx src/runtime/state/db/migrations.test.ts && tsx src/workspaces/state/workspace-store.test.ts && tsx src/workspaces/tasks/workspace-tasks.test.ts && tsx src/workspaces/tasks/workspace-task-reminders.test.ts && tsx src/activity/history/audit-store.test.ts && tsx src/activity/history/bash-output-store.test.ts && tsx src/activity/runtime/lifecycle.test.ts && tsx src/activity/history/query-service.test.ts && tsx src/mcp/operations/core-operation-executor.test.ts && tsx src/mcp/operations/bulk-mutation.test.ts && tsx src/mcp/operations/batch/scheduler.test.ts && tsx src/mcp/operations/batch/executor-policy.test.ts && tsx src/workspaces.test.ts && tsx src/workspaces/conversation-checkout.test.ts && tsx src/workspaces/conversation-worktree.test.ts && tsx src/workspaces/git/worktree-recovery.test.ts && tsx src/mcp/server/workspace/workspace-inventory.test.ts && tsx src/mcp/server/workspace/workspace-recovery.test.ts && tsx src/mcp/server/workspace/workspace-checkpoint.test.ts && tsx src/workspaces/review/review-checkpoints.test.ts && tsx src/lsp/code-intelligence.server.test.ts && npm run build:app && tsx src/mcp/process/server.test.ts && tsx src/mcp/panel/server.test.ts && tsx src/mcp/server/server.test.ts && tsx src/mcp/oauth/oauth-store.test.ts && tsx src/cli/maintenance.test.ts && tsx src/cli/maintenance-prune.test.ts && tsx src/cli/cli.test.ts",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "release:check": "node scripts/release-version.mjs check",
     "release:tag-check": "node scripts/release-version.mjs tag",

package/scripts/lsp/dev-beta.sh

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+set -euo pipefail
+repo_root="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+cd "$repo_root"
+mkdir -p logs
+node --input-type=module <<'JS' 2>&1 | tee logs/lsp-beta-dev.log
+import assert from "node:assert/strict";
+import { spawn } from "node:child_process";
+import { relative, resolve, sep } from "node:path";
+import { createInteractiveDebugEnvironment, debugRoot } from "./scripts/debug/runtime.mjs";
+import { loadConfig } from "./dist/runtime/config/config.js";
+
+const { configDir, env } = createInteractiveDebugEnvironment();
+const config = loadConfig(env);
+assert.equal(config.port, 7677, "Beta acceptance must use the dedicated dev port 7677.");
+assert.equal(config.host, "127.0.0.1", "Beta acceptance must bind to loopback.");
+const stateRelative = relative(resolve(debugRoot), resolve(config.stateDir));
+assert.ok(stateRelative !== ".." && !stateRelative.startsWith(`..${sep}`) && !stateRelative.startsWith(sep),
+  "Beta acceptance state must stay under .forgerelay-debug/.");
+console.error(`[forgerelay:beta] config: ${configDir}; isolated state: ${config.stateDir}`);
+const child = spawn(process.execPath, ["dist/cli.js", "serve"], { env, stdio: "inherit" });
+for (const signal of ["SIGINT", "SIGTERM"]) process.on(signal, () => child.kill(signal));
+child.on("error", (error) => { console.error(error); process.exitCode = 1; });
+child.on("exit", (code, signal) => {
+  process.exitCode = code ?? (signal ? 1 : 0);
+});
+JS

package/scripts/lsp/interop.mjs

@@ -113,7 +113,8 @@ for (const fixture of fixtures) {
     console.log(`SKIP ${fixture.id}: ${fixture.command} not found on PATH; ForgeRelay does not install Language servers.`);
     continue;
   }
-  const preflight = probeExecutable(executable);
+  // pyright-langserver has no --version mode; verify it with the real LSP requests below.
+  const preflight = fixture.id === "pyright" ? { available: true } : probeExecutable(executable);
   if (!preflight.available) {
     skipped += 1;
     console.log(`SKIP ${fixture.id}: ${executable} is present but not runnable: ${preflight.reason}`);

package/scripts/lsp/mutation-soak.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+set -euo pipefail
+repo_root="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+cd "$repo_root"
+mkdir -p logs
+node --import tsx scripts/lsp/mutation-soak.ts 2>&1 | tee logs/lsp-mutation-http-soak.log

package/scripts/lsp/mutation-soak.ts

@@ -0,0 +1,186 @@
+import assert from "node:assert/strict";
+import { execFile } from "node:child_process";
+import { randomBytes } from "node:crypto";
+import { once } from "node:events";
+import { mkdir, mkdtemp, readFile, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+import { promisify } from "node:util";
+import { Client, StreamableHTTPClientTransport } from "@modelcontextprotocol/client";
+import { createMcpServer } from "../../src/server.js";
+import { createHttpServer } from "../../src/mcp/server/transport/http-server.js";
+import { loadConfig } from "../../src/runtime/config/config.js";
+import type { CodeIntelligenceManager } from "../../src/lsp/runtime/manager.js";
+
+// A disposable dev HTTP instance; never reuse installed configuration or state.
+const base = "http://127.0.0.1:7677";
+const debugRoot = resolve(".forgerelay-debug");
+await mkdir(debugRoot, { recursive: true });
+const root = await mkdtemp(join(debugRoot, "mutation-soak-"));
+const configDir = join(root, "config");
+const project = join(root, "project");
+await mkdir(configDir);
+await mkdir(join(project, ".forgerelay"), { recursive: true });
+// Prevent discovery from inheriting the enclosing ForgeRelay Git project.
+await promisify(execFile)("git", ["init", "--quiet", project]);
+await writeFile(join(configDir, "config.json"), JSON.stringify({
+  host: "127.0.0.1", port: 7677, publicBaseUrl: base,
+  allowedRoots: [root], stateDir: join(root, "state"), worktreeRoot: join(root, "worktrees"),
+  agentDir: join(root, "agent"), subagents: false,
+}));
+const ownerToken = randomBytes(32).toString("base64url");
+const config = loadConfig({
+  PATH: process.env.PATH,
+  FORGERELAY_CONFIG_DIR: configDir,
+  FORGERELAY_OAUTH_OWNER_TOKEN: ownerToken,
+  FORGERELAY_TOOL_MODE: "full",
+  FORGERELAY_WIDGETS: "off",
+  FORGERELAY_SKILLS: "0",
+  FORGERELAY_LOG_SHELL_COMMANDS: "0",
+});
+assert.equal(config.port, 7677);
+assert.equal(config.stateDir, join(root, "state"));
+let manager: CodeIntelligenceManager | undefined;
+const diagnostics = new Map<string, number>();
+const runtime = createHttpServer(config, {}, (...args) => {
+  if (!manager) {
+    manager = args[6];
+    const run = manager.run.bind(manager);
+    manager.run = async (...input) => {
+      const result = await run(...input);
+      if (result.operation === "diagnostics") {
+        diagnostics.set(result.selectedServer, (diagnostics.get(result.selectedServer) ?? 0) + 1);
+      }
+      return result;
+    };
+  }
+  return createMcpServer(...args);
+});
+const http = runtime.app.listen(7677, "127.0.0.1");
+// EADDRINUSE fails the run; this script never stops an existing listener.
+await once(http, "listening");
+const client = new Client({ name: "mutation-soak", version: "1" }, {
+  versionNegotiation: { mode: "legacy" },
+});
+type ToolInput =
+  | { path: string; context?: "full" }
+  | { workspaceId: string; path: string; content: string }
+  | { workspaceId: string; path: string; edits: Array<{ oldText: string; newText: string }> };
+let mutations = 0;
+try {
+  const auth = await fetch(`${base}/auth/cli`, {
+    method: "POST", headers: { "content-type": "application/json" },
+    body: JSON.stringify({ owner_token: ownerToken }),
+  });
+  assert.equal(auth.status, 200);
+  const tokens = await auth.json() as { access_token: string };
+  await client.connect(new StreamableHTTPClientTransport(new URL(`${base}/mcp`), {
+    requestInit: { headers: { Authorization: `Bearer ${tokens.access_token}` } },
+  }));
+  const call = async (name: string, input: ToolInput, signal?: AbortSignal) => {
+    const result = await client.callTool({
+      name, arguments: input, _meta: { "openai/session": "mutation-soak" },
+    }, { signal, timeout: 30_000 });
+    assert.notEqual(result.isError, true, `${name} failed`);
+    return result;
+  };
+  const opened = await call("open_workspace", { path: project, context: "full" });
+  const workspaceId = (opened.structuredContent as { workspaceId: string }).workspaceId;
+  assert.ok(manager);
+  const cleanup = () => (manager as unknown as { closeIdle(now: number): Promise<void> })
+    .closeIdle(Date.now() + 3_600_000);
+  const pyright = join(homedir(), ".forgerelay/language-servers/node_modules/.bin/pyright-langserver");
+  const fake = resolve("src/lsp/test-fixtures/fake-lsp-server.mjs");
+  const cancellationLog = join(root, "cancellation-lsp.jsonl");
+  const languageConfig = (generation: number) => ({
+    pyright: {
+      command: pyright, args: ["--stdio"],
+      languages: ["python"], extensions: [".py"], projectMarkers: ["pyrightconfig.json"],
+      env: { FORGERELAY_SOAK_GENERATION: String(generation) },
+    },
+    capacity: {
+      command: process.execPath, args: [fake],
+      languages: ["typescript"], extensions: [".cap"], projectMarkers: ["capacity.project"],
+      env: { FORGERELAY_FAKE_LSP_DIAGNOSTICS_MODE: "pull" },
+    },
+    cancellation: {
+      command: process.execPath, args: [fake],
+      languages: ["typescript"], extensions: [".cancel"], projectMarkers: [],
+      env: {
+        FORGERELAY_FAKE_LSP_DIAGNOSTICS_MODE: "pull",
+        FORGERELAY_FAKE_LSP_DIAGNOSTIC_DELAY_MS: "1000",
+        FORGERELAY_FAKE_LSP_LOG: cancellationLog,
+      },
+    },
+  });
+  const definitions = join(project, ".forgerelay/language-servers.json");
+  await writeFile(definitions, JSON.stringify(languageConfig(0)));
+  for (let i = 0; i < 3; i++) {
+    await mkdir(join(project, `python-${i}`));
+    await writeFile(join(project, `python-${i}/pyrightconfig.json`), "{}");
+  }
+  const verify = async (result: Awaited<ReturnType<typeof call>>, diagnostic: RegExp) => {
+    const text = result.content.filter(c => c.type === "text").map(c => c.text).join("\n");
+    if (diagnostic.source !== "pyright") assert.match(text, diagnostic);
+    assert.doesNotMatch(text, /diagnostics warning|SIGTERM|start_failed|server_crashed|failed internally/i);
+    mutations++;
+  };
+  for (let round = 0; round < 30; round++) {
+    await Promise.all([0, 1, 2].map(async i => {
+      const path = `python-${i}/main.py`;
+      const oldText = `value: int = "round-${round}"`;
+      await verify(await call("write", { workspaceId, path, content: `${oldText}\n` }), /pyright/);
+      await verify(await call("edit", {
+        workspaceId, path, edits: [{ oldText, newText: `value: int = "edited-${round}"` }],
+      }), /pyright/);
+    }));
+    if (round % 5 === 4) {
+      await writeFile(definitions, JSON.stringify(languageConfig(round)));
+      await cleanup();
+    }
+    assert.equal(diagnostics.get("pyright"), mutations, "each Python mutation must finish real diagnostics");
+    if (round % 10 === 9) console.log(`PASS real Pyright: ${round + 1} rounds, ${mutations} mutations`);
+  }
+  assert.equal(diagnostics.get("pyright"), 180, "every Python mutation must complete real Pyright diagnostics");
+  // Default capacity is sixteen services. Distinct project roots force eviction.
+  for (let i = 0; i < 18; i++) {
+    await mkdir(join(project, `capacity-${i}`));
+    await writeFile(join(project, `capacity-${i}/capacity.project`), "");
+    await verify(await call("write", {
+      workspaceId, path: `capacity-${i}/main.cap`, content: "const value = 1;\n",
+    }), /pulled diagnostic/);
+  }
+  assert.ok(manager.stats().servicesTotal <= 16);
+  assert.equal(diagnostics.get("capacity"), 18);
+  await verify(await call("write", {
+    workspaceId, path: "main.cancel", content: "const value = 1;\n",
+  }), /pulled diagnostic/);
+  const controller = new AbortController();
+  const pendingEdit = call("edit", {
+    workspaceId, path: "main.cancel", edits: [{ oldText: "1", newText: "2" }],
+  }, controller.signal);
+  const cancelled = assert.rejects(pendingEdit, /abort|cancel/i);
+  const deadline = Date.now() + 10_000;
+  while (true) {
+    const log = await readFile(cancellationLog, "utf8");
+    if (log.split('"method":"textDocument/diagnostic"').length >= 3) break;
+    assert.ok(Date.now() < deadline, "cancelled edit must reach automatic diagnostics");
+    await new Promise(resolveWait => setTimeout(resolveWait, 10));
+  }
+  controller.abort();
+  await cancelled;
+  assert.match(await readFile(join(project, "main.cancel"), "utf8"), /value = 2/);
+  await verify(await call("edit", {
+    workspaceId, path: "main.cancel", edits: [{ oldText: "2", newText: "3" }],
+  }), /pulled diagnostic/);
+  await cleanup();
+  assert.equal(manager.stats().servicesTotal, 0);
+  const health = await fetch(`${base}/healthz`);
+  assert.equal(health.status, 200);
+  console.log(`PASS dev HTTP/MCP soak: ${mutations} verified mutations + cancellation; state ${root}`);
+  await writeFile(join(root, "result.json"), JSON.stringify({ mutations, passed: true }));
+} finally {
+  await client.close();
+  await runtime.close();
+  await new Promise<void>((resolveClose, reject) => http.close(error => error ? reject(error) : resolveClose()));
+}

package/scripts/lsp/verify-beta.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+set -euo pipefail
+repo_root="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+cd "$repo_root"
+mkdir -p logs
+npm run release:verify 2>&1 | tee logs/beta-release-verify.log

package/scripts/release/publish.mjs

@@ -40,7 +40,7 @@ if (basename(packagePath) !== expectedPackageName) {
   throw new Error(`unexpected release artifact ${basename(packagePath)}; expected ${expectedPackageName}`);
 }
 
-const npmTag = pkg.version.includes("-rc.") ? "next" : "latest";
+const npmTag = /-(?:rc|beta)\.\d+$/.test(pkg.version) ? "next" : "latest";
 const packageSpec = `${pkg.name}@${pkg.version}`;
 if (npmPackageExists(packageSpec)) {
   console.log(`${packageSpec} is already published; leaving npm unchanged.`);

package/scripts/release/release-version.test.mjs

@@ -110,10 +110,22 @@ test("release version tooling prepares and validates an rc release", async (t) =
 test("release version tooling rejects unsupported prerelease identifiers", async (t) => {
   const root = await createFixture(t);
   await assert.rejects(
-    () => runRelease(root, "prepare", "0.6.0-beta.1"),
+    () => runRelease(root, "prepare", "0.6.0-alpha.1"),
     (error) => {
-      assert.match(String(error.stderr ?? error), /prepare X\.Y\.Z\[-rc\.N\]/);
+      assert.match(String(error.stderr ?? error), /prepare X\.Y\.Z\[-rc\.N\|-beta\.N\]/);
       return true;
     },
   );
 });
+
+test("beta metadata and matching tag require dedicated beta notes", async (t) => {
+  const root = await createFixture(t);
+  await runRelease(root, "prepare", "0.5.8-beta.1");
+  const pkg = JSON.parse(await readFile(join(root, "package.json"), "utf8"));
+  assert.equal(pkg.version, "0.5.8-beta.1");
+  await runRelease(root, "check");
+  await assert.rejects(() => runRelease(root, "tag", "v0.5.8-beta.1"), /missing dedicated release notes/);
+  await writeFile(join(root, "docs", "releases", "v0.5.8-beta.1.md"), "# Beta\n\nBeta notes.\n");
+  const checked = await runRelease(root, "tag", "v0.5.8-beta.1");
+  assert.match(checked.stdout, /release tag v0\.5\.8-beta\.1 matches/);
+});

package/scripts/release-proof.mjs

@@ -135,11 +135,12 @@ function hookTag() {
   }
   const pushCommand = pushMatch[0];
   if (/(?:^|\s)(?:-f|--force(?:-with-lease)?)(?:=\S*)?(?=$|\s)/.test(pushCommand)
-    || /(?:^|\s)\+(?:refs\/tags\/)?v\d+\.\d+\.\d+(?:-rc\.\d+)?(?=$|\s)/.test(pushCommand)) {
+    || /(?:^|\s)\+(?:refs\/tags\/)?v\d+\.\d+\.\d+(?:-(?:rc|beta)\.\d+)?(?=$|\s)/.test(pushCommand)) {
     throw new Error("force push is not allowed for release tags");
   }
   const deleting = /(?:^|\s)(?:-d|--delete)(?=$|\s)/.test(pushCommand);
-  const tagMatch = /(?:^|\s)(?:tag\s+)?(?:refs\/tags\/)?(v\d+\.\d+\.\d+(?:-rc\.\d+)?)(?=$|\s)/.exec(pushCommand);
+  const tagPattern = /(?:^|\s)(?:tag\s+)?(?:refs\/tags\/)?(v\d+\.\d+\.\d+(?:-(?:rc|beta)\.\d+)?)(?=$|\s)/;
+  const tagMatch = tagPattern.exec(pushCommand);
   if (!tagMatch?.[1]) {
     throw new Error("release Hook payload does not contain a release tag push");
   }

package/scripts/release-proof.test.mjs

@@ -231,6 +231,27 @@ test("release tag hook gate accepts an rc tag for the package version", async (t
   assert.match(checked.stdout, /Release tag gate OK: v0\.6\.0-rc\.1/);
 });
 
+test("release tag hook validates beta tags instead of treating them as non-release pushes", async (t) => {
+  const root = await mkdtemp(join(tmpdir(), "forgerelay-beta-proof-"));
+  t.after(() => rm(root, { recursive: true, force: true }));
+  await writeFile(join(root, "package.json"), JSON.stringify({ version: "1.3.6-beta.1" }) + "\n");
+  await mkdir(join(root, "docs", "releases"), { recursive: true });
+  await writeFile(join(root, "docs", "releases", "v1.3.6-beta.1.md"), "# Beta\n\nDedicated beta notes.\n");
+  await git(root, ["init"]);
+  await git(root, ["config", "user.email", "proof@example.com"]);
+  await git(root, ["config", "user.name", "Release Proof Test"]);
+  await git(root, ["add", "."]);
+  await git(root, ["commit", "-m", "release beta"]);
+  await git(root, ["tag", "v1.3.6-beta.1"]);
+  const checked = await runProof(root, "check-hook", {
+    FORGERELAY_HOOK_PAYLOAD: JSON.stringify({ command: "git push origin v1.3.6-beta.1" }),
+  });
+  assert.match(checked.stdout, /Release tag gate OK: v1\.3\.6-beta\.1/);
+  await assert.rejects(() => runProof(root, "check-hook", {
+    FORGERELAY_HOOK_PAYLOAD: JSON.stringify({ command: "git push origin +v1.3.6-beta.1" }),
+  }), /force push is not allowed/);
+});
+
 test("release tag hook gate rejects a mismatched tag without invoking a remote", async (t) => {
   const root = await mkdtemp(join(tmpdir(), "forgerelay-release-proof-"));
   t.after(() => rm(root, { recursive: true, force: true }));

package/scripts/release-version.mjs

@@ -9,7 +9,7 @@ const changelogPath = resolve(repoRoot, "CHANGELOG.md");
 const noticePath = resolve(repoRoot, "NOTICE.md");
 const licensePath = resolve(repoRoot, "LICENSE");
 const stableVersionPattern = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/;
-const releaseVersionPattern = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-rc\.(0|[1-9]\d*))?$/;
+const releaseVersionPattern = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-(?:rc|beta)\.(0|[1-9]\d*))?$/;
 const expectedPackageName = "@akira-tl/forgerelay";
 const expectedRepositoryUrl = "git+https://github.com/Akira-TL/forgerelay.git";
 const expectedHomepage = "https://github.com/Akira-TL/forgerelay#readme";
@@ -27,7 +27,7 @@ switch (command) {
     break;
   case "tag": {
     checkState(state);
-    if (!value) fail("usage: node scripts/release-version.mjs tag vX.Y.Z[-rc.N]");
+    if (!value) fail("usage: node scripts/release-version.mjs tag vX.Y.Z[-rc.N|-beta.N]");
     if (getUnreleasedBody(state.changelog)) {
       fail("CHANGELOG.md still has Unreleased changes; prepare the next version before creating a release tag");
     }
@@ -42,7 +42,7 @@ switch (command) {
   case "prepare": {
     checkState(state);
     if (!value || !releaseVersionPattern.test(value)) {
-      fail("usage: node scripts/release-version.mjs prepare X.Y.Z[-rc.N] [--dry-run]");
+      fail("usage: node scripts/release-version.mjs prepare X.Y.Z[-rc.N|-beta.N] [--dry-run]");
     }
     await prepareRelease(state, value, dryRun);
     break;
@@ -58,10 +58,10 @@ switch (command) {
   }
   case "notes": {
     checkState(state);
-    if (!value) fail("usage: node scripts/release-version.mjs notes vX.Y.Z[-rc.N]");
+    if (!value) fail("usage: node scripts/release-version.mjs notes vX.Y.Z[-rc.N|-beta.N]");
     const version = value.startsWith("v") ? value.slice(1) : value;
     if (!releaseVersionPattern.test(version)) {
-      fail(`release notes version ${JSON.stringify(value)} must be vX.Y.Z[-rc.N] or X.Y.Z[-rc.N]`);
+      fail(`release notes version ${JSON.stringify(value)} must be vX.Y.Z[-rc.N|-beta.N] or X.Y.Z[-rc.N|-beta.N]`);
     }
     const body = getReleaseBody(state.changelog, version);
     if (!body) fail(`CHANGELOG.md has no release notes for ${version}`);
@@ -98,7 +98,7 @@ function checkState(state) {
     fail(`unexpected package name ${JSON.stringify(state.pkg.name)}; expected ${expectedPackageName}`);
   }
   if (typeof version !== "string" || !releaseVersionPattern.test(version)) {
-    fail(`package version ${JSON.stringify(version)} must be X.Y.Z or X.Y.Z-rc.N`);
+    fail(`package version ${JSON.stringify(version)} must be X.Y.Z, X.Y.Z-rc.N or X.Y.Z-beta.N`);
   }
   if (state.pkg.repository?.url !== expectedRepositoryUrl) {
     fail(`package repository.url must be ${expectedRepositoryUrl} for GitHub/npm trusted publishing`);