npm - @things-factory/headless-twin - Versions diffs - 10.1.18 → 10.1.20 - Mend

@things-factory/headless-twin 10.1.18 → 10.1.20

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (20) hide show

package/dist-server/service/actuation/command-dispatcher.d.ts CHANGED Viewed

@@ -218,6 +218,8 @@ export declare function settleByApproval(store: CommandStore, domainId: string,
     at: string;
     note?: string;
 }): Promise<StoredCommand>;
+/** 낸 사람이 자기 것을 승인하려 했다 — 워크리스트가 쓰는 낱말과 **같은 값**이어야 한다. */
+export declare const SELF_APPROVAL = "self-approval";
 /**
  * 어댑터에 넘긴다 — **승인을 지나지 않은 것은 여기서 막힌다.**
  *

package/dist-server/service/actuation/command-dispatcher.js CHANGED Viewed

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.SELF_APPROVAL = void 0;
 exports.propose = propose;
 exports.linkApproval = linkApproval;
 exports.approve = approve;
@@ -169,10 +170,28 @@ function assertNotSelfApproval(command, by) {
     if (!proposer)
         return;
     if (proposer.toLowerCase() === String(by ?? '').trim().toLowerCase()) {
-        throw new Error(`낸 사람이 자기 조치를 승인할 수 없다 (${proposer}) — 되돌릴 수 없는 조치에는 다른 사람의 승인이 필요하다. ` +
-            '승인자가 없다면 결재선에 승인자를 지정하거나, 다른 사람이 승인해야 한다');
+        throw selfApprovalRefused(proposer);
     }
 }
+/**
+ * 같은 사실에는 **같은 낱말** — `self-approval` (ADR-0052 ③, ADR-0042 ③).
+ *
+ * 워크리스트에도 같은 규칙이 선다(`worklist/server/controllers/activity-approval/own-request.ts`).
+ * **두 벌이 아니라 두 문이다** — 커널은 업무 목록을 안 지나는 길(API · AI 발의)에서 자기 커맨드를
+ * 지키고, 워크리스트는 결재 문을 지킨다. 커널↔호스트 경계를 넘어 합치지 않는다.
+ *
+ * 두 문이 위험한 것은 **서로 다른 답을 낼 때**다. 그래서 문장이 아니라 **코드를 맞춘다** — 문장은
+ * 번역도 집계도 안 되고, 고치는 날 두 문이 다른 말을 한다. 붙잡는 쪽은 `code` 를 보고, 사람에게는
+ * `message` 를 보인다.
+ */
+function selfApprovalRefused(proposer) {
+    const error = new Error(`낸 사람이 자기 조치를 승인할 수 없다 (${proposer}) — 되돌릴 수 없는 조치에는 다른 사람의 승인이 필요하다. ` +
+        '승인자가 없다면 결재선에 승인자를 지정하거나, 다른 사람이 승인해야 한다');
+    error.code = exports.SELF_APPROVAL;
+    return error;
+}
+/** 낸 사람이 자기 것을 승인하려 했다 — 워크리스트가 쓰는 낱말과 **같은 값**이어야 한다. */
+exports.SELF_APPROVAL = 'self-approval';
 /** 승인 기록만 바뀌고 나머지는 그대로 간다 — 하나라도 흘리면 그 사실이 사라진다. */
 function carried(command) {
     return {

package/dist-server/service/actuation/command-dispatcher.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"command-dispatcher.js","sourceRoot":"","sources":["../../../server/service/actuation/command-dispatcher.ts"],"names":[],"mappings":"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","sourcesContent":["/\n 승인을 지난 커맨드만 어댑터에 넘긴다 — 게이트가 서는 자리.\n \n ── 왜 이 자리인가 (2026-08-31) ──────────────────────────────────────────\n * 설계가 「기본 = propose-only」를 정해 두었는데 코드에 그 규율이 없었다. 인티그레이션 레인이 어댑터에\n * 조치를 붙이려다 그것을 보고 멈췄다 — 게이트 없이 붙이면 트윈이 사람 승인 없이 현장에 작업지시를\n * 내린다. 작업지시는 취소해도 이미 만든 것이 남는다.\n \n ── 확인을 여기서 한 번만 한다 ───────────────────────────────────────────\n * 어댑터는 승인을 확인하지 않는다. 그 확인은 이 파일이 했고 타입이 그것을 증명한다\n * (`ApprovedCommand` 는 `approveCommand`·`asApproved` 로만 만들어진다). 어댑터가 또 확인하면 규칙이\n * 두 벌이 되고, 한쪽만 고쳐지는 날이 온다.\n \n ── 저장소에 닿는 자리를 밖으로 낸다 ─────────────────────────────────────\n * 훅에서와 같은 이유다(§`HookStore`). 시험이 재기동을 넣을 수 있어야 한다 — 승인이 프로세스 안에만\n * 살아 있으면 「승인된다」는 보이지만 「다시 세운 뒤에도 승인이 남아 있나」는 보이지 않는다.\n /\nimport {\n CMD,\n approveCommand,\n asApproved,\n commandFromSpec,\n nextCommandState,\n passThroughReversible,\n requiresApproval,\n type ApprovedCommand,\n type CommandApproval,\n type CommandOrigin,\n type CommandTypeSpec,\n type ISOTime,\n type TwinCommand\n} from '@operato/ops-contract'\n\n/\n 조치의 결과 — 어댑터가 돌려준다.\n \n 계약에도 같은 이름의 타입이 있는데(`contract.ts:3074`) 다른 것이다. 그쪽은 커널 자극의 답이고\n * 이쪽은 현장 지시의 답이다. 자극과 조치를 가른 것과 같은 갈림이다(§`propose` 의 거절).\n /\nimport type { RetryOutlook } from './retry-plan.js'\n\nexport interface CommandAck {\n ok: boolean\n /* 저쪽 문서 · 작업 식별자. 되돌릴 때 무엇을 되돌릴지 말하려면 이것이 있어야 한다. /\n ref?: string\n /\n 받아들였으나 저쪽이 덧붙인 말 — 실패가 아니고, 「끝났다」도 아니다.\n \n ── 왜 필요한가 (2026-09-02 실측) ──────────────────────────────────────\n * MES 에 조치 둘을 넘겼더니 트윈 쪽 두 행이 구별되지 않았다.\n \n WO-20260902-004 지시서 붙음 acked · ref 있음 · error 없음\n * WO-20260902-005 지시서 못 붙음 acked · ref 있음 · error 없음 ← 같다\n \n 005 는 사람이 MES 에서 지시서를 골라야 현장에 간다. 커넥터는 그 사실을 받았는데 *적을 칸이\n 없어서 로그로만** 남겼다. `error` 에 적으면 실패로 읽혀 커맨드가 `failed` 로 앉는다.\n \n 해석하지 않고 그대로 적는다. 무엇이 남았는지는 저쪽 어휘이고, 커널이 그 방언을 알면 보편\n * 계약이 깨진다 — 효과의 상태를 그대로 적는 것과 같은 규율(§`effect-match.ts`).\n /\n note?: string\n /\n 그 말 중 다음에 할 일 한 줄 — 원인은 `note` 다.\n \n 왜 둘인가: 읽는 사람은 「그래서 내가 뭘 해야 하나」를 먼저 찾는다(UX 레인). 한 문장으로 주면\n * 화면이 자르게 되고, 자르는 규칙이 화면마다 생긴다. 어댑터는 이미 둘로 알고 있으니 붙이지\n * 않고 따로 준다.\n /\n noteNext?: string\n error?: string\n /\n 다시 해서 될 일인가 — 실패에만 답한다(§`RetryOutlook`).\n \n again 그대로 다시 해 볼 만하다 못 닿았거나 저쪽이 잠깐 흔들렸다\n * after-fix 사람이 고친 뒤 그대로 나간다 설정 문제\n * never 이 조치로는 영원히 안 된다 지시 내용이 틀렸다\n \n 문장에 담지 않는 이유: 일꾼이 그것을 쓰려면 문장을 파싱해야 하고, 번역되면 깨진다.\n * `code` 를 따로 둔 것과 같은 이유다.\n \n 비어 있으면 말하지 않은 것이고 `never` 가 아니다. 그때 일꾼은 집지 않고 목록에 남긴다 —\n * 모르는 것을 `never` 로 접으면 고칠 수 있는 것을 사람이 포기한다.\n \n 타입을 좁게 둔다 — 어댑터가 답하는 값이고, 여기서 넓히면 커넥터가 모르는 낱말을 보내도\n * 타입이 통과시킨다. 표에서 읽는 쪽은 `string` 이다(DB 는 무엇이든 들 수 있으므로\n * `isRetryOutlook` 으로 걸러 읽는다).\n /\n retry?: RetryOutlook\n}\n\n/\n 저장소에서 되세운 커맨드 — 계약의 커맨드에 호스트가 아는 한 칸이 붙는다.\n \n `approvalRef` 를 계약에 넣지 않는다. 계약은 운영 도메인의 어휘(EPCIS·ISA-95)를 들고, 「승인 기록이\n * 어느 업무 시스템의 몇 번 문서인가」는 이 저장소의 배선이다. 계약에 넣으면 커널을 쓰는 모든 소비처가\n * 우리 업무 모듈의 존재를 알게 된다.\n /\nexport type StoredCommand = TwinCommand & {\n approvalRef?: string\n proposedBy?: string\n /* 규칙이 낸 것이면 그 근거가 된 관측(`Attention.id`) — 중복을 막는 열쇠다. /\n causeRef?: string\n ruleRef?: string\n /\n 저쪽에서 실제로 무엇이 되었나 — 상태가 아니라 별개 사실이다.\n \n `acked` 는 「저쪽이 답했다」이고 종착 상태다. 여기에 「현장에 나갔다」를 상태로 이어 붙이면\n * `acked` 가 종착이 아니게 되고, 되돌아오는 관측이 없는 커넥터의 조치가 *영원히 끝나지 않은\n 것으로 보인다.** 그런 커넥터가 정상이다 — 관측을 되돌려 주는 능력은 커넥터의 성질이지 조치의\n * 수명이 아니다.\n \n `status` 는 해석하지 않고 그대로 적는다(§`effect-match.ts`). 오더 상태 어휘는 도메인\n * 소유이고, 어느 값이 「현장에 나갔다」인지는 현장마다 다르다.\n \n 이 칸이 비어 있는 것은 「효과가 없었다」가 아니라 「모른다」다. 넘기다 닿지 못한 조치는\n * 식별자를 못 받으므로 이을 길이 아예 없다.\n \n ── 계약에도 같은 칸을 두었다 ──────────────────────────────────────────\n * `ops-contract` 의 `TwinCommand.effect` 가 이것이다. 다만 이 저장소는 그 패키지를 레지스트리에서\n * 받으므로(`^0.9.0`), 다음 판이 올라올 때까지 여기에 산다 — 위의 `approvalRef`·`causeRef` 와 같다.\n /\n effect?: { status: string; at: string; seen: number }\n /* 받아들였으나 저쪽이 덧붙인 말 — 해석하지 않고 그대로(§`CommandAck.note`). /\n dispatchNote?: string\n /* 그 말 중 다음에 할 일 한 줄 — 원인은 위 칸이다(§`CommandAck.noteNext`). /\n dispatchNoteNext?: string\n /\n 다시 해서 될 일인가 — 어댑터가 실패에 답한 갈래(§`RetryOutlook`). 비면 말하지 않은 것이다.\n \n 여기는 `string` 이다 — 표에서 읽은 값이고 DB 는 무엇이든 들 수 있다. 좁은 타입으로 두면\n * 낡은 행이나 손으로 고친 값이 타입상 참인 척한다. 판정하는 쪽이 `isRetryOutlook` 으로 걸러\n * 읽고, 모르는 낱말은 「말하지 않은 것」과 같이 다룬다.\n /\n retry?: string\n /* 몇 번 넘겨 봤나. 첫 시도가 1. /\n attempts?: number\n /* 다음에 넘겨 볼 시각(ISO) — 물러섬을 표에 든다. 메모리에 두면 재기동에 사라진다. /\n nextAttemptAt?: string\n}\n\n/* 커맨드가 사는 자리 — 재기동을 넘어야 한다. /\nexport interface CommandStore {\n load(domainId: string, id: string): Promise<StoredCommand \| null>\n save(domainId: string, command: StoredCommand): Promise<void>\n /* 새로 낸다 — `save` 는 있는 행만 고친다. 낼 길이 없으면 대기 줄은 영원히 비어 있다. /\n create(domainId: string, command: StoredCommand): Promise<StoredCommand>\n /\n 결정을 기다리는 것들의 근거 — 규칙 판정이 중복을 피하려면 이것이 있어야 한다.\n \n 규칙을 쓰지 않는 소비처도 있으므로 없어도 된다. 없으면 판정에 빈 집합이 가고, 그때는 중복이 난다\n * — 그 사실을 부르는 쪽이 알아야 하므로 조용히 빈 집합을 만들어 주지 않는다.\n /\n openCauses?(domainId: string, instanceId: string): Promise<ReadonlySet<string>>\n /\n 넘긴 지시의 식별자로 조치를 찾는다 — 폐루프가 이 하나에 걸린다.\n \n 없으면 나간 지시와 돌아온 관측을 이을 수 없다. 그 사실을 부르는 쪽이 알아야 하므로 조용히 빈\n * 지도를 만들어 주지 않는다(§`openCauses` 와 같은 규율).\n /\n byDispatchRef?(domainId: string, refs: readonly string[]): Promise<ReadonlyMap<string, StoredCommand>>\n /\n 효과를 기다리는 조치들 — backfill 하는 길이 이것에 걸린다.\n \n 유입 자리에서 잇는 것만으로는 부족하다. 우리가 내려가 있던 동안, 또는 배선이 아직 없던 동안 온\n * 보고는 영원히 사라진다. 실제로 그렇게 됐다 — 배선을 만든 날 그 앞에 온 보고 하나를 못 이었다.\n \n 넘긴 식별자가 있는 것만 낸다. 없는 것은 이을 열쇠가 없다.\n /\n awaitingEffect?(domainId: string): Promise<readonly StoredCommand[]>\n /\n 넘길 차례를 기다리는 것들 — 승인만 되고 안 나간 것과, 실패해서 다시 해 볼 것.\n \n 일꾼이 이것으로 표를 읽는다. 없으면 일꾼이 아무것도 하지 않는다(옛 거동) — 저장소가\n * 이 능력을 갖추지 않은 구현도 그대로 돌아야 한다.\n /\n pendingDispatch?(domainId: string): Promise<readonly StoredCommand[]>\n /\n 효과만 적는다 — 상태를 건드리지 않는다.\n \n `save` 로 적으면 상태·승인·오류까지 함께 쓰이고, 유입 경로가 조치의 수명에 손을 대게 된다.\n * 관측이 조치를 되돌리거나 다시 넘기게 하는 길은 두지 않는다.\n /\n recordEffects?(domainId: string, updates: readonly { commandId: string; status: string; at: string; seen: number }[]): Promise<void>\n /\n 근거마다 마지막으로 조치를 낸 시각 — 승인 직후 같은 것이 다시 올라오는 것을 막는다.\n \n 없어도 된다. 없으면 판정이 결정 대기만 보고, 승인하는 순간 같은 조건이 다시 올라온다.\n /\n lastProposedAt?(domainId: string, instanceId: string): Promise<ReadonlyMap<string, number>>\n}\n\n/\n 조치를 낸다 — 대기 줄에 무언가가 들어오는 유일한 자리.\n \n ── 왜 뒤늦게 생겼나 (2026-08-31) ────────────────────────────────────────\n * 게이트와 승인 화면을 만들고 나서 물었다 — 「무엇을 승인하는 화면인가」. 커맨드 행을 *적는 코드가\n 하나도 없었다.** 자리는 있고 길이 없는 그 부류다.\n \n 종류를 선언된 것으로 제한한다. 모르는 종류를 받으면 되돌릴 수 있는지도 모르는 채로 게이트를 지나게\n * 되고, 그러면 게이트가 시늉이 된다.\n /\nexport async function propose(\n store: CommandStore,\n domainId: string,\n specs: readonly CommandTypeSpec[],\n seed: {\n id: string\n instanceId: string\n type: string\n origin: CommandOrigin\n proposedAt: ISOTime\n payload?: Record<string, unknown>\n /* 낸 사람. 사람이 냈으면 반드시 있어야 한다 — 없으면 자기 승인을 막을 수 없다. /\n proposedBy?: string\n /* 규칙이 낸 것이면 그 근거. 이 값이 없으면 다음 주기가 같은 것을 또 올린다. /\n causeRef?: string\n ruleRef?: string\n }\n): Promise<StoredCommand> {\n const spec = specs.find(s => s.type === seed.type)\n if (!spec) {\n /\n * 자극과 조치는 다른 어휘다.\n \n 계약에 두 벌이 있다. `CMD` 는 커널 안에서 도는 자극이고(`resource.repair` = 모델에서 수리된 것으로\n * 둔다), 여기서 다루는 것은 현장에 나가는 지시다(`production.order` = 실제로 만든다). 주의 신호가\n * 권하는 것(`Attention.suggestedAction.command`)은 앞엣것이다.\n \n 둘이 섞이는 길이 실재한다 — 주의를 읽어 조치를 내는 코드를 쓰다 보면 그 값을 그대로 넘기게 된다.\n * 막히기는 하는데 왜 막히는지 말하지 않으면 부르는 쪽은 선언이 빠진 줄로 읽고 선언을 추가한다.\n * 그 순간 모델 안의 자극이 현장 지시가 된다.\n /\n if ((Object.values(CMD) as string[]).includes(seed.type)) {\n throw new Error(\n `그것은 커널 안에서 도는 자극이다 (${seed.type}) — 현장에 나가는 지시가 아니다. ` +\n '모델 상태를 바꾸려면 커널에 자극을 넣고, 현장에 무언가를 시키려면 그 지시를 조치 종류로 선언한다'\n )\n }\n\n throw new Error(\n `선언되지 않은 조치 종류다 (${seed.type}) — 선언된 것: ${specs.map(s => s.type).join(', ') \|\| '(없음)'}. ` +\n '되돌릴 수 있는지를 모르는 채로 승인 게이트를 지나게 할 수 없다'\n )\n }\n\n /\n * 사람이 낸 것이면 누구인지 있어야 한다. 없이 받으면 그 커맨드는 아무나 승인할 수 있는 것이 되고,\n * 자기 승인을 막는 규칙이 그 한 건만 비껴간다.\n /\n if (seed.origin === 'operator' && !seed.proposedBy?.trim()) {\n throw new Error('사람이 내는 조치는 낸 사람이 있어야 한다 — 없으면 자기 것을 자기가 승인하는 것을 막을 수 없다')\n }\n\n / 요구하는 칸이 없으면 계약이 던진다 — 빈 지시가 대기 줄에 쌓이면 승인하는 사람이 판단할 근거가 없다. /\n return await store.create(domainId, {\n ...commandFromSpec(spec, seed),\n ...(seed.proposedBy?.trim() ? { proposedBy: seed.proposedBy.trim() } : {}),\n ...(seed.causeRef ? { causeRef: seed.causeRef } : {}),\n ...(seed.ruleRef ? { ruleRef: seed.ruleRef } : {})\n })\n}\n\n/\n 결재선에 올라간 자리를 커맨드에 적는다.\n \n 이것이 적힌 뒤로 직접 결정은 막힌다. 그래서 올리기와 적기가 한 트랜잭션에 있어야 한다 — 올렸는데\n * 적지 못하면 결재선에는 있고 커맨드는 직접 결정도 되는 상태가 남는다.\n /\nexport async function linkApproval(\n store: CommandStore,\n domainId: string,\n id: string,\n approvalRef: string\n): Promise<StoredCommand> {\n const command = await mustLoad(store, domainId, id)\n const next: StoredCommand = { ...command, approvalRef }\n await store.save(domainId, next)\n return next\n}\n\n/\n 승인한다 — 직접 문.\n \n 승인할 수 없는 상태면 계약이 던진다 — 여기서 답으로 돌려주지 않는 이유는, 실패를 답으로 주면 부르는\n * 쪽이 그것을 무시할 수 있기 때문이다.\n /\nexport async function approve(\n store: CommandStore,\n domainId: string,\n id: string,\n approval: CommandApproval\n): Promise<StoredCommand> {\n const command = await mustLoad(store, domainId, id)\n assertDirectDoorOpen(command)\n assertNotSelfApproval(command, approval.by)\n\n const approved = approveCommand(command, approval)\n await store.save(domainId, { ...approved, ...carried(command) })\n return approved\n}\n\n/* 거절한다 — 여기서 끝난다. 되살아나지 않는다. /\nexport async function reject(\n store: CommandStore,\n domainId: string,\n id: string,\n approval: CommandApproval\n): Promise<StoredCommand> {\n const command = await mustLoad(store, domainId, id)\n assertDirectDoorOpen(command)\n return await settle(store, domainId, command, false, approval)\n}\n\n/\n 결재선의 판정을 커맨드에 옮긴다 — 결재선 문.\n \n 부르는 쪽은 앱의 브리지다. 올라간 자리를 함께 넘기게 해서, 다른 결재 건의 판정이 이 커맨드에 적히는\n * 길을 막는다.\n \n 거절을 여기서 끝으로 다룬다. 업무 목록에서 「거절」은 되돌려 보내 고쳐 올리라는 뜻이지만, 조치에는\n * 고칠 것이 없다 — 지시 내용은 제안될 때 이미 정해져 있다. 그러니 되돌려 받을 것이 없고, 게이트를 닫는\n * 것이 맞다. 커맨드가 닫힌 뒤에 결재선에서 누가 승인해도 계약이 `rejected → approved` 를 허용하지 않는다.\n /\nexport async function settleByApproval(\n store: CommandStore,\n domainId: string,\n id: string,\n decision: { approvalRef: string; approved: boolean; by: string; at: string; note?: string }\n): Promise<StoredCommand> {\n const command = await mustLoad(store, domainId, id)\n\n if (!command.approvalRef) {\n throw new Error(`결재선에 올라가지 않은 커맨드다 (${id}) — 이 판정이 어디서 왔는지 확인할 수 없다`)\n }\n if (command.approvalRef !== decision.approvalRef) {\n throw new Error(\n `다른 결재 건의 판정이다 (커맨드 ${id} 는 ${command.approvalRef} 를 기다리는데 판정은 ${decision.approvalRef} 에서 왔다)`\n )\n }\n\n const approval: CommandApproval = {\n by: decision.by,\n at: decision.at,\n ...(decision.note ? { note: decision.note } : {})\n }\n\n if (!decision.approved) return await settle(store, domainId, command, false, approval)\n\n /\n * 결재선을 지나온 것도 이 규칙을 지난다. 결재선이 비어 있으면 업무 목록이 스레드를 곧바로 종료하고\n * (§`submit.ts`), 승인자를 `Myself` 로 넣으면 낸 사람이 승인자다 — 두 경우 다 여기서 막힌다.\n /\n assertNotSelfApproval(command, decision.by)\n\n const approved = approveCommand(command, approval)\n await store.save(domainId, { ...approved, ...carried(command) })\n return approved\n}\n\nasync function mustLoad(store: CommandStore, domainId: string, id: string): Promise<StoredCommand> {\n const command = await store.load(domainId, id)\n if (!command) throw new Error(`모르는 커맨드다 (${id})`)\n return command\n}\n\n/* 결재선에 올라간 커맨드는 직접 결정하지 않는다 — 문은 한 벌이다. /\nfunction assertDirectDoorOpen(command: StoredCommand): void {\n if (!command.approvalRef) return\n throw new Error(\n `이 조치는 결재선에 올라가 있다 (${command.approvalRef}) — 승인·거절은 업무 목록에서 한다. ` +\n '여기서 결정하면 결재선에는 대기로 남고 조치는 나간 상태가 된다'\n )\n}\n\n/\n 낸 사람은 자기 것을 승인하지 못한다.\n \n ── 왜 필요한가 (2026-08-31) ─────────────────────────────────────────────\n * 결재선에 올리는 길을 만들고 나서 업무 목록의 `submit.ts` 를 읽었다. *결재선이 비어 있으면 스레드가\n 곧바로 종료되고*, 그러면 우리 콜백이 「승인됐다」로 받는다. 승인자를 지정하지 않은 도메인에서는 낸\n 사람이 그 자리에서 자기 조치를 승인한 것이 된다. 오류 한 줄 없이.\n \n 결재선을 지정한 경우에도 열린다 — `Myself` 를 승인자로 넣으면 낸 사람이 승인자다.\n \n 그래서 규칙을 게이트 안쪽에 둔다. 올리는 자리에서만 막으면 그 자리를 지나지 않는 길에서 다시 열린다.\n * 되돌릴 수 없는 조치에 두 사람이 필요하다는 것이 이 표의 존재 이유다.\n \n 거절에는 걸지 않는다 — 낸 사람이 자기 것을 물리는 것은 막을 이유가 없다.\n /\nfunction assertNotSelfApproval(command: StoredCommand, by: string): void {\n const proposer = command.proposedBy?.trim()\n if (!proposer) return\n\n if (proposer.toLowerCase() === String(by ?? '').trim().toLowerCase()) {\n throw new Error(\n `낸 사람이 자기 조치를 승인할 수 없다 (${proposer}) — 되돌릴 수 없는 조치에는 다른 사람의 승인이 필요하다. ` +\n '승인자가 없다면 결재선에 승인자를 지정하거나, 다른 사람이 승인해야 한다'\n )\n }\n}\n\n/* 승인 기록만 바뀌고 나머지는 그대로 간다 — 하나라도 흘리면 그 사실이 사라진다. /\nfunction carried(command: StoredCommand): Partial<StoredCommand> {\n return {\n ...(command.approvalRef ? { approvalRef: command.approvalRef } : {}),\n ...(command.proposedBy ? { proposedBy: command.proposedBy } : {}),\n ...(command.causeRef ? { causeRef: command.causeRef } : {}),\n ...(command.ruleRef ? { ruleRef: command.ruleRef } : {})\n }\n}\n\nasync function settle(\n store: CommandStore,\n domainId: string,\n command: StoredCommand,\n approved: boolean,\n approval: CommandApproval\n): Promise<StoredCommand> {\n const to = nextCommandState(command.state, approved ? 'approve' : 'reject')\n if (!to) throw new Error(`${command.state} 상태의 커맨드는 ${approved ? '승인' : '거절'}할 수 없다 (${command.id})`)\n\n const next: StoredCommand = { ...command, state: to, approval, ...carried(command) }\n await store.save(domainId, next)\n return next\n}\n\n/\n 어댑터에 넘긴다 — 승인을 지나지 않은 것은 여기서 막힌다.\n \n `actuate` 는 `ApprovedCommand` 만 받으므로, 승인 없이 이 함수를 지나가는 길이 없다. 저장소에서\n * 되세운 커맨드는 타입이 지워진 채로 오므로 `asApproved` 로 다시 확인한다 — 확인 없이 표식을 붙이면\n * 재기동이 게이트를 여는 길이 된다.\n \n 되돌릴 수 있는 커맨드는 사람 없이 지난다(시뮬·what-if). 그 판단도 계약이 한다.\n /\nexport async function dispatch(\n store: CommandStore,\n domainId: string,\n id: string,\n actuate: (command: ApprovedCommand) => Promise<CommandAck>\n): Promise<StoredCommand> {\n const command = await mustLoad(store, domainId, id)\n const ref = carried(command)\n\n /\n * 되돌릴 수 있는 것은 제안 상태에서 바로 지난다. 되돌릴 수 없는 것은 승인 기록이 있어야 하고,\n * 없으면 여기서 던진다 — 조용히 건너뛰면 그 커맨드가 승인 없이 나간 것이 된다.\n /\n const approved: ApprovedCommand =\n command.state === 'proposed' && !requiresApproval(command) ? passThroughReversible(command) : asApproved(command)\n\n const to = nextCommandState(approved.state, 'dispatch')\n if (!to) throw new Error(`${approved.state} 상태의 커맨드는 넘길 수 없다 (${id})`)\n\n /\n * 넘기기 전에 「넘기는 중」을 먼저 적는다. 넘기고 나서 적으면, 그 사이에 프로세스가 죽었을 때\n * 저쪽은 받았는데 우리는 안 보낸 줄 알고 다시 보낸다. 현장이 두 번 움직인다.\n \n ── 지난 시도의 자국을 지운다 (2026-09-03, 인티그레이션 레인이 걸어서 찾음) ──\n * `failed → dispatch` 를 열어 둔 것의 짝이다. 다시 넘겨 성공했는데 *지난 실패의 `error` 가 그대로\n 남아** 한 행이 두 가지를 동시에 말했다.\n \n state acked 받았다\n * error 「그쪽에 비밀값이 설정되지 않았습니다」 안 받는다 ← 지난 시도의 것\n \n 화면이 그 행을 그리면 어느 쪽을 믿어야 하는지 알 수 없다. `dispatchNote` 도 같은 부류였다 —\n * 새 응답에 덧붙일 말이 없으면 옛 말이 남는다.\n \n 그래서 「넘기는 중」이 이번 시도의 빈 종이여야 한다. 셋 다 이번 응답이 채우는 값이다.\n \n `dispatchRef` 를 지워도 효과가 고아가 되지 않는다 — 식별자는 성공할 때만 붙고(§아래), 성공은\n * `acked` 로 끝난다(종착). 그러니 다시 넘길 수 있는 커맨드에는 식별자가 없고 효과도 없다.\n /\n const dispatching: StoredCommand = {\n ...approved,\n state: to,\n ...ref,\n dispatchRef: undefined,\n dispatchNote: undefined,\n error: undefined\n }\n await store.save(domainId, dispatching)\n\n let ack: CommandAck\n try {\n ack = await actuate(approved)\n } catch (e: any) {\n / 던진 실패는 어댑터가 갈래를 말할 기회가 없었다 — `retry` 를 비워 두고 일꾼이 「모름」으로 읽는다. /\n const failed: StoredCommand = { ...dispatching, state: 'failed', error: String(e?.message ?? e) }\n await store.save(domainId, failed)\n return failed\n }\n\n const settled: StoredCommand = ack?.ok\n ? {\n ...dispatching,\n state: 'acked',\n dispatchRef: ack.ref,\n ...(ack.note ? { dispatchNote: ack.note } : {}),\n ...(ack.noteNext ? { dispatchNoteNext: ack.noteNext } : {})\n }\n : {\n ...dispatching,\n state: 'failed',\n error: ack?.error ?? '어댑터가 이유를 말하지 않았다',\n / 다시 될 일인지 어댑터가 답했으면 적는다 — 일꾼이 다음 주기에 이 값을 본다. */\n ...(ack?.retry ? { retry: ack.retry } : {})\n }\n await store.save(domainId, settled)\n return settled\n}\n"]}
1	+ {"version":3,"file":"command-dispatcher.js","sourceRoot":"","sources":["../../../server/service/actuation/command-dispatcher.ts"],"names":[],"mappings":"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","sourcesContent":["/\n 승인을 지난 커맨드만 어댑터에 넘긴다 — 게이트가 서는 자리.\n \n ── 왜 이 자리인가 (2026-08-31) ──────────────────────────────────────────\n * 설계가 「기본 = propose-only」를 정해 두었는데 코드에 그 규율이 없었다. 인티그레이션 레인이 어댑터에\n * 조치를 붙이려다 그것을 보고 멈췄다 — 게이트 없이 붙이면 트윈이 사람 승인 없이 현장에 작업지시를\n * 내린다. 작업지시는 취소해도 이미 만든 것이 남는다.\n \n ── 확인을 여기서 한 번만 한다 ───────────────────────────────────────────\n * 어댑터는 승인을 확인하지 않는다. 그 확인은 이 파일이 했고 타입이 그것을 증명한다\n * (`ApprovedCommand` 는 `approveCommand`·`asApproved` 로만 만들어진다). 어댑터가 또 확인하면 규칙이\n * 두 벌이 되고, 한쪽만 고쳐지는 날이 온다.\n \n ── 저장소에 닿는 자리를 밖으로 낸다 ─────────────────────────────────────\n * 훅에서와 같은 이유다(§`HookStore`). 시험이 재기동을 넣을 수 있어야 한다 — 승인이 프로세스 안에만\n * 살아 있으면 「승인된다」는 보이지만 「다시 세운 뒤에도 승인이 남아 있나」는 보이지 않는다.\n /\nimport {\n CMD,\n approveCommand,\n asApproved,\n commandFromSpec,\n nextCommandState,\n passThroughReversible,\n requiresApproval,\n type ApprovedCommand,\n type CommandApproval,\n type CommandOrigin,\n type CommandTypeSpec,\n type ISOTime,\n type TwinCommand\n} from '@operato/ops-contract'\n\n/\n 조치의 결과 — 어댑터가 돌려준다.\n \n 계약에도 같은 이름의 타입이 있는데(`contract.ts:3074`) 다른 것이다. 그쪽은 커널 자극의 답이고\n * 이쪽은 현장 지시의 답이다. 자극과 조치를 가른 것과 같은 갈림이다(§`propose` 의 거절).\n /\nimport type { RetryOutlook } from './retry-plan.js'\n\nexport interface CommandAck {\n ok: boolean\n /* 저쪽 문서 · 작업 식별자. 되돌릴 때 무엇을 되돌릴지 말하려면 이것이 있어야 한다. /\n ref?: string\n /\n 받아들였으나 저쪽이 덧붙인 말 — 실패가 아니고, 「끝났다」도 아니다.\n \n ── 왜 필요한가 (2026-09-02 실측) ──────────────────────────────────────\n * MES 에 조치 둘을 넘겼더니 트윈 쪽 두 행이 구별되지 않았다.\n \n WO-20260902-004 지시서 붙음 acked · ref 있음 · error 없음\n * WO-20260902-005 지시서 못 붙음 acked · ref 있음 · error 없음 ← 같다\n \n 005 는 사람이 MES 에서 지시서를 골라야 현장에 간다. 커넥터는 그 사실을 받았는데 *적을 칸이\n 없어서 로그로만** 남겼다. `error` 에 적으면 실패로 읽혀 커맨드가 `failed` 로 앉는다.\n \n 해석하지 않고 그대로 적는다. 무엇이 남았는지는 저쪽 어휘이고, 커널이 그 방언을 알면 보편\n * 계약이 깨진다 — 효과의 상태를 그대로 적는 것과 같은 규율(§`effect-match.ts`).\n /\n note?: string\n /\n 그 말 중 다음에 할 일 한 줄 — 원인은 `note` 다.\n \n 왜 둘인가: 읽는 사람은 「그래서 내가 뭘 해야 하나」를 먼저 찾는다(UX 레인). 한 문장으로 주면\n * 화면이 자르게 되고, 자르는 규칙이 화면마다 생긴다. 어댑터는 이미 둘로 알고 있으니 붙이지\n * 않고 따로 준다.\n /\n noteNext?: string\n error?: string\n /\n 다시 해서 될 일인가 — 실패에만 답한다(§`RetryOutlook`).\n \n again 그대로 다시 해 볼 만하다 못 닿았거나 저쪽이 잠깐 흔들렸다\n * after-fix 사람이 고친 뒤 그대로 나간다 설정 문제\n * never 이 조치로는 영원히 안 된다 지시 내용이 틀렸다\n \n 문장에 담지 않는 이유: 일꾼이 그것을 쓰려면 문장을 파싱해야 하고, 번역되면 깨진다.\n * `code` 를 따로 둔 것과 같은 이유다.\n \n 비어 있으면 말하지 않은 것이고 `never` 가 아니다. 그때 일꾼은 집지 않고 목록에 남긴다 —\n * 모르는 것을 `never` 로 접으면 고칠 수 있는 것을 사람이 포기한다.\n \n 타입을 좁게 둔다 — 어댑터가 답하는 값이고, 여기서 넓히면 커넥터가 모르는 낱말을 보내도\n * 타입이 통과시킨다. 표에서 읽는 쪽은 `string` 이다(DB 는 무엇이든 들 수 있으므로\n * `isRetryOutlook` 으로 걸러 읽는다).\n /\n retry?: RetryOutlook\n}\n\n/\n 저장소에서 되세운 커맨드 — 계약의 커맨드에 호스트가 아는 한 칸이 붙는다.\n \n `approvalRef` 를 계약에 넣지 않는다. 계약은 운영 도메인의 어휘(EPCIS·ISA-95)를 들고, 「승인 기록이\n * 어느 업무 시스템의 몇 번 문서인가」는 이 저장소의 배선이다. 계약에 넣으면 커널을 쓰는 모든 소비처가\n * 우리 업무 모듈의 존재를 알게 된다.\n /\nexport type StoredCommand = TwinCommand & {\n approvalRef?: string\n proposedBy?: string\n /* 규칙이 낸 것이면 그 근거가 된 관측(`Attention.id`) — 중복을 막는 열쇠다. /\n causeRef?: string\n ruleRef?: string\n /\n 저쪽에서 실제로 무엇이 되었나 — 상태가 아니라 별개 사실이다.\n \n `acked` 는 「저쪽이 답했다」이고 종착 상태다. 여기에 「현장에 나갔다」를 상태로 이어 붙이면\n * `acked` 가 종착이 아니게 되고, 되돌아오는 관측이 없는 커넥터의 조치가 *영원히 끝나지 않은\n 것으로 보인다.** 그런 커넥터가 정상이다 — 관측을 되돌려 주는 능력은 커넥터의 성질이지 조치의\n * 수명이 아니다.\n \n `status` 는 해석하지 않고 그대로 적는다(§`effect-match.ts`). 오더 상태 어휘는 도메인\n * 소유이고, 어느 값이 「현장에 나갔다」인지는 현장마다 다르다.\n \n 이 칸이 비어 있는 것은 「효과가 없었다」가 아니라 「모른다」다. 넘기다 닿지 못한 조치는\n * 식별자를 못 받으므로 이을 길이 아예 없다.\n \n ── 계약에도 같은 칸을 두었다 ──────────────────────────────────────────\n * `ops-contract` 의 `TwinCommand.effect` 가 이것이다. 다만 이 저장소는 그 패키지를 레지스트리에서\n * 받으므로(`^0.9.0`), 다음 판이 올라올 때까지 여기에 산다 — 위의 `approvalRef`·`causeRef` 와 같다.\n /\n effect?: { status: string; at: string; seen: number }\n /* 받아들였으나 저쪽이 덧붙인 말 — 해석하지 않고 그대로(§`CommandAck.note`). /\n dispatchNote?: string\n /* 그 말 중 다음에 할 일 한 줄 — 원인은 위 칸이다(§`CommandAck.noteNext`). /\n dispatchNoteNext?: string\n /\n 다시 해서 될 일인가 — 어댑터가 실패에 답한 갈래(§`RetryOutlook`). 비면 말하지 않은 것이다.\n \n 여기는 `string` 이다 — 표에서 읽은 값이고 DB 는 무엇이든 들 수 있다. 좁은 타입으로 두면\n * 낡은 행이나 손으로 고친 값이 타입상 참인 척한다. 판정하는 쪽이 `isRetryOutlook` 으로 걸러\n * 읽고, 모르는 낱말은 「말하지 않은 것」과 같이 다룬다.\n /\n retry?: string\n /* 몇 번 넘겨 봤나. 첫 시도가 1. /\n attempts?: number\n /* 다음에 넘겨 볼 시각(ISO) — 물러섬을 표에 든다. 메모리에 두면 재기동에 사라진다. /\n nextAttemptAt?: string\n}\n\n/* 커맨드가 사는 자리 — 재기동을 넘어야 한다. /\nexport interface CommandStore {\n load(domainId: string, id: string): Promise<StoredCommand \| null>\n save(domainId: string, command: StoredCommand): Promise<void>\n /* 새로 낸다 — `save` 는 있는 행만 고친다. 낼 길이 없으면 대기 줄은 영원히 비어 있다. /\n create(domainId: string, command: StoredCommand): Promise<StoredCommand>\n /\n 결정을 기다리는 것들의 근거 — 규칙 판정이 중복을 피하려면 이것이 있어야 한다.\n \n 규칙을 쓰지 않는 소비처도 있으므로 없어도 된다. 없으면 판정에 빈 집합이 가고, 그때는 중복이 난다\n * — 그 사실을 부르는 쪽이 알아야 하므로 조용히 빈 집합을 만들어 주지 않는다.\n /\n openCauses?(domainId: string, instanceId: string): Promise<ReadonlySet<string>>\n /\n 넘긴 지시의 식별자로 조치를 찾는다 — 폐루프가 이 하나에 걸린다.\n \n 없으면 나간 지시와 돌아온 관측을 이을 수 없다. 그 사실을 부르는 쪽이 알아야 하므로 조용히 빈\n * 지도를 만들어 주지 않는다(§`openCauses` 와 같은 규율).\n /\n byDispatchRef?(domainId: string, refs: readonly string[]): Promise<ReadonlyMap<string, StoredCommand>>\n /\n 효과를 기다리는 조치들 — backfill 하는 길이 이것에 걸린다.\n \n 유입 자리에서 잇는 것만으로는 부족하다. 우리가 내려가 있던 동안, 또는 배선이 아직 없던 동안 온\n * 보고는 영원히 사라진다. 실제로 그렇게 됐다 — 배선을 만든 날 그 앞에 온 보고 하나를 못 이었다.\n \n 넘긴 식별자가 있는 것만 낸다. 없는 것은 이을 열쇠가 없다.\n /\n awaitingEffect?(domainId: string): Promise<readonly StoredCommand[]>\n /\n 넘길 차례를 기다리는 것들 — 승인만 되고 안 나간 것과, 실패해서 다시 해 볼 것.\n \n 일꾼이 이것으로 표를 읽는다. 없으면 일꾼이 아무것도 하지 않는다(옛 거동) — 저장소가\n * 이 능력을 갖추지 않은 구현도 그대로 돌아야 한다.\n /\n pendingDispatch?(domainId: string): Promise<readonly StoredCommand[]>\n /\n 효과만 적는다 — 상태를 건드리지 않는다.\n \n `save` 로 적으면 상태·승인·오류까지 함께 쓰이고, 유입 경로가 조치의 수명에 손을 대게 된다.\n * 관측이 조치를 되돌리거나 다시 넘기게 하는 길은 두지 않는다.\n /\n recordEffects?(domainId: string, updates: readonly { commandId: string; status: string; at: string; seen: number }[]): Promise<void>\n /\n 근거마다 마지막으로 조치를 낸 시각 — 승인 직후 같은 것이 다시 올라오는 것을 막는다.\n \n 없어도 된다. 없으면 판정이 결정 대기만 보고, 승인하는 순간 같은 조건이 다시 올라온다.\n /\n lastProposedAt?(domainId: string, instanceId: string): Promise<ReadonlyMap<string, number>>\n}\n\n/\n 조치를 낸다 — 대기 줄에 무언가가 들어오는 유일한 자리.\n \n ── 왜 뒤늦게 생겼나 (2026-08-31) ────────────────────────────────────────\n * 게이트와 승인 화면을 만들고 나서 물었다 — 「무엇을 승인하는 화면인가」. 커맨드 행을 *적는 코드가\n 하나도 없었다.** 자리는 있고 길이 없는 그 부류다.\n \n 종류를 선언된 것으로 제한한다. 모르는 종류를 받으면 되돌릴 수 있는지도 모르는 채로 게이트를 지나게\n * 되고, 그러면 게이트가 시늉이 된다.\n /\nexport async function propose(\n store: CommandStore,\n domainId: string,\n specs: readonly CommandTypeSpec[],\n seed: {\n id: string\n instanceId: string\n type: string\n origin: CommandOrigin\n proposedAt: ISOTime\n payload?: Record<string, unknown>\n /* 낸 사람. 사람이 냈으면 반드시 있어야 한다 — 없으면 자기 승인을 막을 수 없다. /\n proposedBy?: string\n /* 규칙이 낸 것이면 그 근거. 이 값이 없으면 다음 주기가 같은 것을 또 올린다. /\n causeRef?: string\n ruleRef?: string\n }\n): Promise<StoredCommand> {\n const spec = specs.find(s => s.type === seed.type)\n if (!spec) {\n /\n * 자극과 조치는 다른 어휘다.\n \n 계약에 두 벌이 있다. `CMD` 는 커널 안에서 도는 자극이고(`resource.repair` = 모델에서 수리된 것으로\n * 둔다), 여기서 다루는 것은 현장에 나가는 지시다(`production.order` = 실제로 만든다). 주의 신호가\n * 권하는 것(`Attention.suggestedAction.command`)은 앞엣것이다.\n \n 둘이 섞이는 길이 실재한다 — 주의를 읽어 조치를 내는 코드를 쓰다 보면 그 값을 그대로 넘기게 된다.\n * 막히기는 하는데 왜 막히는지 말하지 않으면 부르는 쪽은 선언이 빠진 줄로 읽고 선언을 추가한다.\n * 그 순간 모델 안의 자극이 현장 지시가 된다.\n /\n if ((Object.values(CMD) as string[]).includes(seed.type)) {\n throw new Error(\n `그것은 커널 안에서 도는 자극이다 (${seed.type}) — 현장에 나가는 지시가 아니다. ` +\n '모델 상태를 바꾸려면 커널에 자극을 넣고, 현장에 무언가를 시키려면 그 지시를 조치 종류로 선언한다'\n )\n }\n\n throw new Error(\n `선언되지 않은 조치 종류다 (${seed.type}) — 선언된 것: ${specs.map(s => s.type).join(', ') \|\| '(없음)'}. ` +\n '되돌릴 수 있는지를 모르는 채로 승인 게이트를 지나게 할 수 없다'\n )\n }\n\n /\n * 사람이 낸 것이면 누구인지 있어야 한다. 없이 받으면 그 커맨드는 아무나 승인할 수 있는 것이 되고,\n * 자기 승인을 막는 규칙이 그 한 건만 비껴간다.\n /\n if (seed.origin === 'operator' && !seed.proposedBy?.trim()) {\n throw new Error('사람이 내는 조치는 낸 사람이 있어야 한다 — 없으면 자기 것을 자기가 승인하는 것을 막을 수 없다')\n }\n\n / 요구하는 칸이 없으면 계약이 던진다 — 빈 지시가 대기 줄에 쌓이면 승인하는 사람이 판단할 근거가 없다. /\n return await store.create(domainId, {\n ...commandFromSpec(spec, seed),\n ...(seed.proposedBy?.trim() ? { proposedBy: seed.proposedBy.trim() } : {}),\n ...(seed.causeRef ? { causeRef: seed.causeRef } : {}),\n ...(seed.ruleRef ? { ruleRef: seed.ruleRef } : {})\n })\n}\n\n/\n 결재선에 올라간 자리를 커맨드에 적는다.\n \n 이것이 적힌 뒤로 직접 결정은 막힌다. 그래서 올리기와 적기가 한 트랜잭션에 있어야 한다 — 올렸는데\n * 적지 못하면 결재선에는 있고 커맨드는 직접 결정도 되는 상태가 남는다.\n /\nexport async function linkApproval(\n store: CommandStore,\n domainId: string,\n id: string,\n approvalRef: string\n): Promise<StoredCommand> {\n const command = await mustLoad(store, domainId, id)\n const next: StoredCommand = { ...command, approvalRef }\n await store.save(domainId, next)\n return next\n}\n\n/\n 승인한다 — 직접 문.\n \n 승인할 수 없는 상태면 계약이 던진다 — 여기서 답으로 돌려주지 않는 이유는, 실패를 답으로 주면 부르는\n * 쪽이 그것을 무시할 수 있기 때문이다.\n /\nexport async function approve(\n store: CommandStore,\n domainId: string,\n id: string,\n approval: CommandApproval\n): Promise<StoredCommand> {\n const command = await mustLoad(store, domainId, id)\n assertDirectDoorOpen(command)\n assertNotSelfApproval(command, approval.by)\n\n const approved = approveCommand(command, approval)\n await store.save(domainId, { ...approved, ...carried(command) })\n return approved\n}\n\n/* 거절한다 — 여기서 끝난다. 되살아나지 않는다. /\nexport async function reject(\n store: CommandStore,\n domainId: string,\n id: string,\n approval: CommandApproval\n): Promise<StoredCommand> {\n const command = await mustLoad(store, domainId, id)\n assertDirectDoorOpen(command)\n return await settle(store, domainId, command, false, approval)\n}\n\n/\n 결재선의 판정을 커맨드에 옮긴다 — 결재선 문.\n \n 부르는 쪽은 앱의 브리지다. 올라간 자리를 함께 넘기게 해서, 다른 결재 건의 판정이 이 커맨드에 적히는\n * 길을 막는다.\n \n 거절을 여기서 끝으로 다룬다. 업무 목록에서 「거절」은 되돌려 보내 고쳐 올리라는 뜻이지만, 조치에는\n * 고칠 것이 없다 — 지시 내용은 제안될 때 이미 정해져 있다. 그러니 되돌려 받을 것이 없고, 게이트를 닫는\n * 것이 맞다. 커맨드가 닫힌 뒤에 결재선에서 누가 승인해도 계약이 `rejected → approved` 를 허용하지 않는다.\n /\nexport async function settleByApproval(\n store: CommandStore,\n domainId: string,\n id: string,\n decision: { approvalRef: string; approved: boolean; by: string; at: string; note?: string }\n): Promise<StoredCommand> {\n const command = await mustLoad(store, domainId, id)\n\n if (!command.approvalRef) {\n throw new Error(`결재선에 올라가지 않은 커맨드다 (${id}) — 이 판정이 어디서 왔는지 확인할 수 없다`)\n }\n if (command.approvalRef !== decision.approvalRef) {\n throw new Error(\n `다른 결재 건의 판정이다 (커맨드 ${id} 는 ${command.approvalRef} 를 기다리는데 판정은 ${decision.approvalRef} 에서 왔다)`\n )\n }\n\n const approval: CommandApproval = {\n by: decision.by,\n at: decision.at,\n ...(decision.note ? { note: decision.note } : {})\n }\n\n if (!decision.approved) return await settle(store, domainId, command, false, approval)\n\n /\n * 결재선을 지나온 것도 이 규칙을 지난다. 결재선이 비어 있으면 업무 목록이 스레드를 곧바로 종료하고\n * (§`submit.ts`), 승인자를 `Myself` 로 넣으면 낸 사람이 승인자다 — 두 경우 다 여기서 막힌다.\n /\n assertNotSelfApproval(command, decision.by)\n\n const approved = approveCommand(command, approval)\n await store.save(domainId, { ...approved, ...carried(command) })\n return approved\n}\n\nasync function mustLoad(store: CommandStore, domainId: string, id: string): Promise<StoredCommand> {\n const command = await store.load(domainId, id)\n if (!command) throw new Error(`모르는 커맨드다 (${id})`)\n return command\n}\n\n/* 결재선에 올라간 커맨드는 직접 결정하지 않는다 — 문은 한 벌이다. /\nfunction assertDirectDoorOpen(command: StoredCommand): void {\n if (!command.approvalRef) return\n throw new Error(\n `이 조치는 결재선에 올라가 있다 (${command.approvalRef}) — 승인·거절은 업무 목록에서 한다. ` +\n '여기서 결정하면 결재선에는 대기로 남고 조치는 나간 상태가 된다'\n )\n}\n\n/\n 낸 사람은 자기 것을 승인하지 못한다.\n \n ── 왜 필요한가 (2026-08-31) ─────────────────────────────────────────────\n * 결재선에 올리는 길을 만들고 나서 업무 목록의 `submit.ts` 를 읽었다. *결재선이 비어 있으면 스레드가\n 곧바로 종료되고*, 그러면 우리 콜백이 「승인됐다」로 받는다. 승인자를 지정하지 않은 도메인에서는 낸\n 사람이 그 자리에서 자기 조치를 승인한 것이 된다. 오류 한 줄 없이.\n \n 결재선을 지정한 경우에도 열린다 — `Myself` 를 승인자로 넣으면 낸 사람이 승인자다.\n \n 그래서 규칙을 게이트 안쪽에 둔다. 올리는 자리에서만 막으면 그 자리를 지나지 않는 길에서 다시 열린다.\n * 되돌릴 수 없는 조치에 두 사람이 필요하다는 것이 이 표의 존재 이유다.\n \n 거절에는 걸지 않는다 — 낸 사람이 자기 것을 물리는 것은 막을 이유가 없다.\n /\nfunction assertNotSelfApproval(command: StoredCommand, by: string): void {\n const proposer = command.proposedBy?.trim()\n if (!proposer) return\n\n if (proposer.toLowerCase() === String(by ?? '').trim().toLowerCase()) {\n throw selfApprovalRefused(proposer)\n }\n}\n\n/\n 같은 사실에는 같은 낱말 — `self-approval` (ADR-0052 ③, ADR-0042 ③).\n \n 워크리스트에도 같은 규칙이 선다(`worklist/server/controllers/activity-approval/own-request.ts`).\n * 두 벌이 아니라 두 문이다 — 커널은 업무 목록을 안 지나는 길(API · AI 발의)에서 자기 커맨드를\n * 지키고, 워크리스트는 결재 문을 지킨다. 커널↔호스트 경계를 넘어 합치지 않는다.\n \n 두 문이 위험한 것은 서로 다른 답을 낼 때다. 그래서 문장이 아니라 코드를 맞춘다 — 문장은\n * 번역도 집계도 안 되고, 고치는 날 두 문이 다른 말을 한다. 붙잡는 쪽은 `code` 를 보고, 사람에게는\n * `message` 를 보인다.\n /\nfunction selfApprovalRefused(proposer: string): Error & { code: string } {\n const error = new Error(\n `낸 사람이 자기 조치를 승인할 수 없다 (${proposer}) — 되돌릴 수 없는 조치에는 다른 사람의 승인이 필요하다. ` +\n '승인자가 없다면 결재선에 승인자를 지정하거나, 다른 사람이 승인해야 한다'\n ) as Error & { code: string }\n\n error.code = SELF_APPROVAL\n return error\n}\n\n/* 낸 사람이 자기 것을 승인하려 했다 — 워크리스트가 쓰는 낱말과 같은 값이어야 한다. /\nexport const SELF_APPROVAL = 'self-approval'\n\n/* 승인 기록만 바뀌고 나머지는 그대로 간다 — 하나라도 흘리면 그 사실이 사라진다. /\nfunction carried(command: StoredCommand): Partial<StoredCommand> {\n return {\n ...(command.approvalRef ? { approvalRef: command.approvalRef } : {}),\n ...(command.proposedBy ? { proposedBy: command.proposedBy } : {}),\n ...(command.causeRef ? { causeRef: command.causeRef } : {}),\n ...(command.ruleRef ? { ruleRef: command.ruleRef } : {})\n }\n}\n\nasync function settle(\n store: CommandStore,\n domainId: string,\n command: StoredCommand,\n approved: boolean,\n approval: CommandApproval\n): Promise<StoredCommand> {\n const to = nextCommandState(command.state, approved ? 'approve' : 'reject')\n if (!to) throw new Error(`${command.state} 상태의 커맨드는 ${approved ? '승인' : '거절'}할 수 없다 (${command.id})`)\n\n const next: StoredCommand = { ...command, state: to, approval, ...carried(command) }\n await store.save(domainId, next)\n return next\n}\n\n/\n 어댑터에 넘긴다 — 승인을 지나지 않은 것은 여기서 막힌다.\n \n `actuate` 는 `ApprovedCommand` 만 받으므로, 승인 없이 이 함수를 지나가는 길이 없다. 저장소에서\n * 되세운 커맨드는 타입이 지워진 채로 오므로 `asApproved` 로 다시 확인한다 — 확인 없이 표식을 붙이면\n * 재기동이 게이트를 여는 길이 된다.\n \n 되돌릴 수 있는 커맨드는 사람 없이 지난다(시뮬·what-if). 그 판단도 계약이 한다.\n /\nexport async function dispatch(\n store: CommandStore,\n domainId: string,\n id: string,\n actuate: (command: ApprovedCommand) => Promise<CommandAck>\n): Promise<StoredCommand> {\n const command = await mustLoad(store, domainId, id)\n const ref = carried(command)\n\n /\n * 되돌릴 수 있는 것은 제안 상태에서 바로 지난다. 되돌릴 수 없는 것은 승인 기록이 있어야 하고,\n * 없으면 여기서 던진다 — 조용히 건너뛰면 그 커맨드가 승인 없이 나간 것이 된다.\n /\n const approved: ApprovedCommand =\n command.state === 'proposed' && !requiresApproval(command) ? passThroughReversible(command) : asApproved(command)\n\n const to = nextCommandState(approved.state, 'dispatch')\n if (!to) throw new Error(`${approved.state} 상태의 커맨드는 넘길 수 없다 (${id})`)\n\n /\n * 넘기기 전에 「넘기는 중」을 먼저 적는다. 넘기고 나서 적으면, 그 사이에 프로세스가 죽었을 때\n * 저쪽은 받았는데 우리는 안 보낸 줄 알고 다시 보낸다. 현장이 두 번 움직인다.\n \n ── 지난 시도의 자국을 지운다 (2026-09-03, 인티그레이션 레인이 걸어서 찾음) ──\n * `failed → dispatch` 를 열어 둔 것의 짝이다. 다시 넘겨 성공했는데 *지난 실패의 `error` 가 그대로\n 남아** 한 행이 두 가지를 동시에 말했다.\n \n state acked 받았다\n * error 「그쪽에 비밀값이 설정되지 않았습니다」 안 받는다 ← 지난 시도의 것\n \n 화면이 그 행을 그리면 어느 쪽을 믿어야 하는지 알 수 없다. `dispatchNote` 도 같은 부류였다 —\n * 새 응답에 덧붙일 말이 없으면 옛 말이 남는다.\n \n 그래서 「넘기는 중」이 이번 시도의 빈 종이여야 한다. 셋 다 이번 응답이 채우는 값이다.\n \n `dispatchRef` 를 지워도 효과가 고아가 되지 않는다 — 식별자는 성공할 때만 붙고(§아래), 성공은\n * `acked` 로 끝난다(종착). 그러니 다시 넘길 수 있는 커맨드에는 식별자가 없고 효과도 없다.\n /\n const dispatching: StoredCommand = {\n ...approved,\n state: to,\n ...ref,\n dispatchRef: undefined,\n dispatchNote: undefined,\n error: undefined\n }\n await store.save(domainId, dispatching)\n\n let ack: CommandAck\n try {\n ack = await actuate(approved)\n } catch (e: any) {\n / 던진 실패는 어댑터가 갈래를 말할 기회가 없었다 — `retry` 를 비워 두고 일꾼이 「모름」으로 읽는다. /\n const failed: StoredCommand = { ...dispatching, state: 'failed', error: String(e?.message ?? e) }\n await store.save(domainId, failed)\n return failed\n }\n\n const settled: StoredCommand = ack?.ok\n ? {\n ...dispatching,\n state: 'acked',\n dispatchRef: ack.ref,\n ...(ack.note ? { dispatchNote: ack.note } : {}),\n ...(ack.noteNext ? { dispatchNoteNext: ack.noteNext } : {})\n }\n : {\n ...dispatching,\n state: 'failed',\n error: ack?.error ?? '어댑터가 이유를 말하지 않았다',\n / 다시 될 일인지 어댑터가 답했으면 적는다 — 일꾼이 다음 주기에 이 값을 본다. */\n ...(ack?.retry ? { retry: ack.retry } : {})\n }\n await store.save(domainId, settled)\n return settled\n}\n"]}

package/dist-server/service/reference/actuation-routing.js CHANGED Viewed

@@ -23,6 +23,8 @@ exports.actuationReadinessOf = actuationReadinessOf;
 const shell_1 = require("@things-factory/shell");
 const twin_instance_js_1 = require("../twin-instance/twin-instance.js");
 const twin_reference_js_1 = require("./twin-reference.js");
+const log_js_1 = require("../../engine/log.js");
+const actuation_verification_js_1 = require("./actuation-verification.js");
 const reference_adapter_js_1 = require("./reference-adapter.js");
 const actuation_target_js_1 = require("./actuation-target.js");
 /**
@@ -68,7 +70,30 @@ async function routeActuation(domainId, instanceId, command) {
         return { ok: false, error: `커넥터를 찾았는데 조치를 보낼 자리가 없습니다 (${target.adapterType}). ${actuation_target_js_1.APPROVAL_STANDS}` };
     }
     const site = { siteId: target.siteId };
-    return adapter.actuate(ref?.connectionConfig ?? {}, site, command);
+    const result = await adapter.actuate(ref?.connectionConfig ?? {}, site, command);
+    /*
+     * **왕복이 일어났다는 사실을 남긴다** (ADR-0046 ②).
+     *
+     * 설정이 맞는 것과 저쪽이 받는 것은 다르고, 그 차이는 한 번 넘겨 봐야만 안다. 승인 화면이 그것을
+     * 미리 말하려면 지난 왕복의 결과가 어딘가에 남아 있어야 한다 — 없으면 화면은 매번 「해 봐야 안다」만
+     * 말한다.
+     *
+     * 두 경로(`dispatchAfterApproval` · `sweepPendingDispatch`)가 다 이 함수를 지나므로 여기 한 곳이면
+     * 된다. 실패해도 조치 결과는 그대로 돌려준다 — 기록이 본업을 막으면 안 되고, 삼키지도 않는다.
+     */
+    if (ref)
+        await recordActuationOutcome(ref, result).catch(err => (0, log_js_1.twinError)('[reference] actuation state not recorded', err));
+    return result;
+}
+/**
+ * 조치 결과를 레퍼런스에 적는다 — **코드만, 문장은 아니다.**
+ *
+ * 거절 사유에 코드가 없으면 `actuationFailure` 를 비워 둔다. 자리를 채우려고 `error` 문장을 옮기면
+ * `lastError` 가 이미 겪은 것을 반복한다 — 저장된 문장은 번역도 집계도 안 되고, 커넥터가 그 문장을
+ * 고치는 날 옛 행과 새 행이 다른 말을 한다. **모르는 것은 안 적는다.**
+ */
+async function recordActuationOutcome(ref, result) {
+    await (0, shell_1.getRepository)(twin_reference_js_1.TwinReference).update({ id: ref.id }, (0, actuation_verification_js_1.actuationOutcomePatch)(result, new Date().toISOString()));
 }
 /**
  * 이 트윈이 조치를 받을 수 있나 — **넘기기 전에 화면이 먼저 알 수 있게.**

package/dist-server/service/reference/actuation-routing.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"actuation-routing.js","sourceRoot":"","sources":["../../../server/service/reference/actuation-routing.ts"],"names":[],"mappings":"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","sourcesContent":["/\n 승인된 조치가 원본으로 나가는 길 — 판단은 `actuation-target.ts`, 여기는 배선.\n \n ── 무엇이 끊겨 있었나 (2026-09-02) ────────────────────────────────────────────\n * MES 커넥터는 `actuate` 를 다 만들어 두었다. 서명·접수 판정·초안 상태까지 있었다. 그런데 넘기는\n * 리졸버가 어댑터를 찾지도 않고 「구현이 없습니다」라고 답했다. 그 문장을 사실로 읽어서 설계\n * 문서에도, 다른 레인에도 그렇게 알렸다 — 둘 다 틀렸다.\n \n 자리는 있고 길이 없는 상태다. 이 저장소에서 가장 자주 나는 결함 부류이고, 조치 경로에서 나면\n * 결과가 하나다 — 승인은 쌓이는데 현장에는 아무것도 가지 않는다.\n \n ── 왜 구동과 따로 두나 ───────────────────────────────────────────────────────\n * 모양이 같아서 한 함수로 묶고 싶어진다. 묶지 않는다.\n \n 구동은 시뮬레이터를 움직인다 틀리면 시늉이 어긋난다\n * 조치는 현장에 작업지시를 낸다 틀리면 만들지 않아도 될 것을 만든다\n /\nimport { getRepository } from '@things-factory/shell'\n\nimport type { ApprovedCommand } from '@operato/ops-contract'\n\nimport { TwinInstance } from '../twin-instance/twin-instance.js'\n\nimport { TwinReference } from './twin-reference.js'\nimport { capabilitiesOf, getAdapter, type ActuationReadiness, type SiteDescriptor } from './reference-adapter.js'\nimport { APPROVAL_STANDS, actuationTarget, isActuationAllowed, type ActuationTarget } from './actuation-target.js'\n\n/* 어댑터가 답하는 모양 그대로 — 디스패처가 이 값을 커맨드 행에 적는다. /\n/\n 조치를 낸 결과 — 어댑터가 답한 것을 좁히지 않고 그대로 나른다.\n \n ── 왜 넓혔나 (2026-09-04, 인티그레이션 레인이 찾음) ────────────────────────\n * 이 타입이 `ok`·`ref`·`error` 셋만 들고 있었다. 그래서 `routeActuation` 이 어댑터의 답을\n * 그대로 되돌리는데 타입은 `note`·`noteNext`·`retry` 를 버린다고 말했다.\n \n 값은 흘렀다 — JS 객체가 키를 안 버리므로. 어제 `dispatch_note` 에 실제로 앉았다. 그런데\n * 커넥터를 만드는 사람이 그 칸이 있다는 것을 알 방법이 없었다. 우리가 어제 하루 종일\n * 「자리는 있고 길이 없다」로 부른 것의 타입 판이다.\n \n 좁히지 않는다: 세 칸을 다 실어 `CommandAck` 와 같은 모양으로 둔다. 커널이 어느 칸을 어떻게\n * 쓰는지는 `dispatch` 가 정하고, 이 자리는 나르기만 한다.\n /\nexport interface ActuationAck {\n ok: boolean\n /* 저쪽 문서·작업 식별자. 없으면 무엇을 되돌릴지 지목할 수 없다. /\n ref?: string\n /* 받아들였으나 저쪽이 덧붙인 말 — 실패가 아니다. 원인 쪽 문장. /\n note?: string\n /* 그 말 중 다음에 할 일 한 줄 — 붙여 보내지 않는다. /\n noteNext?: string\n error?: string\n /* 다시 해서 될 일인가 — 실패에만. 말하지 않으면 일꾼이 집지 않는다. /\n retry?: 'again' \| 'after-fix' \| 'never'\n}\n\n/\n 저장소를 한 번만 읽고, 판정과 함께 부를 것까지 돌려준다.\n \n 판정한 뒤 보낼 때 다시 읽으면 그 사이에 연결 설정이 바뀔 수 있다 — 판정한 커넥터와 실제로 부르는\n * 커넥터가 달라진다. 그리고 같은 행을 두 번 읽을 이유가 없다.\n /\nasync function resolve(domainId: string, instanceId: string) {\n const inst = await getRepository(TwinInstance).findOne({ where: { domain: { id: domainId }, instanceId } })\n const ref = inst\n ? await getRepository(TwinReference).findOne({ where: { domain: { id: domainId }, source: instanceId } })\n : null\n const adapter = ref ? getAdapter(ref.adapterType) : undefined\n\n const target = actuationTarget({\n instanceId,\n twinExists: !!inst,\n siteId: (inst?.origin as any)?.siteId,\n ...(ref ? { ref: { source: ref.source, adapterType: ref.adapterType } } : {}),\n adapterRegistered: !!adapter,\n capabilities: capabilitiesOf(adapter),\n declaresActuate: !!adapter?.capabilities?.includes('actuate'),\n hasActuateImpl: typeof adapter?.actuate === 'function'\n })\n\n return { target, ref, adapter }\n}\n\n/\n 이 트윈의 원본에 승인된 조치를 보낸다.\n \n 거절할 때는 무엇이 없어서인지 말한다. 「보내지 못했습니다」만 답하면 사람이 연결 설정을 열어야\n * 하는지, 커넥터를 고쳐야 하는지, 트윈을 다시 만들어야 하는지 알 수 없다.\n /\nexport async function routeActuation(\n domainId: string,\n instanceId: string,\n command: ApprovedCommand\n): Promise<ActuationAck> {\n const { target, ref, adapter } = await resolve(domainId, instanceId)\n if (!isActuationAllowed(target)) return { ok: false, error: `${target.detail}. ${APPROVAL_STANDS}` }\n\n /\n * 여기까지 왔으면 판정이 그 둘의 존재를 이미 확인했다(§`actuationTarget`). 그래도 조용히 지나가지\n * 않는다 — 판정과 배선이 어긋나면 그것이 결함이고, `!` 로 덮으면 그 결함이 「아무 일도 일어나지\n * 않았다」로 나타난다.\n /\n if (!adapter?.actuate) {\n return { ok: false, error: `커넥터를 찾았는데 조치를 보낼 자리가 없습니다 (${target.adapterType}). ${APPROVAL_STANDS}` }\n }\n\n const site: SiteDescriptor = { siteId: target.siteId }\n return adapter.actuate(ref?.connectionConfig ?? {}, site, command)\n}\n\n/\n 이 트윈이 조치를 받을 수 있나 — 넘기기 전에 화면이 먼저 알 수 있게.\n \n 승인 화면이 「넘기기」를 보이기 전에 이것을 묻는다. 누를 수 없는 것을 보여 주고 눌렀을 때 거절하는\n * 것보다, 왜 못 넘기는지 먼저 말하는 것이 낫다.\n /\nexport async function actuationTargetOf(domainId: string, instanceId: string): Promise<ActuationTarget> {\n return (await resolve(domainId, instanceId)).target\n}\n\n/\n 저쪽이 받을 준비가 됐나 — 넘기기 전에 묻는다. 화면이 사람을 헛걸음시키지 않게.\n \n ── 왜 `actuationTargetOf` 와 따로인가 ──────────────────────────────────────\n * 그쪽은 망을 타지 않는다. 화면이 목록을 그릴 때마다 부를 수 있어야 하므로 그래야 한다.\n * 이 함수는 커넥터가 저쪽에 물을 수 있고, 그래서 부르는 시점이 다르다 — 사람이 「넘기기」를\n * 열었을 때다.\n \n ── 답이 문이 아니다 ────────────────────────────────────────────────────────\n * 이 답으로 넘김을 막지 않는다. 막으면 점검이 틀렸거나 잠깐 못 닿은 사이에 성공할 수 있었던\n * 조치가 못 나간다. 화면이 미리 말하는 데까지가 이 함수의 일이다.\n \n 커넥터가 이 얼굴을 안 만들었으면 「모른다」로 답한다 — 「준비됐다」가 아니다. 없는 확인을\n * 통과로 읽으면 이 함수가 있으나 없으나 같아진다.\n /\nexport async function actuationReadinessOf(domainId: string, instanceId: string): Promise<ActuationReadiness> {\n const { target, ref, adapter } = await resolve(domainId, instanceId)\n\n / 보낼 대상 자체가 없으면 저쪽에 물을 것도 없다 — 그 사실을 그대로 옮긴다. /\n if (!isActuationAllowed(target)) {\n return { checked: 'local', ready: false, reason: target.detail, code: target.code }\n }\n\n if (!adapter?.actuationReadiness) {\n / 확인할 길이 없다. 「준비됐다」로 답하지 않는다 — 그러면 화면이 없는 확인을 통과로 읽는다. /\n return {\n checked: 'local',\n reason: `커넥터 \"${target.adapterType}\" 는 저쪽이 받을 준비가 됐는지 알려 주지 않습니다 — 넘겨 보고 알게 됩니다`,\n code: 'not-checkable'\n }\n }\n\n try {\n return await adapter.actuationReadiness(ref?.connectionConfig ?? {}, { siteId: target.siteId })\n } catch (e: any) {\n /\n * 점검이 터진 것을 「저쪽이 죽었다」로 옮기지 않는다 — 우리 점검의 실패다. 그리고 던지지 않는다:\n * 이 함수 때문에 승인 화면이 안 열리면, 알려 주려던 것보다 큰 것을 잃는다.\n */\n return {\n checked: 'local',\n reason: `준비 상태를 확인하다 실패했습니다 — ${String(e?.message ?? e).slice(0, 160)}`,\n code: 'check-failed'\n }\n }\n}\n"]}
1	+ {"version":3,"file":"actuation-routing.js","sourceRoot":"","sources":["../../../server/service/reference/actuation-routing.ts"],"names":[],"mappings":"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","sourcesContent":["/\n 승인된 조치가 원본으로 나가는 길 — 판단은 `actuation-target.ts`, 여기는 배선.\n \n ── 무엇이 끊겨 있었나 (2026-09-02) ────────────────────────────────────────────\n * MES 커넥터는 `actuate` 를 다 만들어 두었다. 서명·접수 판정·초안 상태까지 있었다. 그런데 넘기는\n * 리졸버가 어댑터를 찾지도 않고 「구현이 없습니다」라고 답했다. 그 문장을 사실로 읽어서 설계\n * 문서에도, 다른 레인에도 그렇게 알렸다 — 둘 다 틀렸다.\n \n 자리는 있고 길이 없는 상태다. 이 저장소에서 가장 자주 나는 결함 부류이고, 조치 경로에서 나면\n * 결과가 하나다 — 승인은 쌓이는데 현장에는 아무것도 가지 않는다.\n \n ── 왜 구동과 따로 두나 ───────────────────────────────────────────────────────\n * 모양이 같아서 한 함수로 묶고 싶어진다. 묶지 않는다.\n \n 구동은 시뮬레이터를 움직인다 틀리면 시늉이 어긋난다\n * 조치는 현장에 작업지시를 낸다 틀리면 만들지 않아도 될 것을 만든다\n /\nimport { getRepository } from '@things-factory/shell'\n\nimport type { ApprovedCommand } from '@operato/ops-contract'\n\nimport { TwinInstance } from '../twin-instance/twin-instance.js'\n\nimport { TwinReference } from './twin-reference.js'\nimport { twinError } from '../../engine/log.js'\nimport { actuationOutcomePatch } from './actuation-verification.js'\nimport { capabilitiesOf, getAdapter, type ActuationReadiness, type ActuationResult, type SiteDescriptor } from './reference-adapter.js'\nimport { APPROVAL_STANDS, actuationTarget, isActuationAllowed, type ActuationTarget } from './actuation-target.js'\n\n/* 어댑터가 답하는 모양 그대로 — 디스패처가 이 값을 커맨드 행에 적는다. /\n/\n 조치를 낸 결과 — 어댑터가 답한 것을 좁히지 않고 그대로 나른다.\n \n ── 왜 넓혔나 (2026-09-04, 인티그레이션 레인이 찾음) ────────────────────────\n * 이 타입이 `ok`·`ref`·`error` 셋만 들고 있었다. 그래서 `routeActuation` 이 어댑터의 답을\n * 그대로 되돌리는데 타입은 `note`·`noteNext`·`retry` 를 버린다고 말했다.\n \n 값은 흘렀다 — JS 객체가 키를 안 버리므로. 어제 `dispatch_note` 에 실제로 앉았다. 그런데\n * 커넥터를 만드는 사람이 그 칸이 있다는 것을 알 방법이 없었다. 우리가 어제 하루 종일\n * 「자리는 있고 길이 없다」로 부른 것의 타입 판이다.\n \n 좁히지 않는다: 세 칸을 다 실어 `CommandAck` 와 같은 모양으로 둔다. 커널이 어느 칸을 어떻게\n * 쓰는지는 `dispatch` 가 정하고, 이 자리는 나르기만 한다.\n /\nexport interface ActuationAck {\n ok: boolean\n /* 저쪽 문서·작업 식별자. 없으면 무엇을 되돌릴지 지목할 수 없다. /\n ref?: string\n /* 받아들였으나 저쪽이 덧붙인 말 — 실패가 아니다. 원인 쪽 문장. /\n note?: string\n /* 그 말 중 다음에 할 일 한 줄 — 붙여 보내지 않는다. /\n noteNext?: string\n error?: string\n /* 다시 해서 될 일인가 — 실패에만. 말하지 않으면 일꾼이 집지 않는다. /\n retry?: 'again' \| 'after-fix' \| 'never'\n}\n\n/\n 저장소를 한 번만 읽고, 판정과 함께 부를 것까지 돌려준다.\n \n 판정한 뒤 보낼 때 다시 읽으면 그 사이에 연결 설정이 바뀔 수 있다 — 판정한 커넥터와 실제로 부르는\n * 커넥터가 달라진다. 그리고 같은 행을 두 번 읽을 이유가 없다.\n /\nasync function resolve(domainId: string, instanceId: string) {\n const inst = await getRepository(TwinInstance).findOne({ where: { domain: { id: domainId }, instanceId } })\n const ref = inst\n ? await getRepository(TwinReference).findOne({ where: { domain: { id: domainId }, source: instanceId } })\n : null\n const adapter = ref ? getAdapter(ref.adapterType) : undefined\n\n const target = actuationTarget({\n instanceId,\n twinExists: !!inst,\n siteId: (inst?.origin as any)?.siteId,\n ...(ref ? { ref: { source: ref.source, adapterType: ref.adapterType } } : {}),\n adapterRegistered: !!adapter,\n capabilities: capabilitiesOf(adapter),\n declaresActuate: !!adapter?.capabilities?.includes('actuate'),\n hasActuateImpl: typeof adapter?.actuate === 'function'\n })\n\n return { target, ref, adapter }\n}\n\n/\n 이 트윈의 원본에 승인된 조치를 보낸다.\n \n 거절할 때는 무엇이 없어서인지 말한다. 「보내지 못했습니다」만 답하면 사람이 연결 설정을 열어야\n * 하는지, 커넥터를 고쳐야 하는지, 트윈을 다시 만들어야 하는지 알 수 없다.\n /\nexport async function routeActuation(\n domainId: string,\n instanceId: string,\n command: ApprovedCommand\n): Promise<ActuationAck> {\n const { target, ref, adapter } = await resolve(domainId, instanceId)\n if (!isActuationAllowed(target)) return { ok: false, error: `${target.detail}. ${APPROVAL_STANDS}` }\n\n /\n * 여기까지 왔으면 판정이 그 둘의 존재를 이미 확인했다(§`actuationTarget`). 그래도 조용히 지나가지\n * 않는다 — 판정과 배선이 어긋나면 그것이 결함이고, `!` 로 덮으면 그 결함이 「아무 일도 일어나지\n * 않았다」로 나타난다.\n /\n if (!adapter?.actuate) {\n return { ok: false, error: `커넥터를 찾았는데 조치를 보낼 자리가 없습니다 (${target.adapterType}). ${APPROVAL_STANDS}` }\n }\n\n const site: SiteDescriptor = { siteId: target.siteId }\n const result = await adapter.actuate(ref?.connectionConfig ?? {}, site, command)\n\n /\n * 왕복이 일어났다는 사실을 남긴다 (ADR-0046 ②).\n \n 설정이 맞는 것과 저쪽이 받는 것은 다르고, 그 차이는 한 번 넘겨 봐야만 안다. 승인 화면이 그것을\n * 미리 말하려면 지난 왕복의 결과가 어딘가에 남아 있어야 한다 — 없으면 화면은 매번 「해 봐야 안다」만\n * 말한다.\n \n 두 경로(`dispatchAfterApproval` · `sweepPendingDispatch`)가 다 이 함수를 지나므로 여기 한 곳이면\n * 된다. 실패해도 조치 결과는 그대로 돌려준다 — 기록이 본업을 막으면 안 되고, 삼키지도 않는다.\n /\n if (ref) await recordActuationOutcome(ref, result).catch(err => twinError('[reference] actuation state not recorded', err))\n\n return result\n}\n\n/\n 조치 결과를 레퍼런스에 적는다 — 코드만, 문장은 아니다.\n \n 거절 사유에 코드가 없으면 `actuationFailure` 를 비워 둔다. 자리를 채우려고 `error` 문장을 옮기면\n * `lastError` 가 이미 겪은 것을 반복한다 — 저장된 문장은 번역도 집계도 안 되고, 커넥터가 그 문장을\n * 고치는 날 옛 행과 새 행이 다른 말을 한다. 모르는 것은 안 적는다.\n /\nasync function recordActuationOutcome(ref: TwinReference, result: ActuationResult): Promise<void> {\n await getRepository(TwinReference).update({ id: ref.id }, actuationOutcomePatch(result, new Date().toISOString()))\n}\n\n/\n 이 트윈이 조치를 받을 수 있나 — 넘기기 전에 화면이 먼저 알 수 있게.\n \n 승인 화면이 「넘기기」를 보이기 전에 이것을 묻는다. 누를 수 없는 것을 보여 주고 눌렀을 때 거절하는\n * 것보다, 왜 못 넘기는지 먼저 말하는 것이 낫다.\n /\nexport async function actuationTargetOf(domainId: string, instanceId: string): Promise<ActuationTarget> {\n return (await resolve(domainId, instanceId)).target\n}\n\n/\n 저쪽이 받을 준비가 됐나 — 넘기기 전에 묻는다. 화면이 사람을 헛걸음시키지 않게.\n \n ── 왜 `actuationTargetOf` 와 따로인가 ──────────────────────────────────────\n * 그쪽은 망을 타지 않는다. 화면이 목록을 그릴 때마다 부를 수 있어야 하므로 그래야 한다.\n * 이 함수는 커넥터가 저쪽에 물을 수 있고, 그래서 부르는 시점이 다르다 — 사람이 「넘기기」를\n * 열었을 때다.\n \n ── 답이 문이 아니다 ────────────────────────────────────────────────────────\n * 이 답으로 넘김을 막지 않는다. 막으면 점검이 틀렸거나 잠깐 못 닿은 사이에 성공할 수 있었던\n * 조치가 못 나간다. 화면이 미리 말하는 데까지가 이 함수의 일이다.\n \n 커넥터가 이 얼굴을 안 만들었으면 「모른다」로 답한다 — 「준비됐다」가 아니다. 없는 확인을\n * 통과로 읽으면 이 함수가 있으나 없으나 같아진다.\n /\nexport async function actuationReadinessOf(domainId: string, instanceId: string): Promise<ActuationReadiness> {\n const { target, ref, adapter } = await resolve(domainId, instanceId)\n\n / 보낼 대상 자체가 없으면 저쪽에 물을 것도 없다 — 그 사실을 그대로 옮긴다. /\n if (!isActuationAllowed(target)) {\n return { checked: 'local', ready: false, reason: target.detail, code: target.code }\n }\n\n if (!adapter?.actuationReadiness) {\n / 확인할 길이 없다. 「준비됐다」로 답하지 않는다 — 그러면 화면이 없는 확인을 통과로 읽는다. /\n return {\n checked: 'local',\n reason: `커넥터 \"${target.adapterType}\" 는 저쪽이 받을 준비가 됐는지 알려 주지 않습니다 — 넘겨 보고 알게 됩니다`,\n code: 'not-checkable'\n }\n }\n\n try {\n return await adapter.actuationReadiness(ref?.connectionConfig ?? {}, { siteId: target.siteId })\n } catch (e: any) {\n /\n * 점검이 터진 것을 「저쪽이 죽었다」로 옮기지 않는다 — 우리 점검의 실패다. 그리고 던지지 않는다:\n * 이 함수 때문에 승인 화면이 안 열리면, 알려 주려던 것보다 큰 것을 잃는다.\n */\n return {\n checked: 'local',\n reason: `준비 상태를 확인하다 실패했습니다 — ${String(e?.message ?? e).slice(0, 160)}`,\n code: 'check-failed'\n }\n }\n}\n"]}

package/dist-server/service/reference/actuation-verification.d.ts ADDED Viewed

@@ -0,0 +1,22 @@
+import type { ActuationFailure, ActuationState } from './twin-reference.js';
+import type { ActuationResult } from './reference-adapter.js';
+/** 레퍼런스에 적을 칸들. `actuationVerifiedAt` 이 없는 것은 「건드리지 않는다」는 뜻이다. */
+export interface ActuationOutcomePatch {
+    actuationState: ActuationState;
+    actuationVerifiedAt?: string;
+    actuationFailure: ActuationFailure | null;
+}
+/**
+ * 결과 → 적을 것.
+ *
+ * ── 세 가지를 지킨다 ───────────────────────────────────────────────────────
+ * **받아들여지면 지난 거절을 지운다.** 남겨 두면 화면이 「됐는데 실패 사유가 있다」를 그린다.
+ *
+ * **거절은 성공 시각을 건드리지 않는다.** 「전에 한 번 닿았다」와 「이번에 안 됐다」는 둘 다 사실이고,
+ * 지우면 앞엣것이 사라진다 — 사람이 「한 번이라도 닿은 적 있나」를 물을 자리가 없어진다.
+ *
+ * **코드가 없으면 사유를 비운다.** 자리를 채우려고 `error` 문장을 옮기지 않는다. `lastError` 가 이미
+ * 겪었다 — 저장된 사람 문장은 번역도 집계도 안 되고, 커넥터가 그 문장을 고치는 날 옛 행과 새 행이
+ * 서로 다른 말을 한다. 모르는 것은 안 적는다.
+ */
+export declare function actuationOutcomePatch(result: ActuationResult, at: string): ActuationOutcomePatch;

package/dist-server/service/reference/actuation-verification.js ADDED Viewed

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.actuationOutcomePatch = actuationOutcomePatch;
+/**
+ * 결과 → 적을 것.
+ *
+ * ── 세 가지를 지킨다 ───────────────────────────────────────────────────────
+ * **받아들여지면 지난 거절을 지운다.** 남겨 두면 화면이 「됐는데 실패 사유가 있다」를 그린다.
+ *
+ * **거절은 성공 시각을 건드리지 않는다.** 「전에 한 번 닿았다」와 「이번에 안 됐다」는 둘 다 사실이고,
+ * 지우면 앞엣것이 사라진다 — 사람이 「한 번이라도 닿은 적 있나」를 물을 자리가 없어진다.
+ *
+ * **코드가 없으면 사유를 비운다.** 자리를 채우려고 `error` 문장을 옮기지 않는다. `lastError` 가 이미
+ * 겪었다 — 저장된 사람 문장은 번역도 집계도 안 되고, 커넥터가 그 문장을 고치는 날 옛 행과 새 행이
+ * 서로 다른 말을 한다. 모르는 것은 안 적는다.
+ */
+function actuationOutcomePatch(result, at) {
+    if (result.ok) {
+        return { actuationState: 'verified', actuationVerifiedAt: at, actuationFailure: null };
+    }
+    return {
+        actuationState: 'failed',
+        actuationFailure: result.errorCode
+            ? { code: result.errorCode, at, ...(result.errorParams ? { params: result.errorParams } : {}) }
+            : null
+    };
+}
+//# sourceMappingURL=actuation-verification.js.map

package/dist-server/service/reference/actuation-verification.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"actuation-verification.js","sourceRoot":"","sources":["../../../server/service/reference/actuation-verification.ts"],"names":[],"mappings":";;AA+BA,sDAWC;AAxBD;;;;;;;;;;;;GAYG;AACH,SAAgB,qBAAqB,CAAC,MAAuB,EAAE,EAAU;IACvE,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACd,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,mBAAmB,EAAE,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAA;IACxF,CAAC;IAED,OAAO;QACL,cAAc,EAAE,QAAQ;QACxB,gBAAgB,EAAE,MAAM,CAAC,SAAS;YAChC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;YAC/F,CAAC,CAAC,IAAI;KACT,CAAA;AACH,CAAC","sourcesContent":["/*\n * 조치 왕복의 결과를 레퍼런스에 어떻게 적을 것인가 — **순수하게.**\n *\n * `actuation-routing.ts` 에 두면 시험이 그 파일을 들여야 하고, 그 파일은 엔티티를 값으로 들인다\n * (데코레이터가 붙은 클래스). 가벼운 모듈로 떼어 두면 판단만 따로 확인할 수 있다.\n *\n * 여기서 들이는 것은 **타입뿐**이다 — 런타임에 남지 않는다.\n */\nimport type { ActuationFailure, ActuationState } from './twin-reference.js'\nimport type { ActuationResult } from './reference-adapter.js'\n\n/** 레퍼런스에 적을 칸들. `actuationVerifiedAt` 이 없는 것은 「건드리지 않는다」는 뜻이다. */\nexport interface ActuationOutcomePatch {\n actuationState: ActuationState\n actuationVerifiedAt?: string\n actuationFailure: ActuationFailure | null\n}\n\n/**\n * 결과 → 적을 것.\n *\n * ── 세 가지를 지킨다 ───────────────────────────────────────────────────────\n * **받아들여지면 지난 거절을 지운다.** 남겨 두면 화면이 「됐는데 실패 사유가 있다」를 그린다.\n *\n * **거절은 성공 시각을 건드리지 않는다.** 「전에 한 번 닿았다」와 「이번에 안 됐다」는 둘 다 사실이고,\n * 지우면 앞엣것이 사라진다 — 사람이 「한 번이라도 닿은 적 있나」를 물을 자리가 없어진다.\n *\n * **코드가 없으면 사유를 비운다.** 자리를 채우려고 `error` 문장을 옮기지 않는다. `lastError` 가 이미\n * 겪었다 — 저장된 사람 문장은 번역도 집계도 안 되고, 커넥터가 그 문장을 고치는 날 옛 행과 새 행이\n * 서로 다른 말을 한다. 모르는 것은 안 적는다.\n */\nexport function actuationOutcomePatch(result: ActuationResult, at: string): ActuationOutcomePatch {\n if (result.ok) {\n return { actuationState: 'verified', actuationVerifiedAt: at, actuationFailure: null }\n }\n\n return {\n actuationState: 'failed',\n actuationFailure: result.errorCode\n ? { code: result.errorCode, at, ...(result.errorParams ? { params: result.errorParams } : {}) }\n : null\n }\n}\n"]}

package/dist-server/service/reference/connection-portability.d.ts CHANGED Viewed

@@ -131,8 +131,30 @@ export declare function secretEnvName(source: string, key: string): string;
 export declare function intakeCollisions(connections: readonly {
     source: string;
     adapterType?: string;
-    config?: Record<string, unknown>;
+    /** 꾸러미·계획이 쓰는 이름. */
+    config?: Record<string, unknown> | null;
+    /** **DB 행이 쓰는 이름** — `TwinReference` 의 칸이다. 둘 다 받는다(ADR-0053 ①). */
+    connectionConfig?: Record<string, unknown> | null;
 }[]): {
     intake: string;
     sources: string[];
 }[];
+/**
+ * **화면 저장의 문** — 이 연결을 이 설정으로 저장하면 다른 연결과 받는 사이트가 겹치나 (ADR-0046 ②-1).
+ *
+ * 들여오기(`planImport`)는 `intakeCollisions` 로 거부하는데 화면 저장(`saveTwinReference`)은 부르지 않아서,
+ * 연결을 베껴 이름만 바꾸면 경고 0 으로 두 트윈의 조치가 한 공장에 섰다. 판정은 같은 함수 하나로 한다.
+ * 경고가 아니라 거부이고, 사람이 그 자리에서 고치도록 **이미 그 사이트를 쓰는 연결의 이름**을 싣는다.
+ */
+export declare function refuseIntakeCollision(source: string, config: Record<string, unknown> | undefined, others: readonly {
+    source: string;
+    siteName?: string | null;
+    connectionConfig?: Record<string, unknown> | null;
+}[]): {
+    code: 'intake-site-taken';
+    message: string;
+    params: {
+        site: string;
+        connection: string;
+    };
+} | null;

package/dist-server/service/reference/connection-portability.js CHANGED Viewed

@@ -38,6 +38,7 @@ exports.planImport = planImport;
 exports.sayPlan = sayPlan;
 exports.secretEnvName = secretEnvName;
 exports.intakeCollisions = intakeCollisions;
+exports.refuseIntakeCollision = refuseIntakeCollision;
 /** 값이 아니라 **채워져 있었다는 사실**만 나가는 칸들. */
 exports.SECRET_KEYS = ['token', 'hookSecret', 'intakeSecret', 'password', 'apiKey'];
 /**
@@ -153,9 +154,8 @@ availableSecrets = () => false) {
      * 잡습니다 — 그게 실제로 더 쉽게 나는 쪽입니다(하나는 화면에서, 하나는 파일에서 생깁니다).
      */
     const after = [
-        ...existing
-            .filter(e => !seen.has(e.source))
-            .map(e => ({ source: e.source, config: (e.connectionConfig ?? {}) })),
+        /* 행 모양 그대로 넘긴다 — 옮기는 자리는 `intakeCollisions` 안 한 곳이다(ADR-0053 ①). */
+        ...existing.filter(e => !seen.has(e.source)),
         ...actions
             .filter((a) => a.action !== 'skip')
             .map(a => ({ source: a.connection.source, config: a.connection.config }))
@@ -214,7 +214,17 @@ function secretEnvName(source, key) {
 function intakeCollisions(connections) {
     const byIntake = new Map();
     for (const c of connections) {
-        const cfg = c.config ?? {};
+        /*
+         * **모양이 둘인 것을 여기서 안다** (ADR-0053 ①, 2026-09-16).
+         *
+         * 꾸러미는 `config`, `TwinReference` 행은 `connectionConfig` 다. 전에는 `config` 만 읽어서, 행을
+         * 그대로 넘기면 같은 충돌에도 `[]` 를 냈다 — 오류도 경고도 없이 **저장이 통과하고 가드는 선 채로
+         * 아무 일도 안 한다.** 부르는 쪽마다 옮기게 두면 다음 소비처가 또 밟는다(이 함수는 화면이 쓰라고
+         * 리졸버에서 다시 내보내진다).
+         *
+         * 「없다」가 편한 답인 자리라 더 위험하다 — 빨강이 아니라 **조용한 초록**으로 흐른다.
+         */
+        const cfg = c.config ?? c.connectionConfig ?? {};
         /* 받는 자리를 정하는 규칙은 커넥터의 것과 같아야 합니다 — 여기서 다시 지으면 두 벌이 됩니다. */
         const intake = String(cfg.intakeSiteId ?? cfg.siteId ?? '').trim();
         /* 조치를 낼 수 없는 연결은 부딪힐 것이 없습니다 — 주소가 없으면 아무 데도 안 갑니다. */
@@ -227,4 +237,28 @@ function intakeCollisions(connections) {
         .filter(([, sources]) => sources.length > 1)
         .map(([intake, sources]) => ({ intake, sources: sources.sort() }));
 }
+/**
+ * **화면 저장의 문** — 이 연결을 이 설정으로 저장하면 다른 연결과 받는 사이트가 겹치나 (ADR-0046 ②-1).
+ *
+ * 들여오기(`planImport`)는 `intakeCollisions` 로 거부하는데 화면 저장(`saveTwinReference`)은 부르지 않아서,
+ * 연결을 베껴 이름만 바꾸면 경고 0 으로 두 트윈의 조치가 한 공장에 섰다. 판정은 같은 함수 하나로 한다.
+ * 경고가 아니라 거부이고, 사람이 그 자리에서 고치도록 **이미 그 사이트를 쓰는 연결의 이름**을 싣는다.
+ */
+function refuseIntakeCollision(source, config, others) {
+    const rest = others.filter(o => o.source !== source);
+    /* `others` 는 DB 행이다 — 옮기지 않고 그대로 넘긴다(ADR-0053 ①). */
+    const hit = intakeCollisions([...rest, { source, config: config ?? {} }]).find(c => c.sources.includes(source));
+    if (!hit)
+        return null;
+    const connection = rest
+        .filter(o => hit.sources.includes(o.source))
+        .map(o => o.siteName || o.source)
+        .join(', ');
+    const site = String(config?.intakeSiteId ?? config?.siteId ?? '').trim();
+    return {
+        code: 'intake-site-taken',
+        message: `intake site ${site} is already used by ${connection}`,
+        params: { site, connection }
+    };
+}
 //# sourceMappingURL=connection-portability.js.map

package/dist-server/service/reference/connection-portability.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"connection-portability.js","sourceRoot":"","sources":["../../../server/service/reference/connection-portability.ts"],"names":[],"mappings":"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","sourcesContent":["/\n 연결을 내보내고 다시 들여옵니다 — 실제 셋업을 파일로 보관하고 되세웁니다.\n \n ── 이것은 데모가 아니라 제품 기능입니다 (2026-09-05) ───────────────────────\n * 데모 시드(`seed-demo-twins.ts`)와 다른 것입니다. 그쪽은 내장 가상 마스터로 보여 줄 트윈을\n * 만들고 `TWIN_PROVISION_DEMO` 뒤에 숨습니다. 이것은 실제로 붙인 연결을 옮기는 길이라\n * 데모 스위치 뒤에 두지 않습니다 — 백업·이관·복구가 데모일 수 없습니다.\n \n 그래서 특정 공장을 제품 코드에 적지 않습니다. 적으면 배포마다 남의 공장이 하나씩 따라가고,\n * 데모 시드 머리말이 적어 둔 「프로덕션 배포는 트윈 0 에서 시작한다」가 깨집니다. 무엇을 세울지는\n * 파일이 말하고 코드는 그 파일을 읽을 줄만 압니다.\n \n ── 왜 필요했나 ────────────────────────────────────────────────────────────\n * 실 MES 두 공장을 트윈에 세웠는데(`mes-line-a` · `mes-miratek`) *그 셋업이 한 데이터베이스\n 안에만 있었습니다.** 잃으면 다시 손으로 만들어야 하고, 다른 배포에 옮길 길도 없었습니다.\n \n ── 담는 것과 안 담는 것 ────────────────────────────────────────────────────\n \n 담는다 연결 선언 — 주소 · 도메인 · 사이트 · 치수 · 이름공간 · 받는 자리\n * 안 담는다 비밀값 — 토큰 · 웹훅 서명값 · 받는 쪽 비밀값\n * 안 담는다 사실(저널) — 원본이 다시 보내면 된다. 담으면 가짜 과거가 배포마다 복제된다\n * 안 담는다 마스터에서 온 트윈 모델 — 연결이 있으면 재동기화가 다시 만든다\n \n 비밀값은 이름만 적습니다. 어느 칸이 채워져 있었는지는 알려 주되 값은 안 나갑니다 — 파일은\n * 주고받는 물건이고, 한 번 나간 비밀값은 되돌릴 수 없습니다. 들여올 때 「이 셋이 없다」고 말하고\n * 사람이 연결 화면에서 채웁니다.\n \n ── 왜 사실을 안 담나 ───────────────────────────────────────────────────────\n * 저널은 되풀이 읽히고 미러로 복제되고 구독으로 방송됩니다. 내보낸 사실을 다른 배포에 들여오면\n * 일어나지 않은 일이 그 공장의 지난 기록에 섭니다. 커서만 옮겨 두면 원본이 그 뒤부터 다시\n * 보내 주므로, 사실은 원본에서 오는 것이 맞습니다.\n /\n\n/* 값이 아니라 채워져 있었다는 사실만 나가는 칸들. /\nexport const SECRET_KEYS = ['token', 'hookSecret', 'intakeSecret', 'password', 'apiKey'] as const\n\nexport interface PortableConnection {\n source: string\n system?: string\n siteName?: string\n adapterType: string\n /* 비밀값을 뺀 연결 설정. /\n config: Record<string, unknown>\n /* 내보낼 때 채워져 있던 비밀 칸 이름 — 값은 없습니다. /\n secretsRequired: string[]\n /* 이 연결이 무엇을 세우나. /\n scope?: unknown\n}\n\nexport interface ConnectionBundle {\n kind: 'operato-twin/connections'\n version: 1\n exportedAt: string\n /* 어디서 내보냈나 — 사람이 나중에 「이게 어느 배포 것인가」를 물을 때 답합니다. /\n exportedFrom?: { domain?: string; note?: string }\n connections: PortableConnection[]\n}\n\n/\n 무엇을 세우나 선언만 남깁니다 — 지난 동기화의 측정값은 뺍니다.\n \n `scopeSpec` 에는 `produced`(선언) 옆에 `assessments`(그때 몇 개가 섰나) · `lastFailures` 가 함께\n * 삽니다. 그것까지 내보내면 새 배포가 다른 기계에서 잰 수를 자기 것으로 보입니다 — 「설비 42」가\n * 아무것도 안 세운 배포의 화면에 서고, 그 수가 어디서 왔는지 아무도 모릅니다.\n \n 재는 것은 그 배포에서 다시 재야 합니다. 오늘 「설정을 고쳤다」와 「모델이 다시 섰다」를 가른 것과\n * 같은 구별입니다.\n /\nfunction producedOf(scopeSpec: any): { produced: unknown } \| undefined {\n const produced = scopeSpec?.produced\n return Array.isArray(produced) && produced.length ? { produced } : undefined\n}\n\nconst isSecret = (key: string): boolean =>\n (SECRET_KEYS as readonly string[]).includes(key) \|\| /secret\|token\|password\|apikey/i.test(key)\n\n/\n 연결 행들을 옮길 수 있는 모양으로 — 비밀값을 빼고.\n \n 빼는 판정을 이름으로 합니다. 목록으로만 하면 커넥터가 새 비밀 칸을 더할 때 그 값이 조용히\n * 파일로 나갑니다 — 이름 규칙을 함께 두어 새 칸이 기본으로 안 나가게 합니다.\n /\nexport function exportConnections(\n rows: readonly { source: string; system?: string; siteName?: string; adapterType: string; connectionConfig?: any; scopeSpec?: any }[],\n meta: { at: string; domain?: string; note?: string }\n): ConnectionBundle {\n return {\n kind: 'operato-twin/connections',\n version: 1,\n exportedAt: meta.at,\n ...(meta.domain \|\| meta.note ? { exportedFrom: { ...(meta.domain ? { domain: meta.domain } : {}), ...(meta.note ? { note: meta.note } : {}) } } : {}),\n connections: rows.map(r => {\n const cfg = (r.connectionConfig ?? {}) as Record<string, unknown>\n const kept: Record<string, unknown> = {}\n const secrets: string[] = []\n for (const [k, v] of Object.entries(cfg)) {\n if (isSecret(k)) {\n / 비어 있던 칸은 적지 않습니다 — 「채워야 한다」와 「이 커넥터에 그런 칸이 있다」는 다릅니다. /\n if (String(v ?? '').trim()) secrets.push(k)\n continue\n }\n kept[k] = v\n }\n return {\n source: r.source,\n ...(r.system ? { system: r.system } : {}),\n ...(r.siteName ? { siteName: r.siteName } : {}),\n adapterType: r.adapterType,\n config: kept,\n secretsRequired: secrets.sort(),\n ...(producedOf(r.scopeSpec) ? { scope: producedOf(r.scopeSpec) } : {})\n }\n })\n }\n}\n\nexport type ImportAction =\n \| { action: 'create'; connection: PortableConnection; missingSecrets: string[] }\n \| { action: 'update'; connection: PortableConnection; missingSecrets: string[]; keptSecrets: string[] }\n \| { action: 'skip'; source: string; why: string }\n\nexport interface ImportPlan {\n actions: ImportAction[]\n /* 사람이 연결 화면에서 채워야 하는 것 — 이것이 비어야 「시드만으로 끝」입니다. /\n /\n 사람이 환경에 넣어야 하는 비밀값.\n \n `env` 를 함께 냅니다 — 그 이름을 사람이 손으로 적기 때문입니다. 화면이 이름을 따로 만들면\n * 규칙이 두 곳에 살고, 갈리는 날 「넣었는데 안 읽힌다」가 됩니다. 실제로 났습니다(2026-09-06):\n * 화면이 `TWIN_SECRET__MES-MIRATEK__HOOKSECRET` 을 알려 줬는데 서버가 읽는 이름은\n * `TWIN_SECRET__MES_MIRATEK__HOOK_SECRET` 이었습니다. 하이픈과 낙타 경계 둘 다 달랐습니다.\n \n `keys` 와 순서가 같습니다 — `keys[i]` 의 이름이 `env[i]` 입니다.\n /\n needsHuman: { source: string; keys: string[]; env: string[] }[]\n /* 들여온 뒤에 두 연결이 같은 곳에 조치를 내게 되나 — 있으면 들여오면 안 됩니다. /\n collisions: { intake: string; sources: string[] }[]\n errors: string[]\n}\n\n/\n 들여오기 계획을 먼저 냅니다 — 쓰기 전에 무엇이 일어날지 사람이 봅니다.\n \n ── 이미 있는 연결을 덮지 않습니다 ──────────────────────────────────────────\n * 같은 이름이 이미 있으면 선언만 갱신하고 비밀값은 그대로 둡니다. 사람이 화면에서 넣은 값을\n * 파일이 지우면, 파일 하나 들여왔다가 도는 연결이 멈춥니다. 데모 시드도 같은 규율을 적어 두었습니다\n * (「옆 설정을 지우지 않는다 — 시드는 자기가 아는 것만 채운다」).\n \n ── 없는 비밀값을 지어내지 않습니다 ─────────────────────────────────────────\n * 빈 값으로 채워 두면 연결이 서고 동기화할 때 처음 실패합니다. 그때는 무엇이 없어서인지 화면에서\n * 멉니다. 여기서 이름을 대고 멈추는 것이 낫습니다.\n /\nexport function planImport(\n bundle: unknown,\n existing: readonly { source: string; connectionConfig?: any }[],\n /* 지금 환경이 줄 수 있는 비밀값 이름들 — 값은 안 받습니다(이 함수는 값을 만지지 않습니다). /\n availableSecrets: (source: string, key: string) => boolean = () => false\n): ImportPlan {\n const errors: string[] = []\n const b = bundle as ConnectionBundle\n if (!b \|\| typeof b !== 'object') return { actions: [], needsHuman: [], collisions: [], errors: ['들여올 것이 객체가 아닙니다'] }\n if (b.kind !== 'operato-twin/connections') {\n return { actions: [], needsHuman: [], collisions: [], errors: [`이 파일은 연결 꾸러미가 아닙니다(kind: ${JSON.stringify((b as any).kind ?? null)})`] }\n }\n if (b.version !== 1) errors.push(`모르는 판입니다(version: ${JSON.stringify((b as any).version)}) — 읽을 수 있는 것만 읽습니다`)\n if (!Array.isArray(b.connections)) return { actions: [], needsHuman: [], collisions: [], errors: [...errors, 'connections 가 목록이 아닙니다'] }\n\n const have = new Map(existing.map(e => [e.source, e]))\n const seen = new Set<string>()\n const actions: ImportAction[] = []\n const needsHuman: { source: string; keys: string[]; env: string[] }[] = []\n\n for (const c of b.connections) {\n const source = String(c?.source ?? '').trim()\n if (!source) {\n errors.push('이름 없는 연결이 있습니다 — 건너뜁니다')\n continue\n }\n if (seen.has(source)) {\n actions.push({ action: 'skip', source, why: '같은 이름이 파일에 두 번 있습니다' })\n continue\n }\n seen.add(source)\n if (!String(c?.adapterType ?? '').trim()) {\n actions.push({ action: 'skip', source, why: '커넥터 종류가 없습니다 — 무엇으로 붙일지 모릅니다' })\n continue\n }\n\n const cur = have.get(source)\n const curCfg = (cur?.connectionConfig ?? {}) as Record<string, unknown>\n const wanted = Array.isArray(c.secretsRequired) ? c.secretsRequired.map(String) : []\n const kept = wanted.filter(k => String(curCfg[k] ?? '').trim())\n const missing = wanted.filter(k => !kept.includes(k) && !availableSecrets(source, k))\n\n if (missing.length) needsHuman.push({ source, keys: missing, env: missing.map(k => secretEnvName(source, k)) })\n actions.push(\n cur\n ? { action: 'update', connection: c, missingSecrets: missing, keptSecrets: kept }\n : { action: 'create', connection: c, missingSecrets: missing }\n )\n }\n\n /\n * 들여온 뒤의 모습으로 봅니다. 파일 안에서만 보면 「이미 있는 연결과 부딪히는 것」을 못\n * 잡습니다 — 그게 실제로 더 쉽게 나는 쪽입니다(하나는 화면에서, 하나는 파일에서 생깁니다).\n /\n const after = [\n ...existing\n .filter(e => !seen.has(e.source))\n .map(e => ({ source: e.source, config: (e.connectionConfig ?? {}) as Record<string, unknown> })),\n ...actions\n .filter((a): a is Extract<ImportAction, { connection: PortableConnection }> => a.action !== 'skip')\n .map(a => ({ source: a.connection.source, config: a.connection.config }))\n ]\n return { actions, needsHuman, collisions: intakeCollisions(after), errors }\n}\n\n/* 사람이 읽는 한 줄 — 화면과 로그가 같은 문장을 쓰게. /\nexport function sayPlan(plan: ImportPlan): string {\n const n = (a: ImportAction['action']) => plan.actions.filter(x => x.action === a).length\n const head = `연결 ${plan.actions.length}개 — 새로 ${n('create')} · 갱신 ${n('update')} · 건너뜀 ${n('skip')}`\n / 부딪힘을 먼저 말합니다 — 비밀값이 없는 것은 안 도는 것이고, 부딪히는 것은 잘못 도는 것입니다. /\n if (plan.collisions.length) {\n const who = plan.collisions.map(c => `${c.sources.join(' · ')} → ${c.intake}`).join(', ')\n return `${head}. ⚠ 두 연결이 같은 곳에 조치를 냅니다* — ${who}. 다른 공장의 작업지시가 한 공장에 섭니다`\n }\n if (!plan.needsHuman.length) return `${head}. 비밀값은 다 있습니다`\n const who = plan.needsHuman.map(h => `${h.source}(${h.keys.join(' · ')})`).join(', ')\n return `${head}. 비밀값을 사람이 넣어야 합니다 — ${who}. 연결 화면에서 채우면 그때부터 돕니다`\n}\n\n/*\n 비밀값이 사는 환경 변수 이름 — `mes-miratek` · `hookSecret` → `TWIN_SECRET__MES_MIRATEK__HOOK_SECRET`.\n \n 꾸러미에는 비밀 칸의 이름만 있고 값은 환경에서 옵니다. 그 이름을 사람이 손으로 적으므로 규칙이\n * 흔들리면 「넣었는데 안 읽힌다」가 됩니다 — 오늘 종일 잡은 「양쪽 다 초록인데 안 간다」의 설정 쪽\n * 판본입니다. 그래서 이 규칙을 한 곳에 두고 시험으로 못 박습니다.\n \n 낙타 이름의 경계를 밑줄로 가릅니다 — 안 그러면 `HOOKSECRET` 과 `HOOK_SECRET` 이 갈려 한쪽만 읽힙니다.\n /\nexport function secretEnvName(source: string, key: string): string {\n const up = (x: string) =>\n x\n .replace(/([a-z0-9])([A-Z])/g, '$1_$2')\n .replace(/[^A-Za-z0-9]+/g, '_')\n .replace(/^_+\|_+$/g, '')\n .toUpperCase()\n return `TWIN_SECRET__${up(source)}__${up(key)}`\n}\n\n/\n 두 연결이 같은 곳에 조치를 내지 않나 — 같으면 다른 공장의 작업지시가 한 공장에 섭니다.\n \n ── 왜 이 검사가 생겼나 (2026-09-05) ────────────────────────────────────────\n * `mes-miratek` 이 서면서 한 커넥터가 처음으로 공장 둘을 달았습니다. 조치가 나가는 주소는\n * `intakeSiteId` 가 정하는데(`operato-plant.ts:389`), 그 값이 트윈의 사이트 이름을 이깁니다 —\n * 트윈에서는 `mes-line-a` 인데 MES 의 도메인은 `system` 이라 그 override 가 필요합니다.\n \n 그래서 연결을 베껴 만들고 그 칸만 안 고치면 두 트윈의 조치가 같은 공장으로 갑니다. 오류가\n * 안 납니다 — 저쪽은 정상적인 작업지시로 받고 실제로 만듭니다.\n \n 게이트에 이미 「사이트를 모르면 보내지 않는다」가 있는데(`no-site`), 그 이유가 적혀 있는 문장이\n * 「잘못된 공장이 실제로 만든다」 입니다. 이것은 그 둘째 길입니다 — 사이트를 아는데 *틀린\n 사이트를 압니다.*\n \n * 파일로 연결을 만들 수 있게 되면서 더 쉬워졌습니다: 꾸러미를 베껴 이름만 바꾸면 받는 자리가\n * 그대로 따라옵니다.\n /\nexport function intakeCollisions(\n connections: readonly { source: string; adapterType?: string; config?: Record<string, unknown> }[]\n): { intake: string; sources: string[] }[] {\n const byIntake = new Map<string, string[]>()\n for (const c of connections) {\n const cfg = c.config ?? {}\n / 받는 자리를 정하는 규칙은 커넥터의 것과 같아야 합니다 — 여기서 다시 지으면 두 벌이 됩니다. /\n const intake = String(cfg.intakeSiteId ?? cfg.siteId ?? '').trim()\n / 조치를 낼 수 없는 연결은 부딪힐 것이 없습니다 — 주소가 없으면 아무 데도 안 갑니다. */\n if (!intake \|\| !String(cfg.intakeEndpoint ?? '').trim()) continue\n const key = `${String(cfg.intakeEndpoint).trim().replace(/\\/$/, '')}::${intake}`\n byIntake.set(key, [...(byIntake.get(key) ?? []), c.source])\n }\n return [...byIntake.entries()]\n .filter(([, sources]) => sources.length > 1)\n .map(([intake, sources]) => ({ intake, sources: sources.sort() }))\n}\n"]}
1	+ {"version":3,"file":"connection-portability.js","sourceRoot":"","sources":["../../../server/service/reference/connection-portability.ts"],"names":[],"mappings":"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","sourcesContent":["/\n 연결을 내보내고 다시 들여옵니다 — 실제 셋업을 파일로 보관하고 되세웁니다.\n \n ── 이것은 데모가 아니라 제품 기능입니다 (2026-09-05) ───────────────────────\n * 데모 시드(`seed-demo-twins.ts`)와 다른 것입니다. 그쪽은 내장 가상 마스터로 보여 줄 트윈을\n * 만들고 `TWIN_PROVISION_DEMO` 뒤에 숨습니다. 이것은 실제로 붙인 연결을 옮기는 길이라\n * 데모 스위치 뒤에 두지 않습니다 — 백업·이관·복구가 데모일 수 없습니다.\n \n 그래서 특정 공장을 제품 코드에 적지 않습니다. 적으면 배포마다 남의 공장이 하나씩 따라가고,\n * 데모 시드 머리말이 적어 둔 「프로덕션 배포는 트윈 0 에서 시작한다」가 깨집니다. 무엇을 세울지는\n * 파일이 말하고 코드는 그 파일을 읽을 줄만 압니다.\n \n ── 왜 필요했나 ────────────────────────────────────────────────────────────\n * 실 MES 두 공장을 트윈에 세웠는데(`mes-line-a` · `mes-miratek`) *그 셋업이 한 데이터베이스\n 안에만 있었습니다.** 잃으면 다시 손으로 만들어야 하고, 다른 배포에 옮길 길도 없었습니다.\n \n ── 담는 것과 안 담는 것 ────────────────────────────────────────────────────\n \n 담는다 연결 선언 — 주소 · 도메인 · 사이트 · 치수 · 이름공간 · 받는 자리\n * 안 담는다 비밀값 — 토큰 · 웹훅 서명값 · 받는 쪽 비밀값\n * 안 담는다 사실(저널) — 원본이 다시 보내면 된다. 담으면 가짜 과거가 배포마다 복제된다\n * 안 담는다 마스터에서 온 트윈 모델 — 연결이 있으면 재동기화가 다시 만든다\n \n 비밀값은 이름만 적습니다. 어느 칸이 채워져 있었는지는 알려 주되 값은 안 나갑니다 — 파일은\n * 주고받는 물건이고, 한 번 나간 비밀값은 되돌릴 수 없습니다. 들여올 때 「이 셋이 없다」고 말하고\n * 사람이 연결 화면에서 채웁니다.\n \n ── 왜 사실을 안 담나 ───────────────────────────────────────────────────────\n * 저널은 되풀이 읽히고 미러로 복제되고 구독으로 방송됩니다. 내보낸 사실을 다른 배포에 들여오면\n * 일어나지 않은 일이 그 공장의 지난 기록에 섭니다. 커서만 옮겨 두면 원본이 그 뒤부터 다시\n * 보내 주므로, 사실은 원본에서 오는 것이 맞습니다.\n /\n\n/* 값이 아니라 채워져 있었다는 사실만 나가는 칸들. /\nexport const SECRET_KEYS = ['token', 'hookSecret', 'intakeSecret', 'password', 'apiKey'] as const\n\nexport interface PortableConnection {\n source: string\n system?: string\n siteName?: string\n adapterType: string\n /* 비밀값을 뺀 연결 설정. /\n config: Record<string, unknown>\n /* 내보낼 때 채워져 있던 비밀 칸 이름 — 값은 없습니다. /\n secretsRequired: string[]\n /* 이 연결이 무엇을 세우나. /\n scope?: unknown\n}\n\nexport interface ConnectionBundle {\n kind: 'operato-twin/connections'\n version: 1\n exportedAt: string\n /* 어디서 내보냈나 — 사람이 나중에 「이게 어느 배포 것인가」를 물을 때 답합니다. /\n exportedFrom?: { domain?: string; note?: string }\n connections: PortableConnection[]\n}\n\n/\n 무엇을 세우나 선언만 남깁니다 — 지난 동기화의 측정값은 뺍니다.\n \n `scopeSpec` 에는 `produced`(선언) 옆에 `assessments`(그때 몇 개가 섰나) · `lastFailures` 가 함께\n * 삽니다. 그것까지 내보내면 새 배포가 다른 기계에서 잰 수를 자기 것으로 보입니다 — 「설비 42」가\n * 아무것도 안 세운 배포의 화면에 서고, 그 수가 어디서 왔는지 아무도 모릅니다.\n \n 재는 것은 그 배포에서 다시 재야 합니다. 오늘 「설정을 고쳤다」와 「모델이 다시 섰다」를 가른 것과\n * 같은 구별입니다.\n /\nfunction producedOf(scopeSpec: any): { produced: unknown } \| undefined {\n const produced = scopeSpec?.produced\n return Array.isArray(produced) && produced.length ? { produced } : undefined\n}\n\nconst isSecret = (key: string): boolean =>\n (SECRET_KEYS as readonly string[]).includes(key) \|\| /secret\|token\|password\|apikey/i.test(key)\n\n/\n 연결 행들을 옮길 수 있는 모양으로 — 비밀값을 빼고.\n \n 빼는 판정을 이름으로 합니다. 목록으로만 하면 커넥터가 새 비밀 칸을 더할 때 그 값이 조용히\n * 파일로 나갑니다 — 이름 규칙을 함께 두어 새 칸이 기본으로 안 나가게 합니다.\n /\nexport function exportConnections(\n rows: readonly { source: string; system?: string; siteName?: string; adapterType: string; connectionConfig?: any; scopeSpec?: any }[],\n meta: { at: string; domain?: string; note?: string }\n): ConnectionBundle {\n return {\n kind: 'operato-twin/connections',\n version: 1,\n exportedAt: meta.at,\n ...(meta.domain \|\| meta.note ? { exportedFrom: { ...(meta.domain ? { domain: meta.domain } : {}), ...(meta.note ? { note: meta.note } : {}) } } : {}),\n connections: rows.map(r => {\n const cfg = (r.connectionConfig ?? {}) as Record<string, unknown>\n const kept: Record<string, unknown> = {}\n const secrets: string[] = []\n for (const [k, v] of Object.entries(cfg)) {\n if (isSecret(k)) {\n / 비어 있던 칸은 적지 않습니다 — 「채워야 한다」와 「이 커넥터에 그런 칸이 있다」는 다릅니다. /\n if (String(v ?? '').trim()) secrets.push(k)\n continue\n }\n kept[k] = v\n }\n return {\n source: r.source,\n ...(r.system ? { system: r.system } : {}),\n ...(r.siteName ? { siteName: r.siteName } : {}),\n adapterType: r.adapterType,\n config: kept,\n secretsRequired: secrets.sort(),\n ...(producedOf(r.scopeSpec) ? { scope: producedOf(r.scopeSpec) } : {})\n }\n })\n }\n}\n\nexport type ImportAction =\n \| { action: 'create'; connection: PortableConnection; missingSecrets: string[] }\n \| { action: 'update'; connection: PortableConnection; missingSecrets: string[]; keptSecrets: string[] }\n \| { action: 'skip'; source: string; why: string }\n\nexport interface ImportPlan {\n actions: ImportAction[]\n /* 사람이 연결 화면에서 채워야 하는 것 — 이것이 비어야 「시드만으로 끝」입니다. /\n /\n 사람이 환경에 넣어야 하는 비밀값.\n \n `env` 를 함께 냅니다 — 그 이름을 사람이 손으로 적기 때문입니다. 화면이 이름을 따로 만들면\n * 규칙이 두 곳에 살고, 갈리는 날 「넣었는데 안 읽힌다」가 됩니다. 실제로 났습니다(2026-09-06):\n * 화면이 `TWIN_SECRET__MES-MIRATEK__HOOKSECRET` 을 알려 줬는데 서버가 읽는 이름은\n * `TWIN_SECRET__MES_MIRATEK__HOOK_SECRET` 이었습니다. 하이픈과 낙타 경계 둘 다 달랐습니다.\n \n `keys` 와 순서가 같습니다 — `keys[i]` 의 이름이 `env[i]` 입니다.\n /\n needsHuman: { source: string; keys: string[]; env: string[] }[]\n /* 들여온 뒤에 두 연결이 같은 곳에 조치를 내게 되나 — 있으면 들여오면 안 됩니다. /\n collisions: { intake: string; sources: string[] }[]\n errors: string[]\n}\n\n/\n 들여오기 계획을 먼저 냅니다 — 쓰기 전에 무엇이 일어날지 사람이 봅니다.\n \n ── 이미 있는 연결을 덮지 않습니다 ──────────────────────────────────────────\n * 같은 이름이 이미 있으면 선언만 갱신하고 비밀값은 그대로 둡니다. 사람이 화면에서 넣은 값을\n * 파일이 지우면, 파일 하나 들여왔다가 도는 연결이 멈춥니다. 데모 시드도 같은 규율을 적어 두었습니다\n * (「옆 설정을 지우지 않는다 — 시드는 자기가 아는 것만 채운다」).\n \n ── 없는 비밀값을 지어내지 않습니다 ─────────────────────────────────────────\n * 빈 값으로 채워 두면 연결이 서고 동기화할 때 처음 실패합니다. 그때는 무엇이 없어서인지 화면에서\n * 멉니다. 여기서 이름을 대고 멈추는 것이 낫습니다.\n /\nexport function planImport(\n bundle: unknown,\n existing: readonly { source: string; connectionConfig?: any }[],\n /* 지금 환경이 줄 수 있는 비밀값 이름들 — 값은 안 받습니다(이 함수는 값을 만지지 않습니다). /\n availableSecrets: (source: string, key: string) => boolean = () => false\n): ImportPlan {\n const errors: string[] = []\n const b = bundle as ConnectionBundle\n if (!b \|\| typeof b !== 'object') return { actions: [], needsHuman: [], collisions: [], errors: ['들여올 것이 객체가 아닙니다'] }\n if (b.kind !== 'operato-twin/connections') {\n return { actions: [], needsHuman: [], collisions: [], errors: [`이 파일은 연결 꾸러미가 아닙니다(kind: ${JSON.stringify((b as any).kind ?? null)})`] }\n }\n if (b.version !== 1) errors.push(`모르는 판입니다(version: ${JSON.stringify((b as any).version)}) — 읽을 수 있는 것만 읽습니다`)\n if (!Array.isArray(b.connections)) return { actions: [], needsHuman: [], collisions: [], errors: [...errors, 'connections 가 목록이 아닙니다'] }\n\n const have = new Map(existing.map(e => [e.source, e]))\n const seen = new Set<string>()\n const actions: ImportAction[] = []\n const needsHuman: { source: string; keys: string[]; env: string[] }[] = []\n\n for (const c of b.connections) {\n const source = String(c?.source ?? '').trim()\n if (!source) {\n errors.push('이름 없는 연결이 있습니다 — 건너뜁니다')\n continue\n }\n if (seen.has(source)) {\n actions.push({ action: 'skip', source, why: '같은 이름이 파일에 두 번 있습니다' })\n continue\n }\n seen.add(source)\n if (!String(c?.adapterType ?? '').trim()) {\n actions.push({ action: 'skip', source, why: '커넥터 종류가 없습니다 — 무엇으로 붙일지 모릅니다' })\n continue\n }\n\n const cur = have.get(source)\n const curCfg = (cur?.connectionConfig ?? {}) as Record<string, unknown>\n const wanted = Array.isArray(c.secretsRequired) ? c.secretsRequired.map(String) : []\n const kept = wanted.filter(k => String(curCfg[k] ?? '').trim())\n const missing = wanted.filter(k => !kept.includes(k) && !availableSecrets(source, k))\n\n if (missing.length) needsHuman.push({ source, keys: missing, env: missing.map(k => secretEnvName(source, k)) })\n actions.push(\n cur\n ? { action: 'update', connection: c, missingSecrets: missing, keptSecrets: kept }\n : { action: 'create', connection: c, missingSecrets: missing }\n )\n }\n\n /\n * 들여온 뒤의 모습으로 봅니다. 파일 안에서만 보면 「이미 있는 연결과 부딪히는 것」을 못\n * 잡습니다 — 그게 실제로 더 쉽게 나는 쪽입니다(하나는 화면에서, 하나는 파일에서 생깁니다).\n /\n const after = [\n / 행 모양 그대로 넘긴다 — 옮기는 자리는 `intakeCollisions` 안 한 곳이다(ADR-0053 ①). /\n ...existing.filter(e => !seen.has(e.source)),\n ...actions\n .filter((a): a is Extract<ImportAction, { connection: PortableConnection }> => a.action !== 'skip')\n .map(a => ({ source: a.connection.source, config: a.connection.config }))\n ]\n return { actions, needsHuman, collisions: intakeCollisions(after), errors }\n}\n\n/* 사람이 읽는 한 줄 — 화면과 로그가 같은 문장을 쓰게. /\nexport function sayPlan(plan: ImportPlan): string {\n const n = (a: ImportAction['action']) => plan.actions.filter(x => x.action === a).length\n const head = `연결 ${plan.actions.length}개 — 새로 ${n('create')} · 갱신 ${n('update')} · 건너뜀 ${n('skip')}`\n / 부딪힘을 먼저 말합니다 — 비밀값이 없는 것은 안 도는 것이고, 부딪히는 것은 잘못 도는 것입니다. /\n if (plan.collisions.length) {\n const who = plan.collisions.map(c => `${c.sources.join(' · ')} → ${c.intake}`).join(', ')\n return `${head}. ⚠ 두 연결이 같은 곳에 조치를 냅니다* — ${who}. 다른 공장의 작업지시가 한 공장에 섭니다`\n }\n if (!plan.needsHuman.length) return `${head}. 비밀값은 다 있습니다`\n const who = plan.needsHuman.map(h => `${h.source}(${h.keys.join(' · ')})`).join(', ')\n return `${head}. 비밀값을 사람이 넣어야 합니다 — ${who}. 연결 화면에서 채우면 그때부터 돕니다`\n}\n\n/*\n 비밀값이 사는 환경 변수 이름 — `mes-miratek` · `hookSecret` → `TWIN_SECRET__MES_MIRATEK__HOOK_SECRET`.\n \n 꾸러미에는 비밀 칸의 이름만 있고 값은 환경에서 옵니다. 그 이름을 사람이 손으로 적으므로 규칙이\n * 흔들리면 「넣었는데 안 읽힌다」가 됩니다 — 오늘 종일 잡은 「양쪽 다 초록인데 안 간다」의 설정 쪽\n * 판본입니다. 그래서 이 규칙을 한 곳에 두고 시험으로 못 박습니다.\n \n 낙타 이름의 경계를 밑줄로 가릅니다 — 안 그러면 `HOOKSECRET` 과 `HOOK_SECRET` 이 갈려 한쪽만 읽힙니다.\n /\nexport function secretEnvName(source: string, key: string): string {\n const up = (x: string) =>\n x\n .replace(/([a-z0-9])([A-Z])/g, '$1_$2')\n .replace(/[^A-Za-z0-9]+/g, '_')\n .replace(/^_+\|_+$/g, '')\n .toUpperCase()\n return `TWIN_SECRET__${up(source)}__${up(key)}`\n}\n\n/\n 두 연결이 같은 곳에 조치를 내지 않나 — 같으면 다른 공장의 작업지시가 한 공장에 섭니다.\n \n ── 왜 이 검사가 생겼나 (2026-09-05) ────────────────────────────────────────\n * `mes-miratek` 이 서면서 한 커넥터가 처음으로 공장 둘을 달았습니다. 조치가 나가는 주소는\n * `intakeSiteId` 가 정하는데(`operato-plant.ts:389`), 그 값이 트윈의 사이트 이름을 이깁니다 —\n * 트윈에서는 `mes-line-a` 인데 MES 의 도메인은 `system` 이라 그 override 가 필요합니다.\n \n 그래서 연결을 베껴 만들고 그 칸만 안 고치면 두 트윈의 조치가 같은 공장으로 갑니다. 오류가\n * 안 납니다 — 저쪽은 정상적인 작업지시로 받고 실제로 만듭니다.\n \n 게이트에 이미 「사이트를 모르면 보내지 않는다」가 있는데(`no-site`), 그 이유가 적혀 있는 문장이\n * 「잘못된 공장이 실제로 만든다」 입니다. 이것은 그 둘째 길입니다 — 사이트를 아는데 *틀린\n 사이트를 압니다.*\n \n * 파일로 연결을 만들 수 있게 되면서 더 쉬워졌습니다: 꾸러미를 베껴 이름만 바꾸면 받는 자리가\n * 그대로 따라옵니다.\n /\nexport function intakeCollisions(\n connections: readonly {\n source: string\n adapterType?: string\n /* 꾸러미·계획이 쓰는 이름. /\n config?: Record<string, unknown> \| null\n /* DB 행이 쓰는 이름 — `TwinReference` 의 칸이다. 둘 다 받는다(ADR-0053 ①). /\n connectionConfig?: Record<string, unknown> \| null\n }[]\n): { intake: string; sources: string[] }[] {\n const byIntake = new Map<string, string[]>()\n for (const c of connections) {\n /\n * 모양이 둘인 것을 여기서 안다 (ADR-0053 ①, 2026-09-16).\n \n 꾸러미는 `config`, `TwinReference` 행은 `connectionConfig` 다. 전에는 `config` 만 읽어서, 행을\n * 그대로 넘기면 같은 충돌에도 `[]` 를 냈다 — 오류도 경고도 없이 *저장이 통과하고 가드는 선 채로\n 아무 일도 안 한다.** 부르는 쪽마다 옮기게 두면 다음 소비처가 또 밟는다(이 함수는 화면이 쓰라고\n * 리졸버에서 다시 내보내진다).\n \n 「없다」가 편한 답인 자리라 더 위험하다 — 빨강이 아니라 조용한 초록으로 흐른다.\n /\n const cfg = c.config ?? c.connectionConfig ?? {}\n / 받는 자리를 정하는 규칙은 커넥터의 것과 같아야 합니다 — 여기서 다시 지으면 두 벌이 됩니다. /\n const intake = String(cfg.intakeSiteId ?? cfg.siteId ?? '').trim()\n / 조치를 낼 수 없는 연결은 부딪힐 것이 없습니다 — 주소가 없으면 아무 데도 안 갑니다. /\n if (!intake \|\| !String(cfg.intakeEndpoint ?? '').trim()) continue\n const key = `${String(cfg.intakeEndpoint).trim().replace(/\\/$/, '')}::${intake}`\n byIntake.set(key, [...(byIntake.get(key) ?? []), c.source])\n }\n return [...byIntake.entries()]\n .filter(([, sources]) => sources.length > 1)\n .map(([intake, sources]) => ({ intake, sources: sources.sort() }))\n}\n\n/\n 화면 저장의 문 — 이 연결을 이 설정으로 저장하면 다른 연결과 받는 사이트가 겹치나 (ADR-0046 ②-1).\n \n 들여오기(`planImport`)는 `intakeCollisions` 로 거부하는데 화면 저장(`saveTwinReference`)은 부르지 않아서,\n * 연결을 베껴 이름만 바꾸면 경고 0 으로 두 트윈의 조치가 한 공장에 섰다. 판정은 같은 함수 하나로 한다.\n * 경고가 아니라 거부이고, 사람이 그 자리에서 고치도록 이미 그 사이트를 쓰는 연결의 이름을 싣는다.\n /\nexport function refuseIntakeCollision(\n source: string,\n config: Record<string, unknown> \| undefined,\n others: readonly { source: string; siteName?: string \| null; connectionConfig?: Record<string, unknown> \| null }[]\n): { code: 'intake-site-taken'; message: string; params: { site: string; connection: string } } \| null {\n const rest = others.filter(o => o.source !== source)\n / `others` 는 DB 행이다 — 옮기지 않고 그대로 넘긴다(ADR-0053 ①). */\n const hit = intakeCollisions([...rest, { source, config: config ?? {} }]).find(c => c.sources.includes(source))\n if (!hit) return null\n const connection = rest\n .filter(o => hit.sources.includes(o.source))\n .map(o => o.siteName \|\| o.source)\n .join(', ')\n const site = String(config?.intakeSiteId ?? config?.siteId ?? '').trim()\n return {\n code: 'intake-site-taken',\n message: `intake site ${site} is already used by ${connection}`,\n params: { site, connection }\n }\n}\n"]}