@things-factory/headless-twin 10.1.277 → 10.1.279

package/server/service/reference/hook-rejected.ts

@@ -1,53 +0,0 @@
-/*
- * 떨어진 것을 **보내는 쪽이 알아들을 모양으로** 바꾼다 — 순수 판정, 한 곳.
- *
- * ── 무엇이 있었나 (2026-09-07 측정) ─────────────────────────────────────────
- * 훅 응답의 떨어진 목록이 `{ record, errors }` 였고, plant 은 그것을 **봉투 id 문자열 목록**으로
- * 읽고 있었다.
- *
- * ```
- * headless-twin  rejected: { record, errors }[]        객체 배열
- * plant          "rejected is a list of envelope ids"  문자열 배열
- * ```
- *
- * `Array.isArray` 는 통과하므로 그쪽의 새 guard 도 안 걸렸다. id 를 맞추는데 객체라 하나도 안 맞고
- * **묶음 전체가 「보냈음」으로 찍혔다.** 422 와 `ok: false` 를 보냈는데 그쪽 행은 재시도 0 ·
- * 오류 없음 · 보냈음이었다. 인티그레이션 레인이 두 파일을 나란히 읽어서 찾았다.
- *
- * 우리가 말했는데 상대가 못 알아듣는 모양이면, 말한 것이 아니다.
- *
- * ── 왜 배선에서 갈라 놓나 ───────────────────────────────────────────────────
- * `reference-hook.ts` 는 엔티티를 물어서 시험 러너가 못 읽는다. 이 판정은 평범한 값으로 확인할 수
- * 있어야 하고, 오늘 이 저장소에서 「고쳐도 통과하고 안 고쳐도 통과하는 시험」이 여럿 나왔다.
- */
-
-/** 훅 응답에 실리는 떨어진 것 하나 — 봉투 id 를 알면 그것을, 모르면 레코드를. */
-export type RejectedForCaller = { eventId: string; errors: string[] } | { record: unknown; errors: string[] }
-
-/**
- * 떨어진 것에 봉투 id 를 붙인다.
- *
- * **짝은 객체 동일성으로 짓는다.** 유입에 넘긴 레코드가 배치의 원소 그대로이므로(§`takeInSequence`)
- * 커넥터를 고치지 않고도 봉투로 되짚을 수 있다. 값으로 비교하면 같은 모양의 레코드 둘이 서로의 id 를
- * 가져간다 — 그러면 보내는 쪽이 **엉뚱한 행**을 떨어진 것으로 표시한다.
- *
- * **id 를 못 찾으면 레코드를 그대로 싣는다.** 빈 id 를 실으면 보내는 쪽이 아무 행도 못 찾으면서
- * 「알았다」고 여긴다 — 지금 났던 일이 정확히 그것이다.
- */
-export function rejectedForCaller(
-  rejected: readonly { record: unknown; errors: string[] }[],
-  items: readonly { record?: unknown; eventId?: unknown }[]
-): RejectedForCaller[] {
-  const idOf = new Map<unknown, string>()
-
-  for (const it of items) {
-    const id = typeof it?.eventId === 'string' && it.eventId.trim() ? it.eventId : undefined
-    if (id && it?.record !== undefined) idOf.set(it.record, id)
-  }
-
-  return rejected.map(r => {
-    const eventId = idOf.get(r.record)
-
-    return eventId ? { eventId, errors: r.errors } : { record: r.record, errors: r.errors }
-  })
-}

package/server/service/reference/hook-store.ts

@@ -1,28 +0,0 @@
-/*
- * 훅이 저장소에 닿는 두 자리 — 연결을 찾는 것과 커서를 적는 것.
- *
- * ── 왜 갈라져 있나 (2026-08-31) ──────────────────────────────────────────
- * `reference-hook.ts` 가 엔티티를 직접 가져오면 그 파일을 부르는 시험이 TypeORM 데코레이터를 지나게
- * 되고, 시험이 서지 않는다. 실제로 훅 시험이 규약 파일(`hook-contract.ts`)만 부르고 있었던 이유가
- * 그것이다 — 그래서 **배선은 아무 시험도 걷지 않았다.**
- *
- * 저장소에 닿는 두 함수만 여기로 내면, 처리 순서 전체를 시험이 같은 함수로 걸을 수 있다. 시험은
- * 저장본을 손에 들고 있는 구현을 넣어 재기동까지 넣는다.
- */
-import { getRepository } from '@things-factory/shell'
-
-import { TwinReference } from './twin-reference.js'
-import type { HookStore } from './reference-hook.js'
-
-/** 실제 저장소를 쓰는 구현 — 라우터가 이것을 넣는다. */
-export function databaseStore(): HookStore {
-  return {
-    load: (domainId: string, source: string) =>
-      getRepository(TwinReference)
-        .findOne({ where: { domain: { id: domainId }, source } })
-        .catch(() => null),
-    saveCursor: async (refId: string, cursor: unknown) => {
-      await getRepository(TwinReference).update({ id: refId }, { liveCursor: cursor } as any)
-    }
-  }
-}

package/server/service/reference/index.ts

@@ -1,18 +0,0 @@
-import { ConnectionPortabilityResolver } from './connection-portability-resolver.js'
-import { TwinReferenceResolver } from './reference-resolver.js'
-import { TwinReferenceProgressSubscription } from './reference-progress-subscription.js'
-import { TwinReference } from './twin-reference.js'
-import { TwinReferenceReconciliation } from './twin-reference-reconciliation.js'
-import { TwinReferenceReconciliationQuery } from './reference-reconciliation-query.js'
-
-export const entities = [TwinReference, TwinReferenceReconciliation]
-export const resolvers = [TwinReferenceResolver, TwinReferenceProgressSubscription, ConnectionPortabilityResolver, TwinReferenceReconciliationQuery]
-export * from './control-routing.js'
-/* 진행 단계 어휘 — **모든 커넥터가 같은 낱말로 말한다.** 화면은 단계마다 번역 하나만 두면 된다. */
-export * from './reference-progress.js'
-/* 커넥터 점검 하네스 — 실 원본에 붙여 무엇이 채워지고 무엇이 비는지 센다(앱을 띄우지 않는다). */
-export * from './reference-probe.js'
-/* 놓친 구간을 backfill 해 채우는 길 — 밀어 받는 길과 같은 번호 검사를 지난다. */
-export * from './reference-fill.js'
-export * from './reference-reconciliation.js'
-export * from './connection-portability.js'

package/server/service/reference/ingest-space.ts

@@ -1,104 +0,0 @@
-/*
- * 인제스트가 어느 공간으로 들어갈지 정한다 — **순수**.
- *
- * ── 왜 있나 (2026-08-05) ────────────────────────────────────────────────────
- * 한 현실(공장·물류센터)을 여러 렌즈가 비춘다: 창고(WMS)·공정(MES)·야드(YMS) 가 같은 부지에 있다.
- * 엔진은 이미 그것을 지원한다 — 같은 `spaceId` 로 들어오면 공간 content 를 병합하고 기존 값을 이긴다.
- *
- * 그런데 **만드는 흐름에 그 선택이 없었다.** 템플릿은 `space.spaceId` 를 정하지 않으므로 항상
- * `<source>-site` 로 파생돼, 새 트윈은 늘 새 현장처럼 생겼다. 데이터로는 가능한 일이 저작으로는
- * 불가능했다.
- *
- * ── 없는 공간에 알리지 않고 새 공간을 만들지 않는다 ────────────────────────────────
- * "이 현장에 더한다" 는 요청이 오타·낡은 목록으로 빗나갔을 때 새 공간을 만들어 주면, 사용자는
- * 합쳤다고 믿고 화면에서는 따로 놀게 된다 — 나중에 두 현장을 손으로 합쳐야 하고, 그때는 이미
- * 이벤트가 양쪽에 쌓여 있다. 그래서 **모르는 공간이면 거절한다.**
- *
- * ── 같은 id 를 쓰는 구역은 알리지 않고 합쳐지므로 알린다 ──────────────────────────
- * 공간 content 의 구역·랜드마크는 id 로 합집합을 만든다(`unionById`). 두 렌즈가 우연히 같은 구역
- * id(`a-yard` 따위)를 쓰면 서로 다른 구역이 하나로 합쳐진다. 막을 일은 아니다(같은 현장의 같은 구역을
- * 가리키는 정당한 경우가 많다) — 다만 **모르고 지나가지 않게** 경고로 돌려준다.
- */
-
-/** 공간 판정 결과. */
-export interface IngestSpaceChoice {
-  /** 실제로 쓸 공간 id. */
-  spaceId: string
-  /** 사용자가 기존 현장에 합치기를 골랐나(마스터가 파생한 공간과 다른 곳으로 들어가나). */
-  joined: boolean
-}
-
-/** 거절 사유 — 호출측이 문장을 만들 때 쓴다(언어 중립 코드). */
-export const INGEST_SPACE_NOT_FOUND = 'space-not-found'
-
-/**
- * 요청받은 공간과 마스터가 파생한 공간 중 무엇으로 들어갈지 정한다.
- *
- * @param masterSpaceId 마스터에서 파생된 공간 id(요청이 없을 때의 기본).
- * @param requested     사용자가 고른 기존 공간 id. 없으면 빈 값/undefined.
- * @param requestedExists 그 공간이 이 테넌트에 실제로 있나(호출측이 조회해 넘긴다).
- * @throws 요청한 공간이 없으면 — 알리지 않고 새로 만들지 않는다.
- */
-export function resolveIngestSpace(masterSpaceId: string, requested: string | undefined | null, requestedExists: boolean): IngestSpaceChoice {
-  const want = (requested ?? '').trim()
-  if (!want) return { spaceId: masterSpaceId, joined: false }
-  if (!requestedExists) {
-    const e = new Error(`space "${want}" not found — cannot co-locate into a space that does not exist`)
-    ;(e as any).code = INGEST_SPACE_NOT_FOUND
-    throw e
-  }
-  /* 마스터가 이미 그 공간을 가리키면 합치기가 아니다 — 같은 공간의 재인제스트다. */
-  return { spaceId: want, joined: want !== masterSpaceId }
-}
-
-/**
- * 실 시스템 import 가 현장을 고를 때의 거절 판정 — **순수**.
- *
- * 레퍼런스 하나는 사이트를 여럿 발견할 수 있고(`discoverSites`), 그 사이트마다 트윈이 하나씩 생긴다.
- * 그런데 "이 현장에 더한다" 는 **한 곳**을 가리키는 말이다. 사이트 여럿을 한 공간에 넣으면 서로 다른
- * 현장의 구역·랜드마크가 id 로 합쳐지고(`unionById`), 그 사실을 알아차릴 때는 이미 이벤트가 양쪽에
- * 쌓여 있다 — 손으로 되돌릴 수 없는 종류다. 그래서 **묻지 않고 합치지 않고, 거절한다.**
- *
- * 공간을 고르지 않으면 지금까지의 거동 그대로다: 사이트마다 마스터가 파생한 공간으로 들어간다.
- */
-export type ImportSpaceRefusalCode = 'space-with-multiple-sites'
-
-export interface ImportSpaceRefusal {
-  code: ImportSpaceRefusalCode
-  params?: Record<string, string | number>
-  /** 영어 canonical — 로그에 남고, 번역이 없으면 그대로 보인다(발견 오류와 같은 규약). */
-  message: string
-}
-
-/**
- * @param siteCount 실제로 만들 사이트 수(필터 적용 후).
- * @param requested 사용자가 고른 기존 공간 id. 없으면 판정할 것이 없다.
- * @returns 거절 사유. 없으면 진행해도 된다.
- */
-export function refuseImportSpace(siteCount: number, requested?: string | null): ImportSpaceRefusal | undefined {
-  const want = (requested ?? '').trim()
-  if (!want || siteCount <= 1) return undefined
-  return {
-    code: 'space-with-multiple-sites',
-    params: { spaceId: want, count: siteCount },
-    message: `cannot co-locate ${siteCount} sites into space "${want}" — pick one site, or omit the space so each site gets its own`
-  }
-}
-
-/** 구역·랜드마크처럼 id 로 합쳐지는 것들. */
-interface Identified {
-  id?: string
-}
-
-/**
- * 합치는 쪽과 기존 쪽이 같은 id 를 쓰는 것들을 찾아 경고 문장을 만든다.
- *
- * 정당한 경우(같은 현장의 같은 구역)와 사고(서로 다른 구역이 우연히 같은 이름)를 기계가 가릴 수는
- * 없다. 구분할 수 없는 것을 고르지 않고, **무엇이 합쳐졌는지 말한다.**
- */
-export function collidingIds(existing: readonly Identified[] | undefined | null, incoming: readonly Identified[] | undefined | null): string[] {
-  const have = new Set((existing ?? []).map(x => x?.id).filter(Boolean) as string[])
-  const hits = new Set<string>()
-  for (const x of incoming ?? []) if (x?.id && have.has(x.id)) hits.add(x.id)
-  return [...hits].sort()
-}

package/server/service/reference/knob-defaults.ts

@@ -1,59 +0,0 @@
-/*
- * 노브 기본값 적용 — **순수**. "안 준 값은 템플릿이 선언한 기본값으로."
- *
- * ── 왜 있나 (2026-08-05) ────────────────────────────────────────────────────
- * 템플릿은 노브마다 기본값을 선언한다(`knobs[].default`). 그런데 그 기본값을 채우는 일을 **위자드만**
- * 하고 있었다 — 서버는 받은 파라미터를 그대로 `build(p)` 에 넘긴다. 그래서 파라미터를 일부만 주고
- * 부르면(AI·스크립트·API 호출자) 템플릿 안에서 `Number(p.inboundRate) || 0` 이 **0** 이 되고,
- * 발생률 0 = 도착 없음 = **아무것도 하지 않는 트윈**이 알리지 않고 만들어진다.
- *
- * 실제로 그 함정을 밟았다: 유통가공 창고를 파라미터 일부만 주고 만들었더니 이벤트가 0건이었고,
- * 처음에는 템플릿이 깨진 것으로 오진했다. 기본값을 아는 곳이 계약(노브 스키마)인데 그것을 적용하는
- * 곳이 화면뿐이면, 화면을 거치지 않는 모든 경로가 함정이 된다.
- *
- * ── 0 을 기본값으로 덮지 않는다 ─────────────────────────────────────────────
- * 발생률 `0` 은 "도착 없음" 이라는 **뜻 있는 값**이다. 없는 것과 0 은 다르다 — falsy 로 판정해 덮으면
- * "자극 없이 구조만 보겠다" 는 선언이 알리지 않고 뒤집힌다. 그래서 **키가 없을 때만** 채운다.
- * `null` 은 없는 것으로 본다(JSON·GraphQL 경로에서 "주지 않음" 이 null 로 오는 일이 흔하다).
- *
- * ── 선언 밖 파라미터는 손대지 않는다 ────────────────────────────────────────
- * 템플릿은 노브에 없는 값도 읽는다(예: `geo` 대신 `lat`/`lon` 폴백). 모르는 키를 걷어내면 그 경로가
- * 알리지 않고 끊긴다. 그대로 통과시킨다.
- */
-
-/** 템플릿 노브 — 기본값 적용에 필요한 만큼만 본다. */
-export interface KnobLike {
-  key?: string
-  default?: unknown
-}
-
-/**
- * 빠진 노브를 기본값으로 채운다.
- *
- * @param knobs  템플릿이 선언한 노브들(없으면 파라미터를 그대로 돌려준다).
- * @param params 호출자가 준 파라미터.
- * @returns 새 객체 — 입력을 바꾸지 않는다(호출자의 객체가 몰래 변하면 추적이 어렵다).
- */
-export function applyKnobDefaults(knobs: readonly KnobLike[] | undefined | null, params: Record<string, unknown> | undefined | null): Record<string, unknown> {
-  const out: Record<string, unknown> = { ...(params ?? {}) }
-  for (const k of knobs ?? []) {
-    if (!k?.key) continue
-    if (k.default === undefined) continue // 기본값을 선언하지 않은 노브는 채울 것이 없다
-    const given = out[k.key]
-    if (given === undefined || given === null) out[k.key] = k.default
-  }
-  return out
-}
-
-/**
- * 기본값으로 채운 노브 이름들 — 호출자에게 "무엇을 내가 정해 줬는지" 알릴 때 쓴다.
- *
- * 알리지 않고 채우는 것도 알리지 않고 비우는 것만큼 위험하다: 사용자가 준 적 없는 값으로 트윈이 만들어졌는데
- * 아무 말이 없으면, 나중에 "왜 이 수치인가" 를 아무도 답할 수 없다.
- */
-export function filledKnobKeys(knobs: readonly KnobLike[] | undefined | null, params: Record<string, unknown> | undefined | null): string[] {
-  const given = params ?? {}
-  return (knobs ?? [])
-    .filter(k => k?.key && k.default !== undefined && (given[k.key!] === undefined || given[k.key!] === null))
-    .map(k => k.key!)
-}

package/server/service/reference/live-cadence.ts

@@ -1,129 +0,0 @@
-/*
- * **원천이 축마다 언제·얼마나 자주 내놓나** — 유입 건강이 이 선언으로 견준다.
- *
- * ── 왜 필요한가 (2026-09-04 실측) ──────────────────────────────────────────
- * 유입 건강이 **한 자로 전부를 쟀다.** 10분 안에 아무것도 오지 않으면 「유입 없음」이다. 그런데
- * 원천마다 시간의 결이 다르다.
- *
- *   태양광 발전        일몰에 멈춘다 — 두 사이트가 같은 분 19:25 에 함께
- *   부하 계측          밤에도 온다 · 15분마다
- *   인증서 가격        화·목만 거래된다 · 그 날 하루 한 번
- *   MES · 주방        현장 근무시간 밖에는 사실이 안 난다 · 훅이라 「보내면 온다」
- *
- * 그래서 **정상인데 매일 밤 절반이 빨갛게 났다.** 거짓 빨강이 쌓이면 진짜 빨강도 같이 안 읽힌다.
- *
- * ── 두 축이고 서로 다르다 ───────────────────────────────────────────────────
- *   window            지금이 그 축의 활동 시각인가        → 아니면 조용한 것이 정상
- *   expectedSilenceMs 활동 시각 안에서 이만큼 조용해도 정상 → 넘기면 유입 없음
- *
- * 주기를 넘겼어도 활동 시각 밖이면 정상이다. 한 값으로 접을 수 없다 — 인증서 가격이 그 증거다.
- * 「매일 와야 한다」로 재면 주 5일 중 3일이 빨갛고, 「주 2회」로 재면 이어 쓴 날을 못 본다.
- *
- * ── 커널이 일출·일몰을 계산하지 않는다 ─────────────────────────────────────
- * 굴절·고위도·박명 정의가 다 선택이고, 우리가 정하면 그 순간 방언이다. 그리고 계약이 같은 문제에
- * 이미 답해 뒀다(§`TwinModelDef.utcOffsetMinutes`): 「긴 지평선의 정확한 답은 호스트가 표준대로
- * **절대 구간**을 계산해 넣는 것이다」.
- *
- * 그래서 원천은 `windowKind: 'daylight'` 로 **종류만** 선언하고, 좌표를 아는 호스트가 날마다
- * 구체적인 구간을 채운다. **고정 시각을 선언에 박지 않는다** — 일몰 19:25 는 오늘 잰 값이고 두 달
- * 뒤에는 틀리다. 그것을 박으면 겨울마다 거짓 빨강이 다시 난다.
- *
- * ── 「주기 없음」과 「모른다」는 다르다 ──────────────────────────────────────
- * MES 는 훅으로 밀어 준다 — 몇 분마다가 아니라 「보내면 온다」다. 보낼 것이 없으면 안 보내는 것이
- * 정상이고, 그것을 침묵으로 판정하면 안 된다.
- *
- * 선언하지 않은 축은 **지금까지처럼** 창 하나로 견준다(옛 거동). 「모른다」를 「안 와도 된다」로
- * 접지 않는다 — 그러면 정말 끊긴 원천이 통째로 조용해진다.
- */
-import type { WorkCalendarEntry } from '@operato/ops-contract'
-
-/**
- * 창의 종류 — **호스트가 채워야 하는 것**만 이름이 있다.
- *
- * 지금은 하나다. 늘리기 전에 「호스트가 그것을 계산할 근거를 갖고 있나」를 먼저 물어야 한다 —
- * 좌표 없이 `daylight` 를 선언하면 호스트가 채울 것이 없고, 그러면 그 축은 창이 없는 것과 같다.
- */
-export type LiveWindowKind = 'daylight'
-
-/** 한 축의 시간성 — 어느 사실이 언제·얼마나 자주 오나. */
-export interface LiveCadence {
-  /**
-   * 어느 축인가 — **`OP_EVENT` 의 값 그대로**(`equipment.status` · `quality.output` …).
-   *
-   * 새 낱말을 만들지 않는다. 만들면 커넥터가 부르는 이름과 장부가 세는 이름이 갈리고, 그때
-   * 선언이 조용히 아무 축에도 안 붙는다.
-   */
-  axis: string
-  /**
-   * 활동 시각 안에서 **이만큼 조용해도 정상**(ms). 없으면 창 하나로 견준다.
-   *
-   * 15분마다 긷는 원천은 이 값을 선언해야 한다 — 안 하면 긷는 사이마다 「유입 없음」으로 보인다.
-   */
-  expectedSilenceMs?: number
-  /**
-   * 이 축이 **활동하는 창** — 근무 달력 어휘 그대로(요일·시간대·휴일).
-   *
-   * 계약이 이미 그 셋을 표현한다. 새 모양을 만들지 않는 이유는 판정하는 함수가 이미 하나
-   * 있기 때문이다(`inWorkCalendar`) — 두 벌이면 화면과 커널이 다른 답을 낸다.
-   */
-  window?: readonly WorkCalendarEntry[]
-  /**
-   * 창을 **호스트가 채우는 종류** — 좌표·표준으로 계산해야 하는 것.
-   *
-   * `window` 와 함께 선언하면 호스트가 채운 것이 이긴다(계산이 선언보다 그 날에 맞다).
-   */
-  windowKind?: LiveWindowKind
-  /**
-   * **보내면 온다** — 이 축은 침묵으로 판정하지 않는다(훅·구독).
-   *
-   * 「주기가 없다」와 「모른다」를 가르는 값이다. 훅은 보낼 것이 없으면 안 보내고, 그것이 정상이다.
-   */
-  pushed?: boolean
-}
-
-/** 그 축의 선언을 찾는다 — 없으면 `undefined`(옛 거동으로 견준다). */
-export function cadenceOf(cadences: readonly LiveCadence[] | undefined, axis: string): LiveCadence | undefined {
-  return cadences?.find(c => c.axis === axis)
-}
-
-/**
- * 유입 건강이 이 축을 어떻게 견줄 것인가 — **판정에 넘길 두 값으로 옮긴다.**
- *
- * `syncVerdictOf` 가 받는 모양(§`ingest-health.ts`)에 맞춘다. 그 함수는 순수하고 달력을 보지
- * 않으므로, 창 판정은 여기서 끝내고 참·거짓만 넘긴다 — `capabilityOf` 가 `requiredTests` 를 받는
- * 것과 같은 규율이다.
- *
- * ── 「보내면 온다」는 침묵으로 판정하지 않는다 ──────────────────────────────
- * `pushed` 면 `quietNow` 를 늘 참으로 낸다. 그러면 침묵이 「유입 없음」이 되지 않는다. **다른
- * 갈래는 그대로 산다** — 버려지는 중·결선 없음은 몇 시든 문제이고 그것들이 이 값보다 앞선다.
- *
- * ── 모르면 아무것도 답하지 않는다 ──────────────────────────────────────────
- * 선언이 없으면 둘 다 비운다. 그때 판정은 지금까지처럼 창 하나로 견준다 — 「모른다」를 「안 와도
- * 된다」로 접으면 정말 끊긴 원천이 통째로 조용해진다.
- */
-export function ingestExpectation(
-  cadence: LiveCadence | undefined,
-  ctx: { nowMs: number; utcOffsetMinutes?: number; inWindow?: (window: readonly WorkCalendarEntry[]) => boolean }
-): { expectedSilenceMs?: number; quietNow?: boolean } {
-  if (!cadence) return {}
-
-  const out: { expectedSilenceMs?: number; quietNow?: boolean } = {}
-
-  if (typeof cadence.expectedSilenceMs === 'number' && cadence.expectedSilenceMs > 0) {
-    out.expectedSilenceMs = cadence.expectedSilenceMs
-  }
-
-  if (cadence.pushed) {
-    /* 보낼 것이 없으면 안 보내는 것이 정상이다 — 침묵을 근거로 삼지 않는다. */
-    out.quietNow = true
-    return out
-  }
-
-  /*
-   * 창이 있으면 그것으로 판정한다. **판정할 수단을 안 받았으면 답하지 않는다** — 부르는 쪽이
-   * 달력 판정 함수를 주지 않았는데 우리가 「활동 시각이다」로 단언하면 그것이 지어낸 값이다.
-   */
-  if (cadence.window?.length && ctx.inWindow) out.quietNow = !ctx.inWindow(cadence.window)
-
-  return out
-}

package/server/service/reference/live-feed-lease.ts

@@ -1,56 +0,0 @@
-/*
- * What a live feed takes its task lease under — pure naming, one place.
- *
- * ── Why the name is built here and not by the adapter ──────────────────────
- * `TaskLease` deliberately has no domain column: the thing made exclusive is a
- * loop, not a tenant's slice of one, and a task that does need to be per-tenant
- * puts the tenant in its name so the unique index keeps meaning what it says.
- *
- * An adapter cannot honour that. It receives `cfg` and `site`, and neither
- * carries a domain — so a name built from `siteId` would let two domains that
- * happen to share a plant code block each other's channel. It would look
- * exactly like "someone else holds it", which is the ordinary case on every
- * instance but one, so nothing would be logged and nothing would look wrong.
- *
- * ── Why the source and not the site ───────────────────────────────────────
- * One reference is one connection to one system, and that connection is what a
- * second instance must not open twice. A source that discovers several sites
- * still reads them over that one connection.
- *
- * ── Why the parts are joined with `::` ────────────────────────────────────
- * The same separator the push cursor key already uses (`instanceId::scope`), so
- * a person reading `task_leases` during an incident sees the same shape they
- * see in `liveCursor`.
- */
-
-/** Marks the name as a live feed, so a lease table read tells you what kind of task it is. */
-const PREFIX = 'twin-live'
-
-/**
- * The lease name for one twin's feed.
- *
- * ── Domain and instance are required; the source is not ───────────────────
- * A feed is registered per instance, so domain plus instance already names it
- * uniquely. The source is appended when known because it is what a person
- * reading `task_leases` wants to see — which system this channel talks to.
- *
- * Missing a domain or an instance is refused rather than filled in. A blank
- * there would collapse two different feeds onto one name, and the failure
- * would be that one of them silently stops: it would look exactly like
- * "someone else holds it", which is the ordinary case on every instance but
- * one, so nothing would be logged.
- */
-export function liveFeedLeaseName(domainId: string, instanceId: string, source?: string): string {
-  for (const [what, value] of [
-    ['domainId', domainId],
-    ['instanceId', instanceId]
-  ] as const) {
-    if (!value || !String(value).trim()) {
-      throw new Error(`cannot name a live feed lease without ${what} — two feeds would share one name`)
-    }
-  }
-
-  const named = source && String(source).trim()
-
-  return named ? `${PREFIX}::${domainId}::${instanceId}::${named}` : `${PREFIX}::${domainId}::${instanceId}`
-}

package/server/service/reference/live-ingest.ts

@@ -1,94 +0,0 @@
-/*
- * **원본이 준 레코드를 트윈에 넣는다** — 밀어 받는 길과 backfill 이 같이 쓴다.
- *
- * ── 왜 한 곳에 두나 ─────────────────────────────────────────────────────────
- * 이 몸통이 `routes.ts` 의 훅 안에 박혀 있었습니다. backfill 문을 만들면서 복사하면 두 길이 서로
- * 다른 규칙으로 받게 되고, 한쪽만 수정되는 날이 옵니다.
- *
- * 실제로 그 위험이 이 자리에 있습니다. 유입 장부의 네 갈래(앉음 · 되풀이 · 어휘 · 거절)를
- * 2026-09-05 에 고쳤는데, 그때 이 몸통이 두 벌이었다면 한쪽 셈만 닫혔을 것입니다.
- *
- * ── 커널을 직접 부르지 않는 쪽이 넘겨받는다 ────────────────────────────────
- * 훅 판정(`reference-hook.ts`)은 이 함수를 인자로 받습니다. 그 파일이 엔진을 직접 부르면 테스트할
- * 때 엔진이 필요해집니다. 그 규율은 그대로 두고, 이 파일이 엔진을 아는 유일한 자리가 됩니다.
- */
-import type { IngestResult } from './reference-hook.js'
-
-import { TwinEngine } from '../../engine/index.js'
-import { ingestCanonicalRecords } from '../../engine/canonical-ingest.js'
-import { databaseCommandStore, settleEffects } from '../actuation/index.js'
-import { shouldHaveTime } from '../../engine/event-time.js'
-import { twinWarn } from '../../engine/log.js'
-
-/**
- * 레코드를 넣고 **네 갈래로 답한다.**
- *
- * 두 갈래로는 셈이 안 닫힙니다(인티그레이션 레인 실측 2026-09-05).
- *
- * ```
- * 두 갈래   157 − 46 − 2 = 109 「설명 못 함」   진실은 되풀이 108 + 어휘 1
- * 네 갈래   157 − 46 − 2 − 108 − 1 = 0
- * ```
- *
- * 109 를 「사라졌다」로 내면 그날부터 아무도 그 수를 안 봅니다. 늘 참인 경고는 벽지가 됩니다.
- *
- * `vocabulary` 는 저널에 안 가는 어휘 요소의 수입니다. 사라진 것이 아닙니다.
- *
- * @param via 유입 장부에 남길 길 이름 — `hook`(밀어 받음) · `fill`(빠진 구간을 다시 받음)
- */
-export function liveIngest(
-  domainId: string,
-  instanceId: string,
-  records: unknown[],
-  via: string
-): IngestResult & { vocabulary: number; undated?: Record<string, number> } {
-  const { accepted, rejected, masterData, undated } = ingestCanonicalRecords(
-    records as any,
-    domainId,
-    new Date().toISOString(),
-    TwinEngine.factScope(domainId, instanceId)
-  )
-  /* 사건이 아닌 것은 상태만 세운다 — 두 길이 같은 규율이다(§`applyMasterData`). */
-  if (masterData.length) TwinEngine.applyMasterData(domainId, instanceId, masterData)
-  const { applied, duplicates } = TwinEngine.ingestLiveResult(domainId, instanceId, accepted, via)
-
-  /*
-   * **나간 지시와 잇는다** — 폐루프. 기다리지 않습니다: 훅의 응답이 이것 때문에 늦으면 보내는 쪽이
-   * 되풀이하고, 그러면 같은 관측이 두 번 옵니다. 실패해도 관측 유입은 멈추지 않습니다.
-   */
-  void settleEffects({ domainId, envelopes: accepted, store: databaseCommandStore() })
-
-  /*
-   * 커널이 받지 못한 수를 이름으로 남깁니다 — 트윈이 멈춘 사이 버려진 레코드를 「통과」로 세면
-   * 화면이 100% 라고 말합니다. 중복으로 걸러진 것은 버려진 것이 아니므로 빼고 셉니다.
-   */
-  const undelivered = Math.max(0, accepted.length - applied - duplicates)
-  TwinEngine.recordIngestResult(domainId, instanceId, records.length, rejected, Date.now(), undelivered, masterData.length)
-
-  /*
-   * 떨어진 것을 **수가 아니라 목록으로** 넘깁니다 — 응답에 실어야 보내는 쪽이 그것만 따로 둘 수
-   * 있습니다. 수만 주면 배치 전체를 다시 보내거나 전부 버리는 두 갈래밖에 없습니다.
-   */
-  /*
-   * **표에 있는 type 인데 시각을 못 읽었으면 그것은 결함이다.** 그 fact 는 자기 시각을 싣기로 되어
-   * 있는데 안 실려 온 것이고, 그대로 두면 ingest 시각이 그 사실의 시각으로 저장된다.
-   *
-   * 표에 없는 type 은 세기만 한다 — 절대값 snapshot 은 polling 순간이 맞는 시각이다.
-   */
-  const wrong = Object.entries(undated ?? {}).filter(([type]) => shouldHaveTime(type))
-  if (wrong.length) {
-    twinWarn(
-      `[twin-ingest] "${instanceId}" — 시각을 실어야 하는 fact 가 시각 없이 왔습니다: ` +
-        wrong.map(([t, n]) => `${t} ${n}건`).join(' · ') +
-        `. 그 사실들은 지금 시각으로 저널에 앉습니다`
-    )
-  }
-
-  return {
-    applied,
-    duplicates,
-    vocabulary: masterData.length,
-    rejected,
-    ...(undated && Object.keys(undated).length ? { undated } : {})
-  }
-}