chore(sync): snapshot local changes

Author: Aitomates

universal-refiner/src/core/ports.ts

@@ -0,0 +1,17 @@
+export const OPERATOR_DASHBOARD_PORT = 3000;
+
+export function resolveDashboardPort(
+  preferred = process.env.PROMPT_REFINER_DASHBOARD_PORT,
+  legacy = process.env.PORT,
+): number {
+  const configured = preferred || legacy;
+  if (!configured) {
+    return OPERATOR_DASHBOARD_PORT;
+  }
+
+  const port = Number.parseInt(configured, 10);
+  if (!Number.isInteger(port) || port < 1 || port > 65_535) {
+    return OPERATOR_DASHBOARD_PORT;
+  }
+  return port;
+}

universal-refiner/tests/ports.test.ts

@@ -0,0 +1,19 @@
+import { describe, expect, it } from "vitest";
+import { OPERATOR_DASHBOARD_PORT, resolveDashboardPort } from "../src/core/ports.js";
+
+describe("dashboard port policy", () => {
+  it("uses the fixed operator dashboard port by default", () => {
+    expect(OPERATOR_DASHBOARD_PORT).toBe(3000);
+    expect(resolveDashboardPort(undefined, undefined)).toBe(3000);
+  });
+
+  it("prefers the named dashboard port over legacy PORT", () => {
+    expect(resolveDashboardPort("3000", "4321")).toBe(3000);
+  });
+
+  it("keeps legacy PORT as a compatibility fallback and rejects invalid values", () => {
+    expect(resolveDashboardPort(undefined, "3999")).toBe(3999);
+    expect(resolveDashboardPort("not-a-port", "3999")).toBe(3000);
+    expect(resolveDashboardPort("70000", undefined)).toBe(3000);
+  });
+});