@linxiraos/pi-utils 1.4.1 → 1.4.3

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 ## [Unreleased]
 
+## [1.4.3] - 2026-10-25
+
+- Released as part of Zeta 1.4.3; no package-specific user-visible changes.
+
+## [1.4.2] - 2026-10-24
+
+- Added `ZETA_WEB_PORT` (43141), `ZETA_GATEWAY_PORT` (43143) and `ZETA_STATS_PORT` (43147) as the single source for Zeta's local service defaults
+
 ## [1.4.1] - 2026-10-23
 
 - Version alignment with the 1.4.1 release line (no behavioral changes).

package/dist/types/index.d.ts

@@ -22,6 +22,7 @@ export * from "./mermaid-ascii.js";
 export * from "./mime.js";
 export * from "./path.js";
 export * from "./path-tree.js";
+export * from "./ports.js";
 export * from "./peek-file.js";
 export * as postmortem from "./postmortem.js";
 export * from "./process-name.js";

package/dist/types/ports.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Default loopback ports for Zeta's local services.
+ *
+ * OMP installs on the same machine use 30141/30142/3847, and common developer
+ * tools squat on 3000/8080/8787/3847. Zeta therefore owns a dedicated block:
+ * three uncommon ports, at least two apart, so a side-by-side OMP install and
+ * unrelated services cannot take the gateway or the stats dashboard away.
+ *
+ * Every default in the repository derives from these constants. The standalone
+ * Electron shell (`desktop/src/main.ts`, not a Bun workspace package) carries
+ * literals that must match; its serve-discovery test asserts the values.
+ */
+export declare const ZETA_WEB_PORT = 43141;
+export declare const ZETA_GATEWAY_PORT = 43143;
+export declare const ZETA_STATS_PORT = 43147;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@linxiraos/pi-utils",
-	"version": "1.4.1",
+	"version": "1.4.3",
 	"description": "Shared utilities for pi packages",
 	"keywords": [
 		"utilities",
@@ -54,7 +54,7 @@
 		"fmt": "oxfmt --no-error-on-unmatched-pattern 'src/**/*.{ts,tsx}' '{test,bench,examples,scripts}/**/*.ts' '*.ts'"
 	},
 	"dependencies": {
-		"@linxiraos/pi-natives": "1.4.1"
+		"@linxiraos/pi-natives": "1.4.3"
 	},
 	"devDependencies": {
 		"@types/bun": "1.4.3"

package/src/index.ts

@@ -22,6 +22,7 @@ export * from "./mermaid-ascii";
 export * from "./mime";
 export * from "./path";
 export * from "./path-tree";
+export * from "./ports";
 export * from "./peek-file";
 export * as postmortem from "./postmortem";
 export * from "./process-name";

package/src/ports.ts

@@ -0,0 +1,15 @@
+/**
+ * Default loopback ports for Zeta's local services.
+ *
+ * OMP installs on the same machine use 30141/30142/3847, and common developer
+ * tools squat on 3000/8080/8787/3847. Zeta therefore owns a dedicated block:
+ * three uncommon ports, at least two apart, so a side-by-side OMP install and
+ * unrelated services cannot take the gateway or the stats dashboard away.
+ *
+ * Every default in the repository derives from these constants. The standalone
+ * Electron shell (`desktop/src/main.ts`, not a Bun workspace package) carries
+ * literals that must match; its serve-discovery test asserts the values.
+ */
+export const ZETA_WEB_PORT = 43141;
+export const ZETA_GATEWAY_PORT = 43143;
+export const ZETA_STATS_PORT = 43147;