@linxiraos/pi-utils 1.4.12 → 1.4.13

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 ## [Unreleased]
 
+## [1.4.13] - 2026-11-08
+
+- Released as part of Zeta 1.4.13.
+
 ## [1.4.12] - 2026-11-08
 
 - Synced with upstream OMP v18.18.0.

package/dist/types/dirs.d.ts

@@ -284,18 +284,21 @@ export declare function hashPath(absPath: string): string;
 export declare function getWorktreeDir(segment: string): string;
 /**
  * Get the GitHub view cache database path (~/.zeta/cache/github-cache.db).
- * Honors the `OMP_GITHUB_CACHE_DB` env var when set so tests can isolate the
- * cache file without touching the rest of the config root.
+ * Honors the `ZETA_GITHUB_CACHE_DB` env var (`OMP_GITHUB_CACHE_DB` kept as a
+ * read alias) when set so tests can isolate the cache file without touching
+ * the rest of the config root.
  */
 export declare function getGithubCacheDbPath(): string;
 /**
  * Get the conventional commit inference cache database path (~/.zeta/cache/commit-inference.db).
- * Honors `OMP_COMMIT_CACHE_DB` so tests and operators can isolate the cache.
+ * Honors `ZETA_COMMIT_CACHE_DB` (`OMP_COMMIT_CACHE_DB` kept as a read alias)
+ * so tests and operators can isolate the cache.
  */
 export declare function getCommitCacheDbPath(): string;
 /**
  * Get the judgment answer cache database path (~/.zeta/cache/judgment-cache.db).
- * Honors `OMP_JUDGMENT_CACHE_DB` so tests and operators can isolate the cache.
+ * Honors `ZETA_JUDGMENT_CACHE_DB` (`OMP_JUDGMENT_CACHE_DB` kept as a read
+ * alias) so tests and operators can isolate the cache.
  */
 export declare function getJudgmentCacheDbPath(): string;
 /** Get the legacy Pi extension parse cache database path. */
@@ -421,10 +424,11 @@ export declare function getMCPConfigPath(scope: "user" | "project", cwd?: string
 /** Get the SSH config file path. */
 export declare function getSSHConfigPath(scope: "user" | "project", cwd?: string): string;
 /**
- * Application label for usage attribution (`OMP_APP_NAME`), defaulting to
- * `zeta`. Embedders that drive zeta programmatically (robomp, CI bots, …) set
- * the env var so broker-side per-client burn tracking can answer "what did
- * app X use" instead of folding everything into one install-wide bucket.
+ * Application label for usage attribution (`ZETA_APP_NAME`, with
+ * `OMP_APP_NAME` kept as a read alias), defaulting to `zeta`. Embedders that
+ * drive zeta programmatically (robomp, CI bots, …) set the env var so
+ * broker-side per-client burn tracking can answer "what did app X use" instead
+ * of folding everything into one install-wide bucket.
  */
 export declare function getAppName(): string;
 /**

package/package.json

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

package/src/dirs.ts

@@ -24,6 +24,13 @@ import { isBunTestRuntime } from "./test-runtime";
  * names, provider attribution headers, splash wordmark. NOT the CLI command. */
 export const APP_NAME: string = "zeta";
 
+/** Read `primary`, falling back to the pre-rename `legacy` spelling. */
+function readAliasedEnv(primary: string, legacy: string): string | undefined {
+	const value = process.env[primary]?.trim();
+	if (value) return value;
+	return process.env[legacy]?.trim() || undefined;
+}
+
 /** CLI binary name (`npm i -g @linxiraos/zeta` installs exactly one bin,
  * `zetacode` — the retired `zeta-c`/`zeta-cli` aliases are gone). Every
  * user-facing "run this command" string and process title uses this; the
@@ -971,30 +978,33 @@ export function getWorktreeDir(segment: string): string {
 
 /**
  * Get the GitHub view cache database path (~/.zeta/cache/github-cache.db).
- * Honors the `OMP_GITHUB_CACHE_DB` env var when set so tests can isolate the
- * cache file without touching the rest of the config root.
+ * Honors the `ZETA_GITHUB_CACHE_DB` env var (`OMP_GITHUB_CACHE_DB` kept as a
+ * read alias) when set so tests can isolate the cache file without touching
+ * the rest of the config root.
  */
 export function getGithubCacheDbPath(): string {
-	const override = process.env.OMP_GITHUB_CACHE_DB;
+	const override = readAliasedEnv("ZETA_GITHUB_CACHE_DB", "OMP_GITHUB_CACHE_DB");
 	if (override) return override;
 	return dirs.rootSubdir(path.join("cache", "github-cache.db"), "cache");
 }
 /**
  * Get the conventional commit inference cache database path (~/.zeta/cache/commit-inference.db).
- * Honors `OMP_COMMIT_CACHE_DB` so tests and operators can isolate the cache.
+ * Honors `ZETA_COMMIT_CACHE_DB` (`OMP_COMMIT_CACHE_DB` kept as a read alias)
+ * so tests and operators can isolate the cache.
  */
 export function getCommitCacheDbPath(): string {
-	const override = process.env.OMP_COMMIT_CACHE_DB;
+	const override = readAliasedEnv("ZETA_COMMIT_CACHE_DB", "OMP_COMMIT_CACHE_DB");
 	if (override) return override;
 	return dirs.rootSubdir(path.join("cache", "commit-inference.db"), "cache");
 }
 
 /**
  * Get the judgment answer cache database path (~/.zeta/cache/judgment-cache.db).
- * Honors `OMP_JUDGMENT_CACHE_DB` so tests and operators can isolate the cache.
+ * Honors `ZETA_JUDGMENT_CACHE_DB` (`OMP_JUDGMENT_CACHE_DB` kept as a read
+ * alias) so tests and operators can isolate the cache.
  */
 export function getJudgmentCacheDbPath(): string {
-	const override = process.env.OMP_JUDGMENT_CACHE_DB;
+	const override = readAliasedEnv("ZETA_JUDGMENT_CACHE_DB", "OMP_JUDGMENT_CACHE_DB");
 	if (override) return override;
 	return dirs.rootSubdir(path.join("cache", "judgment-cache.db"), "cache");
 }
@@ -1355,13 +1365,14 @@ let cachedInstallId: string | null = null;
 
 const INSTALL_ID_FILE = "install-id";
 /**
- * Application label for usage attribution (`OMP_APP_NAME`), defaulting to
- * `zeta`. Embedders that drive zeta programmatically (robomp, CI bots, …) set
- * the env var so broker-side per-client burn tracking can answer "what did
- * app X use" instead of folding everything into one install-wide bucket.
+ * Application label for usage attribution (`ZETA_APP_NAME`, with
+ * `OMP_APP_NAME` kept as a read alias), defaulting to `zeta`. Embedders that
+ * drive zeta programmatically (robomp, CI bots, …) set the env var so
+ * broker-side per-client burn tracking can answer "what did app X use" instead
+ * of folding everything into one install-wide bucket.
  */
 export function getAppName(): string {
-	const value = process.env.OMP_APP_NAME?.trim();
+	const value = readAliasedEnv("ZETA_APP_NAME", "OMP_APP_NAME");
 	return value ? value : "zeta";
 }
 

package/src/ptree.ts

@@ -16,8 +16,8 @@ type InMask = "pipe" | "ignore" | Buffer | Uint8Array | null;
 /** A Bun subprocess with stdout/stderr always piped (stdin may vary). */
 type PipedSubprocess<In extends InMask = InMask> = Subprocess<In, "pipe", "pipe">;
 
-const LINUX_SUBREAPER_COMMAND_ENV = "OMP_PTREE_SUBREAPER_COMMAND";
-const LINUX_SUBREAPER_BUN_BE_BUN_ENV = "OMP_PTREE_SUBREAPER_BUN_BE_BUN";
+const LINUX_SUBREAPER_COMMAND_ENV = "ZETA_PTREE_SUBREAPER_COMMAND";
+const LINUX_SUBREAPER_BUN_BE_BUN_ENV = "ZETA_PTREE_SUBREAPER_BUN_BE_BUN";
 const SUBREAPER_KILL_WINDOW_MS = 100;
 const SUBREAPER_KILL_POLL_MS = 5;