@uniquedivine/tg-sai 0.0.2 → 0.0.4

package/cfg.ts

@@ -5,6 +5,12 @@ export interface TelegramIdentity {
   kind: "user" | "bot"
 }
 
+export interface TelegramChatIdentity {
+  id: number
+  title: string
+  kind: "channel" | "group"
+}
+
 /**
  * Telegram bot identity for the Sai team bot. The bot is the automation target
  * to add and promote in candidate chats.
@@ -17,13 +23,51 @@ export const saiBot = {
 } satisfies TelegramIdentity
 
 /**
- * Telegram user identity for Unique (`uniquedivine`). In this workflow, Unique
- * is the target user to promote to admin or prepare for ownership transfer.
+ * Known Telegram user identities used by tg-sai operator workflows.
  */
-export const uniqueDivine = {
-  id: 1912700300,
-  handle: "uniquedivine",
-  displayName: "Unique (NIBIRU)",
-  kind: "user",
-} satisfies TelegramIdentity
+export const USERS = {
+  /**
+   * Default operational target user to promote to admin or prepare for
+   * ownership transfer.
+   */
+  uniqueDivine: {
+    id: 1912700300,
+    handle: "uniquedivine",
+    displayName: "Unique (NIBIRU)",
+    kind: "user",
+  },
+
+  /**
+   * Corinne's primary account. This account owns or administers some candidate
+   * chats used by tg-sai operator flows.
+   */
+  corinne: {
+    id: 7930936303,
+    handle: "corinnebernett",
+    displayName: "Corinne Bernett",
+    kind: "user",
+  },
+
+  /**
+   * Corinne's alternate account. Use this account as a controlled
+   * owner-transfer target when dry-running or testing against the internal
+   * Nibiru chat before touching partner or production chats.
+   */
+  corinneAlt: {
+    id: 8274304175,
+    handle: "corinneantonia",
+    displayName: "Corinne Antonia",
+    kind: "user",
+  },
+} satisfies Record<string, TelegramIdentity>
+
+/**
+ * Internal Nibiru chat used as a controlled target for tg-sai dry runs and
+ * ownership-transfer tests.
+ */
+export const nibiruInternal = {
+  id: -1002094035214,
+  title: "Nibiru | Internal",
+  kind: "channel",
+} satisfies TelegramChatIdentity
 

package/health.ts

@@ -297,7 +297,7 @@ function checkPassword(
   profile: TgSaiProfile | null,
 ): void {
   if (env.TELEGRAM_PASSWORD || profile?.password) {
-    info(collector, "password_status: present")
+    good(collector, "password_status: present")
     return
   }
   warning(

package/main.ts

@@ -8,6 +8,7 @@ import {
   rm,
   writeFile,
 } from "node:fs/promises"
+import { createRequire } from "node:module"
 import { tmpdir } from "node:os"
 import { join } from "node:path"
 import { Command } from "commander"
@@ -20,13 +21,14 @@ import type {
   ProposedAction,
 } from "./adminAudit"
 import { planAdminBootstrap } from "./adminAudit"
-import { saiBot, uniqueDivine } from "./cfg"
+import { saiBot, USERS } from "./cfg"
 import { runHealthCheck } from "./health"
 import {
   addTargetToChat,
   createMtcuteClient,
   fetchChatAuditInput,
   findSaiChats,
+  normalizeUser,
   promoteTargetAdmin,
   transferTargetOwnership,
 } from "./mtcuteAdapter"
@@ -51,7 +53,10 @@ import type {
   TelegramCredentialValues,
 } from "./profiles"
 
-const DEFAULT_USER_TARGET_ID = uniqueDivine.id
+const require = createRequire(import.meta.url)
+const packageJson = require("./package.json") as { version: string }
+
+const DEFAULT_USER_TARGET_ID = USERS.uniqueDivine.id
 const DEFAULT_BOT_TARGET_ID = saiBot.id
 const DEFAULT_BOT_TARGET_PEER = saiBot.handle
 
@@ -211,6 +216,17 @@ function actionExecutorDeps(logger: BatchLogger = consoleBatchLogger) {
   }
 }
 
+function actorBatchLogger(actorUsername: string): BatchLogger {
+  return {
+    event(event) {
+      emitJsonObject({
+        ...event,
+        actorUsername,
+      })
+    },
+  }
+}
+
 /**
  * Emits one command-level JSON event to stdout.
  */
@@ -269,6 +285,14 @@ async function getTelegramEnv(profileName?: string): Promise<TelegramEnv> {
   }
 }
 
+async function selectedProfileName(profileName?: string): Promise<string | null> {
+  if (profileName) {
+    return profileName
+  }
+  const config = await readConfig()
+  return config.activeProfile
+}
+
 function parsePeer(value: string): number | string {
   const normalized = value.startsWith("@") ? value.slice(1) : value
   const asNumber = Number(normalized)
@@ -310,7 +334,7 @@ function printAudit(input: ChatAuditInput) {
   console.log(
     `target_can_receive_ownership: ${audit.targetCanReceiveOwnership}`,
   )
-  console.log(`proposed_actions: ${audit.proposedActions.join("; ")}`)
+  console.log(`proposed_actions: ${formatActionList(audit.proposedActions)}`)
 }
 
 function shouldRunAction(
@@ -320,6 +344,10 @@ function shouldRunAction(
   return proposedActions.includes(action)
 }
 
+function formatActionList(actions: ProposedAction[]): string {
+  return JSON.stringify(actions)
+}
+
 async function withClient<T>(
   profileName: string | undefined,
   fn: (
@@ -380,7 +408,9 @@ async function runAddBot(options: AddBotOptions): Promise<void> {
     console.log(`target_peer: ${options.targetPeer}`)
     console.log(`actor_role: ${beforePlan.actorRole}`)
     console.log(`target_role_before: ${beforePlan.targetRole}`)
-    console.log(`proposed_actions: ${beforePlan.proposedActions.join("; ")}`)
+    console.log(
+      `proposed_actions: ${formatActionList(beforePlan.proposedActions)}`,
+    )
 
     if (options.run !== true) {
       console.log("dry_run: pass --run to add/promote the bot")
@@ -427,7 +457,9 @@ async function runAddBot(options: AddBotOptions): Promise<void> {
 
     console.log(`target_role_after: ${afterPlan.targetRole}`)
     console.log(`target_is_admin_after: ${afterPlan.targetIsAdmin}`)
-    console.log(`remaining_actions: ${afterPlan.proposedActions.join("; ")}`)
+    console.log(
+      `remaining_actions: ${formatActionList(afterPlan.proposedActions)}`,
+    )
   })
 }
 
@@ -448,7 +480,9 @@ async function runAddOwner(options: AddOwnerOptions): Promise<void> {
     console.log(
       `target_can_receive_ownership_before: ${beforePlan.targetCanReceiveOwnership}`,
     )
-    console.log(`proposed_actions: ${beforePlan.proposedActions.join("; ")}`)
+    console.log(
+      `proposed_actions: ${formatActionList(beforePlan.proposedActions)}`,
+    )
 
     if (options.run !== true) {
       console.log("dry_run: pass --run to add/promote the target user")
@@ -498,7 +532,9 @@ async function runAddOwner(options: AddOwnerOptions): Promise<void> {
     console.log(
       `target_can_receive_ownership_after: ${afterPlan.targetCanReceiveOwnership}`,
     )
-    console.log(`remaining_actions: ${afterPlan.proposedActions.join("; ")}`)
+    console.log(
+      `remaining_actions: ${formatActionList(afterPlan.proposedActions)}`,
+    )
 
     if (!afterPlan.actorCanTransferOwnership) {
       console.log("ownership_transfer: skipped_actor_not_owner")
@@ -565,6 +601,7 @@ async function runSaiFind(options: SaiFindOptions): Promise<void> {
 async function applyTargetPlan(params: {
   client: Awaited<ReturnType<typeof createMtcuteClient>>
   chat: ChatInput
+  actorUsername: string
   targetUserId: number | string
   targetPeer: number | string
   rights: Record<string, boolean>
@@ -580,6 +617,7 @@ async function applyTargetPlan(params: {
   printJsonEvent("target_plan", {
     chatId: params.chat.chatId,
     title: params.chat.title,
+    actorUsername: params.actorUsername,
     targetUserId: params.targetUserId,
     actionPrefix: params.actionPrefix,
     run: params.run,
@@ -591,6 +629,7 @@ async function applyTargetPlan(params: {
   if (!beforePlan.actorCanApply) {
     printJsonEvent("target_skip", {
       chatId: params.chat.chatId,
+      actorUsername: params.actorUsername,
       actionPrefix: params.actionPrefix,
       reason: "actor_lacks_owner_or_add_admins_right",
     })
@@ -601,7 +640,7 @@ async function applyTargetPlan(params: {
     return
   }
 
-  const deps = actionExecutorDeps()
+  const deps = actionExecutorDeps(actorBatchLogger(params.actorUsername))
   if (shouldRunAction(beforePlan.proposedActions, "add target user")) {
     await withFloodWaitRetry(
       {
@@ -647,6 +686,7 @@ async function maybeTransferOwner(params: {
   client: Awaited<ReturnType<typeof createMtcuteClient>>
   env: TelegramEnv
   chat: ChatInput
+  actorUsername: string
   targetUser: number | string
   enabled: boolean
   run: boolean
@@ -664,6 +704,7 @@ async function maybeTransferOwner(params: {
   if (!plan.actorCanTransferOwnership) {
     printJsonEvent("ownership_skip", {
       chatId: params.chat.chatId,
+      actorUsername: params.actorUsername,
       reason: "actor_not_owner",
     })
     return
@@ -671,6 +712,7 @@ async function maybeTransferOwner(params: {
   if (!plan.targetCanReceiveOwnership) {
     printJsonEvent("ownership_skip", {
       chatId: params.chat.chatId,
+      actorUsername: params.actorUsername,
       reason: "target_not_eligible",
     })
     return
@@ -678,6 +720,7 @@ async function maybeTransferOwner(params: {
   if (params.env.password === null) {
     printJsonEvent("ownership_skip", {
       chatId: params.chat.chatId,
+      actorUsername: params.actorUsername,
       reason: "missing_telegram_password",
     })
     return
@@ -685,6 +728,7 @@ async function maybeTransferOwner(params: {
   if (!params.run) {
     printJsonEvent("ownership_plan", {
       chatId: params.chat.chatId,
+      actorUsername: params.actorUsername,
       action: "transfer_owner",
     })
     return
@@ -701,7 +745,7 @@ async function maybeTransferOwner(params: {
         targetPeer: params.targetUser,
         password: params.env.password ?? "",
       }),
-    actionExecutorDeps(),
+    actionExecutorDeps(actorBatchLogger(params.actorUsername)),
   )
 }
 
@@ -727,18 +771,23 @@ async function runSaiBootstrap(options: SaiBootstrapOptions): Promise<void> {
 
   await withClient(options.profile, async (client, env) => {
     activeJsonLogPath = logPath
+    const actor = normalizeUser(await client.getMe())
+    const actorUsername = actor.username ?? ""
+    const profileName = await selectedProfileName(options.profile)
     const ownershipTransferEnabled =
       options.transferOwner !== false && env.password !== null
     console.log(`wrote_run_log: ${logPath}`)
     printJsonEvent("run_start", {
       file: options.file,
       logPath,
+      profileName,
+      actor,
       chatCount: chats.length,
       run: options.run === true,
       transferOwner: ownershipTransferEnabled,
       passwordAvailable: env.password !== null,
       delayMs,
-      targetUser: uniqueDivine.id,
+      targetUser: USERS.uniqueDivine.id,
       targetBot: saiBot.id,
     })
 
@@ -749,12 +798,14 @@ async function runSaiBootstrap(options: SaiBootstrapOptions): Promise<void> {
           total: chats.length,
           chatId: chat.chatId,
           title: chat.title,
+          actorUsername,
         })
 
         try {
           await applyTargetPlan({
             client,
             chat,
+            actorUsername,
             targetUserId: saiBot.id,
             targetPeer: saiBot.handle,
             rights: saiBotAdminRights,
@@ -764,8 +815,9 @@ async function runSaiBootstrap(options: SaiBootstrapOptions): Promise<void> {
           await applyTargetPlan({
             client,
             chat,
-            targetUserId: uniqueDivine.id,
-            targetPeer: uniqueDivine.handle,
+            actorUsername,
+            targetUserId: USERS.uniqueDivine.id,
+            targetPeer: USERS.uniqueDivine.handle,
             rights: ownerTargetAdminRights,
             actionPrefix: "owner_target",
             run: options.run === true,
@@ -774,16 +826,19 @@ async function runSaiBootstrap(options: SaiBootstrapOptions): Promise<void> {
             client,
             env,
             chat,
-            targetUser: uniqueDivine.handle,
+            actorUsername,
+            targetUser: USERS.uniqueDivine.handle,
             enabled: ownershipTransferEnabled,
             run: options.run === true,
           })
           printJsonEvent("chat_complete", {
             chatId: chat.chatId,
+            actorUsername,
           })
         } catch (error) {
           printJsonEvent("chat_error", {
             chatId: chat.chatId,
+            actorUsername,
             errorName: error instanceof Error ? error.name : "UnknownError",
             errorMessage:
               error instanceof Error ? error.message : String(error),
@@ -793,6 +848,7 @@ async function runSaiBootstrap(options: SaiBootstrapOptions): Promise<void> {
         if (delayMs > 0 && i < chats.length - 1) {
           printJsonEvent("chat_delay", {
             chatId: chat.chatId,
+            actorUsername,
             delayMs,
           })
           await sleep(delayMs)
@@ -1087,7 +1143,7 @@ export function createProgram(): Command {
   program
     .name("tg-sai")
     .description("Audit and manage Sai Telegram chat admin state")
-    .version("0.1.0")
+    .version(packageJson.version, "--version", "output the version number")
     .helpOption("--help", "display help for command")
 
   program.action(() => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniquedivine/tg-sai",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "type": "module",
   "private": false,
   "description": "Sai Telegram admin audit and bootstrap CLI",