@hoox-sh/hoox-shared 1.2.0 → 1.3.0

package/dist/kill-switch.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Copyright (c) 2026 HOOX · HOOX · jango-blockchained (hoox-sh)
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/** Prefix for trade-worker kill-switch error messages (message.startsWith checks). */
+export declare const KILL_SWITCH_ACTIVE_PREFIX = "KILL_SWITCH_ACTIVE";
+export declare const KILL_SWITCH_KEYS: readonly ["trade:kill_switch", "global:kill_switch"];
+/**
+ * Truthy kill-switch flag values (case-insensitive, trimmed):
+ * true, 1, yes, on
+ */
+export declare function isTruthyKillSwitchFlag(value: string | null | undefined): boolean;
+export type KillSwitchFailMode = "open" | "closed";
+export interface KillSwitchResult {
+    enabled: boolean;
+    source?: string;
+    error?: string;
+}
+export interface CheckKillSwitchOptions {
+    /**
+     * When CONFIG_KV is missing.
+     * Default "open" (gateway/dev). Trade-worker should pass "closed".
+     */
+    onMissingKv?: KillSwitchFailMode;
+    /**
+     * When KV get throws.
+     * Default "closed" for safety (stricter than the gateway's historical fail-open).
+     */
+    onReadError?: KillSwitchFailMode;
+}
+/** Minimal KV surface used by kill-switch checks (avoids workers-types dependency). */
+export type KillSwitchKv = {
+    get(key: string): Promise<string | null>;
+};
+/**
+ * Read both kill-switch keys in parallel. If any value is truthy, trading is paused.
+ *
+ * Fail modes:
+ * - Missing kv → enabled iff onMissingKv === "closed" (source: "missing_kv")
+ * - Read error → enabled iff onReadError === "closed"
+ */
+export declare function checkKillSwitch(kv: KillSwitchKv | undefined | null, options?: CheckKillSwitchOptions): Promise<KillSwitchResult>;
+/**
+ * Convenience boolean wrapper around {@link checkKillSwitch}.
+ */
+export declare function isTradingPaused(kv: KillSwitchKv | undefined | null, options?: CheckKillSwitchOptions): Promise<boolean>;
+//# sourceMappingURL=kill-switch.d.ts.map

package/dist/kill-switch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kill-switch.d.ts","sourceRoot":"","sources":["../src/kill-switch.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAeH,sFAAsF;AACtF,eAAO,MAAM,yBAAyB,uBAAuB,CAAC;AAE9D,eAAO,MAAM,gBAAgB,sDAGnB,CAAC;AAEX;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,OAAO,CAIT;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEnD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC;;;OAGG;IACH,WAAW,CAAC,EAAE,kBAAkB,CAAC;CAClC;AAED,uFAAuF;AACvF,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC1C,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,EAAE,EAAE,YAAY,GAAG,SAAS,GAAG,IAAI,EACnC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,gBAAgB,CAAC,CAiC3B;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,EAAE,EAAE,YAAY,GAAG,SAAS,GAAG,IAAI,EACnC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,OAAO,CAAC,CAGlB"}

package/dist/kill-switch.js

@@ -0,0 +1,130 @@
+// @bun
+var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+
+// src/kvKeys.ts
+var KV_TRADE_DEFAULT_LEVERAGE = "trade:default_leverage";
+var KV_TRADE_MAX_POSITION_SIZE = "trade:max_position_size";
+var KV_TRADE_MAX_DAILY_DRAWDOWN_PERCENT = "trade:max_daily_drawdown_percent";
+var KV_TRADE_TRAILING_STOP_PERCENT = "trade:trailing_stop_percent";
+var KV_TRADE_KILL_SWITCH = "trade:kill_switch";
+var KV_TRADE_ROUTING = "trade:routing";
+var KV_BOT_ENABLED = "bot:enabled";
+var KV_BOT_DEFAULT_CHAT_ID = "bot:default_chat_id";
+var KV_BOT_NOTIFY_ON_EXECUTION = "bot:notify_on_execution";
+var KV_BOT_NOTIFY_ON_ERROR = "bot:notify_on_error";
+var KV_WEBHOOK_IP_CHECK_ENABLED = "webhook:tradingview:ip_check_enabled";
+var KV_WEBHOOK_ALLOWED_IPS = "webhook:tradingview:allowed_ips";
+var KV_WEBHOOK_QUEUE_MODE = "webhook:queue_mode";
+var KV_EMAIL_SCAN_SUBJECT = "email:scan_subject";
+var KV_EMAIL_USE_IMAP = "email:use_imap";
+var KV_EMAIL_COIN_PATTERN = "email:coin_pattern";
+var KV_EMAIL_ACTION_PATTERN = "email:action_pattern";
+var KV_EMAIL_QUANTITY_MULTIPLIER = "email:quantity_multiplier";
+var KV_AGENT_CONFIG = "agent:config";
+var KV_AGENT_OPENAI_KEY = "agent:openai_key";
+var KV_AGENT_ANTHROPIC_KEY = "agent:anthropic_key";
+var KV_AGENT_GOOGLE_KEY = "agent:google_key";
+var KV_DASHBOARD_AI_HEALTH_SUMMARY = "dashboard:ai_health_summary";
+var KV_GLOBAL_KILL_SWITCH = "global:kill_switch";
+var KV_HEALTH_CHECK = "health_check";
+var KV_HOUSEKEEPING_LAST_CHECK = "housekeeping:last_check";
+var QUEUE_MODE_FAILOVER = "queue_failover";
+var QUEUE_MODE_EVERYWHERE = "queue_everywhere";
+var QUEUE_MODE_DISABLED = "queue_disabled";
+var KVKeys = {
+  KV_TRADE_DEFAULT_LEVERAGE,
+  KV_TRADE_MAX_POSITION_SIZE,
+  KV_TRADE_MAX_DAILY_DRAWDOWN_PERCENT,
+  KV_TRADE_TRAILING_STOP_PERCENT,
+  KV_TRADE_KILL_SWITCH,
+  KV_TRADE_ROUTING,
+  KV_BOT_ENABLED,
+  KV_BOT_DEFAULT_CHAT_ID,
+  KV_BOT_NOTIFY_ON_EXECUTION,
+  KV_BOT_NOTIFY_ON_ERROR,
+  KV_WEBHOOK_IP_CHECK_ENABLED,
+  KV_WEBHOOK_ALLOWED_IPS,
+  KV_WEBHOOK_QUEUE_MODE,
+  KV_EMAIL_SCAN_SUBJECT,
+  KV_EMAIL_USE_IMAP,
+  KV_EMAIL_COIN_PATTERN,
+  KV_EMAIL_ACTION_PATTERN,
+  KV_EMAIL_QUANTITY_MULTIPLIER,
+  KV_AGENT_CONFIG,
+  KV_AGENT_OPENAI_KEY,
+  KV_AGENT_ANTHROPIC_KEY,
+  KV_AGENT_GOOGLE_KEY,
+  KV_DASHBOARD_AI_HEALTH_SUMMARY,
+  KV_GLOBAL_KILL_SWITCH,
+  KV_HEALTH_CHECK,
+  KV_HOUSEKEEPING_LAST_CHECK,
+  QUEUE_MODE_FAILOVER,
+  QUEUE_MODE_EVERYWHERE,
+  QUEUE_MODE_DISABLED
+};
+
+// src/kill-switch.ts
+var KILL_SWITCH_ACTIVE_PREFIX = "KILL_SWITCH_ACTIVE";
+var KILL_SWITCH_KEYS = [
+  KV_TRADE_KILL_SWITCH,
+  KV_GLOBAL_KILL_SWITCH
+];
+function isTruthyKillSwitchFlag(value) {
+  if (value == null)
+    return false;
+  const v = value.trim().toLowerCase();
+  return v === "true" || v === "1" || v === "yes" || v === "on";
+}
+async function checkKillSwitch(kv, options) {
+  const onMissingKv = options?.onMissingKv ?? "open";
+  const onReadError = options?.onReadError ?? "closed";
+  if (!kv) {
+    if (onMissingKv === "closed") {
+      return { enabled: true, source: "missing_kv" };
+    }
+    return { enabled: false };
+  }
+  try {
+    const values = await Promise.all(KILL_SWITCH_KEYS.map(async (key) => ({
+      key,
+      value: await kv.get(key)
+    })));
+    for (const { key, value } of values) {
+      if (isTruthyKillSwitchFlag(value)) {
+        return { enabled: true, source: key };
+      }
+    }
+    return { enabled: false };
+  } catch (error) {
+    const errorStr = String(error);
+    if (onReadError === "closed") {
+      return { enabled: true, source: "read_error", error: errorStr };
+    }
+    return { enabled: false, error: errorStr };
+  }
+}
+async function isTradingPaused(kv, options) {
+  const result = await checkKillSwitch(kv, options);
+  return result.enabled;
+}
+export {
+  isTruthyKillSwitchFlag,
+  isTradingPaused,
+  checkKillSwitch,
+  KILL_SWITCH_KEYS,
+  KILL_SWITCH_ACTIVE_PREFIX
+};

package/dist/kvKeys.d.ts

@@ -38,6 +38,7 @@ export declare const KV_AGENT_OPENAI_KEY = "agent:openai_key";
 export declare const KV_AGENT_ANTHROPIC_KEY = "agent:anthropic_key";
 export declare const KV_AGENT_GOOGLE_KEY = "agent:google_key";
 export declare const KV_DASHBOARD_AI_HEALTH_SUMMARY = "dashboard:ai_health_summary";
+export declare const KV_GLOBAL_KILL_SWITCH = "global:kill_switch";
 export declare const KV_HEALTH_CHECK = "health_check";
 export declare const KV_HOUSEKEEPING_LAST_CHECK = "housekeeping:last_check";
 export declare const QUEUE_MODE_FAILOVER = "queue_failover";
@@ -67,6 +68,7 @@ export declare const KVKeys: {
     KV_AGENT_ANTHROPIC_KEY: string;
     KV_AGENT_GOOGLE_KEY: string;
     KV_DASHBOARD_AI_HEALTH_SUMMARY: string;
+    KV_GLOBAL_KILL_SWITCH: string;
     KV_HEALTH_CHECK: string;
     KV_HOUSEKEEPING_LAST_CHECK: string;
     QUEUE_MODE_FAILOVER: string;

package/dist/kvKeys.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kvKeys.d.ts","sourceRoot":"","sources":["../src/kvKeys.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;GAYG;AAGH,eAAO,MAAM,yBAAyB,2BAA2B,CAAC;AAClE,eAAO,MAAM,0BAA0B,4BAA4B,CAAC;AACpE,eAAO,MAAM,mCAAmC,qCACZ,CAAC;AACrC,eAAO,MAAM,8BAA8B,gCAAgC,CAAC;AAC5E,eAAO,MAAM,oBAAoB,sBAAsB,CAAC;AACxD,eAAO,MAAM,gBAAgB,kBAAkB,CAAC;AAGhD,eAAO,MAAM,cAAc,gBAAgB,CAAC;AAC5C,eAAO,MAAM,sBAAsB,wBAAwB,CAAC;AAC5D,eAAO,MAAM,0BAA0B,4BAA4B,CAAC;AACpE,eAAO,MAAM,sBAAsB,wBAAwB,CAAC;AAG5D,eAAO,MAAM,2BAA2B,yCACA,CAAC;AACzC,eAAO,MAAM,sBAAsB,oCAAoC,CAAC;AACxE,eAAO,MAAM,qBAAqB,uBAAuB,CAAC;AAG1D,eAAO,MAAM,qBAAqB,uBAAuB,CAAC;AAC1D,eAAO,MAAM,iBAAiB,mBAAmB,CAAC;AAClD,eAAO,MAAM,qBAAqB,uBAAuB,CAAC;AAC1D,eAAO,MAAM,uBAAuB,yBAAyB,CAAC;AAC9D,eAAO,MAAM,4BAA4B,8BAA8B,CAAC;AAGxE,eAAO,MAAM,eAAe,iBAAiB,CAAC;AAC9C,eAAO,MAAM,mBAAmB,qBAAqB,CAAC;AACtD,eAAO,MAAM,sBAAsB,wBAAwB,CAAC;AAC5D,eAAO,MAAM,mBAAmB,qBAAqB,CAAC;AAGtD,eAAO,MAAM,8BAA8B,gCAAgC,CAAC;AAG5E,eAAO,MAAM,eAAe,iBAAiB,CAAC;AAC9C,eAAO,MAAM,0BAA0B,4BAA4B,CAAC;AAGpE,eAAO,MAAM,mBAAmB,mBAAmB,CAAC;AACpD,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AACxD,eAAO,MAAM,mBAAmB,mBAAmB,CAAC;AAKpD,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BlB,CAAC"}
+{"version":3,"file":"kvKeys.d.ts","sourceRoot":"","sources":["../src/kvKeys.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;GAYG;AAGH,eAAO,MAAM,yBAAyB,2BAA2B,CAAC;AAClE,eAAO,MAAM,0BAA0B,4BAA4B,CAAC;AACpE,eAAO,MAAM,mCAAmC,qCACZ,CAAC;AACrC,eAAO,MAAM,8BAA8B,gCAAgC,CAAC;AAC5E,eAAO,MAAM,oBAAoB,sBAAsB,CAAC;AACxD,eAAO,MAAM,gBAAgB,kBAAkB,CAAC;AAGhD,eAAO,MAAM,cAAc,gBAAgB,CAAC;AAC5C,eAAO,MAAM,sBAAsB,wBAAwB,CAAC;AAC5D,eAAO,MAAM,0BAA0B,4BAA4B,CAAC;AACpE,eAAO,MAAM,sBAAsB,wBAAwB,CAAC;AAG5D,eAAO,MAAM,2BAA2B,yCACA,CAAC;AACzC,eAAO,MAAM,sBAAsB,oCAAoC,CAAC;AACxE,eAAO,MAAM,qBAAqB,uBAAuB,CAAC;AAG1D,eAAO,MAAM,qBAAqB,uBAAuB,CAAC;AAC1D,eAAO,MAAM,iBAAiB,mBAAmB,CAAC;AAClD,eAAO,MAAM,qBAAqB,uBAAuB,CAAC;AAC1D,eAAO,MAAM,uBAAuB,yBAAyB,CAAC;AAC9D,eAAO,MAAM,4BAA4B,8BAA8B,CAAC;AAGxE,eAAO,MAAM,eAAe,iBAAiB,CAAC;AAC9C,eAAO,MAAM,mBAAmB,qBAAqB,CAAC;AACtD,eAAO,MAAM,sBAAsB,wBAAwB,CAAC;AAC5D,eAAO,MAAM,mBAAmB,qBAAqB,CAAC;AAGtD,eAAO,MAAM,8BAA8B,gCAAgC,CAAC;AAG5E,eAAO,MAAM,qBAAqB,uBAAuB,CAAC;AAC1D,eAAO,MAAM,eAAe,iBAAiB,CAAC;AAC9C,eAAO,MAAM,0BAA0B,4BAA4B,CAAC;AAGpE,eAAO,MAAM,mBAAmB,mBAAmB,CAAC;AACpD,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AACxD,eAAO,MAAM,mBAAmB,mBAAmB,CAAC;AAKpD,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BlB,CAAC"}

package/dist/kvKeys.js

@@ -39,6 +39,7 @@ var KV_AGENT_OPENAI_KEY = "agent:openai_key";
 var KV_AGENT_ANTHROPIC_KEY = "agent:anthropic_key";
 var KV_AGENT_GOOGLE_KEY = "agent:google_key";
 var KV_DASHBOARD_AI_HEALTH_SUMMARY = "dashboard:ai_health_summary";
+var KV_GLOBAL_KILL_SWITCH = "global:kill_switch";
 var KV_HEALTH_CHECK = "health_check";
 var KV_HOUSEKEEPING_LAST_CHECK = "housekeeping:last_check";
 var QUEUE_MODE_FAILOVER = "queue_failover";
@@ -68,6 +69,7 @@ var KVKeys = {
   KV_AGENT_ANTHROPIC_KEY,
   KV_AGENT_GOOGLE_KEY,
   KV_DASHBOARD_AI_HEALTH_SUMMARY,
+  KV_GLOBAL_KILL_SWITCH,
   KV_HEALTH_CHECK,
   KV_HOUSEKEEPING_LAST_CHECK,
   QUEUE_MODE_FAILOVER,
@@ -89,6 +91,7 @@ export {
   KV_TRADE_DEFAULT_LEVERAGE,
   KV_HOUSEKEEPING_LAST_CHECK,
   KV_HEALTH_CHECK,
+  KV_GLOBAL_KILL_SWITCH,
   KV_EMAIL_USE_IMAP,
   KV_EMAIL_SCAN_SUBJECT,
   KV_EMAIL_QUANTITY_MULTIPLIER,

package/dist/operator-transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"operator-transport.d.ts","sourceRoot":"","sources":["../src/operator-transport.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AAExE,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,iBAAiB,CAAC;IAC7B,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,4CAA4C;IAC5C,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACnC;AAwBD,MAAM,WAAW,+BAA+B;IAC9C;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,GAAG,GAAE,oBAA0D,EAC/D,OAAO,GAAE,+BAAoC,GAC5C,wBAAwB,CAyB1B;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,wBAAwB,GAChC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAuBxB;AAED,qEAAqE;AACrE,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAGT;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,wBAAwB,EACjC,IAAI,EAAE,MAAM,GACX,MAAM,CAIR"}
+{"version":3,"file":"operator-transport.d.ts","sourceRoot":"","sources":["../src/operator-transport.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AAExE,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,iBAAiB,CAAC;IAC7B,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,4CAA4C;IAC5C,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACnC;AA6BD,MAAM,WAAW,+BAA+B;IAC9C;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,GAAG,GAAE,oBAA0D,EAC/D,OAAO,GAAE,+BAAoC,GAC5C,wBAAwB,CAyB1B;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,wBAAwB,GAChC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAuBxB;AAED,qEAAqE;AACrE,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAGT;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,wBAAwB,EACjC,IAAI,EAAE,MAAM,GACX,MAAM,CAIR"}

package/dist/operator-transport.js

@@ -17,7 +17,11 @@ var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 
 // src/operator-transport.ts
 function stripTrailingSlashes(url) {
-  return url.replace(/\/+$/, "");
+  let end = url.length;
+  while (end > 0 && url.charCodeAt(end - 1) === 47) {
+    end -= 1;
+  }
+  return end === url.length ? url : url.slice(0, end);
 }
 function parseTransport(raw) {
   if (!raw)
@@ -64,7 +68,7 @@ function hasOperatorClientCredentials(profile) {
   return Boolean(profile.accessClientId && profile.accessClientSecret);
 }
 function operatorUrl(profile, path) {
-  const base = profile.apiBase.replace(/\/+$/, "");
+  const base = stripTrailingSlashes(profile.apiBase);
   const p = path.startsWith("/") ? path : `/${path}`;
   return `${base}${p}`;
 }

package/dist/path-utils.d.ts

@@ -10,7 +10,7 @@ export type HooxPath = string & {
     readonly __brand: "HooxPath";
 };
 /** Where resolveHooxRuntimeRoot found (or failed to find) a setup monorepo. */
-export type RuntimeRootSource = "env" | "cwd" | "global" | "none";
+export type RuntimeRootSource = "env" | "cwd" | "remembered" | "global" | "none";
 /** Result of resolveHooxRuntimeRoot(). */
 export interface RuntimeRootResult {
     /** Absolute monorepo root, or null if none found. */
@@ -21,9 +21,17 @@ export interface RuntimeRootResult {
     checked: {
         env?: string;
         cwd: string | null;
+        remembered?: string | null;
         global: string;
     };
 }
+/** Persisted monorepo pointer written when the CLI discovers a checkout. */
+export interface RememberedMonorepo {
+    /** Absolute path to monorepo root. */
+    root: string;
+    /** ISO timestamp of last successful remember. */
+    updatedAt: string;
+}
 /**
  * Gets the Hoox home directory location: $HOME/.hoox
  *
@@ -48,9 +56,29 @@ export declare function getHooxHome(): HooxPath;
 /**
  * True when `dir` looks like a hoox monorepo root.
  *
- * Markers match CLI verifyRepoRoot: root wrangler.jsonc + packages/cli package.
+ * Aligns with CLI `verifyRepoRoot`:
+ *   - Required: `packages/cli/package.json`
+ *   - Plus one of: `wrangler.jsonc`, `wrangler.jsonc.example`, `workers/`, `.gitmodules`
+ *
+ * (`wrangler.jsonc` is gitignored and created by init — fresh clones only
+ * ship `wrangler.jsonc.example`.)
  */
 export declare function isHooxSetupRoot(dir: string): boolean;
+/**
+ * Path to the remembered monorepo pointer file.
+ * `$HOOX_HOME/config/monorepo.json` (default `~/.hoox/config/monorepo.json`).
+ */
+export declare function getRememberedMonorepoPath(): HooxPath;
+/**
+ * Read the last monorepo path the CLI discovered (if still valid).
+ * Returns null when missing, unreadable, or no longer a setup root.
+ */
+export declare function getRememberedMonorepoRoot(): string | null;
+/**
+ * Persist a monorepo root for future CLI invocations from any cwd.
+ * No-op when path is not a valid setup root.
+ */
+export declare function rememberMonorepoRoot(root: string): boolean;
 /**
  * Walk up from `startDir` looking for a hoox monorepo root.
  *
@@ -63,14 +91,17 @@ export declare function findHooxSetupRoot(startDir?: string): string | null;
  * Order:
  *   1. HOOX_REPO — must pass isHooxSetupRoot or result is source "env" with root null
  *   2. Walk up from cwd
- *   3. getHooxRepoPath() ($HOME/.hoox/repo or $HOOX_HOME/repo)
+ *   3. Remembered monorepo (~/.hoox/config/monorepo.json) — last discovered checkout
+ *   4. getHooxRepoPath() ($HOME/.hoox/repo or $HOOX_HOME/repo)
  *
  * Project cwd and tool root are intentionally separate: a random project
- * directory can still use the global runtime for TUI / templates.
+ * directory can still use a remembered or global monorepo for CLI ops.
  */
 export declare function resolveHooxRuntimeRoot(options?: {
     cwd?: string;
     env?: NodeJS.ProcessEnv;
+    /** Skip reading remembered path (tests). Default false. */
+    skipRemembered?: boolean;
 }): RuntimeRootResult;
 /**
  * Candidate TUI entry files under a monorepo root (source first, then dist).

package/dist/path-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"path-utils.d.ts","sourceRoot":"","sources":["../src/path-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA0BH;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAA;CAAE,CAAC;AAEjE,+EAA+E;AAC/E,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAElE,0CAA0C;AAC1C,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,iDAAiD;IACjD,MAAM,EAAE,iBAAiB,CAAC;IAC1B,qDAAqD;IACrD,OAAO,EAAE;QACP,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAUD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAgBtC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAWpD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,GAAE,MAAsB,GAC/B,MAAM,GAAG,IAAI,CAQf;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE;IAC/C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB,GAAG,iBAAiB,CAoDpB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAOnE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,QAAQ,CAiC9D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAStD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkBvE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,IAAI,QAAQ,CAE1C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,IAAI,QAAQ,CAE3C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,IAAI,QAAQ,CAEzC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,IAAI,QAAQ,CAE9C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,IAAI,QAAQ,CAE3C"}
+{"version":3,"file":"path-utils.d.ts","sourceRoot":"","sources":["../src/path-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkCH;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAA;CAAE,CAAC;AAEjE,+EAA+E;AAC/E,MAAM,MAAM,iBAAiB,GACzB,KAAK,GACL,KAAK,GACL,YAAY,GACZ,QAAQ,GACR,MAAM,CAAC;AAEX,0CAA0C;AAC1C,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,iDAAiD;IACjD,MAAM,EAAE,iBAAiB,CAAC;IAC1B,qDAAqD;IACrD,OAAO,EAAE;QACP,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,4EAA4E;AAC5E,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;CACnB;AAUD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAgBtC;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAgBpD;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,QAAQ,CAEpD;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,GAAG,IAAI,CAYzD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CA4B1D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,GAAE,MAAsB,GAC/B,MAAM,GAAG,IAAI,CAQf;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE;IAC/C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,2DAA2D;IAC3D,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,GAAG,iBAAiB,CAiEpB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAOnE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,QAAQ,CAiC9D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAStD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkBvE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,IAAI,QAAQ,CAE1C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,IAAI,QAAQ,CAE3C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,IAAI,QAAQ,CAEzC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,IAAI,QAAQ,CAE9C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,IAAI,QAAQ,CAE3C"}

package/dist/path-utils.js

@@ -16,7 +16,13 @@ var __export = (target, all) => {
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 
 // src/path-utils.ts
-import { existsSync } from "fs";
+import {
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  writeFileSync,
+  chmodSync
+} from "fs";
 import { homedir } from "os";
 import { dirname, join, resolve } from "path";
 function createHooxPath(path) {
@@ -42,7 +48,55 @@ function isHooxSetupRoot(dir) {
     return false;
   try {
     const root = resolve(dir);
-    return existsSync(join(root, "wrangler.jsonc")) && existsSync(join(root, "packages", "cli", "package.json"));
+    if (!existsSync(join(root, "packages", "cli", "package.json"))) {
+      return false;
+    }
+    return existsSync(join(root, "wrangler.jsonc")) || existsSync(join(root, "wrangler.jsonc.example")) || existsSync(join(root, "workers")) || existsSync(join(root, ".gitmodules"));
+  } catch {
+    return false;
+  }
+}
+function getRememberedMonorepoPath() {
+  return resolveHooxPath("config/monorepo.json");
+}
+function getRememberedMonorepoRoot() {
+  try {
+    const path = getRememberedMonorepoPath();
+    if (!existsSync(path))
+      return null;
+    const raw = readFileSync(path, "utf-8");
+    const data = JSON.parse(raw);
+    if (!data.root || typeof data.root !== "string")
+      return null;
+    const resolved = resolve(data.root);
+    return isHooxSetupRoot(resolved) ? resolved : null;
+  } catch {
+    return null;
+  }
+}
+function rememberMonorepoRoot(root) {
+  try {
+    const resolved = resolve(root);
+    if (!isHooxSetupRoot(resolved))
+      return false;
+    const configDir = getHooxConfigDir();
+    mkdirSync(configDir, { recursive: true, mode: 448 });
+    try {
+      chmodSync(configDir, 448);
+    } catch {}
+    const payload = {
+      root: resolved,
+      updatedAt: new Date().toISOString()
+    };
+    const path = getRememberedMonorepoPath();
+    writeFileSync(path, JSON.stringify(payload, null, 2) + `
+`, {
+      mode: 384
+    });
+    try {
+      chmodSync(path, 384);
+    } catch {}
+    return true;
   } catch {
     return false;
   }
@@ -62,6 +116,7 @@ function resolveHooxRuntimeRoot(options) {
   const env = options?.env ?? process.env;
   const cwd = resolve(options?.cwd ?? process.cwd());
   const globalRepo = getHooxRepoPath();
+  const remembered = options?.skipRemembered ? null : getRememberedMonorepoRoot();
   const envRepo = env.HOOX_REPO?.trim();
   if (envRepo) {
     const resolved = resolve(envRepo);
@@ -72,6 +127,7 @@ function resolveHooxRuntimeRoot(options) {
         checked: {
           env: resolved,
           cwd: findHooxSetupRoot(cwd),
+          remembered,
           global: globalRepo
         }
       };
@@ -82,6 +138,7 @@ function resolveHooxRuntimeRoot(options) {
       checked: {
         env: resolved,
         cwd: findHooxSetupRoot(cwd),
+        remembered,
         global: globalRepo
       }
     };
@@ -91,20 +148,27 @@ function resolveHooxRuntimeRoot(options) {
     return {
       root: local,
       source: "cwd",
-      checked: { cwd: local, global: globalRepo }
+      checked: { cwd: local, remembered, global: globalRepo }
+    };
+  }
+  if (remembered) {
+    return {
+      root: remembered,
+      source: "remembered",
+      checked: { cwd: null, remembered, global: globalRepo }
     };
   }
   if (isHooxSetupRoot(globalRepo)) {
     return {
       root: globalRepo,
       source: "global",
-      checked: { cwd: null, global: globalRepo }
+      checked: { cwd: null, remembered: null, global: globalRepo }
     };
   }
   return {
     root: null,
     source: "none",
-    checked: { cwd: null, global: globalRepo }
+    checked: { cwd: null, remembered: null, global: globalRepo }
   };
 }
 function getTuiEntryCandidates(runtimeRoot) {
@@ -174,9 +238,12 @@ function getHooxStatePath() {
 export {
   resolveHooxRuntimeRoot,
   resolveHooxPath,
+  rememberMonorepoRoot,
   isWithinHooxHome,
   isHooxSetupRoot,
   getTuiEntryCandidates,
+  getRememberedMonorepoRoot,
+  getRememberedMonorepoPath,
   getRelativeHooxPath,
   getHooxWranglerPath,
   getHooxStatePath,

package/dist/service-bindings.d.ts

@@ -27,7 +27,7 @@ export declare const D1_READ_AUTH_KEY_FIELDS: readonly ["D1_READ_KEY_BINDING", "
 export declare const D1_WRITE_AUTH_KEY_FIELDS: readonly ["D1_WRITE_KEY_BINDING", "INTERNAL_KEY_BINDING"];
 /** trade-worker execute routes (/webhook, /process, POST /api/signals). */
 export declare const TRADE_EXECUTE_AUTH_KEY_FIELDS: readonly ["TRADE_EXECUTE_KEY_BINDING", "INTERNAL_KEY_BINDING", "AGENT_INTERNAL_KEY"];
-/** trade-worker read routes (GET /api/signals, GET /report). */
+/** trade-worker read routes (GET /api/signals, GET /api/system-logs, GET /report). */
 export declare const TRADE_READ_AUTH_KEY_FIELDS: readonly ["TRADE_READ_KEY_BINDING", "INTERNAL_KEY_BINDING"];
 /** telegram-worker /alert notification endpoint. */
 export declare const TELEGRAM_ALERT_AUTH_KEY_FIELDS: readonly ["TELEGRAM_INTERNAL_KEY_BINDING", "INTERNAL_KEY_BINDING"];

package/dist/service-bindings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service-bindings.d.ts","sourceRoot":"","sources":["../src/service-bindings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAmB,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE9E,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CACzE;AAED,uDAAuD;AACvD,eAAO,MAAM,qBAAqB;;;;;;;;;IAShC,sDAAsD;;;;CAI9C,CAAC;AAEX,iFAAiF;AACjF,eAAO,MAAM,uBAAuB,0DAG1B,CAAC;AAEX,kFAAkF;AAClF,eAAO,MAAM,wBAAwB,2DAG3B,CAAC;AAEX,2EAA2E;AAC3E,eAAO,MAAM,6BAA6B,sFAIhC,CAAC;AAEX,gEAAgE;AAChE,eAAO,MAAM,0BAA0B,6DAG7B,CAAC;AAEX,oDAAoD;AACpD,eAAO,MAAM,8BAA8B,oEAGjC,CAAC;AAEX,4CAA4C;AAC5C,eAAO,MAAM,8BAA8B,iEAGjC,CAAC;AAEX,wEAAwE;AACxE,eAAO,MAAM,iCAAiC,6EAIpC,CAAC;AAEX,8CAA8C;AAC9C,eAAO,MAAM,uCAAuC,sFAI1C,CAAC;AAEX,gDAAgD;AAChD,eAAO,MAAM,wCAAwC,6FAI3C,CAAC;AAEX,0DAA0D;AAC1D,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,mBAAmB,GAC7B,MAAM,GAAG,SAAS,CAEpB;AAED,MAAM,WAAW,uBAAuB;IACtC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,6BAA6B,CAAC,EAAE,MAAM,CAAC;IACvC,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,uBAAuB,EACzE,OAAO,EAAE,cAAc,EACvB,GAAG,EAAE,CAAC,EACN,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE;IACR,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,iBAAiB,CAAC,EAAE,mBAAmB,CAAC;CACzC,GACA,OAAO,CAAC,QAAQ,CAAC,CAsBnB;AAED,wBAAgB,YAAY,CAC1B,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE;IACR,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACA,OAAO,CAAC,QAAQ,CAAC,CAWnB"}
+{"version":3,"file":"service-bindings.d.ts","sourceRoot":"","sources":["../src/service-bindings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAmB,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE9E,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CACzE;AAED,uDAAuD;AACvD,eAAO,MAAM,qBAAqB;;;;;;;;;IAShC,sDAAsD;;;;CAI9C,CAAC;AAEX,iFAAiF;AACjF,eAAO,MAAM,uBAAuB,0DAG1B,CAAC;AAEX,kFAAkF;AAClF,eAAO,MAAM,wBAAwB,2DAG3B,CAAC;AAEX,2EAA2E;AAC3E,eAAO,MAAM,6BAA6B,sFAIhC,CAAC;AAEX,sFAAsF;AACtF,eAAO,MAAM,0BAA0B,6DAG7B,CAAC;AAEX,oDAAoD;AACpD,eAAO,MAAM,8BAA8B,oEAGjC,CAAC;AAEX,4CAA4C;AAC5C,eAAO,MAAM,8BAA8B,iEAGjC,CAAC;AAEX,wEAAwE;AACxE,eAAO,MAAM,iCAAiC,6EAIpC,CAAC;AAEX,8CAA8C;AAC9C,eAAO,MAAM,uCAAuC,sFAI1C,CAAC;AAEX,gDAAgD;AAChD,eAAO,MAAM,wCAAwC,6FAI3C,CAAC;AAEX,0DAA0D;AAC1D,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,mBAAmB,GAC7B,MAAM,GAAG,SAAS,CAEpB;AAED,MAAM,WAAW,uBAAuB;IACtC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,6BAA6B,CAAC,EAAE,MAAM,CAAC;IACvC,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,uBAAuB,EACzE,OAAO,EAAE,cAAc,EACvB,GAAG,EAAE,CAAC,EACN,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE;IACR,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,iBAAiB,CAAC,EAAE,mBAAmB,CAAC;CACzC,GACA,OAAO,CAAC,QAAQ,CAAC,CAsBnB;AAED,wBAAgB,YAAY,CAC1B,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE;IACR,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACA,OAAO,CAAC,QAAQ,CAAC,CAWnB"}

package/dist/session.js

@@ -16,7 +16,13 @@ var __export = (target, all) => {
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 
 // src/path-utils.ts
-import { existsSync } from "fs";
+import {
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  writeFileSync,
+  chmodSync
+} from "fs";
 import { homedir } from "os";
 import { dirname, join, resolve } from "path";
 function createHooxPath(path) {
@@ -42,7 +48,55 @@ function isHooxSetupRoot(dir) {
     return false;
   try {
     const root = resolve(dir);
-    return existsSync(join(root, "wrangler.jsonc")) && existsSync(join(root, "packages", "cli", "package.json"));
+    if (!existsSync(join(root, "packages", "cli", "package.json"))) {
+      return false;
+    }
+    return existsSync(join(root, "wrangler.jsonc")) || existsSync(join(root, "wrangler.jsonc.example")) || existsSync(join(root, "workers")) || existsSync(join(root, ".gitmodules"));
+  } catch {
+    return false;
+  }
+}
+function getRememberedMonorepoPath() {
+  return resolveHooxPath("config/monorepo.json");
+}
+function getRememberedMonorepoRoot() {
+  try {
+    const path = getRememberedMonorepoPath();
+    if (!existsSync(path))
+      return null;
+    const raw = readFileSync(path, "utf-8");
+    const data = JSON.parse(raw);
+    if (!data.root || typeof data.root !== "string")
+      return null;
+    const resolved = resolve(data.root);
+    return isHooxSetupRoot(resolved) ? resolved : null;
+  } catch {
+    return null;
+  }
+}
+function rememberMonorepoRoot(root) {
+  try {
+    const resolved = resolve(root);
+    if (!isHooxSetupRoot(resolved))
+      return false;
+    const configDir = getHooxConfigDir();
+    mkdirSync(configDir, { recursive: true, mode: 448 });
+    try {
+      chmodSync(configDir, 448);
+    } catch {}
+    const payload = {
+      root: resolved,
+      updatedAt: new Date().toISOString()
+    };
+    const path = getRememberedMonorepoPath();
+    writeFileSync(path, JSON.stringify(payload, null, 2) + `
+`, {
+      mode: 384
+    });
+    try {
+      chmodSync(path, 384);
+    } catch {}
+    return true;
   } catch {
     return false;
   }
@@ -62,6 +116,7 @@ function resolveHooxRuntimeRoot(options) {
   const env = options?.env ?? process.env;
   const cwd = resolve(options?.cwd ?? process.cwd());
   const globalRepo = getHooxRepoPath();
+  const remembered = options?.skipRemembered ? null : getRememberedMonorepoRoot();
   const envRepo = env.HOOX_REPO?.trim();
   if (envRepo) {
     const resolved = resolve(envRepo);
@@ -72,6 +127,7 @@ function resolveHooxRuntimeRoot(options) {
         checked: {
           env: resolved,
           cwd: findHooxSetupRoot(cwd),
+          remembered,
           global: globalRepo
         }
       };
@@ -82,6 +138,7 @@ function resolveHooxRuntimeRoot(options) {
       checked: {
         env: resolved,
         cwd: findHooxSetupRoot(cwd),
+        remembered,
         global: globalRepo
       }
     };
@@ -91,20 +148,27 @@ function resolveHooxRuntimeRoot(options) {
     return {
       root: local,
       source: "cwd",
-      checked: { cwd: local, global: globalRepo }
+      checked: { cwd: local, remembered, global: globalRepo }
+    };
+  }
+  if (remembered) {
+    return {
+      root: remembered,
+      source: "remembered",
+      checked: { cwd: null, remembered, global: globalRepo }
     };
   }
   if (isHooxSetupRoot(globalRepo)) {
     return {
       root: globalRepo,
       source: "global",
-      checked: { cwd: null, global: globalRepo }
+      checked: { cwd: null, remembered: null, global: globalRepo }
     };
   }
   return {
     root: null,
     source: "none",
-    checked: { cwd: null, global: globalRepo }
+    checked: { cwd: null, remembered: null, global: globalRepo }
   };
 }
 function getTuiEntryCandidates(runtimeRoot) {

package/dist/sse.js

@@ -17,7 +17,11 @@ var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 
 // src/operator-transport.ts
 function stripTrailingSlashes(url) {
-  return url.replace(/\/+$/, "");
+  let end = url.length;
+  while (end > 0 && url.charCodeAt(end - 1) === 47) {
+    end -= 1;
+  }
+  return end === url.length ? url : url.slice(0, end);
 }
 function parseTransport(raw) {
   if (!raw)
@@ -64,7 +68,7 @@ function hasOperatorClientCredentials(profile) {
   return Boolean(profile.accessClientId && profile.accessClientSecret);
 }
 function operatorUrl(profile, path) {
-  const base = profile.apiBase.replace(/\/+$/, "");
+  const base = stripTrailingSlashes(profile.apiBase);
   const p = path.startsWith("/") ? path : `/${path}`;
   return `${base}${p}`;
 }

package/dist/stores/config-store.d.ts

@@ -3,6 +3,8 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import type { ViewId, LogFilter, NotificationPreferences } from "../types";
+/** TUI prefs file — isolated from operator config.json (which may hold apiToken). */
+export declare function getTuiPreferencesPath(): string;
 export interface ConfigState {
     theme: "dark" | "light";
     refreshIntervalMs: number;