elanous 0.2.10 → 0.2.12

package/src/telegram.ts

@@ -25,6 +25,7 @@ import { randomUUID } from 'node:crypto';
 import { buildTurnOutputTextBlocks } from './input/turn-output-block.js';
 import { selectTurnOutputTextForSink } from './input/turn-output-sink-registry.js';
 import { debug } from './debug/log.js';
+import { botAudienceFor, filterBotCommands, readBotAudience } from './maturity/bot-command-maturity.js';
 import { resolveChannelBotToken } from './channel-bot-token.js';
 import type { TelegramVoiceAdapter } from './voice/channel-adapters/telegram-voice-adapter.js';
 import { createTelegramSurfaceHitl, type TelegramSurfaceHitl } from './hitl/telegram-surface-hitl.js';
@@ -67,11 +68,15 @@ import { runUrlRoute } from './skills/url-route-exec.js';
 import { recordRoutedLinkAbsorbed } from './intake-plane/link-ledger.js';
 import { classifyFrontInput } from './intake-plane/front-classifier.js';
 import { handleTelegramSeatWork, type TelegramSeatWorkDeps } from './intake-plane/telegram-seat-work.js';
+import { deliverSeatAnswers } from './seat-dispatch/seat-ask.js';
 import { effectiveInstanceRoot } from './instance/resolve.js';
 import { getElanousConfigDir } from './elanous-config-dir.js';
 import { defaultFieldEvent, FieldUploadError, parseFieldCaption, resolveFieldMime, saveFieldMedia } from './field/field-media.js';
 import { scheduleFieldReel, type FieldReelOptions } from './field/field-reel.js';
+import { handleTelegramFieldNote } from './field-note/telegram.js';
+import type { TranscriptionEngine, FieldAudio } from './field-note/transcribe.js';
 import { maybeHandleCardPhoto, type CardPhotoDeps } from './telegram-card-followup.js';
+import { attachTelegramProjectButtons } from './telegram-project-command.js';
 
 export type TgAttachmentKind = 'photo' | 'voice' | 'audio' | 'document';
 
@@ -99,6 +104,8 @@ export interface TgIncoming {
   text: string;
   messageId: number;
   threadId?: number;
+  /** Telegram message timestamp, not poll time. */
+  receivedAt?: string;
   isDm: boolean;
   isGroup: boolean;
   /** Zero or more attached media — populated by parseUpdate from
@@ -217,6 +224,9 @@ export interface TelegramBotOpts {
   fieldRootDir?: () => string;
   /** 시험에서는 실제 렌더 대신 가짜 실행기를 주입한다. */
   fieldReel?: FieldReelOptions;
+  /** NOTE3a engine and audio decoder are injected; no transcription provider is assumed. */
+  fieldNoteEngine?: TranscriptionEngine;
+  fieldNoteDecodeAudio?: (file: string, recordedAt: string) => FieldAudio;
   /** Test seam for the business-card graph and its private run root. */
   cardFollowupDeps?: Pick<CardPhotoDeps, 'runGraph' | 'rootDir' | 'ocrText'>;
 }
@@ -276,7 +286,7 @@ export function classifyTelegramText(
 
 export class TelegramBot {
   private readonly token: string;
-  private readonly botId: string;
+  readonly botId: string;
   private readonly allowedUsers: Set<number>;
   private readonly onMessage: TelegramBotOpts['onMessage'];
   private readonly fetchImpl: typeof fetch;
@@ -336,8 +346,11 @@ export class TelegramBot {
   private readonly fieldDefaultEventOpt?: string;
   private readonly fieldRootDir: () => string;
   private readonly fieldReel?: FieldReelOptions;
+  private readonly fieldNoteEngine?: TranscriptionEngine;
+  private readonly fieldNoteDecodeAudio?: (file: string, recordedAt: string) => FieldAudio;
   private readonly cardFollowupDeps: Pick<CardPhotoDeps, 'runGraph' | 'rootDir' | 'ocrText'>;
   private readonly seatWorkDeps: TelegramSeatWorkDeps;
+  private seatAskTimer: ReturnType<typeof setInterval> | null = null;
   /** 앨범 id → `#현장` 행사 · 답장 디바운스. 태그된 앨범만 들어온다. */
   private readonly fieldGroups = new Map<string, {
     event: string; mode?: 'instant'; at: number; chatId: number; threadId?: number; replyTo: number; count: number;
@@ -372,8 +385,18 @@ export class TelegramBot {
     this.fieldDefaultEventOpt = opts.fieldDefaultEvent;
     this.fieldRootDir = opts.fieldRootDir ?? getElanousConfigDir;
     this.fieldReel = opts.fieldReel;
+    this.fieldNoteEngine = opts.fieldNoteEngine;
+    this.fieldNoteDecodeAudio = opts.fieldNoteDecodeAudio;
     this.cardFollowupDeps = opts.cardFollowupDeps ?? {};
-    this.seatWorkDeps = opts.seatWorkDeps ?? {};
+    this.seatWorkDeps = { ...opts.seatWorkDeps, askDeps: { ...opts.seatWorkDeps?.askDeps,
+      channel: 'telegram', botId: this.botId,
+      send: opts.seatWorkDeps?.askDeps?.send ?? (async (origin, text) => {
+        if (origin.channel !== 'telegram') throw new Error('seat ask belongs to another surface');
+        const posted = await this.sendMessage(Number(origin.chatId), text, { replyTo: origin.messageId, threadId: origin.threadId });
+        if (!posted) throw new Error('Telegram seat ask reply was not posted');
+      }),
+    } };
+
     if (opts.onTriggerTap) {
       // Assign through `as unknown` to bypass `readonly` + private —
       // the tap is set once at construction and never reassigned.
@@ -1120,6 +1143,9 @@ export class TelegramBot {
   async start(): Promise<void> {
     this.running = true;
     this.log(`telegram bot starting (allowlist size ${this.allowedUsers.size})`);
+    this.seatAskTimer = setInterval(() => {
+      void deliverSeatAnswers(this.seatWorkDeps.askDeps!).catch((error) => this.log(`seat ask delivery failed: ${String(error)}`));
+    }, 10_000);
     if (this.allowedUsers.size === 0) this.log('telegram.owner-gate empty-allowlist');
 
     // Publish the slash-command menu to Telegram. Clients pick up the
@@ -1128,9 +1154,16 @@ export class TelegramBot {
     // still processes `/commands` via the incoming-message dispatch
     // path, users just don't get the autocomplete.
     if (this.slashCommands.length > 0) {
+      const audience = this.slashContext
+        ? readBotAudience((this.slashContext.userConfig.raw?.telegram as { commandAudience?: unknown } | undefined)?.commandAudience)
+        : botAudienceFor('telegram');
+      const commands = filterBotCommands('telegram', this.slashCommands, audience);
+      debug.log('telegram.command', 'menu-filtered', {
+        total: this.slashCommands.length, shown: commands.length, ...audience,
+      });
       try {
         const result = await this.apiCall<unknown>('setMyCommands', {
-          commands: toTelegramBotCommands(this.slashCommands),
+          commands: toTelegramBotCommands(commands),
         });
         debug.log('telegram.command', 'published', { success: true, result });
         this.log(`telegram: setMyCommands published (${String(result)})`);
@@ -1151,6 +1184,7 @@ export class TelegramBot {
     const CONFLICT_BACKOFF_CAP = 60_000;
     while (this.running) {
       try {
+        await deliverSeatAnswers(this.seatWorkDeps.askDeps!);
         const wantCallbackQuery = this.callbackHandlers.size > 0;
         const wantReaction = this.reactionHandlers.size > 0;
         // allowed_updates 는 명시한 것만 받으므로 등록된 핸들러 종류만 추가(비파괴 — 핸들러
@@ -1192,6 +1226,7 @@ export class TelegramBot {
               userId: cq.from.id,
               userName: cq.from.username ?? cq.from.first_name,
               chatId: cq.message?.chat.id,
+              threadId: cq.message?.message_thread_id,
               messageId: cq.message?.message_id,
               data: cq.data ?? '',
             };
@@ -1292,7 +1327,11 @@ export class TelegramBot {
     this.log('telegram bot stopped');
   }
 
-  stop(): void { this.running = false; }
+  stop(): void {
+    this.running = false;
+    if (this.seatAskTimer) clearInterval(this.seatAskTimer);
+    this.seatAskTimer = null;
+  }
 
   /** Download + normalize this message's attachments into the shape
    *  the ACP content-blocks module consumes. Called lazily by slash
@@ -1502,6 +1541,13 @@ export class TelegramBot {
     }
     // 현장 업로드 — `#현장` 캡션(또는 태그된 앨범의 나머지)의 사진·영상은 LLM 대신 현장 폴더로.
     if (await this.tryHandleFieldUpload(ctx)) return;
+    if (await handleTelegramFieldNote(ctx, {
+      rootDir: this.fieldRootDir(),
+      download: (fileId) => this.downloadFile(fileId),
+      reply: async (incoming, text) => { await this.sendMessage(incoming.chatId, text, { replyTo: incoming.messageId, threadId: incoming.threadId }); },
+      engine: this.fieldNoteEngine, decodeAudio: this.fieldNoteDecodeAudio,
+      now: () => new Date(this.nowImpl()),
+    })) return;
     if (await maybeHandleCardPhoto(ctx, {
       isOwner: (userId) => this.isOwnerAllowed(userId),
       isFieldAlbum: (id) => this.fieldGroups.has(id),
@@ -1801,6 +1847,7 @@ export class TelegramBot {
             const reply = await slashParse.cmd.handler(slashParse.args, ctx, {
               userConfig: this.slashContext.userConfig,
               allCommands: this.slashCommands,
+              sendButtons: async (text, buttons) => { await this.sendInlineKeyboard(ctx.chatId, text, buttons, { replyTo: ctx.messageId, threadId: ctx.threadId }); },
               downloadAttachments: () => this.downloadCtxAttachments(ctx),
               daemonBridge: this.slashContext.daemonBridge,
               hitlConfirmChannel: this.hitlConfirmChannelForChat(ctx.chatId, ctx.threadId),
@@ -1985,6 +2032,7 @@ export class TelegramBot {
               return await slashParse.cmd.handler(slashParse.args, ctx, {
                 userConfig: this.slashContext!.userConfig,
                 allCommands: this.slashCommands,
+                sendButtons: async (text, buttons) => { await this.sendInlineKeyboard(ctx.chatId, text, buttons, { replyTo: ctx.messageId, threadId: ctx.threadId }); },
                 streamer,
                 downloadAttachments: () => this.downloadCtxAttachments(ctx),
                 daemonBridge: this.slashContext!.daemonBridge,
@@ -2004,6 +2052,7 @@ export class TelegramBot {
               return await runAcpViaSlash(activeBackend, [ctx.text], ctx, {
                 userConfig: this.slashContext!.userConfig,
                 allCommands: this.slashCommands,
+                sendButtons: async (text, buttons) => { await this.sendInlineKeyboard(ctx.chatId, text, buttons, { replyTo: ctx.messageId, threadId: ctx.threadId }); },
                 streamer,
                 downloadAttachments: () => this.downloadCtxAttachments(ctx),
                 daemonBridge: this.slashContext!.daemonBridge,
@@ -2244,6 +2293,7 @@ interface RawUpdate {
   update_id: number;
   message?: {
     message_id: number;
+    date?: number;
     from?: { id: number; first_name?: string; username?: string };
     chat: { id: number; type: 'private' | 'group' | 'supergroup' | 'channel' };
     text?: string;
@@ -2260,7 +2310,7 @@ interface RawUpdate {
   callback_query?: {
     id: string;
     from: { id: number; first_name?: string; username?: string };
-    message?: { message_id: number; chat: { id: number } };
+    message?: { message_id: number; message_thread_id?: number; chat: { id: number } };
     data?: string;
     chat_instance?: string;
   };
@@ -2279,6 +2329,7 @@ export interface TgCallbackQuery {
   userId: number;
   userName?: string;
   chatId?: number;
+  threadId?: number;
   messageId?: number;
   data: string;
 }
@@ -2371,6 +2422,7 @@ export function parseUpdate(u: RawUpdate): TgIncoming | null {
     text: (typeof m.text === 'string' ? m.text : (m.caption ?? '')),
     messageId: m.message_id,
     threadId: m.message_thread_id,
+    ...(typeof m.date === 'number' ? { receivedAt: new Date(m.date * 1000).toISOString() } : {}),
     isDm,
     isGroup: !isDm,
     attachments,
@@ -2886,9 +2938,10 @@ export function botFromConfig(opts: BotFromConfigOpts): TelegramBot {
   botRef.ensureSurfaceHitl();
   // DEC-TG(대표 10-02) — decision cards on the MAIN bot only (other channel pollers carry other tokens). The ticker
   // itself sends only while this bot polls, so a send-only nexus bot never duplicates the standalone poller's cards.
-  if (opts.userConfig.raw?.decisions === undefined || (opts.userConfig.raw.decisions as { cards?: unknown }).cards !== false) {
-    const mainToken = resolveChannelBotToken('telegram', opts.userConfig)?.token;
-    if (mainToken && botToken === mainToken) {
+  const mainToken = resolveChannelBotToken('telegram', opts.userConfig)?.token;
+  if (mainToken && botToken === mainToken) {
+    attachTelegramProjectButtons(botRef, opts.userConfig);
+    if (opts.userConfig.raw?.decisions === undefined || (opts.userConfig.raw.decisions as { cards?: unknown }).cards !== false) {
       const bot = botRef;
       void import('./decisions/telegram-decision-cards.js')
         .then(({ attachTelegramDecisionCards }) => { attachTelegramDecisionCards(bot, opts.userConfig); })

package/src/tool-runtime/self-cognition-runtimes.ts

@@ -11,6 +11,7 @@ export const SELF_COGNITION_TOOL_NAMES = [
   'logs_query',
   'ops_status',
   'memory_recall',
+  'context_now',
 ] as const;
 
 type SelfCognitionToolName = (typeof SELF_COGNITION_TOOL_NAMES)[number];
@@ -23,7 +24,14 @@ function coreTools(): CoreToolsModule {
   return require('../domains/core-tools.js') as CoreToolsModule;
 }
 
+export const CONTEXT_NOW_SPEC: LLMToolSpec = {
+  name: 'context_now',
+  description: '지금 무엇이 돌고 있는지 릴리스 칸·열린 결정·자리 원장·최근 맥락 이벤트의 출처 있는 요약을 읽는다. 원문 대화는 반환하지 않는다.',
+  parameters: { type: 'object', properties: { topic: { type: 'string', description: '칸 id·제목 또는 이벤트 요약에 들어 있는 낱말(선택).' } }, required: [] },
+};
+
 function coreSpec(name: SelfCognitionToolName): LLMToolSpec {
+  if (name === 'context_now') return CONTEXT_NOW_SPEC;
   const spec = coreTools().CORE_TOOL_SPECS.find(candidate => candidate.name === name);
   if (!spec) throw new Error(`Missing core tool spec for self-cognition runtime '${name}'`);
   return spec;
@@ -193,9 +201,11 @@ export const SELF_COGNITION_RUNTIMES: readonly ToolRuntime[] = SELF_COGNITION_TO
   get spec() {
     return coreSpec(name);
   },
-  run: async (args, ctx) => name === 'memory_recall' || name === 'self_recall'
-    ? runRecall(name, args, ctx)
-    : toToolRunResult(await coreTools().buildCoreTools().dispatch(name, args)),
+  run: async (args, ctx) => name === 'context_now'
+    ? (await import('../context-bus/context-now.js')).contextNow({ ...(typeof args.topic === 'string' ? { topic: args.topic } : {}) })
+    : name === 'memory_recall' || name === 'self_recall'
+      ? runRecall(name, args, ctx)
+      : toToolRunResult(await coreTools().buildCoreTools().dispatch(name, args)),
 }));
 
 /** MCP catalog metadata derived from the same name ledger as the runtimes. */

package/src/user-config.ts

@@ -50,7 +50,7 @@ import type { SkillTier } from './skills/runner.js';
 import { sharedAgentSkillRoots } from './skills/shared-agent-skill-roots.js';
 import {
   isModelTier,
-  isModelTierPersona,
+  isModelTierProfile,
   type BudgetUserConfig,
   type ModelTier,
   type ModelTierUserConfig,
@@ -450,6 +450,8 @@ export interface SkillSource {
 export interface SkillsConfig {
   activeSet: SkillSetName;
   dirs: string[];
+  /** Gift redemption API origin; defaults to https://elanous.ai. */
+  giftEndpoint?: string;
   /** Include the existing shared ~/.agents/skills directory. Default true; false opts out. */
   includeSharedAgentSkills?: boolean;
   /**
@@ -766,6 +768,7 @@ function skillsDefaults(): SkillsConfig {
   return {
     activeSet: 'claudecode',
     dirs: d ? [d] : [],
+    giftEndpoint: 'https://elanous.ai',
     includeSharedAgentSkills: true,
     allow: [],
     deny: [],
@@ -912,8 +915,8 @@ export interface TelegramConfig {
   /** 누가 Q&A 폴링을 하나 — 기본(없음·`'nexus'`)은 넥서스 데몬, `'standalone'` 이면
    *  넥서스는 폴링하지 않고 `elanous telegram run` 이 맡는다. */
   poller?: 'nexus' | 'standalone';
-  /** 발송 목적(kind) → 채널 역할. 명시 `channels` 가 있을 때만 쓴다 — 표에 없는 kind 는 옛 `reportChannel` 로 간다.
-   *  기본표는 `DEFAULT_KIND_ROLES`(telegram-report.ts) · 여기 값이 덮어쓴다. */
+  /** 레거시 kind→역할 설정(읽기 호환). 선택한 채널의 봇이 kind 정책의
+   *  운영/매매 경계를 지킬 때만 발송 라우팅에 적용한다. */
   kindRoles?: Record<string, string>;
   /** `#현장` 캡션에 행사 슬러그가 없을 때 쓸 기본 행사(예: `marketers-night-2026-10`). 없으면 `field-<로컬 날짜>`. */
   fieldDefaultEvent?: string;
@@ -2023,7 +2026,12 @@ function parseModelTierFieldOrUndefined(v: unknown): ModelTier | undefined {
 function parseModelTierConfig(raw: unknown): ModelTierUserConfig | undefined {
   if (!raw || typeof raw !== 'object' || Array.isArray(raw)) return undefined;
   const r = raw as Record<string, unknown>;
-  const persona = isModelTierPersona(r.persona) ? r.persona : undefined;
+  // Compatibility is read-only: the normalized config and subsequent writes use profile.
+  let profile = isModelTierProfile(r.profile) ? r.profile : undefined;
+  if (r.profile === undefined && r.persona !== undefined) {
+    debug.log('config', 'deprecated-key', { from: 'modelTier.persona', to: 'modelTier.profile' });
+    if (isModelTierProfile(r.persona)) profile = r.persona;
+  }
   const preset = typeof r.preset === 'string' && r.preset.trim().length > 0
     ? r.preset.trim()
     : undefined;
@@ -2057,7 +2065,7 @@ function parseModelTierConfig(raw: unknown): ModelTierUserConfig | undefined {
   const embedding = parseModelTierFieldOrUndefined(r.embedding);
   const vision = parseModelTierFieldOrUndefined(r.vision);
   const out: ModelTierUserConfig = {
-    ...spreadIfDefined('persona', persona),
+    ...spreadIfDefined('profile', profile),
     ...spreadIfDefined('preset', preset),
     ...spreadIfDefined('voice', voice),
     ...spreadIfDefined('llm', llm),
@@ -3232,7 +3240,7 @@ export interface AutoReviewConfig {
   };
 }
 
-export type ModelRole = 'implement' | 'review' | 'research' | 'planning' | 'audit' | 'classify';
+export type ModelRole = 'implement' | 'review' | 'research' | 'planning' | 'audit' | 'classify' | 'graph-grow';
 
 export interface RoleModelConfig {
   implement?: string;
@@ -3241,6 +3249,7 @@ export interface RoleModelConfig {
   planning?: string;
   audit?: string;
   classify?: string;
+  'graph-grow'?: string;
 }
 
 /** Sparse provider-agnostic model tier preferences by execution role. */
@@ -3307,6 +3316,7 @@ export const ROLE_MODEL_DEFAULTS: Record<ModelRole, { environment: string; tier:
   planning: { environment: 'ELANOUS_SKILL_PLAN_MODEL', tier: 'best' },
   audit: { environment: 'ELANOUS_MEMORY_JUDGE_MODEL', tier: 'better' },
   classify: { environment: 'ELANOUS_ACTION_CLASSIFIER_MODEL', tier: 'budget' },
+  'graph-grow': { environment: 'ELANOUS_GRAPH_GROW_MODEL', tier: 'better' },
 };
 
 /** Resolve `auto` through the same runtime provider selector that dispatches LLM calls.
@@ -3429,7 +3439,9 @@ export interface RoleLlmResolveOptions {
  *  ⛔ 아무 override 도 없으면 ③~⑥ 만 타므로 산출이 종전과 «같다»(§4f 불변식 · NL 진입 무변경). */
 export function resolveRoleLlm(role: ModelRole, opts: RoleLlmResolveOptions = {}): RoleLlmResolution {
   const config = opts.config ?? getUserConfig();
-  const globalProvider = resolveActiveProvider(config);
+  // 전역 provider 는 필요할 때만 푼다 — 역할이 provider 를 명시했으면 전역 provider 가 없어도 해석된다.
+  let activeProvider: LLMProviderName | undefined;
+  const globalProvider = (): LLMProviderName => (activeProvider ??= resolveActiveProvider(config));
   // 명시 인자가 있으면 그것이 진실 — 없을 때만 발사 시점에 정해진 값을 읽는다(둘 다 source='flag').
   const flagSpec = (opts.overrides ?? launchRoleLlmOverrides)?.[role];
   const layers: ReadonlyArray<readonly [RoleLlmSpec | undefined, RoleLlmSource]> = [
@@ -3438,7 +3450,7 @@ export function resolveRoleLlm(role: ModelRole, opts: RoleLlmResolveOptions = {}
   ];
   for (const [spec, source] of layers) {
     if (!spec) continue;
-    const provider = spec.provider ?? globalProvider;
+    const provider = spec.provider ?? globalProvider();
     const pinned = spec.model?.trim();
     let resolution: RoleLlmResolution | undefined;
     if (pinned) resolution = { model: pinned, provider, ...(spec.tier ? { tier: spec.tier } : {}), source };
@@ -3447,7 +3459,7 @@ export function resolveRoleLlm(role: ModelRole, opts: RoleLlmResolveOptions = {}
     if (resolution) { observeRoleLlm(role, resolution, spec); return resolution; }
     // 세 칸이 «다 비었으면» 아래 층으로 흘린다 — 빈 칸은 선언이 아니다.
   }
-  const baseline = resolveRoleLlmBaseline(role, config, globalProvider);
+  const baseline = resolveRoleLlmBaseline(role, config, globalProvider());
   if (opts.overrides || launchRoleLlmOverrides || config.roleLlm?.[role]) observeRoleLlm(role, baseline, flagSpec);
   return baseline;
 }
@@ -3463,17 +3475,49 @@ export function resolveRoleModel(role: ModelRole, config: UserConfig = getUserCo
 }
 
 
+export type StewardLoopMode = 'off' | 'shadow' | 'live';
+
 export type SeatLoopMode = 'off' | 'shadow' | 'on';
 
+export interface PersonaLoopConfig { enabled: boolean }
+
 export interface SeatLoopConfig {
   /** No seat actions by default; shadow observes without execution, on permits the seat loop to act. */
   mode: SeatLoopMode;
+  /** Seat-to-seat and human questions default to shadow even when the checklist loop is on. */
+  questions?: 'shadow' | 'on';
   seats?: string[];
   podPool?: string;
   reportPr?: number;
+  /** Parent routing and age limits for checklist stalls; omitted values use findStalls defaults. */
+  stall?: { parents?: Record<string, string>; redMinutes?: number; blockedMinutes?: number };
+}
+
+export type EventSeat = 'OP' | 'TC' | 'MK' | 'UX';
+export interface EventRoute { source: 'linear' | 'asana' | 'github'; kind: string; seat: EventSeat; loop: 'seat' }
+export interface EventsConfig { mode: 'shadow' | 'on'; routes: EventRoute[]; linearAssignees: Record<string, EventSeat> }
+
+export function parseEventsConfig(input: unknown): EventsConfig {
+  const events = input && typeof input === 'object' && !Array.isArray(input) ? input as Record<string, unknown> : {};
+  const routes: EventRoute[] = [];
+  const linearAssignees: Record<string, EventSeat> = Object.create(null);
+  if (events.linearAssignees && typeof events.linearAssignees === 'object' && !Array.isArray(events.linearAssignees)) {
+    for (const [id, seat] of Object.entries(events.linearAssignees)) {
+      if (id.trim() && (seat === 'OP' || seat === 'TC' || seat === 'MK' || seat === 'UX')) linearAssignees[id] = seat;
+    }
+  }
+  if (Array.isArray(events.routes)) for (const value of events.routes) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) continue;
+    const route = value as Record<string, unknown>;
+    if ((route.source === 'linear' || route.source === 'asana' || route.source === 'github') && typeof route.kind === 'string' && route.kind.trim()
+      && (route.seat === 'OP' || route.seat === 'TC' || route.seat === 'MK' || route.seat === 'UX') && route.loop === 'seat')
+      routes.push({ source: route.source, kind: route.kind, seat: route.seat, loop: route.loop });
+  }
+  return { mode: events.mode === 'on' ? 'on' : 'shadow', routes, linearAssignees };
 }
 
 export interface UserConfig {
+  events?: EventsConfig;
   /** Explicit HTTPS destination for doctor diagnostics; absent means no upload. */
   diagnostics?: { uploadUrl?: string };
   /** Root CLI help audience; absent or invalid means owner. */
@@ -3482,12 +3526,14 @@ export interface UserConfig {
   hitl?: { executionDeadlineMinutes?: number };
   coo?: { linearProject?: string };
   decisions?: { linearProjection: { enabled: boolean } };
+  /** Per-seat goal and Pod limits; missing or invalid limits use seat-budget defaults. */
+  org?: { budget?: Record<string, { dailyGoals?: number; concurrentPods?: number }> };
   /** Steward and seat loops are parsed independently. An absent seat remains off. */
-  loops?: { steward?: { mode?: 'observe' | 'act'; linearTeam?: string; roles?: Record<string, { maxConcurrent?: number }>; budget?: number; tracks?: Record<string, string>; alertAfterFailures?: number; launch?: 'off' | 'shadow' | 'live'; maxParallel?: number; podPool?: string }; seat?: SeatLoopConfig };
+  loops?: { steward?: { mode?: StewardLoopMode; linearTeam?: string; roles?: Record<string, { maxConcurrent?: number }>; budget?: number; tracks?: Record<string, string>; alertAfterFailures?: number; launch?: 'off' | 'shadow' | 'live'; maxParallel?: number; podPool?: string }; seat?: SeatLoopConfig; persona?: PersonaLoopConfig };
   /** 🔐 Pod 의 Grok API 키 과금은 명시 opt-in 만. 생략·잘못된 값은 false.
    *  budgetGate 와 같은 `harness` 객체다 — 중복 선언이면 뒤 타입이 앞을 지운다. */
-  harness?: { pod?: { grokApiKeyOptIn: boolean }; budgetGate?: HarnessBudgetGateConfig; defaultRepo?: string; substrate?: 'local' | 'pod'; podPool?: string; worktreeAddTimeoutSec?: number };
-  /** ☸️ Pod 실행 칸 — `pool` = 기존 기본 풀(`컨텍스트[@ssh호스트][:상한]` 쉼표 · 앞이 우선). harness 실행은 인자·ELANOUS_POD_POOL·harness.podPool 다음으로 읽는다. */
+  harness?: { pod?: { grokApiKeyOptIn: boolean }; budgetGate?: HarnessBudgetGateConfig; difficultyPlacement?: boolean; defaultRepo?: string; substrate?: 'local' | 'pod'; podPool?: string; worktreeAddTimeoutSec?: number };
+  /** ☸️ Pod 실행 칸 — `pool` = 기존 기본 풀(`컨텍스트[@ssh호스트][:상한][#k3d-레지스트리:포트]` 쉼표 · 앞이 우선). harness 실행은 인자·ELANOUS_POD_POOL·harness.podPool 다음으로 읽는다. */
   pod?: { pool?: string; /** 호스트 Git 미러 디렉터리 — Pod Job 에 읽기 전용으로 마운트한다. */ hostMirror?: string; /** 원격 그라운딩 엔드포인트(호스트 nexus · tailnet 주소) — Pod 가 토큰으로 «질의→인용»만 묻는다(P13). */ groundingUrl?: string; /** 읽기 전용 Pod lease 권장에 쓰는 계정별 동시 수. */ lease?: { perAccount?: number } };
   skillRouter: SkillRouterConfig;
   llm: LLMConfig;
@@ -3656,7 +3702,7 @@ export function parseRoleLlmEntry(raw: unknown): { ok: true; spec: RoleLlmSpec }
   return { ok: true, spec };
 }
 
-export const MODEL_ROLES: readonly ModelRole[] = ['implement', 'review', 'research', 'planning', 'audit', 'classify'];
+export const MODEL_ROLES: readonly ModelRole[] = ['implement', 'review', 'research', 'planning', 'audit', 'classify', 'graph-grow'];
 
 export function isModelRole(v: unknown): v is ModelRole {
   return typeof v === 'string' && (MODEL_ROLES as readonly string[]).includes(v);
@@ -3815,7 +3861,7 @@ function defaultConfig(): UserConfig {
     cli: { helpRole: 'owner' },
     coo: { linearProject: '외부 행정·큰 일 (COO)' },
     decisions: { linearProjection: { enabled: false } },
-    loops: { seat: { mode: 'off', seats: ['MK'], podPool: 'pool-node-b@node-b:8' } },
+    loops: { steward: { mode: 'shadow' }, seat: { mode: 'off', questions: 'shadow', seats: ['MK'], podPool: 'pool-node-b@node-b:8' }, persona: { enabled: false } },
     skillRouter: { ...SR_DEFAULTS },
     llm: { ...LLM_DEFAULTS },
     skills: skillsDefaults(),
@@ -3884,7 +3930,7 @@ function defaultConfig(): UserConfig {
       nativeStructure: { ...TOOLS_DEFAULTS.nativeStructure },
       selfImplement: { ...TOOLS_DEFAULTS.selfImplement },
     },
-    harness: { budgetGate: { ...DEFAULT_BUDGET_GATE } },
+    harness: { budgetGate: { ...DEFAULT_BUDGET_GATE }, difficultyPlacement: false },
     grounding: { sources: [] },
     raw: {},
   };
@@ -4296,7 +4342,7 @@ function parseStewardTracks(input: unknown): Record<string, string> | undefined
 }
 
 function parseSeatLoopsConfig(input: unknown): SeatLoopConfig {
-  const defaults: SeatLoopConfig = { mode: 'off', seats: ['MK'], podPool: 'pool-node-b@node-b:8' };
+  const defaults: SeatLoopConfig = { mode: 'off', questions: 'shadow', seats: ['MK'], podPool: 'pool-node-b@node-b:8' };
   if (!input || typeof input !== 'object' || Array.isArray(input)) return defaults;
   const seat = (input as Record<string, unknown>).seat;
   if (!seat || typeof seat !== 'object' || Array.isArray(seat)) return defaults;
@@ -4304,20 +4350,35 @@ function parseSeatLoopsConfig(input: unknown): SeatLoopConfig {
   const mode = values.mode;
   return {
     mode: mode === 'on' || mode === 'shadow' ? mode : 'off',
+    questions: values.questions === 'on' ? 'on' : 'shadow',
     seats: Array.isArray(values.seats) && values.seats.length > 0
       && values.seats.every((value) => typeof value === 'string' && /^(?:MK|OP|TC|UX)$/.test(value))
       ? [...new Set(values.seats as string[])] : ['MK'],
     podPool: typeof values.podPool === 'string' && values.podPool.trim() ? values.podPool.trim() : defaults.podPool,
     ...(typeof values.reportPr === 'number' && Number.isSafeInteger(values.reportPr) && values.reportPr > 0
       ? { reportPr: values.reportPr } : {}),
+    ...(() => {
+      const stall = values.stall;
+      if (!stall || typeof stall !== 'object' || Array.isArray(stall)) return {};
+      const raw = stall as Record<string, unknown>;
+      const parents = raw.parents && typeof raw.parents === 'object' && !Array.isArray(raw.parents)
+        ? Object.fromEntries(Object.entries(raw.parents).filter(([from, to]) =>
+          /^(?:MK|OP|TC|UX)$/.test(from) && typeof to === 'string' && /^(?:MK|OP|TC|UX)$/.test(to) && from !== to))
+        : undefined;
+      const minutes = (value: unknown): value is number => typeof value === 'number' && Number.isFinite(value) && value >= 0;
+      return { stall: {
+        ...(parents ? { parents } : {}),
+        ...(minutes(raw.redMinutes) ? { redMinutes: raw.redMinutes } : {}),
+        ...(minutes(raw.blockedMinutes) ? { blockedMinutes: raw.blockedMinutes } : {}),
+      } };
+    })(),
   };
 }
 
 function parseStewardLoopsConfig(input: unknown): UserConfig['loops'] {
-  if (!input || typeof input !== 'object' || Array.isArray(input)) return undefined;
-  const value = (input as Record<string, unknown>).steward;
-  if (!value || typeof value !== 'object' || Array.isArray(value)) return undefined;
-  const s = value as Record<string, unknown>;
+  const loops = input && typeof input === 'object' && !Array.isArray(input) ? input as Record<string, unknown> : {};
+  const value = loops.steward;
+  const s = value && typeof value === 'object' && !Array.isArray(value) ? value as Record<string, unknown> : {};
   const roles: NonNullable<NonNullable<UserConfig['loops']>['steward']>['roles'] = {};
   if (s.roles && typeof s.roles === 'object' && !Array.isArray(s.roles)) {
     for (const [role, entry] of Object.entries(s.roles)) {
@@ -4327,8 +4388,9 @@ function parseStewardLoopsConfig(input: unknown): UserConfig['loops'] {
     }
   }
   return { steward: {
-    mode: s.mode === 'act' ? 'act' : 'observe',
-    // Absent or invalid launch keys stay absent: launch.ts applies the defaults (shadow · 3 · pool-node-b@node-b:8).
+    mode: s.mode === 'off' || s.mode === 'shadow' || s.mode === 'live' ? s.mode :
+      s.launch === 'off' || s.launch === 'shadow' || s.launch === 'live' ? s.launch : 'shadow',
+    // A valid legacy launch setting remains effective when mode is absent; explicit mode always wins.
     ...(s.launch === 'off' || s.launch === 'shadow' || s.launch === 'live' ? { launch: s.launch } : {}),
     ...(typeof s.maxParallel === 'number' && Number.isSafeInteger(s.maxParallel) && s.maxParallel > 0 ? { maxParallel: s.maxParallel } : {}),
     ...(typeof s.podPool === 'string' && s.podPool.trim() ? { podPool: s.podPool.trim() } : {}),
@@ -4450,8 +4512,22 @@ export function buildUserConfig(path: string = defaultPath()): UserConfig {
   const rawNotifications = rawGlobalObj?.notifications ?? rawObj.notifications;
   const autopilotConfig = parseAutopilotConfig(rawObj.autopilot);
   const stewardLoops = parseStewardLoopsConfig(rawObj.loops);
+  const orgRaw = rawObj.org && typeof rawObj.org === 'object' && !Array.isArray(rawObj.org) ? rawObj.org as Record<string, unknown> : {};
+  const budgetRaw = orgRaw.budget && typeof orgRaw.budget === 'object' && !Array.isArray(orgRaw.budget) ? orgRaw.budget as Record<string, unknown> : {};
+  const seatBudgets: NonNullable<NonNullable<UserConfig['org']>['budget']> = Object.create(null);
+  for (const [seat, value] of Object.entries(budgetRaw)) {
+    if (!seat || !value || typeof value !== 'object' || Array.isArray(value)) continue;
+    const row = value as Record<string, unknown>;
+    const dailyGoals = row.dailyGoals;
+    const concurrentPods = row.concurrentPods;
+    seatBudgets[seat] = {
+      ...(typeof dailyGoals === 'number' && Number.isSafeInteger(dailyGoals) && dailyGoals >= 0 ? { dailyGoals } : {}),
+      ...(typeof concurrentPods === 'number' && Number.isSafeInteger(concurrentPods) && concurrentPods >= 0 ? { concurrentPods } : {}),
+    };
+  }
 
   return {
+    ...(Object.keys(seatBudgets).length ? { org: { budget: seatBudgets } } : {}),
     pod: {
       ...(typeof legacyPod.pool === 'string' && legacyPod.pool.trim() ? { pool: legacyPod.pool.trim() } : {}),
       ...(typeof legacyPod.hostMirror === 'string' && legacyPod.hostMirror.trim() ? { hostMirror: legacyPod.hostMirror.trim() } : {}),
@@ -4465,6 +4541,7 @@ export function buildUserConfig(path: string = defaultPath()): UserConfig {
     },
     harness: {
       pod: { grokApiKeyOptIn: harnessPod.grokApiKeyOptIn === true },
+      difficultyPlacement: harness.difficultyPlacement === true,
       ...(harness.substrate === 'local' || harness.substrate === 'pod' ? { substrate: harness.substrate } : {}),
       ...(typeof harness.podPool === 'string' && harness.podPool.trim() ? { podPool: harness.podPool.trim() } : {}),
       ...(typeof harness.worktreeAddTimeoutSec === 'number' && Number.isSafeInteger(harness.worktreeAddTimeoutSec)
@@ -4583,6 +4660,7 @@ export function buildUserConfig(path: string = defaultPath()): UserConfig {
     skills: {
       activeSet: normalizeSkillSet(sk.activeSet),
       dirs: strArray(sk.dirs, skillsDefaults().dirs),
+      giftEndpoint: str(sk.giftEndpoint) ?? 'https://elanous.ai',
       includeSharedAgentSkills: sk.includeSharedAgentSkills !== false,
       ...(() => { const sources = parsePersistedSkillSources(sk.sources, sk.connected); return sources ? { sources } : {}; })(),
       allow: strArray(sk.allow, []),
@@ -5112,7 +5190,9 @@ export function buildUserConfig(path: string = defaultPath()): UserConfig {
     coo: { linearProject: typeof (rawObj.coo as { linearProject?: unknown } | undefined)?.linearProject === 'string' && (rawObj.coo as { linearProject: string }).linearProject.trim()
       ? (rawObj.coo as { linearProject: string }).linearProject.trim() : '외부 행정·큰 일 (COO)' },
     decisions: { linearProjection: { enabled: ((rawObj.decisions as { linearProjection?: { enabled?: unknown } } | undefined)?.linearProjection?.enabled === true) } },
-    loops: { ...(stewardLoops ?? {}), seat: parseSeatLoopsConfig(rawObj.loops) },
+    loops: { ...(stewardLoops ?? {}), seat: parseSeatLoopsConfig(rawObj.loops),
+      persona: { enabled: (rawObj.loops as { persona?: { enabled?: unknown } } | undefined)?.persona?.enabled === true } },
+    events: parseEventsConfig(rawObj.events),
     // M1-1: sparse — undefined when the user hasn't set anything, so
     // resolvers fall through to zero-config defaults.
     ...spreadIfDefined('modelTier', parseModelTierConfig(rawObj.modelTier)),
@@ -5692,6 +5772,8 @@ export function saveUserConfig(
     ? rawRest.autopilot as Record<string, unknown> : {};
   const rawLoops = rawRest.loops && typeof rawRest.loops === 'object' && !Array.isArray(rawRest.loops)
     ? rawRest.loops as Record<string, unknown> : {};
+  const rawSteward = rawLoops.steward && typeof rawLoops.steward === 'object' && !Array.isArray(rawLoops.steward)
+    ? rawLoops.steward as Record<string, unknown> : {};
   if (cfg.loops) delete rawRest.loops;
   if (cfg.pod?.hostMirror) {
     const rawPod = rawRest.pod && typeof rawRest.pod === 'object' && !Array.isArray(rawRest.pod)
@@ -5704,6 +5786,7 @@ export function saveUserConfig(
       ...rawHarness,
       pod: cfg.harness?.pod ?? rawHarness.pod,
       budgetGate: cfg.harness?.budgetGate ?? rawHarness.budgetGate,
+      difficultyPlacement: cfg.harness?.difficultyPlacement ?? rawHarness.difficultyPlacement,
       defaultRepo: cfg.harness?.defaultRepo ?? rawHarness.defaultRepo,
       substrate: cfg.harness?.substrate,
       podPool: cfg.harness?.podPool,
@@ -5711,8 +5794,10 @@ export function saveUserConfig(
     ...rawRest,
     ...(cfg.loops ? { loops: {
       ...rawLoops,
+      ...(cfg.loops.steward ? { steward: { ...rawSteward, mode: cfg.loops.steward.mode ?? cfg.loops.steward.launch ?? 'shadow' } } : {}),
       ...(cfg.loops.seat ? { seat: {
         mode: cfg.loops.seat.mode,
+        questions: cfg.loops.seat.questions ?? 'shadow',
         seats: cfg.loops.seat.seats ?? ['MK'],
         podPool: cfg.loops.seat.podPool ?? 'pool-node-b@node-b:8',
         ...(cfg.loops.seat.reportPr === undefined ? {} : { reportPr: cfg.loops.seat.reportPr }),
@@ -5783,6 +5868,7 @@ export function saveUserConfig(
     skills: stripUndef({
       activeSet: cfg.skills.activeSet,
       dirs: [...cfg.skills.dirs],
+      giftEndpoint: cfg.skills.giftEndpoint === 'https://elanous.ai' ? undefined : cfg.skills.giftEndpoint,
       // EN5 — only connected roots are persisted (preset/shared/package are derived). The dev-only `connected` key is not written back.
       sources: cfg.skills.sources && cfg.skills.sources.some((source) => source.kind === 'connected')
         ? cfg.skills.sources.filter((source) => source.kind === 'connected').map(({ id, path, enabled }) => ({ id, path, enabled }))
@@ -6039,7 +6125,7 @@ export function saveUserConfig(
     ...(cfg.tabs && Object.keys(cfg.tabs).length > 0 ? { tabs: cfg.tabs } : {}),
     // M1-2b: sparse — emit only when explicitly set. Keeps Path-A-only
     // users' file clean (no empty modelTier:{} blobs).
-    ...(cfg.modelTier ? { modelTier: cfg.modelTier } : {}),
+    ...(cfg.modelTier ? { modelTier: parseModelTierConfig(cfg.modelTier) } : {}),
     ...(cfg.sessionFabric ? { sessionFabric: cfg.sessionFabric } : {}),
     ...(cfg.nextFluent ? { nextFluent: cfg.nextFluent } : {}),
     ...(cfg.taste ? { taste: cfg.taste } : {}),

package/src/version/packed-revision.json

@@ -1 +1 @@
-{"commit":"2740cab836f9926e0d4e88c7343f3aa5523b069d"}
+{"commit":"27045f4612b148543fb0f91b82d37592d1d6c9f2"}

package/src/web-search/grok.ts

@@ -19,6 +19,7 @@
 
 import { getGrokApiKey } from '../config.js';
 import { grokAgentSearch, GROK_SEARCH_MODEL } from '../grok/agent-search.js';
+import { wantsXSearch } from './x-intent.js';
 import type { WebSearchHit, WebSearchProvider, WebSearchResult } from './provider.js';
 
 const DEFAULT_LIMIT = 5;
@@ -52,10 +53,15 @@ export function buildGrokWebSearchProvider(): WebSearchProvider {
 
       if (!r.ok) throw new Error(r.error ?? 'grok search failed');
 
-      const hits: WebSearchHit[] = r.citations.slice(0, limit).map(c => ({
+      const xSourceUrls = new Set(r.xSearchSources ?? []);
+      const citations = wantsXSearch(q.query)
+        ? [...r.citations.filter(c => xSourceUrls.has(c.url)), ...r.citations.filter(c => !xSourceUrls.has(c.url))]
+        : r.citations;
+      const hits: WebSearchHit[] = citations.slice(0, limit).map(c => ({
         url: c.url,
         title: c.title ?? c.url,
         snippet: '',
+        ...(xSourceUrls.has(c.url) ? { xSearchSource: true } : {}),
       }));
 
       const note = r.text.length > 0 ? r.text.slice(0, 1500) : undefined;