elanous 0.2.34 → 0.2.36

package/src/input-core/context-key-runtime.ts

@@ -0,0 +1,21 @@
+import { createContextKeyService, type ContextKeyService, type ContextKeys } from './context-keys.js';
+
+// Shared lazy singleton for context-key consumers outside the dashboard.
+let service: ContextKeyService | null = null;
+
+export function getRuntimeContextKeyService(): ContextKeyService {
+  if (!service) service = createContextKeyService();
+  return service;
+}
+
+export function getRuntimeContextKeys(): Readonly<ContextKeys> {
+  return getRuntimeContextKeyService().keys;
+}
+
+export function updateRuntimeContextKeys(patch: Partial<ContextKeys>): void {
+  getRuntimeContextKeyService().update(patch);
+}
+
+export function resetRuntimeContextKeysForTests(): void {
+  service = null;
+}

package/src/intake-plane/already-built-hint.ts

@@ -4,8 +4,10 @@
 // 넣으면 근거 링크(커밋·파일) 붙은 알림을 낸다 · 관련 없으면 0건 · 거절한 짝은 다시 묻지
 // 않는다. 순수 함수·부수효과 0. 관련도 점수는 세션 검색의 trigram FTS5 원시함수
 // (src/session/search-index.ts rankByTrigramFts — BM25, 낮을수록 관련도 높음)를 그대로
-// 재사용한다. DEV-FEATURE-MAP 행을 넘겨 부르는 인테이크·저작 경로 배선(intake.hint
-// 관측)은 다음 조각(남은 것)이다.
+// 재사용한다. 호출 지점은 인테이크 요구 퍼널이다 — readRequirementFunnel(요구 퍼널 입구)이
+// features/refusedFeatures 를 runRequirementFunnel 로 넘기고, recordAlreadyBuiltHints 가
+// alreadyBuiltHints 를 불러 결과를 requirements.intake/hint 로 관측한다. 그 행 자체를
+// 생산하는 쪽(DEV-FEATURE-MAP)은 별도 칸 몫이다.
 
 import { rankByTrigramFts, type RankedDoc, type RankResult } from '../session/search-index.js';
 import { hashContent } from '../hasher.js';

package/src/intake-plane/requirement-funnel.ts

@@ -12,6 +12,7 @@ import { getUserConfig } from '../user-config.js';
 import { dateKey } from '../time/format.js';
 import { cardIndexPath, CardStore, type TaskCard } from '../task-cards/card-store.js';
 import { loadIntakeLedger, type IntakeItem } from './items.js';
+import { alreadyBuiltHints, type AlreadyBuiltFeature, type AlreadyBuiltRefusedPair } from './already-built-hint.js';
 import { RequirementLedger } from '../requirements/requirement-ledger.js';
 import { parseRubric, rubricGrade, rubricScore } from '../release-loop/rubric.js';
 
@@ -70,6 +71,10 @@ export interface FunnelOptions {
   adopt?: (candidate: RequirementCandidate, version: string, cellId: string, evidence: string) => void;
   /** REQ-INTAKE-ALL (0.2.25) piece 1: REQ-LEDGER side-record — every candidate captured once (idempotent on candidate id); adopted decisions fold to `placed`. */
   ledger?: RequirementLedger;
+  /** ALREADY-BUILT-HINT (0.2.34 · RFC-harness-full-journey-as-graph §4f): the DEV-FEATURE-MAP rows to compare arrivals against. Absent → no comparison, no `intake.hint` events. Intentional boundary (next piece): the live state-based caller (`src/briefing/brief-items.ts` — `readRequirementFunnel({ stateDir, now })`) does not yet supply these rows, so hints stay silent in live runs until the DEV-FEATURE-MAP cell supplies them. */
+  features?: readonly AlreadyBuiltFeature[];
+  /** Rejected pairs (request hash ⊕ feature) — a refused pair is never asked again. */
+  refusedFeatures?: readonly AlreadyBuiltRefusedPair[];
 }
 
 /** How many of the last 24 hours' unlinked directives the single P0 brief line names (the full backlog is one count). */
@@ -118,6 +123,26 @@ function gate(candidate: RequirementCandidate, options: FunnelOptions, used: num
   return null;
 }
 
+/**
+ * ALREADY-BUILT-HINT (0.2.34 · RFC-harness-full-journey-as-graph §4f) — compare one arrival group's statement
+ * against the DEV-FEATURE-MAP evidence rows through the pure `alreadyBuiltHints` function. Each returned hint
+ * becomes one `intake.hint` observation carrying the match's evidence link (commit · file); no match, an
+ * evidence-less row or a refused pair yields nothing (silence). Side-record only — a hint failure must never
+ * change the funnel result (same try/catch shape as the ledger capture below). E4 absence note:
+ * seat-state/MK/green-e4/ALREADY-BUILT-HINT.md.
+ */
+function recordAlreadyBuiltHints(candidate: RequirementCandidate, options: FunnelOptions): void {
+  if (!options.features?.length) return;
+  try {
+    for (const hint of alreadyBuiltHints(candidate.text, options.features, options.refusedFeatures ?? [])) {
+      debug.log('requirements.intake', 'hint', { id: candidate.id, link: candidate.link, kind: hint.kind,
+        devProject: hint.devProject, feature: hint.feature, evidence: { ...hint.evidence }, score: hint.score });
+    }
+  } catch (error) {
+    debug.log('requirements.intake', 'hint-failed', { id: candidate.id, error: error instanceof Error ? error.message : String(error) });
+  }
+}
+
 /** RUBRIC-PLACE: use the release placement engine's priority, deadline, capacity and predecessor checks, not an invented score. */
 export function runRequirementFunnel(options: FunnelOptions): RequirementFunnelResult {
   const { sources, cells, now } = options;
@@ -139,6 +164,7 @@ export function runRequirementFunnel(options: FunnelOptions): RequirementFunnelR
   for (const members of groups.values()) {
     members.sort((a, b) => a.receivedAt.localeCompare(b.receivedAt));
     const candidate = members.find(member => member.source === 'directive') ?? members[0]!;
+    recordAlreadyBuiltHints(candidate, options);
     const linked = members.map(member => linkFor(member, cells)).find(Boolean);
     const evidence = members.map(member => `${member.link} (${member.receivedAt})`).join(' · ');
     if (linked) {
@@ -256,7 +282,8 @@ export function captureFunnelCandidates(candidates: readonly RequirementDecision
 /** Existing ledgers only; no source collector or sender is started here. Side effect: captures every candidate into this universe's REQ-LEDGER (REQ-INTAKE-ALL). */
 export function readRequirementFunnel(options: { stateDir?: string; now?: Date; mode?: 'shadow' | 'live'; dailyCap?: number;
   allowedLicenses?: readonly string[]; grounding?: readonly IncomingRequirement[]; coordination?: readonly IncomingRequirement[];
-  linear?: readonly IncomingRequirement[]; placement?: PlacementDeps } = {}): RequirementFunnelResult {
+  linear?: readonly IncomingRequirement[]; placement?: PlacementDeps; features?: readonly AlreadyBuiltFeature[];
+  refusedFeatures?: readonly AlreadyBuiltRefusedPair[] } = {}): RequirementFunnelResult {
   const stateDir = options.stateDir ?? elanousStateRoot();
   const now = options.now ?? new Date();
   const config = (getUserConfig().raw.intake as { requirementFunnel?: { mode?: 'shadow' | 'live'; dailyCap?: number; allowedLicenses?: string[] } } | undefined)?.requirementFunnel;
@@ -328,6 +355,7 @@ export function readRequirementFunnel(options: { stateDir?: string; now?: Date;
     coordination: today(options.coordination ?? cardRequests.coordination), linear: today(options.linear ?? cardRequests.linear) }, historicalDirectives, cells, now, mode,
     dailyCap, adoptedToday: todayCount, allowedLicenses, placement: { ...options.placement, schedules },
     ledger: new RequirementLedger({ stateDir }),
+    features: options.features, refusedFeatures: options.refusedFeatures,
     adopt: (candidate, version, cellId, evidence) => {
       placeCell({ id: cellId, title: candidate.text, owner: candidate.owner ?? 'OP', priority: candidate.priority ?? 'P1',
         predecessors: [], ...(candidate.deadlineVersion ? { deadlineVersion: candidate.deadlineVersion } : {}) }, { ...options.placement, now, schedules });

package/src/light-cli.ts

@@ -1,16 +1,32 @@
 import { Command } from 'commander';
-import { applyConfigDirFlagFromArgv } from './cli/config-dir-flag.js';
-import { applyTestStateDirFlagFromArgv } from './cli/test-state-dir-flag.js';
-import { applyTestFlagFromArgv } from './cli/test-flag.js';
 import type { LightCliRoute } from './cli/light-entry-route.js';
 
-/** Dispatch a small read-only command without loading the full command registry. */
+/** Dispatch a small operational command without loading the full command registry. */
 export async function runLightCli(route: LightCliRoute): Promise<void> {
-  // Keep the same pre-import isolation order as src/index.ts. In particular,
-  // config-touching command modules must not load before these flags apply.
-  applyTestStateDirFlagFromArgv();
-  applyTestFlagFromArgv();
-  applyConfigDirFlagFromArgv();
+  // Root instance flags stay on the full entry for the four hot commands.
+  // Other light routes can still accept them; invoke the same shared bootstrap
+  // helpers as src/index.ts, and only load those helpers when a flag is present.
+  const args = process.argv.slice(2);
+  // The legacy entry resolves the config root for operational commands and
+  // warns when the removed ELANOUS_CONFIG_DIR env var disagrees with it.
+  // Preserve that observable warning on hot routes without loading the
+  // resolver for the common case where the ignored env var is absent.
+  if (['msg', 'pty', 'logs', 'tasks', 'tasks-read'].includes(route) && process.env.ELANOUS_CONFIG_DIR !== undefined) {
+    const { getElanousConfigDir } = await import('./elanous-config-dir.js');
+    getElanousConfigDir();
+  }
+  const hasRootInstanceFlag = args.some(arg => ['--test', '--config-dir', '--test-state-dir', '--state-dir']
+    .some(flag => arg === flag || arg.startsWith(`${flag}=`)));
+  if (hasRootInstanceFlag) {
+    const [{ applyTestStateDirFlagFromArgv }, { applyTestFlagFromArgv }, { applyConfigDirFlagFromArgv }] = await Promise.all([
+      import('./cli/test-state-dir-flag.js'),
+      import('./cli/test-flag.js'),
+      import('./cli/config-dir-flag.js'),
+    ]);
+    applyTestStateDirFlagFromArgv();
+    applyTestFlagFromArgv();
+    applyConfigDirFlagFromArgv();
+  }
 
   const program = new Command().name('elanous').enablePositionalOptions();
   switch (route) {
@@ -20,8 +36,8 @@ export async function runLightCli(route: LightCliRoute): Promise<void> {
       break;
     }
     case 'release': {
-      const { registerReleaseCommands } = await import('./cli/release-cli.js');
-      registerReleaseCommands(program);
+      const { registerReleaseChecklistReadCommands } = await import('./cli/release-checklist-read-cli.js');
+      registerReleaseChecklistReadCommands(program);
       break;
     }
     case 'tasks': {
@@ -29,6 +45,11 @@ export async function runLightCli(route: LightCliRoute): Promise<void> {
       registerTasksCommands(program);
       break;
     }
+    case 'tasks-read': {
+      const { registerTaskReadCommands } = await import('./cli/tasks-read-cli.js');
+      registerTaskReadCommands(program);
+      break;
+    }
     case 'pty': {
       const { registerPtyTakeoverCommands } = await import('./cli/pty-takeover-cli.js');
       registerPtyTakeoverCommands(program);

package/src/llm/opengateway-models.ts

@@ -0,0 +1,11 @@
+/** First-slice OpenGateway models observed through a successful streamed chat turn. */
+export const OPENGATEWAY_VERIFIED_MODELS = [
+  'opengateway/deepseek/deepseek-v4.1-flash-ultrafast',
+  'opengateway/z-ai/glm-5.3-flash-ultrafast',
+] as const;
+
+export const OPENGATEWAY_DEFAULT_MODEL = OPENGATEWAY_VERIFIED_MODELS[0];
+
+export function isVerifiedOpenGatewayModel(model: string): boolean {
+  return (OPENGATEWAY_VERIFIED_MODELS as readonly string[]).includes(model);
+}

package/src/llm/provider-credentials.ts

@@ -38,6 +38,7 @@ const ENV_KEY_OVERLAY: Readonly<Record<string, string>> = {
   // 결정 2026-09-23 — openrouter 모델은 BUILTIN_CATALOG 가 아니라 발견 폴드(`catalog/providers/openrouter.yaml`
   //   apiKeyEnv)에서 온다 ⇒ 파생 맵이 비어 하니스 자식에게 키가 릴레이되지 않았다(env 로만 키를 둔 사용자는 자식이 죽는다).
   openrouter: 'OPENROUTER_API_KEY',
+  opengateway: 'OPENGATEWAY_API_KEY',
 };
 
 /** 키가 필요 없는 provider — 자격증명 부재가 **정상**이다(누락 경고를 내면 안 됨).
@@ -188,6 +189,19 @@ interface ResolveCredentialInput {
  * ⚠️ ③ 이 마지막인 것이 이 수리의 핵심이다. 종전엔 ③ 이 **무조건 첫 번째**였고, 그래서 provider 가
  * 바뀌어도 옛 provider 의 키가 따라갔다(= 401 의 근본). provider 가 바뀌었으면 base 키는 **틀린 키**다.
  */
+/** Every explicit OpenGateway key in host config. The Pod compares all sources before apply. */
+export function configuredOpenGatewayKeys(llm: {
+  provider?: string;
+  apiKey?: string;
+  rotation?: readonly { provider: string; apiKey?: string }[];
+}): string[] {
+  const values = [
+    ...(llm.provider === 'opengateway' ? [llm.apiKey] : []),
+    ...(llm.rotation ?? []).filter((entry) => entry.provider === 'opengateway').map((entry) => entry.apiKey),
+  ];
+  return [...new Set(values.map((value) => value?.trim()).filter((value): value is string => Boolean(value)))];
+}
+
 export function resolveProviderCredential(input: ResolveCredentialInput): ResolvedCredential {
   const { provider, rotation, baseApiKey, baseProvider } = input;
   const env = input.env ?? process.env;

package/src/llm/provider-detect.ts

@@ -31,7 +31,7 @@ export interface ProviderDetectDeps {
 
 const LIMIT_MS = 3_000;
 const CLAUDE_LIMIT_MS = 5_000;
-const ORDER = ['openai-codex', 'anthropic', 'grok', 'gemini', 'openrouter', 'openai', 'ollama', 'local'] as const;
+const ORDER = ['openai-codex', 'anthropic', 'grok', 'gemini', 'openrouter', 'openai', 'ollama', 'local', 'opengateway'] as const;
 const AGENT_RANK = { 'claude-code': -2, antigravity: -1 } as const;
 const SOURCE_PRIORITY: Readonly<Record<string, number>> = {
   'elanous-auth': 0,
@@ -44,6 +44,7 @@ const ENV_KEYS: Readonly<Record<string, readonly string[]>> = {
   grok: ['XAI_API_KEY', 'GROK_API_KEY', 'GROK_CODE_XAI_API_KEY'],
   gemini: ['GEMINI_API_KEY', 'GOOGLE_API_KEY'],
   openrouter: ['OPENROUTER_API_KEY'],
+  opengateway: ['OPENGATEWAY_API_KEY'],
   openai: ['OPENAI_API_KEY'],
 };
 
@@ -158,6 +159,12 @@ export async function detectProviders(deps: ProviderDetectDeps = {}): Promise<De
     updateClaude();
     const agyInstall = Promise.resolve().then(() => isDirectory(join(home, '.gemini', 'antigravity-cli'))).catch(() => false);
     const files = [
+      // The installed CLI can discover the key even when the shell has not exported it.
+      // Read only; the value is never included in the detection result.
+      Promise.resolve().then(async () => {
+        const path = join(env.ELANOUS_KEY_CACHE_DIR?.trim() || join(home, '.cache'), 'opengateway_api_key');
+        if (await isFile(path) && populated(await file(path))) add('opengateway', 'apikey', 'cache:OPENGATEWAY_API_KEY');
+      }).catch(() => {}),
       json(storePath).then((store) => {
         const providers = record(store?.providers);
         if (!providers) return;

package/src/llm/runtime-model-family.ts

@@ -4,7 +4,7 @@ import type { LLMProviderName } from '../user-config.js';
  *  `src/llm/model-defaults.ts` (that module imports this file). */
 export type RuntimeLlmModelFamily =
   | 'grok' | 'anthropic' | 'openai' | 'openai-codex' | 'gemini' | 'local'
-  | 'kimi' | 'qwen' | 'glm' | 'openrouter' | 'bedrock' | 'unknown';
+  | 'kimi' | 'qwen' | 'glm' | 'openrouter' | 'opengateway' | 'bedrock' | 'unknown';
 
 export function inferRuntimeLlmModelFamily(model: string | undefined): RuntimeLlmModelFamily {
   if (!model) return 'unknown';
@@ -13,6 +13,7 @@ export function inferRuntimeLlmModelFamily(model: string | undefined): RuntimeLl
   // ⛔ 2026-09-23 — 게이트웨이 접두가 «먼저»다. 안 그러면 `openrouter/anthropic/claude-…` 가 `anthropic` 으로
   //   읽혀 openrouter 와 «비호환»이 되고, `openrouter/z-ai/…` 는 `unknown` 이라 아무 provider 와도 «호환»이 됐다.
   if (m.startsWith('openrouter/')) return 'openrouter';
+  if (m.startsWith('opengateway/')) return 'opengateway';
   // ⭐ BEDROCK-PROVIDER — Bedrock 전용 꼴(`anthropic.claude-…`·지역 접두·`bedrock/…`)이 `includes('claude')` 보다 «먼저».
   //   1st-party id(`claude-…`)는 그대로 anthropic 이다(불변).
   if (m.startsWith('bedrock/') || /^(?:[a-z]{2,6}\.)?anthropic\.claude-/.test(m)) return 'bedrock';

package/src/llm-wellformed.ts

@@ -0,0 +1,70 @@
+// ── LLM 요청 본문 서로게이트 정리 (TUI-RECOVER-SKIPS-CREDITS · 0.2.36 · 2026-10-22 · OP P0) ──────────
+//
+// 🚨 실물(n8n 세션 · 설치본 99edcfa): 매 턴 즉시 실패 «자동 회복 2회 실패».
+//   grok 원문 `Failed to parse the request body as JSON: messages[19].content: unexpected end of hex escape`
+//   ⊕ 같은 요청에 codex `400 {"detail":"Bad Request"}`. 크레딧·폴백 순서 문제가 아니다 — 이력의 글 하나에
+//   «짝 없는 서로게이트»(이모지를 UTF-16 단위로 자른 반토막)가 섞여 JSON 본문이 깨졌다. 새 세션⊕요약도 그 글을 싣는다.
+// ⭐ 보내기 직전에 모든 문자열의 짝 없는 서로게이트를 U+FFFD 로 바꾼다 — 바뀐 메시지만 새로 만든다.
+//
+// 세 얼굴: 관측 = debug.log('llm.request', 'lone-surrogate-fixed', { messages, strings }) · 인지 = 짝 없는 서로게이트 ·
+//   힐링 = U+FFFD 치환(글 하나가 깨져도 턴은 돈다) · 실패 없음.
+
+/** 짝 없는 서로게이트를 U+FFFD 로 — 바뀌었으면 새 문자열. */
+export function wellFormedString(value: string): string {
+  const fn = (value as { toWellFormed?: () => string }).toWellFormed;
+  if (typeof fn === 'function') return fn.call(value);
+  return value.replace(/[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/g, '�');
+}
+
+function isWellFormed(value: string): boolean {
+  const fn = (value as { isWellFormed?: () => boolean }).isWellFormed;
+  if (typeof fn === 'function') return fn.call(value);
+  return wellFormedString(value) === value;
+}
+
+/** 값 속 문자열(객체 «키» 포함)을 훑어 고친다 — 바뀐 곳이 없으면 같은 참조를 돌려준다.
+ *  깊이 제한은 두지 않는다(깊은 곳에 남으면 본문이 그대로 깨진다 · r1 must-fix) — 순환은 지금 걷는 경로 집합으로 끊는다. */
+function fixValue(value: unknown, count: { strings: number }, path: WeakSet<object>): unknown {
+  if (typeof value === 'string') {
+    if (isWellFormed(value)) return value;
+    count.strings += 1;
+    return wellFormedString(value);
+  }
+  if (value === null || typeof value !== 'object') return value;
+  if (path.has(value)) return value;
+  path.add(value);
+  try {
+    if (Array.isArray(value)) {
+      let out: unknown[] | null = null;
+      value.forEach((item, i) => {
+        const next = fixValue(item, count, path);
+        if (next !== item) { out ??= [...value]; out[i] = next; }
+      });
+      return out ?? value;
+    }
+    const proto = Object.getPrototypeOf(value);
+    if (proto !== Object.prototype && proto !== null) return value;
+    let changed = false;
+    const entries = Object.entries(value as Record<string, unknown>).map(([key, item]) => {
+      const nextKey = fixValue(key, count, path) as string;
+      const next = fixValue(item, count, path);
+      if (nextKey !== key || next !== item) changed = true;
+      return [nextKey, next] as const;
+    });
+    return changed ? Object.fromEntries(entries) : value;
+  } finally {
+    path.delete(value);
+  }
+}
+
+/** 메시지 배열 — 고친 메시지 수·문자열 수와 함께. 바뀐 게 없으면 같은 배열. */
+export function wellFormedLLMMessages<T>(messages: readonly T[]): { messages: T[]; fixedMessages: number; fixedStrings: number } {
+  const count = { strings: 0 };
+  let fixedMessages = 0;
+  let out: T[] | null = null;
+  messages.forEach((message, i) => {
+    const next = fixValue(message, count, new WeakSet<object>()) as T;
+    if (next !== message) { fixedMessages += 1; out ??= [...messages]; out[i] = next; }
+  });
+  return { messages: out ?? (messages as T[]), fixedMessages, fixedStrings: count.strings };
+}