elanous 0.2.34 → 0.2.35

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'].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': {

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';