elanous 0.2.5 → 0.2.7

package/src/index.ts

@@ -26,6 +26,7 @@ import { CLI_HARNESS_DOGFOOD_ENTRANCE, CLI_HARNESS_ORCHESTRATE_ENTRANCE, describ
 import { collectCommandEntrances, renderCommandEntrances } from './self-dev/entrance-inventory.js';
 import { isGoalAuthorFileName } from './self-implement/goal-document.js';
 import { DEV_PIPELINE_SINK_SURFACE } from './self-implement/self-cli-sink-surface.js';
+import { registerPrivateLedgerCommands } from './cli/private-ledger-commands.js';
 import { applyTestStateDirFlagFromArgv } from './cli/test-state-dir-flag.js';
 import { applyTestFlagFromArgv, observeTestFlagOwnership, uncoveredTestFlagPaths, staleTestFlagPaths } from './cli/test-flag.js';
 import { registerPtyTakeoverCommands } from './cli/pty-takeover-cli.js';
@@ -61,6 +62,7 @@ import { registerModelWatchCommand } from './cli/model-watch-cli.js';
 import { registerIntakeCommands } from './cli/intake-cli.js';
 import { registerTasksCommands } from './cli/tasks-cli.js';
 import { registerLabelsCommands } from './cli/labels-cli.js';
+import { registerMsgCommands } from './cli/msg-cli.js';
 import { registerDoctorCommand } from './cli/doctor-cli.js';
 import { registerProviderCommands } from './cli/provider-cli.js';
 export { buildCodexAccountImportGuidance, setCodexAccountLogSinkModuleForTesting } from './cli/provider-cli.js';
@@ -73,6 +75,7 @@ import { registerGraphCommands } from './graph-runner/graph-cli.js';
 import { registerLoopCommands } from './loops/loop-cli.js';
 import { registerCardCommand } from './task-cards/card-cli.js';
 import { registerLaunchHeadCommands } from './launch-head/launch-head-cli.js';
+import { acpServerHelpText } from './boot/acp-server-help.js';
 // IMPORTANT: parse `--config-dir <dir>` + `--test-state-dir <dir>`
 // BEFORE Commander loads — the resolvers are read at module-init
 // time by several config-touching imports below, so the override
@@ -94,7 +97,8 @@ import type { AdPipelinePlan, AdPipelineResult } from './ad-pipeline/run.js';
 import type { AcpPermissionApprover } from './acp/client.js';
 import { runGitCommand } from './git-fs/runner.js';
 import { debug, redactSecretText, redactSecrets } from './debug/log.js';
-import { HarnessCliInputError, installHarnessCliCommand, type HarnessAskSayChildLlmOptions, type HarnessAskSayOptions, type HarnessPlanOptions } from './harness/harness-cli-command.js';
+import { installHarnessCliCommand, type HarnessAskSayChildLlmOptions, type HarnessAskSayOptions, type HarnessPlanOptions } from './harness/harness-cli-command.js';
+import { formatCliUserError, isCliUserError } from './cli/cli-user-error.js';
 import { dispatchSolveMission } from './skills/tools/solve-mission.js';
 import { performBrowserAction, type BrowserActionDeps, type BrowserActionResult } from './harness/browser-act.js';
 import { decideTypeAction, type TypeActionDecision, type TypeTarget } from './harness/browser-act-type.js';
@@ -151,7 +155,7 @@ async function readStdinLine(prompt: string = ''): Promise<string> {
   finally { rl.close(); }
 }
 import { loginWithCodex, CODEX_DEVICE_LOGIN_URL } from './oauth/codex.js';
-import { authStorePath, loadTokens, deleteTokens, listProviders as listAuthProviders } from './oauth/store.js';
+import { authStorePath, loadTokens, deleteTokens, saveTokens, listProviders as listAuthProviders, type CodexMirrorResult } from './oauth/store.js';
 import { renderKeyHelp, CONTEXT_LABELS, type KeyContext } from './keybindings.js';
 import { auditKeybindings, renderKeymapAudit } from './keymap-audit.js';
 import { runCodexSetup } from './codex/setup.js';
@@ -163,6 +167,7 @@ import { initSessionWorkingDir } from './session/working-dir.js';
 import { rewriteBareNexusToStatus } from './cli/nexus-entry.js';
 import { registerIngestTokenCommands } from './cli/ingest-token-cli.js';
 import { registerMcpGatewayCommands } from './cli/mcp-gateway-cli.js';
+import { registerRelayCommand } from './relay/relay-cli.js';
 import type { ReviewImage } from './agent-substrate/pr-reviewer.js';
 import {
   describeMissionRouting,
@@ -863,6 +868,14 @@ registerDoctorCommand(program);
 registerControlCommands(program);
 registerHooksCommands(program);
 registerSetupCommand(program);
+program.commands.find(command => command.name() === 'setup')!
+  .option('--terminal', 'Run the terminal onboarding wizard')
+  .hook('preAction', async (_command, action) => {
+    if (action.name() === 'setup' && action.opts().terminal) {
+      const completed = await runOnboardingForCli();
+      process.exit(completed ? 0 : (process.exitCode || 2));
+    }
+  });
 registerStartCommand(program);
 registerGroundingSourcesCli(program);
 registerGraphCommands(program);
@@ -904,6 +917,10 @@ marketCmd.command('publish').description('Publish a local signed marketplace ind
         console.log(`Published ${result.published.length} plugins (sequence ${result.sequence}); skipped ${result.skipped.length}`);
         for (const warning of result.warnings) console.warn(`⚠ ${warning.dir}: ${warning.graph} uses recipes it does not ship (${warning.recipes.join(', ')}) — third-party graphs should use their own recipes.yaml or custom nodes`);
       }
+      for (const item of result.skipped) {
+        for (const hit of item.hits ?? []) console.error(`${item.dir}/${hit.file}:${hit.line}: ${hit.marker}`);
+      }
+      if (!result.ok) process.exitCode = 1;
     } catch (error) {
       console.error(`market publish: ${error instanceof Error ? error.message : 'failed'}`);
       process.exitCode = 1;
@@ -1001,7 +1018,7 @@ program.command('self-update')
 
 program
   .name('elanous')
-  .description('TUI skill runner — Yazi-style 3-pane + multi-LLM, with remote sync, smart diff, and SQLite logging')
+  .description('말 한 줄로 시작: elanous harness say "…" — 끝까지 간다 · 다 보인다 · 스스로를 만들었다')
   .version(cliVersion())
   // Documentation-only entry — the flag is extracted from argv by
   // `applyConfigDirFlagFromArgv` at module init (above) so Commander
@@ -1027,6 +1044,7 @@ program
     '--test',
     '격리 테스트 인스턴스로 실행 — cwd 의 git 트리(worktree 포함)에서 `<트리>/.elanous-test` 를 루트로 잡고 state·config 두 축을 함께 격리한다. config 사본이 없으면 자동 물질화. `--test=<dir>` 로 루트 직접 지정 가능(값 문법은 `=` 형태 하나 — 모호함 없음). ELANOUS_STATE_DIR/--config-dir 을 손으로 줄 필요가 없다.',
   );
+program.addHelpText('after', acpServerHelpText());
 
 program
   .command('measure-fabric-arc-ab')
@@ -1075,6 +1093,8 @@ const mcpCmd = program
   .description('MCP (Model Context Protocol) server / client integration');
 registerMcpGatewayCommands(mcpCmd);
 
+registerRelayCommand(program);
+
 mcpCmd
   .command('serve')
   .description('Run a stdio MCP server exposing the configured mcp.servers as proxy tools (used by `claude mcp add elanous -- elanous mcp serve`)')
@@ -2951,6 +2971,9 @@ const harnessOrchestrateCmd = registerHarnessOrchestrateCapabilityOptions(
 
 const selfCmd = program.command('self').description('Self-awareness memory — 외부 도구(Claude Code/Codex)가 구현/변경 이력을 elanous 기억에 주입·회상');
 
+// M12 Claude Code 의존도 계기판 — `elanous self dependence [--since] [--until] [--json]`(읽기만).
+{ const { registerDependenceCommand } = await import('./cli/dependence-gauge.js'); registerDependenceCommand(selfCmd); }
+
 function printExtendedOrchestrateHelp(command: Command, positional = '[goals...]'): void {
   const optionLines = command.options
     .filter((option) => option.long !== '--help-all')
@@ -5429,30 +5452,7 @@ program.command('ad [input...]')
   });
 
 registerDocsCommands(program);
-// Private local decision ledger follows the same JS-only dispatch path as directives.
-if (existsSync(resolve(import.meta.dir, 'cli/decisions-cli.ts')) || existsSync(resolve(import.meta.dir, 'cli/decisions-cli.js'))) {
-  program.command('decisions').description('대표 결정 로컬 원장').allowUnknownOption().allowExcessArguments(true)
-    .action(async (_opts: unknown, command: Command) => {
-      try { await (await import('./domains/standalone-log-sink.js')).registerStandaloneLogSink('decisions'); }
-      catch { /* Logging must not prevent recording a decision. */ }
-      const privateDecisionsModule: string = './cli/decisions-cli.js';
-      const { registerDecisionsCommands } = await import(privateDecisionsModule) as { registerDecisionsCommands: (program: Command) => void };
-      const privateProgram = new Command();
-      registerDecisionsCommands(privateProgram);
-      await privateProgram.parseAsync(['decisions', ...command.args], { from: 'user' });
-    });
-}
-// Private command is absent from the public export; JS-only distributions still register it.
-if (existsSync(resolve(import.meta.dir, 'cli/directives-cli.ts')) || existsSync(resolve(import.meta.dir, 'cli/directives-cli.js'))) {
-  program.command('directives').description('대표 지시 로컬 색인·검색').allowUnknownOption().allowExcessArguments(true)
-    .action(async (_opts: unknown, command: Command) => {
-      const privateDirectivesModule: string = './cli/directives-cli.js';
-      const { registerDirectivesCommands } = await import(privateDirectivesModule) as { registerDirectivesCommands: (program: Command) => void };
-      const privateProgram = new Command();
-      registerDirectivesCommands(privateProgram);
-      await privateProgram.parseAsync(['directives', ...command.args], { from: 'user' });
-    });
-}
+registerPrivateLedgerCommands(program);
 registerFleetCommands(program);
 
 // ── ops (운영 관측 — 지금 뭐 도나·이상 없나·상태 전이) ──
@@ -7041,6 +7041,7 @@ missionCmd
 
 registerTasksCommands(program);
 registerLabelsCommands(program);
+registerMsgCommands(program);
 
 // ── ask alias (script-friendly one-shot query) ──
 program
@@ -7049,7 +7050,28 @@ program
   .option('--reuse', 'Reuse the active CLI session instead of creating a new one')
   .option('--session <id>', 'Continue an explicit session (id or unique prefix). Overrides --reuse and active session.')
   .option('--json', 'Emit a single JSON line {sessionId, provider, model, reply, logPath, budget} instead of streaming text + ui.info trailer. Stable shape for LLM self-spawn.')
-  .action(async (parts: string[], opts: { reuse?: boolean; session?: string; json?: boolean }) => {
+  .option('--bare', 'Send only this text to the model: no Elanous preamble, project tree, memory, tools or session')
+  .action(async (parts: string[], opts: { reuse?: boolean; session?: string; json?: boolean; bare?: boolean }) => {
+    if (opts.bare) {
+      try {
+        const { askBare } = await import('./cli/ask-bare.js');
+        const llm = await import('./llm.js');
+        const { getUserConfig } = await import('./user-config.js');
+        const { trimToBudget } = await import('./tokens.js');
+        const result = await askBare({ text: parts.join(' '), deps: {
+          getUserConfig, decideProviderForConfig: llm.decideProviderForConfig, getProviderForConfig: llm.getProviderForConfig,
+          streamLLM: llm.streamLLM, trimToBudget,
+        } });
+        if (opts.json) process.stdout.write(JSON.stringify({ sessionId: null, ...result, logPath: null, budget: null, bare: true }) + '\n');
+        else process.stdout.write(result.reply.endsWith('\n') ? result.reply : `${result.reply}\n`);
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (opts.json) process.stdout.write(JSON.stringify({ error: message, bare: true }) + '\n');
+        else console.error(`ask --bare failed: ${message}`);
+        process.exitCode = 1;
+      }
+      return;
+    }
     const cfg = reloadUserConfig();
     await runChatTurnCli({
       cfg,
@@ -7215,9 +7237,13 @@ program
   });
 
 // ── login (provider OAuth) ──
-export function codexLoginSuccessMessage(mirrorResult?: 'written' | 'not-created-missing-cli-fields' | 'write-failed'): string {
+export function codexLoginSuccessMessage(mirrorResult?: CodexMirrorResult): string {
   const prefix = `Signed in. Tokens at ${authStorePath()}.`;
   if (mirrorResult === 'written') return `${prefix} Mirrored to ~/.codex/auth.json.`;
+  if (mirrorResult === 'skipped-different-account') {
+    return `${prefix} Your Codex CLI login (~/.codex/auth.json) belongs to a different account — left unchanged. To switch it, run \`elanous login openai-codex --replace-codex-cli-login\`.`;
+  }
+  if (mirrorResult === 'skipped-unknown-account') return `${prefix} Codex CLI login left unchanged.`;
   if (mirrorResult === 'not-created-missing-cli-fields') {
     return `${prefix} Codex CLI mirror was not created because this login response lacked its required fields; run \`codex login\` once to initialize ~/.codex/auth.json.`;
   }
@@ -7230,7 +7256,8 @@ const loginCmd = program.command('login').description('Authenticate to an LLM pr
 loginCmd
   .command('openai-codex')
   .description('Sign in to OpenAI Codex via the ChatGPT device-code flow')
-  .action(async () => {
+  .option('--replace-codex-cli-login', 'if the Codex CLI (~/.codex/auth.json) is signed in to a different account, replace it with this login')
+  .action(async (opts: { replaceCodexCliLogin?: boolean }) => {
     ui.header('OpenAI Codex — device-code sign-in');
     try {
       const state = await loginWithCodex({
@@ -7255,7 +7282,21 @@ loginCmd
           }
         },
       });
-      ui.info(codexLoginSuccessMessage(state.codexMirrorResult));
+      // AUTH1 — another account's Codex CLI login is left alone unless the user says to replace it.
+      let mirrorResult = state.codexMirrorResult;
+      if (mirrorResult === 'skipped-different-account') {
+        let replace = opts.replaceCodexCliLogin === true;
+        if (!replace && process.stdin.isTTY && process.stdout.isTTY) {
+          const { createInterface } = await import('node:readline/promises');
+          const rl = createInterface({ input: process.stdin, output: process.stdout });
+          try {
+            const answer = await rl.question('  Your Codex CLI (~/.codex/auth.json) is signed in to a different account. Replace it with this login? [y/N] ');
+            replace = /^y(es)?$/i.test(answer.trim());
+          } finally { rl.close(); }
+        }
+        if (replace) mirrorResult = saveTokens('openai-codex', state.tokens, { replaceDifferentCodexAccount: true }).codexMirrorResult;
+      }
+      ui.info(codexLoginSuccessMessage(mirrorResult));
       ui.info(`Expires in ~${state.tokens.expiresAt ? Math.round((state.tokens.expiresAt - Date.now()) / 60000) : '?'}min; auto-refresh on next use.`);
     } catch (err: any) {
       ui.error(`login failed: ${err?.message ?? err}`);
@@ -7843,6 +7884,15 @@ sessionCmd
     console.log(res.formatted ?? '(no context)');
   });
 
+async function runFirstSetupForCli(cfg: ReturnType<typeof getUserConfig>, announceFallback = false): Promise<boolean> {
+  if (cfg.onboarding.webFirst === true) {
+    const { runWebFirstSetup } = await import('./onboarding/web-first.js');
+    if (await runWebFirstSetup({ config: cfg }) === 'link-shown') return false;
+    if (announceFallback) ui.info('No config yet — launching setup wizard first.');
+  }
+  return runOnboardingForCli();
+}
+
 async function runOnboardingForCli(): Promise<boolean> {
   try {
     await runOnboarding();
@@ -7878,8 +7928,8 @@ program
     if (opts.tools) announceChatToolsCompatibility();
     const cfg = getUserConfig();
     if (needsOnboarding(cfg)) {
-      ui.info('No config yet — launching setup wizard first.');
-      if (!await runOnboardingForCli()) return;
+      if (cfg.onboarding.webFirst !== true) ui.info('No config yet — launching setup wizard first.');
+      if (!await runFirstSetupForCli(cfg, true)) return;
     }
     const refreshed = reloadUserConfig();
     // ★ 관측갭 수리(2026-07-21·제1원칙·트랙A) — self-implement 자식 goal-loop(`chat --goal-loop`)은 데몬과
@@ -7945,8 +7995,8 @@ program
     }
     const cfg = getUserConfig();
     if (needsOnboarding(cfg)) {
-      ui.info('No config yet — launching setup wizard first.');
-      if (!await runOnboardingForCli()) return;
+      if (cfg.onboarding.webFirst !== true) ui.info('No config yet — launching setup wizard first.');
+      if (!await runFirstSetupForCli(cfg, true)) return;
     }
     const refreshed = reloadUserConfig();
     const { runRepl } = await import('./repl/index.js');
@@ -9935,6 +9985,22 @@ nexusCmd
     }
   });
 
+// 휴대폰 앱 온보딩 — 링크 하나(⊕ QR)로 이 Mac 의 넥서스에 붙인다(대표 2026-09-30 · 아이폰 첫 화면 단순화).
+program
+  .command('phone')
+  .description('Connect the phone app to this Mac')
+  .command('link')
+  .description('Print a one-tap connect link (and a QR code) for the Elanous phone app')
+  .option('--simulator', 'Use the loopback address (the simulator on this Mac) instead of the tailnet address — `--local` is taken by the global remote flag')
+  .option('--android [serial]', 'Hand the link straight to a USB-connected Android phone (adb reverse + am start · the token is never printed)')
+  .option('--temp', 'Use a short-lived token instead of the owner token')
+  .option('--ttl <duration>', 'Lifetime for --temp (max 24h)', '24h')
+  .option('--no-qr', 'Do not print a QR code')
+  .action(async (opts: { simulator?: boolean; android?: boolean | string; temp?: boolean; ttl: string; qr: boolean }) => {
+    const { runPhoneLink } = await import('./cli/phone-link.js');
+    process.exitCode = await runPhoneLink({ local: opts.simulator, android: opts.android, temp: opts.temp, ttl: opts.ttl, qr: opts.qr });
+  });
+
 // ── ACP — Agent Client Protocol (claude-code, codex, ...) ──
 const tokenCmd = program
   .command('token')
@@ -10603,7 +10669,7 @@ async function main(): Promise<void> {
   // gates on config completeness — no entry-mode branch.)
   const cfg = getUserConfig();
   if (needsOnboarding(cfg)) {
-    if (!await runOnboardingForCli()) return;
+    if (!await runFirstSetupForCli(cfg)) return;
   }
 
   // Active-provider banner so users know WHICH model/auth is about to
@@ -10687,8 +10753,8 @@ async function main(): Promise<void> {
 export function runCli(): void {
   main().catch((err) => {
     closeTui();
-    if (err instanceof HarnessCliInputError) {
-      console.error(`❌ ${err.message}`);
+    if (isCliUserError(err)) {
+      console.error(formatCliUserError(err));
       process.exit(1);
     }
     throw err;

package/src/instance/leader.ts

@@ -2,7 +2,7 @@
 import { INSTALLED_PACKAGE_MARKERS, isInstalledPackagePath } from './installed-package.js';
 import { existsSync, mkdirSync, readFileSync, realpathSync, renameSync, unlinkSync, writeFileSync } from 'node:fs';
 import { homedir } from 'node:os';
-import { dirname, join, resolve } from 'node:path';
+import { dirname, join, resolve, basename } from 'node:path';
 
 export interface LeaderRefusalRecord {
   refusedAt: string;
@@ -53,10 +53,22 @@ export function normalizeTree(p: string): string {
   try { return realpathSync(abs); } catch { return abs; }
 }
 
+/** npm/Homebrew/nvm `<prefix>/lib/node_modules` · bun `…/install/global/node_modules` · pnpm `…/global/<n>/node_modules`. */
+export function isGlobalNodeModules(dir: string): boolean {
+  if (basename(dir) !== 'node_modules') return false;
+  const parent = basename(dirname(dir));
+  return parent === 'lib' || parent === 'global' || (/^\d+$/.test(parent) && basename(dirname(dirname(dir))) === 'global');
+}
+
 export function treeFromScriptPath(scriptPath: string): string | null {
   let dir = dirname(normalizeTree(scriptPath));
   for (let i = 0; i < 30; i++) {
     if (existsSync(join(dir, '.git'))) return dir;
+    // A GLOBAL install stops at its node_modules: a git repo around the install prefix (Homebrew's /opt/homebrew
+    // is one; so is a dotfiles-managed home) is not this code's source tree. Without this stop `npm i -g` under
+    // Homebrew ran as a «source tree» test universe writing config to /opt/homebrew/.elanous-test (OB3 · 10-01).
+    // A project-local <checkout>/node_modules/elanous still resolves to the checkout (the existing design).
+    if (isGlobalNodeModules(dir)) return null;
     const parent = dirname(dir);
     if (parent === dir) return null;
     dir = parent;

package/src/intake-plane/collect-github.ts

@@ -131,7 +131,7 @@ export function signalsFromSnapshot(stars: number, prev: StarSnapshot | undefine
   return { stars, starsDelta, starsPerDay: starsDelta / span };
 }
 
-function appendSnapshots(root: string, rows: StarSnapshot[]): void {
+export function appendGithubStarSnapshots(root: string, rows: StarSnapshot[]): void {
   if (!rows.length) return;
   mkdirSync(intakeLedgerDir(root), { recursive: true });
   appendFileSync(githubStarsFile(root), rows.map((r) => JSON.stringify(r)).join('\n') + '\n');
@@ -154,6 +154,8 @@ export interface CollectGithubOpts {
   /** 스냅숏·비교의 «오늘». 생략하면 UTC 날짜. */
   day?: string;
   now?: () => Date;
+  /** 등록 원천이 질의 하나만 수집할 때; 생략 시 기존 관심 질의 전부. */
+  queries?: readonly string[];
 }
 
 /**
@@ -173,7 +175,7 @@ export async function collectGithubStars(
   const found: GithubStarRepo[] = [];
   // «급상승»은 최근에 생긴 저장소 중 별 순이다 — 전체 기간 별 순이면 활발한 거대 저장소가 매일 같은 목록으로 나온다(2026-09-26 검토).
   const windowStart = new Date(Date.parse(`${day}T00:00:00.000Z`) - days * 86_400_000).toISOString().slice(0, 10);
-  for (const query of GITHUB_STAR_QUERIES) {
+  for (const query of opts.queries ?? GITHUB_STAR_QUERIES) {
     const rows = await search(`${query} created:>=${windowStart}`, perQuery);
     const recent = rows.filter((r) => isRecentRepo(r, day, days));
     queries.push({ query, received: recent.length });
@@ -208,7 +210,7 @@ export async function collectGithubStars(
     day, days, perQuery, dryRun: !!opts.dryRun, queries, repos, raws: raws.length,
   };
   if (!opts.dryRun) {
-    appendSnapshots(root, repos.map((row) => ({ day, repo: row.repo, stars: row.stars })));
+    appendGithubStarSnapshots(root, repos.map((row) => ({ day, repo: row.repo, stars: row.stars })));
     result.ingest = ingestIntakeItems(root, 'github', raws);
   }
   debug.log('intake.collect', 'github-stars', {

package/src/intake-plane/collect-telegram-saved.ts

@@ -60,14 +60,26 @@ export async function collectTelegramSaved(root: string, fetch: FetchSavedMessag
 }
 
 /** GramJS 사용자 세션으로 `me` 대화를 읽는 실제 구현. 자격이 없으면 이유를 담아 던진다(값은 싣지 않는다). */
-export async function gramjsFetchSaved(env: NodeJS.ProcessEnv = process.env): Promise<{ fetch: FetchSavedMessages; close: () => Promise<void> }> {
+type GramjsModules = { TelegramClient: typeof import('telegram').TelegramClient; StringSession: typeof import('telegram/sessions').StringSession };
+const loadGramjs = async (): Promise<GramjsModules> => ({
+  TelegramClient: (await import('telegram')).TelegramClient,
+  StringSession: (await import('telegram/sessions')).StringSession,
+});
+
+export async function gramjsFetchSaved(
+  env: NodeJS.ProcessEnv = process.env,
+  load: () => Promise<GramjsModules> = loadGramjs,
+): Promise<{ fetch: FetchSavedMessages; close: () => Promise<void> }> {
   const apiId = Number(env.TELEGRAM_API_ID ?? 0);
   const apiHash = env.TELEGRAM_API_HASH ?? '';
   const session = env.TELEGRAM_USER_SESSION ?? '';
   const missing = [!apiId && 'TELEGRAM_API_ID', !apiHash && 'TELEGRAM_API_HASH', !session && 'TELEGRAM_USER_SESSION'].filter(Boolean);
   if (missing.length) throw new Error(`텔레그램 사용자 세션 자격이 없다: ${missing.join(' · ')} (docs/manual/MANUAL-telegram-unmanned-test-2026-07-21.md §1~§3)`);
-  const { TelegramClient } = await import('telegram');
-  const { StringSession } = await import('telegram/sessions');
+  // `telegram` is an optional dependency: its native websocket helpers have no Linux ARM64 build, so npm may leave it out.
+  let modules: GramjsModules;
+  try { modules = await load(); }
+  catch { throw new Error('텔레그램 사용자 세션 모듈(telegram)이 이 설치에 없다 — 선택 의존이라 Linux ARM64 등에서는 빠진다(npm i -g telegram 으로 따로 깔 수 있다)'); }
+  const { TelegramClient, StringSession } = modules;
   const client = new TelegramClient(new StringSession(session), apiId, apiHash, { connectionRetries: 3 });
   client.setLogLevel('error' as never);   // 연결 로그가 표준출력을 채우지 않게
   await client.connect();

package/src/intake-plane/discord-seat-work.ts

@@ -0,0 +1,56 @@
+import { parseSeatAddress, resolveSeat } from '../seat-address/seat-address.js';
+import {
+  submitIntakeWork,
+  type SubmitIntakeWorkDeps,
+} from './submit-intake-work.js';
+
+export interface DiscordSeatWorkMessage {
+  channelId: string;
+  messageId: string;
+  threadId?: string;
+}
+
+export interface DiscordSeatWorkDeps extends SubmitIntakeWorkDeps {
+  submit?: typeof submitIntakeWork;
+}
+
+/** Addressed Discord work goes through the graph intake door, not the chat turn. */
+export async function handleDiscordSeatWork(
+  text: string,
+  msg: DiscordSeatWorkMessage,
+  deps: DiscordSeatWorkDeps = {},
+): Promise<string | null> {
+  const address = parseSeatAddress(text);
+  if (!address) return null;
+
+  const seats = address.seats.map((name) => ({ name, seat: resolveSeat(name) }));
+  const unknown = seats.filter(({ seat }) => !seat).map(({ name }) => `@${name}`);
+  if (unknown.length) return `어느 좌석을 말씀하시나요? ${unknown.join(', ')}은(는) 등록된 좌석이 아닙니다. 좌석을 확인해 다시 보내 주세요.`;
+  const body = address.body.trim();
+  if (!body) return '어떤 일을 맡길까요? 좌석 주소 뒤에 요청 내용을 적어 다시 보내 주세요.';
+
+  const reportTo = {
+    channel: 'discord' as const,
+    channelId: msg.channelId,
+    ...(msg.threadId ? { discordThreadId: msg.threadId } : {}),
+  };
+  const replies: string[] = [];
+  for (const { seat } of seats) {
+    if (!seat) continue;
+    const label = seat.title ?? seat.id;
+    const result = await (deps.submit ?? submitIntakeWork)({
+      text: `@${label} ${body}`,
+      track: 'graph',
+      origin: {
+        kind: 'external', ledgerSource: 'memo', provider: 'other',
+        ref: `discord:${msg.channelId}:${msg.messageId}`, reportTo,
+      },
+    }, deps);
+    if (result.ok && result.track === 'graph') {
+      replies.push(`@${label} 접수번호: ${result.acceptanceId}`);
+    } else {
+      replies.push(`@${label} 접수 실패 — ${result.ok ? '접수번호가 없습니다' : result.reason.split('\n')[0]!.slice(0, 200)}`);
+    }
+  }
+  return replies.join('\n');
+}