@llblab/pi-telegram 0.52.2 → 0.53.0

package/lib/thread-display.ts

@@ -5,13 +5,14 @@
  * Excludes routing, name allocation, profile mutation, and live-owner discovery.
  */
 import { isDeepStrictEqual } from "node:util";
+
 import type { TelegramThreadDisplayMode } from "./config.ts";
+import type { TelegramApiCallOptions } from "./telegram-api.ts";
 import type {
   TelegramTopicTargetStore,
   TelegramWorkspaceDisplayBinding,
   TelegramWorkspaceThreadBinding,
 } from "./threads.ts";
-import type { TelegramApiCallOptions } from "./telegram-api.ts";
 
 function labelText(value: string): string {
   return value.replace(/\s+/gu, " ").trim();
@@ -30,14 +31,20 @@ function directorySegments(cwd: string): string[] {
   return cwd.split("/").filter(Boolean);
 }
 
-function distinguishingDirectorySegments(cwd: string, directories: readonly string[]): string[] {
+function distinguishingDirectorySegments(
+  cwd: string,
+  directories: readonly string[],
+): string[] {
   const parts = directorySegments(cwd);
   if (!parts.length) return [];
   for (let depth = 1; depth <= parts.length; depth++) {
     const candidate = labelText(parts.slice(-depth).join("/"));
-    const collides = directories.some((other) => other !== cwd &&
-      labelText(directorySegments(other).slice(-depth).join("/")).toLowerCase() ===
-        candidate.toLowerCase(),
+    const collides = directories.some(
+      (other) =>
+        other !== cwd &&
+        labelText(
+          directorySegments(other).slice(-depth).join("/"),
+        ).toLowerCase() === candidate.toLowerCase(),
     );
     if (!collides) return parts.slice(-depth);
   }
@@ -65,14 +72,21 @@ function formatDirectoryLabel(
 ): string {
   const segments = distinguishingDirectorySegments(cwd, directories);
   if (!segments.length) return "/";
-  const formatted = segments.map((segment) => {
-    const tokens = tokenizeTelegramDirectorySegment(segment);
-    if (!tokens.length) return "";
-    if (mode === "directory-snake") return tokens.map((token) => token.toLowerCase()).join("_");
-    return tokens.map((token) => /\p{L}/u.test(token) && token === token.toUpperCase()
-      ? token
-      : `${token.slice(0, 1).toUpperCase()}${token.slice(1).toLowerCase()}`).join(" ");
-  }).filter(Boolean);
+  const formatted = segments
+    .map((segment) => {
+      const tokens = tokenizeTelegramDirectorySegment(segment);
+      if (!tokens.length) return "";
+      if (mode === "directory-snake")
+        return tokens.map((token) => token.toLowerCase()).join("_");
+      return tokens
+        .map((token) =>
+          /\p{L}/u.test(token) && token === token.toUpperCase()
+            ? token
+            : `${token.slice(0, 1).toUpperCase()}${token.slice(1).toLowerCase()}`,
+        )
+        .join(" ");
+    })
+    .filter(Boolean);
   if (!formatted.length) return directoryLabel(cwd, directories);
   return formatted.join(mode === "directory-snake" ? "_" : " / ");
 }
@@ -91,27 +105,59 @@ export function resolveTelegramLiveWorkspaceBindingKeys(
   };
   add(leaderTarget);
   for (const follower of followers) add(follower.target);
-  return new Set(bindings.filter((binding) =>
-    targets.has(`${binding.target.chatId}:${binding.target.threadId}`),
-  ).map((binding) => binding.bindingKey));
+  return new Set(
+    bindings
+      .filter((binding) =>
+        targets.has(`${binding.target.chatId}:${binding.target.threadId}`),
+      )
+      .map((binding) => binding.bindingKey),
+  );
 }
 
 /** Missing or ambiguous metadata yields no label rather than inventing identity. */
+/** Case-insensitive label occurrences; directory modes count only live bindings. */
+function countTelegramDisplayLabels(
+  bindings: readonly TelegramWorkspaceDisplayBinding[],
+  labels: ReadonlyMap<string, string>,
+  mode: TelegramThreadDisplayMode,
+  liveBindingKeys: ReadonlySet<string>,
+): Map<string, number> {
+  const counts = new Map<string, number>();
+  for (const binding of bindings) {
+    const label = labels.get(binding.bindingKey);
+    if (
+      !label ||
+      ((mode === "directory-snake" || mode === "directory-title") &&
+        !liveBindingKeys.has(binding.bindingKey))
+    )
+      continue;
+    const key = label.toLowerCase();
+    counts.set(key, (counts.get(key) ?? 0) + 1);
+  }
+  return counts;
+}
+
 export function resolveTelegramWorkspaceDisplayNames(
   bindings: readonly TelegramWorkspaceDisplayBinding[],
   mode: TelegramThreadDisplayMode,
   liveBindingKeys: ReadonlySet<string> = new Set(),
 ): Map<string, string> {
   const labels = new Map<string, string>();
-  const directories = Array.from(new Set(bindings.map((binding) => binding.cwd)));
+  const directories = Array.from(
+    new Set(bindings.map((binding) => binding.cwd)),
+  );
   const liveDirectoryCounts = new Map<string, number>();
   for (const binding of bindings) {
     if (!liveBindingKeys.has(binding.bindingKey)) continue;
-    liveDirectoryCounts.set(binding.cwd, (liveDirectoryCounts.get(binding.cwd) ?? 0) + 1);
+    liveDirectoryCounts.set(
+      binding.cwd,
+      (liveDirectoryCounts.get(binding.cwd) ?? 0) + 1,
+    );
   }
   const bases = new Map<string, string>();
   for (const binding of bindings) {
-    const slot = binding.slot && /^[A-Z]$/u.test(binding.slot) ? binding.slot : undefined;
+    const slot =
+      binding.slot && /^[A-Z]$/u.test(binding.slot) ? binding.slot : undefined;
     const manualName = binding.manualThreadName
       ? labelText(binding.manualThreadName)
       : undefined;
@@ -123,36 +169,50 @@ export function resolveTelegramWorkspaceDisplayNames(
       const name = binding.threadName ? labelText(binding.threadName) : slot;
       if (name) labels.set(binding.bindingKey, boundedLabel(name));
     } else {
-      const base = mode === "directories"
-        ? directoryLabel(binding.cwd, directories)
-        : formatDirectoryLabel(binding.cwd, directories, mode);
+      const base =
+        mode === "directories"
+          ? directoryLabel(binding.cwd, directories)
+          : formatDirectoryLabel(binding.cwd, directories, mode);
       bases.set(binding.bindingKey, base);
-      const showSuffix = mode === "directories"
-        ? binding.showSlotSuffix || bindings.filter((candidate) => candidate.cwd === binding.cwd).length > 1
-        : (liveDirectoryCounts.get(binding.cwd) ?? 0) > 1;
+      const showSuffix =
+        mode === "directories"
+          ? binding.showSlotSuffix ||
+            bindings.filter((candidate) => candidate.cwd === binding.cwd)
+              .length > 1
+          : (liveDirectoryCounts.get(binding.cwd) ?? 0) > 1;
       if (showSuffix && !slot) continue;
-      const suffix = !showSuffix ? "" : mode === "directory-title"
-        ? ` ${slot}`
-        : `_${slot!.toLowerCase()}`;
+      const suffix = !showSuffix
+        ? ""
+        : mode === "directory-title"
+          ? ` ${slot}`
+          : `_${slot!.toLowerCase()}`;
       labels.set(binding.bindingKey, boundedLabel(base, suffix));
     }
   }
   // Long or whitespace-normalized paths can collide even after qualification.
-  if (mode === "directories" || mode === "directory-snake" || mode === "directory-title") {
-    const counts = new Map<string, number>();
-    for (const binding of bindings) {
-      const label = labels.get(binding.bindingKey);
-      if (!label || ((mode === "directory-snake" || mode === "directory-title") &&
-          !liveBindingKeys.has(binding.bindingKey))) continue;
-      const key = label.toLowerCase();
-      counts.set(key, (counts.get(key) ?? 0) + 1);
-    }
+  if (
+    mode === "directories" ||
+    mode === "directory-snake" ||
+    mode === "directory-title"
+  ) {
+    const counts = countTelegramDisplayLabels(
+      bindings,
+      labels,
+      mode,
+      liveBindingKeys,
+    );
     for (const binding of bindings) {
       const label = labels.get(binding.bindingKey);
-      if (binding.manualThreadName || !label ||
-          (counts.get(label.toLowerCase()) ?? 0) < 2) continue;
-      if ((mode === "directory-snake" || mode === "directory-title") &&
-          (liveDirectoryCounts.get(binding.cwd) ?? 0) < 2) {
+      if (
+        binding.manualThreadName ||
+        !label ||
+        (counts.get(label.toLowerCase()) ?? 0) < 2
+      )
+        continue;
+      if (
+        (mode === "directory-snake" || mode === "directory-title") &&
+        (liveDirectoryCounts.get(binding.cwd) ?? 0) < 2
+      ) {
         labels.delete(binding.bindingKey);
         continue;
       }
@@ -160,18 +220,23 @@ export function resolveTelegramWorkspaceDisplayNames(
         labels.delete(binding.bindingKey);
         continue;
       }
-      labels.set(binding.bindingKey, boundedLabel(bases.get(binding.bindingKey)!,
-        mode === "directory-title" ? ` ${binding.slot}` : `_${binding.slot.toLowerCase()}`));
+      labels.set(
+        binding.bindingKey,
+        boundedLabel(
+          bases.get(binding.bindingKey)!,
+          mode === "directory-title"
+            ? ` ${binding.slot}`
+            : `_${binding.slot.toLowerCase()}`,
+        ),
+      );
     }
   }
-  const counts = new Map<string, number>();
-  for (const binding of bindings) {
-    const label = labels.get(binding.bindingKey);
-    if (!label || ((mode === "directory-snake" || mode === "directory-title") &&
-        !liveBindingKeys.has(binding.bindingKey))) continue;
-    const key = label.toLowerCase();
-    counts.set(key, (counts.get(key) ?? 0) + 1);
-  }
+  const counts = countTelegramDisplayLabels(
+    bindings,
+    labels,
+    mode,
+    liveBindingKeys,
+  );
   for (const [key, label] of labels) {
     if ((counts.get(label.toLowerCase()) ?? 0) > 1) labels.delete(key);
   }
@@ -185,24 +250,29 @@ export function resolveTelegramInitialWorkspaceDisplayName(input: {
   preserveRetainedManualName?: boolean;
   liveBindingKeys?: ReadonlySet<string>;
 }): string | undefined {
-  const retained = input.bindings.find((binding) =>
-    binding.bindingKey === input.binding.bindingKey,
+  const retained = input.bindings.find(
+    (binding) => binding.bindingKey === input.binding.bindingKey,
   );
   const binding = retained
     ? {
-      ...input.binding,
-      ...(retained.showSlotSuffix ? { showSlotSuffix: true as const } : {}),
-      ...(input.preserveRetainedManualName !== false && retained.manualThreadName
-        ? { manualThreadName: retained.manualThreadName }
-        : {}),
-    }
+        ...input.binding,
+        ...(retained.showSlotSuffix ? { showSlotSuffix: true as const } : {}),
+        ...(input.preserveRetainedManualName !== false &&
+        retained.manualThreadName
+          ? { manualThreadName: retained.manualThreadName }
+          : {}),
+      }
     : input.binding;
-  return resolveTelegramWorkspaceDisplayNames([
-    ...input.bindings.filter((candidate) =>
-      candidate.bindingKey !== binding.bindingKey,
-    ),
-    binding,
-  ], input.mode, new Set([...(input.liveBindingKeys ?? []), binding.bindingKey])).get(binding.bindingKey);
+  return resolveTelegramWorkspaceDisplayNames(
+    [
+      ...input.bindings.filter(
+        (candidate) => candidate.bindingKey !== binding.bindingKey,
+      ),
+      binding,
+    ],
+    input.mode,
+    new Set([...(input.liveBindingKeys ?? []), binding.bindingKey]),
+  ).get(binding.bindingKey);
 }
 
 export async function applyTelegramThreadDisplaySetting(
@@ -210,28 +280,43 @@ export async function applyTelegramThreadDisplaySetting(
   deps: {
     getProfileKey(): string | undefined;
     ownsLeader(): boolean;
-    getLeaderSetter(): ((mode: TelegramThreadDisplayMode) => Promise<void>) | undefined;
-    getFollowerSetter(): ((mode: TelegramThreadDisplayMode) => Promise<void>) | undefined;
+    getLeaderSetter():
+      ((mode: TelegramThreadDisplayMode) => Promise<void>) | undefined;
+    getFollowerSetter():
+      ((mode: TelegramThreadDisplayMode) => Promise<void>) | undefined;
     reloadConfig(): Promise<void>;
   },
 ): Promise<void> {
   const profile = deps.getProfileKey();
-  const setter = deps.ownsLeader() ? deps.getLeaderSetter() : deps.getFollowerSetter();
-  if (!setter) throw new Error("Thread display settings require a connected compatible instance.");
+  const setter = deps.ownsLeader()
+    ? deps.getLeaderSetter()
+    : deps.getFollowerSetter();
+  if (!setter)
+    throw new Error(
+      "Thread display settings require a connected compatible instance.",
+    );
   await setter(mode);
-  if (deps.getProfileKey() !== profile) throw new Error("Telegram Thread display setting changed profile.");
+  if (deps.getProfileKey() !== profile)
+    throw new Error("Telegram Thread display setting changed profile.");
   await deps.reloadConfig();
-  if (deps.getProfileKey() !== profile) throw new Error("Telegram Thread display setting changed profile.");
+  if (deps.getProfileKey() !== profile)
+    throw new Error("Telegram Thread display setting changed profile.");
 }
 
 export interface TelegramThreadDisplayReconcilerDeps {
-  store: Pick<TelegramTopicTargetStore,
-    "listWorkspaceBindings" | "setWorkspaceDisplayTitle" | "persist">;
+  store: Pick<
+    TelegramTopicTargetStore,
+    "listWorkspaceBindings" | "setWorkspaceDisplayTitle" | "persist"
+  >;
   getMode(): TelegramThreadDisplayMode;
   getProfileKey(): string;
   getLeaderEpoch(): string | number | undefined;
-  captureBindingAuthority(binding: TelegramWorkspaceThreadBinding): (() => boolean) | undefined;
-  captureLiveBindingKeys(bindings: readonly TelegramWorkspaceThreadBinding[]): ReadonlySet<string>;
+  captureBindingAuthority(
+    binding: TelegramWorkspaceThreadBinding,
+  ): (() => boolean) | undefined;
+  captureLiveBindingKeys(
+    bindings: readonly TelegramWorkspaceThreadBinding[],
+  ): ReadonlySet<string>;
   callApi<TResponse>(
     method: string,
     body: Record<string, unknown>,
@@ -241,11 +326,15 @@ export interface TelegramThreadDisplayReconcilerDeps {
 
 export function createTelegramThreadDisplaySettingsRuntime(deps: {
   getTarget(): { chatId: number; threadId?: number } | undefined;
-  getBinding(target: { chatId: number; threadId?: number }):
-    { manualThreadName?: string } | undefined;
+  getBinding(target: {
+    chatId: number;
+    threadId?: number;
+  }): { manualThreadName?: string } | undefined;
   apply(mode: TelegramThreadDisplayMode): Promise<void>;
-  reset(target: { chatId: number; threadId?: number }):
-    Promise<{ ok: boolean; message?: string }>;
+  reset(target: {
+    chatId: number;
+    threadId?: number;
+  }): Promise<{ ok: boolean; message?: string }>;
 }): {
   isCustom(): boolean;
   setMode(mode: TelegramThreadDisplayMode): Promise<void>;
@@ -253,17 +342,23 @@ export function createTelegramThreadDisplaySettingsRuntime(deps: {
   return {
     isCustom() {
       const target = deps.getTarget();
-      return !!target && typeof deps.getBinding(target)?.manualThreadName === "string";
+      return (
+        !!target &&
+        typeof deps.getBinding(target)?.manualThreadName === "string"
+      );
     },
     async setMode(mode) {
       const target = deps.getTarget();
-      const hadManualName = !!target &&
+      const hadManualName =
+        !!target &&
         typeof deps.getBinding(target)?.manualThreadName === "string";
       await deps.apply(mode);
       if (!hadManualName || !target) return;
       const reset = await deps.reset(target);
       if (!reset.ok) {
-        throw new Error(reset.message ?? "Telegram Thread display override reset failed.");
+        throw new Error(
+          reset.message ?? "Telegram Thread display override reset failed.",
+        );
       }
     },
   };
@@ -279,40 +374,61 @@ export function createTelegramThreadDisplayReconciler(
     const profile = deps.getProfileKey();
     const mode = deps.getMode();
     const assertAuthority = (): void => {
-      if (epoch === undefined || deps.getLeaderEpoch() !== epoch ||
-          deps.getProfileKey() !== profile || deps.getMode() !== mode) {
-        throw new Error("Telegram Thread display update lost profile, mode, or leader authority.");
+      if (
+        epoch === undefined ||
+        deps.getLeaderEpoch() !== epoch ||
+        deps.getProfileKey() !== profile ||
+        deps.getMode() !== mode
+      ) {
+        throw new Error(
+          "Telegram Thread display update lost profile, mode, or leader authority.",
+        );
       }
     };
     assertAuthority();
     const bindings = deps.store.listWorkspaceBindings();
     const liveBindingKeys = deps.captureLiveBindingKeys(bindings);
-    const titles = resolveTelegramWorkspaceDisplayNames(bindings, mode, liveBindingKeys);
+    const titles = resolveTelegramWorkspaceDisplayNames(
+      bindings,
+      mode,
+      liveBindingKeys,
+    );
     let changed = 0;
     for (const binding of bindings) {
       const isBindingCurrent = deps.captureBindingAuthority(binding);
       if (!isBindingCurrent) continue;
       const title = titles.get(binding.bindingKey);
-      if (!title) throw new Error("Telegram Thread display identity is missing or ambiguous.");
-      const assertBinding = (expected: TelegramWorkspaceThreadBinding): void => {
-        assertAuthority();
-        const current = deps.store.listWorkspaceBindings().find((candidate) =>
-          candidate.bindingKey === expected.bindingKey,
+      if (!title)
+        throw new Error(
+          "Telegram Thread display identity is missing or ambiguous.",
         );
+      const assertBinding = (
+        expected: TelegramWorkspaceThreadBinding,
+      ): void => {
+        assertAuthority();
+        const current = deps.store
+          .listWorkspaceBindings()
+          .find((candidate) => candidate.bindingKey === expected.bindingKey);
         if (!isDeepStrictEqual(current, expected) || !isBindingCurrent()) {
           throw new Error("Telegram Thread display binding changed.");
         }
       };
       assertBinding(binding);
       if ((binding.displayTitle ?? binding.threadName) === title) continue;
-      await deps.callApi("editForumTopic", {
-        chat_id: binding.target.chatId,
-        message_thread_id: binding.target.threadId,
-        name: title,
-      }, { maxAttempts: 1 });
+      await deps.callApi(
+        "editForumTopic",
+        {
+          chat_id: binding.target.chatId,
+          message_thread_id: binding.target.threadId,
+          name: title,
+        },
+        { maxAttempts: 1 },
+      );
       assertBinding(binding);
       if (!deps.store.setWorkspaceDisplayTitle(binding, title)) {
-        throw new Error("Telegram Thread display binding changed before title commit.");
+        throw new Error(
+          "Telegram Thread display binding changed before title commit.",
+        );
       }
       await deps.store.persist();
       assertBinding({ ...binding, displayTitle: title });