elanous 0.2.6 → 0.2.8

package/src/index.ts

@@ -9,6 +9,9 @@ import { LOGS_SINCE_OPTION, registerLogsCommands } from './cli/logs-cli.js';
 import { registerDocsCommands } from './cli/docs-cli.js';
 import { registerA2ACommands } from './cli/a2a-cli.js';
 import { registerPluginCommands } from './cli/plugin-cli.js';
+import { registerConnectCommand, registerSkillsCommands } from './cli/skills-cli.js';
+import { registerImportCommand } from './cli/import-cli.js';
+import { registerPersonaCommands } from './cli/persona-cli.js';
 import { registerFleetCommands } from './cli/fleet-cli.js';
 import { readPipedStdin } from './cli/piped-stdin.js';
 import { writeStdoutJson } from './cli/stdout-json.js';
@@ -62,6 +65,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';
@@ -74,6 +78,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
@@ -95,7 +100,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';
@@ -152,7 +158,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';
@@ -164,6 +170,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,
@@ -864,6 +871,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);
@@ -873,6 +888,10 @@ registerCardCommand(program);
 registerLaunchHeadCommands(program);
 registerA2ACommands(program);
 registerPluginCommands(program);
+registerSkillsCommands(program);
+registerConnectCommand(program);
+registerImportCommand(program);
+registerPersonaCommands(program);
 
 const marketCmd = program.command('market').description('Signed plugin marketplace');
 marketCmd.command('publish').description('Publish a local signed marketplace index and archives')
@@ -905,6 +924,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;
@@ -1002,7 +1025,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
@@ -1028,6 +1051,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')
@@ -1076,6 +1100,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`)')
@@ -2952,6 +2978,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')
@@ -4155,6 +4184,9 @@ const selfOrchestrateCmd = selfCmd
       });
       process.env[HARNESS_RUN_ID_ENV] = runId;
       reportRunId = runId;
+      // HS1 — `harness stop <runId>` must find this process from the moment the run ID exists.
+      try { (await import('./self-dev/orchestrate.js')).writeRunPidRecord(runId); }
+      catch (error) { debug.log('self-dev.orchestrate', 'early-pid-failed', { runId, error: String(error) }, { level: 'warn' }); }
       const createdAt = prior?.createdAt ?? Date.now();
       const { bindOrchestrateRunLedger } = await import('./self-dev/self-orchestrate-runtime.js');
       const { checkpoint } = bindOrchestrateRunLedger({
@@ -4280,7 +4312,26 @@ const selfOrchestrateCmd = selfCmd
           grokApiKeyOptIn = getUserConfig().harness?.pod?.grokApiKeyOptIn === true;
           const credential = resolveGrokCredential();
           const { resolveCodexQuotaPolicy, codexPolicyAllowsCredits, codexPolicyAllowsFallback } = await import('./oauth/codex-quota-policy.js');
-          const quotaPolicy = resolveCodexQuotaPolicy(getUserConfig().llm).policy;
+          const resolvedQuota = resolveCodexQuotaPolicy(getUserConfig().llm);
+          const quotaPolicy = resolvedQuota.policy;
+          // POL1 — say which policy this launch uses and where it came from; warn when a test universe disagrees with production.
+          try {
+            const { effectiveInstanceRoot, prodInstanceRoot } = await import('./instance/resolve.js');
+            const { describeLaunchQuotaPolicy } = await import('./oauth/codex-quota-policy.js');
+            const root = effectiveInstanceRoot();
+            const kind = root === prodInstanceRoot() ? 'prod' as const : 'test' as const;
+            let production: ReturnType<typeof resolveCodexQuotaPolicy> | undefined;
+            if (kind === 'test') {
+              try {
+                const { readFileSync } = await import('node:fs');
+                const prodLlm = (JSON.parse(readFileSync(`${prodInstanceRoot()}/config.json`, 'utf8')) as { llm?: Record<string, unknown> }).llm;
+                production = resolveCodexQuotaPolicy(prodLlm);
+              } catch { /* no production config on this machine */ }
+            }
+            const described = describeLaunchQuotaPolicy({ current: resolvedQuota, universe: { kind, root }, ...(production ? { production } : {}) });
+            debug.log('self-implement.pod', 'quota-policy', { policy: resolvedQuota.policy, source: resolvedQuota.source, universe: kind, productionPolicy: production?.policy ?? null });
+            if (!opts.json) { ui.info(described.line); if (described.warning) ui.warn(described.warning); }
+          } catch { /* the line is advice; the launch goes on */ }
           const plan = planPodProvider({
             codexCandidates: inspectCodexRotation().candidates,
             // Per-account caps (대표 default:97) override the Pod default cap — without them default was dropped at 60%.
@@ -7019,6 +7070,7 @@ missionCmd
 
 registerTasksCommands(program);
 registerLabelsCommands(program);
+registerMsgCommands(program);
 
 // ── ask alias (script-friendly one-shot query) ──
 program
@@ -7027,7 +7079,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,
@@ -7193,9 +7266,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.`;
   }
@@ -7208,17 +7285,33 @@ 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 () => {
-    ui.header('OpenAI Codex — device-code sign-in');
+  .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 }) => {
+    // OB5d — say why there is no browser (ssh · no display) and what to do instead; otherwise try the browser first.
+    const { browserUnavailableReason } = await import('./oauth/browser-availability.js');
+    const noBrowser = browserUnavailableReason();
+    let browserState: Awaited<ReturnType<typeof import('./oauth/codex-browser-login.js')['loginWithCodexBrowser']>> | null = null;
+    if (!noBrowser) {
+      ui.header('OpenAI Codex — 브라우저 로그인');
+      console.log('  브라우저에서 로그인을 마치세요 — 끝나면 자동으로 이어집니다.');
+      try {
+        const { loginWithCodexBrowser } = await import('./oauth/codex-browser-login.js');
+        browserState = await loginWithCodexBrowser();
+      } catch {
+        console.log('  브라우저 로그인이 안 됐습니다 — 코드로 이어갑니다.');
+      }
+    }
+    if (!browserState) ui.header('OpenAI Codex — 코드로 로그인');
+    if (noBrowser) console.log(`  ${noBrowser}`);
     try {
-      const state = await loginWithCodex({
+      const state = browserState ?? await loginWithCodex({
         onProgress: (p) => {
           if (p.type === 'user_code' && p.userCode) {
             console.log('');
-            console.log(`  1) Open in any browser:   ${p.loginUrl}`);
-            console.log(`  2) Enter this code:       ${p.userCode}`);
+            console.log(`  1) 아무 브라우저에서 열기: ${p.loginUrl}`);
+            console.log(`  2) 코드 입력:             ${p.userCode}`);
             console.log('');
-            console.log('  Waiting for sign-in… (Ctrl+C to cancel)');
+            console.log('  로그인을 기다리는 중… (취소: Ctrl+C)');
           }
           if (p.type === 'polling' && p.pollAttempt === 1) {
             process.stdout.write('  .');
@@ -7233,7 +7326,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}`);
@@ -7821,6 +7928,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();
@@ -7856,8 +7972,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`)은 데몬과
@@ -7923,8 +8039,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');
@@ -9725,6 +9841,23 @@ nexusChannelBotCmd
     process.exit(result.exitCode);
   });
 
+// EN13 — bring an existing Telegram/Discord bot over from OpenClaw · Hermes · the previous elanous (~/.monad).
+nexusChannelBotCmd
+  .command('import')
+  .description('Find Telegram/Discord bot settings you already use (OpenClaw, Hermes, previous elanous), preview them with the token masked, and store them after you agree.')
+  .option('--yes', 'Import without asking')
+  .action(async (opts: { yes?: boolean }) => {
+    const { runChannelImport } = await import('./channel-import/run.js');
+    const { createInterface } = await import('node:readline/promises');
+    const ask = process.stdin.isTTY ? async (question: string): Promise<boolean> => {
+      const rl = createInterface({ input: process.stdin, output: process.stdout });
+      try { const answer = (await rl.question(question)).trim(); return answer === '' || /^(y|yes|예|네)$/i.test(answer); }
+      finally { rl.close(); }
+    } : undefined;
+    const result = await runChannelImport({ yes: opts.yes, ...(ask ? { ask } : {}) });
+    process.exit(result.exitCode);
+  });
+
 // FU A6-real P5 (2026-05-11) — interactive Firecrawl setup.
 // Walks the user through CLI detection + API key entry + persist to
 // `registry.discovery.firecrawl.apiKey`. `--api-key <value>` skips
@@ -10389,6 +10522,14 @@ async function main(): Promise<void> {
   //   elanous --acp-server --transport=unix-socket --socket-path=/tmp/x.sock
   //   elanous --acp-server --transport=websocket --port=31415
   //   elanous --acp-server --transport=websocket --no-auth   # skip token check
+  if (rawArgs.includes('--acp-server') && rawArgs.includes('--login')) {
+    // EN10a — an ACP client's terminal auth re-launches `elanous --acp-server --login`: run the sign-in in that terminal and exit with its status.
+    const { ACP_LOGIN_SUBCOMMAND, currentLaunch } = await import('./acp/auth-methods.js');
+    const launch = currentLaunch();
+    const { spawnSync } = await import('node:child_process');
+    const run = spawnSync(launch.command, [...launch.args, ...ACP_LOGIN_SUBCOMMAND], { stdio: 'inherit' });
+    process.exit(run.status ?? 1);
+  }
   if (rawArgs.includes('--acp-server')) {
     const { bootAcpServer, parseAcpBootArgs } = await import('./boot/acp-server.js');
     const { createDaemonRuntime } = await import('./boot/daemon-runtime.js');
@@ -10597,7 +10738,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
@@ -10679,12 +10820,18 @@ async function main(): Promise<void> {
  * 회귀 방어 = `src/cli-entry.test.ts`(실물 `bin/elanous.mjs` 를 spawn 한다).
  */
 export function runCli(): void {
-  main().catch((err) => {
+  main().catch(async (err) => {
     closeTui();
-    if (err instanceof HarnessCliInputError) {
-      console.error(`❌ ${err.message}`);
+    if (isCliUserError(err)) {
+      console.error(formatCliUserError(err));
       process.exit(1);
     }
+    // ER1 — a real crash is reported once (consented · scrubbed · never blocks more than the send timeout).
+    try {
+      const { reportError } = await import('./error-report/report.js');
+      const outcome = await reportError({ code: 'cli-crash', message: err instanceof Error ? `${err.name}: ${err.message}` : String(err), ...(err instanceof Error && err.stack ? { stack: err.stack } : {}), surface: 'cli' });
+      if (outcome.sent) console.error(`오류를 운영팀에 알렸습니다${outcome.reportId ? ` (보고 번호 ${outcome.reportId})` : ''}.`);
+    } catch { /* the crash itself is what matters */ }
     throw err;
   });
 }

package/src/input-core/text-entry.ts

@@ -40,15 +40,23 @@ export function keyEventToTextInsertion(
   return preservePrintableText(ev, name);
 }
 
+/** Hangul Compatibility Jamo (ㄱ…ㅣ · ㅋㅋ · ㅠㅠ). The key parser maps a lone jamo keystroke to the QWERTY key
+ *  on the same position so hotkeys work under the Korean IME — but as TEXT it must stay the jamo the person typed
+ *  (U1 · 2026-10-02: «ㅋㅋㅋ ㅠㅠ» came out as «zzz bb» in the chat input). */
+const COMPAT_JAMO = /^[\u3131-\u318E]$/;
+
 function preservePrintableText(ev: KeyEvent, name: string): string {
+  // The chat composer passes the TUI key (original bytes on `raw`); other composers pass a KeyEvent (`sequence`).
+  const sequence = ev.sequence ?? (ev as { raw?: string }).raw;
+  if (sequence && name.length === 1 && COMPAT_JAMO.test(sequence)) return sequence;
   if (
-    ev.sequence
-    && ev.sequence.length === 1
+    sequence
+    && sequence.length === 1
     && name.length === 1
-    && ev.sequence !== name
-    && ev.sequence.toLowerCase() === name.toLowerCase()
+    && sequence !== name
+    && sequence.toLowerCase() === name.toLowerCase()
   ) {
-    return ev.sequence;
+    return sequence;
   }
   if (name.length === 1) return ev.shift ? name.toUpperCase() : name;
   return name;

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');
+}