@things-factory/ops-master 10.1.248 → 10.1.250

package/dist-server/service/assignment/assignment-history.js

@@ -0,0 +1,289 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.claimAt = claimAt;
+exports.hasAssignmentHistory = hasAssignmentHistory;
+exports.claimsDuring = claimsDuring;
+exports.recordClaim = recordClaim;
+exports.projectDueClaims = projectDueClaims;
+exports.valueOnRow = valueOnRow;
+const typeorm_1 = require("typeorm");
+const shell_1 = require("@things-factory/shell");
+const master_axis_1 = require("../master-axis");
+const master_value_claim_1 = require("./master-value-claim");
+const assignment_write_1 = require("./assignment-write");
+const ms = (at) => at.getTime();
+/** 그 기록시점에 서 있던 주장들 — 물러난 것은 뺀다. */
+async function standingClaims(manager, domain, target, asOfRecord) {
+    const rows = await manager.find(master_value_claim_1.MasterValueClaim, {
+        where: { domain: { id: domain.id }, axis: target.axis, rowId: target.rowId, field: target.field }
+    });
+    const at = asOfRecord ? ms(asOfRecord) : undefined;
+    return rows.filter(one => {
+        /* 그 시점 뒤에 적힌 주장은 그때 몰랐다. */
+        if (at !== undefined && ms(one.recordedAt) > at)
+            return false;
+        /* 그 시점에 이미 물러났으면 안 본다. 그 뒤에 물러난 것은 그때는 서 있었다. */
+        return !(one.supersededAt && (at === undefined || ms(one.supersededAt) <= at));
+    });
+}
+/**
+ * 그 업무시각에 유효했던 주장.
+ *
+ * **없으면 `undefined` 다 — 「선언 없음」과 다르다.** 선언 없음은 `value` 가 `null` 인 주장이 있는
+ * 것이고, 여기서 `undefined` 는 **그때 무엇이었는지 모른다**는 뜻이다.
+ */
+async function claimAt(manager, domain, target, at) {
+    const standing = await standingClaims(manager, domain, target, at.asOfRecord);
+    const when = ms(at.asOfBusiness);
+    const covering = standing.filter(one => (!one.validFrom || ms(one.validFrom) <= when) && (!one.validTo || when < ms(one.validTo)));
+    if (covering.length > 1) {
+        throw new shell_1.Refusal('master-value-claim-conflict', { axis: target.axis, field: target.field, at: at.asOfBusiness.toISOString() }, 'two assignment claims cover the same moment. fix the history before asking.');
+    }
+    return covering[0];
+}
+/**
+ * 이 대상에 **주장이 한 건이라도 있나** — 창 밖의 것까지 센다.
+ *
+ * 창 안에 없는 것과 아예 없는 것은 다른 사실이다. 아예 없으면 이 설치본이 아직 이력을 안 쓰는
+ * 것이고, 있는데 그 창을 안 덮으면 **구멍**이다. 부르는 쪽이 둘을 다르게 다뤄야 해서 따로 묻는다.
+ */
+async function hasAssignmentHistory(manager, domain, target) {
+    const count = await manager.count(master_value_claim_1.MasterValueClaim, {
+        where: { domain: { id: domain.id }, axis: target.axis, rowId: target.rowId, field: target.field }
+    });
+    return count > 0;
+}
+/** 한 창을 덮는 주장들 — **계산 구간을 나눌 경계**가 여기서 나온다. 시작 시각 순이다. */
+async function claimsDuring(manager, domain, target, window, asOfRecord) {
+    const standing = await standingClaims(manager, domain, target, asOfRecord);
+    const from = ms(window.from);
+    const to = ms(window.to);
+    return standing
+        .filter(one => (!one.validFrom || ms(one.validFrom) < to) && (!one.validTo || from < ms(one.validTo)))
+        .sort((a, b) => (a.validFrom ? ms(a.validFrom) : -Infinity) - (b.validFrom ? ms(b.validFrom) : -Infinity));
+}
+/**
+ * 주장을 남긴다. **정정이면 겹치는 것을 물러나게 하고 앞뒤 조각을 다시 주장한다.**
+ *
+ * 부르는 쪽이 마스터 변경과 **같은 트랜잭션**으로 부른다 — 갈라지면 값은 바뀌고 이력은 없는 상태가
+ * 생긴다.
+ */
+async function recordClaim(manager, domain, said, now = new Date()) {
+    const declared = (0, master_value_claim_1.claimedField)(said.target.axis, said.target.field);
+    if (!declared) {
+        throw new shell_1.Refusal('assignment-field-not-declared', { axis: said.target.axis, field: said.target.field }, 'this field does not keep an assignment history. declare it first.');
+    }
+    await assertUsableValue(manager, domain, declared, said, now);
+    /*
+     * **주장은 늘 식별자로 가리킨다.** 부르는 쪽이 이름을 줘도 여기서 푼다 — 한 자리에서 풀지 않으면
+     * 어떤 길로는 이름이 그대로 들어가고, 그 줄은 이름을 바꾸는 날 끊긴다.
+     */
+    const value = await normalisedValue(manager, domain, declared, said.value);
+    const validFrom = said.validFrom ?? now;
+    const validTo = said.validTo;
+    let standing = await standingClaims(manager, domain, said.target, undefined);
+    /*
+     * ── 첫 주장이면 **바뀌기 전 값도 같이 적는다** (2026-09-23) ───────────────
+     * 새 값만 적으면 그 앞이 통째로 구멍이 된다 — 3월에 옮긴 설비의 2월을 아무 주장도 안 덮는다.
+     * 그래서 그 칸이 처음 바뀔 때 옛 값을 `[?, 이 시각)` 으로 같이 세운다. 앞끝은 비운다: 언제부터
+     * 그랬는지는 아무도 안 적었고, 시각을 지어내면 적은 적 없는 것이 적힌 것이 된다.
+     *
+     * 이것 덕분에 **아무것도 안 눌러도 된다.** 주장이 하나도 없다는 것은 「이 칸은 한 번도 안 바뀌었다」
+     * 는 뜻이 되고, 그때는 오늘 값이 과거에도 그 값이었다. 채택이라는 절차가 필요 없어진다.
+     */
+    if (!standing.length && said.previous !== undefined && said.reason !== 'initial') {
+        await manager.save(master_value_claim_1.MasterValueClaim, {
+            domain,
+            axis: said.target.axis,
+            rowId: said.target.rowId,
+            field: said.target.field,
+            value: said.previous,
+            validFrom: null,
+            validTo: validFrom,
+            recordedAt: now,
+            reason: 'initial',
+            recorder: said.recorder
+        });
+        standing = await standingClaims(manager, domain, said.target, undefined);
+    }
+    const from = ms(validFrom);
+    const to = validTo ? ms(validTo) : undefined;
+    const overlapping = standing.filter(one => {
+        const start = one.validFrom ? ms(one.validFrom) : Number.NEGATIVE_INFINITY;
+        const end = one.validTo ? ms(one.validTo) : undefined;
+        return (to === undefined || start < to) && (end === undefined || from < end);
+    });
+    /*
+     * **읽은 뒤에 바뀌었으면 거절한다.** 부르는 쪽이 읽은 것을 주면 지금 서 있는 것과 견준다 —
+     * 다르면 그 사이에 누가 고친 것이고, 내 정정이 그 판단을 덮는다.
+     */
+    if (said.expecting) {
+        const now = new Set(overlapping.map(one => one.id));
+        const read = new Set(said.expecting);
+        const changed = now.size !== read.size || [...now].some(id => !read.has(id));
+        if (changed) {
+            throw new shell_1.Refusal('master-value-claim-superseded', { axis: said.target.axis, field: said.target.field }, 'this history changed while you were editing. read it again and decide again.');
+        }
+    }
+    for (const one of overlapping) {
+        /*
+         * 이미 물러난 것을 다시 물러나게 하려는 것은 **동시 정정**이다. 덮지 않고 거절한다.
+         */
+        if (one.supersededAt) {
+            throw new shell_1.Refusal('master-value-claim-superseded', { axis: said.target.axis, field: said.target.field }, 'this history changed while you were editing. read it again and decide again.');
+        }
+        await manager.save(master_value_claim_1.MasterValueClaim, { ...one, supersededAt: now });
+        /* 앞 조각 — 물러난 주장이 이 정정보다 먼저 시작했으면 그만큼은 그대로였다. 앞끝이 비면 「쭉」이다. */
+        if (!one.validFrom || ms(one.validFrom) < from) {
+            await manager.save(master_value_claim_1.MasterValueClaim, {
+                domain, axis: said.target.axis, rowId: said.target.rowId, field: said.target.field,
+                value: one.value ?? null, validFrom: one.validFrom, validTo: validFrom,
+                recordedAt: now, reason: 'remainder', recorder: said.recorder
+            });
+        }
+        /* 뒤 조각 — 정정이 끝난 뒤에도 그 주장이 이어졌으면 그만큼도 그대로였다. */
+        const end = one.validTo ? ms(one.validTo) : undefined;
+        if (to !== undefined && (end === undefined || end > to)) {
+            await manager.save(master_value_claim_1.MasterValueClaim, {
+                domain, axis: said.target.axis, rowId: said.target.rowId, field: said.target.field,
+                value: one.value ?? null, validFrom: validTo, validTo: one.validTo,
+                recordedAt: now, reason: 'remainder', recorder: said.recorder
+            });
+        }
+    }
+    return manager.save(master_value_claim_1.MasterValueClaim, {
+        domain, axis: said.target.axis, rowId: said.target.rowId, field: said.target.field,
+        value, validFrom, validTo, recordedAt: now, reason: said.reason, recorder: said.recorder
+    });
+}
+/**
+ * 도래한 미래 주장을 마스터 행에 옮긴다 — **앱의 주기 작업이 부른다.**
+ *
+ * ops-master 는 라이브러리라 스스로 돌지 않는다. 그 사이 본행은 낡아 있고, **정확해야 하는 소비처는
+ * 본행이 아니라 주장을 읽는다.**
+ */
+async function projectDueClaims(manager, domain, entities, now = new Date()) {
+    let moved = 0;
+    for (const { axis, entity } of entities) {
+        const fields = [...new Set(claimedFieldsOfAxis(axis))];
+        for (const field of fields) {
+            const due = await manager.find(master_value_claim_1.MasterValueClaim, {
+                where: {
+                    domain: { id: domain.id }, axis, field,
+                    supersededAt: (0, typeorm_1.IsNull)(), validFrom: (0, typeorm_1.LessThanOrEqual)(now), reason: (0, typeorm_1.Not)('remainder')
+                }
+            });
+            for (const claim of due) {
+                const current = await claimAt(manager, domain, { axis, rowId: claim.rowId, field }, { asOfBusiness: now });
+                if (!current || current.id !== claim.id) {
+                    continue;
+                }
+                const row = await manager.findOne(entity, { where: { id: claim.rowId, domain: { id: domain.id } } });
+                if (!row) {
+                    continue;
+                }
+                const next = valueOnRow(claim);
+                if (row[field] !== next) {
+                    await manager.save(entity, { ...row, [field]: next });
+                    moved++;
+                }
+            }
+        }
+    }
+    return moved;
+}
+function claimedFieldsOfAxis(axis) {
+    return master_value_claim_1.CLAIMED_FIELDS.filter(one => one.axis === axis).map(one => one.field);
+}
+/**
+ * 주장의 값을 마스터 칸이 드는 모양으로. 「선언 없음」은 `null` 이다.
+ *
+ * ⚠ **관계 칸에는 이름을 돌려준다** — 그 칸이 이름을 담기 때문이다. 식별자는 주장 안에만 있고,
+ * 그것이 이름이 바뀌어도 과거가 안 끊기는 까닭이다.
+ */
+function valueOnRow(claim) {
+    const value = claim.value;
+    if (value === null || value === undefined) {
+        return null;
+    }
+    if (Array.isArray(value.names)) {
+        return value.names;
+    }
+    const said = value;
+    return said.label ?? said.ref ?? null;
+}
+/**
+ * 값이 이 칸의 모양인가, 그리고 **우리 도메인의 것인가.**
+ *
+ * 다른 도메인의 행을 가리키면 그 도메인이 자기 자료를 고쳐도 이쪽 과거가 흔들린다. 그리고 부모
+ * 관계는 **그 시점에** 도는지 본다 — 지금 안 돌아도 그때는 돌 수 있다.
+ */
+async function assertUsableValue(manager, domain, declared, said, now) {
+    const value = said.value;
+    if (value === null || value === undefined) {
+        return;
+    }
+    if (declared.kind === 'literal') {
+        if (typeof value.literal !== 'string') {
+            throw new shell_1.Refusal('claim-value-shape', { field: declared.field }, 'this field takes the value itself, as written.');
+        }
+        return;
+    }
+    if (declared.kind === 'names') {
+        if (!Array.isArray(value.names)) {
+            throw new shell_1.Refusal('assignment-value-shape', { field: declared.field }, 'this field takes a list of names.');
+        }
+        return;
+    }
+    const ref = value.ref;
+    if (typeof ref !== 'string' || !ref) {
+        throw new shell_1.Refusal('assignment-value-shape', { field: declared.field }, 'this field points at a row, so it needs that row identifier — not its name.');
+    }
+    const axis = master_axis_1.MASTER_AXES.find(one => one.key === declared.target);
+    if (!axis) {
+        return;
+    }
+    /* 이름으로 적힌 칸도 있으므로 둘 다 찾아 본다(§`rowOf`). */
+    const pointed = await (0, assignment_write_1.rowOf)(manager, domain, declared.target, ref);
+    if (!pointed) {
+        throw new shell_1.Refusal('assignment-value-unknown', { field: declared.field, ref }, 'that row is not in this site. point at a row that is.');
+    }
+    if (declared.field === 'parentId') {
+        /*
+         * **푼 식별자로 걷는다.** 안 풀고 걸으면 이름으로 온 값은 아무 주장도 못 찾아 고리를 그냥
+         * 지나간다 — 실제로 그랬다(2026-09-22).
+         */
+        await assertNoCycleAt(manager, domain, said.target.rowId, pointed.id, said.validFrom ?? now);
+    }
+}
+/** 그 시점의 부모 사슬을 걸어 본다. 자기 자신에 닿으면 고리다. */
+async function assertNoCycleAt(manager, domain, rowId, parentRef, at) {
+    const walked = new Set([rowId]);
+    let cursor = parentRef;
+    while (cursor) {
+        if (walked.has(cursor)) {
+            throw new shell_1.Refusal('assignment-parent-cycle', { at: at.toISOString() }, 'this parent makes a loop at that moment. choose another parent.');
+        }
+        walked.add(cursor);
+        const claim = await claimAt(manager, domain, { axis: 'operationalLocation', rowId: cursor, field: 'parentId' }, { asOfBusiness: at });
+        cursor = claim ? (claim.value?.ref ?? undefined) : undefined;
+    }
+}
+/**
+ * 도입할 때 — **지금 값을 초기 상태로 적는다.**
+ *
+ * 과거를 소급해 만드는 것과 다르다. 「도입 시각에 이 값이었다는 것을 확인했다」는 주장이고, **그
+ * 전은 결측 그대로** 둔다. 이것이 없으면 **한 번도 안 옮긴 설비가 영영 이력이 빈다** — 그런 설비가
+ * 가장 많다.
+ *
+ * 이미 주장이 있는 행은 건너뛴다. 두 번 불러도 같다.
+ */
+/** 이름으로 왔든 식별자로 왔든 **식별자와 그때의 이름**으로 만든다. */
+async function normalisedValue(manager, domain, declared, value) {
+    if (!value || declared.kind !== 'relation') {
+        return value ?? null;
+    }
+    const found = await (0, assignment_write_1.rowOf)(manager, domain, declared.target, String(value.ref ?? ''));
+    return found ? { ref: found.id, label: found.name } : value;
+}
+//# sourceMappingURL=assignment-history.js.map

package/dist-server/service/assignment/assignment-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assignment-history.js","sourceRoot":"","sources":["../../../server/service/assignment/assignment-history.ts"],"names":[],"mappings":"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","sourcesContent":["import { EntityManager, IsNull, LessThanOrEqual, Not, ObjectLiteral } from 'typeorm'\nimport { Domain, Refusal } from '@things-factory/shell'\nimport { MASTER_AXES } from '../master-axis'\n\nimport { CLAIMED_FIELDS, MasterValueClaim, claimedField } from './master-value-claim'\nimport { rowOf, toClaimValue } from './assignment-write'\n\n/**\n * 주장을 남기고 읽는 규칙 — **덮어쓰지 않는다.**\n *\n * ── 정정이 양옆을 남긴다 ───────────────────────────────────────────────────\n * 겹치는 주장을 물러나게 하는 것만으로는 모자란다. `A [1일, ∞)` 에 「10~15는 B」를 정정하면 A 의\n * **앞뒤 조각을 같은 값으로 다시 주장**해야 최신 답이 `A·B·A` 가 된다. 조각도 새 주장이므로 정정 전\n * 기록시점으로 읽으면 원래 A 하나가 그대로 나온다.\n *\n * ── 동시 정정은 거절한다 ───────────────────────────────────────────────────\n * 물러나게 하려던 주장이 이미 물러나 있으면 충돌이다. **자동으로 다시 시도하지 않는다** — 덮으면\n * 한쪽의 판단이 사라진다. 다시 읽고 다시 정하는 것은 사람의 일이다.\n */\n\nexport interface ClaimAt {\n  /** 어느 업무시각의 이야기인가. */\n  asOfBusiness: Date\n  /** 어느 기록시점까지 알려진 것만 볼 것인가. 안 주면 지금까지 아는 전부다. */\n  asOfRecord?: Date\n}\n\nexport interface ClaimTarget {\n  axis: string\n  rowId: string\n  field: string\n}\n\nconst ms = (at: Date) => at.getTime()\n\n/** 그 기록시점에 서 있던 주장들 — 물러난 것은 뺀다. */\nasync function standingClaims(\n  manager: EntityManager,\n  domain: Domain,\n  target: ClaimTarget,\n  asOfRecord?: Date\n): Promise<MasterValueClaim[]> {\n  const rows = await manager.find(MasterValueClaim, {\n    where: { domain: { id: domain.id }, axis: target.axis, rowId: target.rowId, field: target.field }\n  })\n\n  const at = asOfRecord ? ms(asOfRecord) : undefined\n\n  return rows.filter(one => {\n    /* 그 시점 뒤에 적힌 주장은 그때 몰랐다. */\n    if (at !== undefined && ms(one.recordedAt) > at) return false\n\n    /* 그 시점에 이미 물러났으면 안 본다. 그 뒤에 물러난 것은 그때는 서 있었다. */\n    return !(one.supersededAt && (at === undefined || ms(one.supersededAt) <= at))\n  })\n}\n\n/**\n * 그 업무시각에 유효했던 주장.\n *\n * **없으면 `undefined` 다 — 「선언 없음」과 다르다.** 선언 없음은 `value` 가 `null` 인 주장이 있는\n * 것이고, 여기서 `undefined` 는 **그때 무엇이었는지 모른다**는 뜻이다.\n */\nexport async function claimAt(\n  manager: EntityManager,\n  domain: Domain,\n  target: ClaimTarget,\n  at: ClaimAt\n): Promise<MasterValueClaim | undefined> {\n  const standing = await standingClaims(manager, domain, target, at.asOfRecord)\n  const when = ms(at.asOfBusiness)\n\n  const covering = standing.filter(one => (!one.validFrom || ms(one.validFrom) <= when) && (!one.validTo || when < ms(one.validTo)))\n\n  if (covering.length > 1) {\n    throw new Refusal(\n      'master-value-claim-conflict',\n      { axis: target.axis, field: target.field, at: at.asOfBusiness.toISOString() },\n      'two assignment claims cover the same moment. fix the history before asking.'\n    )\n  }\n\n  return covering[0]\n}\n\n/**\n * 이 대상에 **주장이 한 건이라도 있나** — 창 밖의 것까지 센다.\n *\n * 창 안에 없는 것과 아예 없는 것은 다른 사실이다. 아예 없으면 이 설치본이 아직 이력을 안 쓰는\n * 것이고, 있는데 그 창을 안 덮으면 **구멍**이다. 부르는 쪽이 둘을 다르게 다뤄야 해서 따로 묻는다.\n */\nexport async function hasAssignmentHistory(\n  manager: EntityManager,\n  domain: Domain,\n  target: ClaimTarget\n): Promise<boolean> {\n  const count = await manager.count(MasterValueClaim, {\n    where: { domain: { id: domain.id }, axis: target.axis, rowId: target.rowId, field: target.field }\n  })\n\n  return count > 0\n}\n\n/** 한 창을 덮는 주장들 — **계산 구간을 나눌 경계**가 여기서 나온다. 시작 시각 순이다. */\nexport async function claimsDuring(\n  manager: EntityManager,\n  domain: Domain,\n  target: ClaimTarget,\n  window: { from: Date; to: Date },\n  asOfRecord?: Date\n): Promise<MasterValueClaim[]> {\n  const standing = await standingClaims(manager, domain, target, asOfRecord)\n  const from = ms(window.from)\n  const to = ms(window.to)\n\n  return standing\n    .filter(one => (!one.validFrom || ms(one.validFrom) < to) && (!one.validTo || from < ms(one.validTo)))\n    .sort((a, b) => (a.validFrom ? ms(a.validFrom) : -Infinity) - (b.validFrom ? ms(b.validFrom) : -Infinity))\n}\n\nexport interface RecordClaim {\n  target: ClaimTarget\n  value: Record<string, unknown> | null\n  /** 언제부터 그러한가. 안 주면 지금부터다 — 그 기본값이 곧 「지금부터」라는 주장이다. */\n  validFrom?: Date\n  /** 언제까지. 정정에서만 쓴다. */\n  validTo?: Date\n  reason: 'initial' | 'change' | 'correction'\n  recorder?: unknown\n  /**\n   * 바뀌기 전 값. **첫 주장일 때만 쓴다** — 그 앞을 덮는 줄을 같이 세운다.\n   *\n   * 부르는 쪽이 같은 트랜잭션에서 이미 알고 있는 값이다(`claimAssignmentChanges`).\n   */\n  previous?: Record<string, unknown> | null\n  /**\n   * 내가 읽었을 때 서 있던 주장들의 id.\n   *\n   * 주면 **그 사이에 누가 바꿨는지** 본다 — 화면에서 읽고 고치는 동안 다른 사람이 같은 구간을\n   * 정정했으면 내 정정이 그것을 덮는다. 덮지 않고 거절한다.\n   */\n  expecting?: readonly string[]\n}\n\n/**\n * 주장을 남긴다. **정정이면 겹치는 것을 물러나게 하고 앞뒤 조각을 다시 주장한다.**\n *\n * 부르는 쪽이 마스터 변경과 **같은 트랜잭션**으로 부른다 — 갈라지면 값은 바뀌고 이력은 없는 상태가\n * 생긴다.\n */\nexport async function recordClaim(\n  manager: EntityManager,\n  domain: Domain,\n  said: RecordClaim,\n  now = new Date()\n): Promise<MasterValueClaim> {\n  const declared = claimedField(said.target.axis, said.target.field)\n\n  if (!declared) {\n    throw new Refusal(\n      'assignment-field-not-declared',\n      { axis: said.target.axis, field: said.target.field },\n      'this field does not keep an assignment history. declare it first.'\n    )\n  }\n\n  await assertUsableValue(manager, domain, declared, said, now)\n\n  /*\n   * **주장은 늘 식별자로 가리킨다.** 부르는 쪽이 이름을 줘도 여기서 푼다 — 한 자리에서 풀지 않으면\n   * 어떤 길로는 이름이 그대로 들어가고, 그 줄은 이름을 바꾸는 날 끊긴다.\n   */\n  const value = await normalisedValue(manager, domain, declared, said.value)\n\n  const validFrom = said.validFrom ?? now\n  const validTo = said.validTo\n  let standing = await standingClaims(manager, domain, said.target, undefined)\n\n  /*\n   * ── 첫 주장이면 **바뀌기 전 값도 같이 적는다** (2026-09-23) ───────────────\n   * 새 값만 적으면 그 앞이 통째로 구멍이 된다 — 3월에 옮긴 설비의 2월을 아무 주장도 안 덮는다.\n   * 그래서 그 칸이 처음 바뀔 때 옛 값을 `[?, 이 시각)` 으로 같이 세운다. 앞끝은 비운다: 언제부터\n   * 그랬는지는 아무도 안 적었고, 시각을 지어내면 적은 적 없는 것이 적힌 것이 된다.\n   *\n   * 이것 덕분에 **아무것도 안 눌러도 된다.** 주장이 하나도 없다는 것은 「이 칸은 한 번도 안 바뀌었다」\n   * 는 뜻이 되고, 그때는 오늘 값이 과거에도 그 값이었다. 채택이라는 절차가 필요 없어진다.\n   */\n  if (!standing.length && said.previous !== undefined && said.reason !== 'initial') {\n    await manager.save(MasterValueClaim, {\n      domain,\n      axis: said.target.axis,\n      rowId: said.target.rowId,\n      field: said.target.field,\n      value: said.previous,\n      validFrom: null,\n      validTo: validFrom,\n      recordedAt: now,\n      reason: 'initial',\n      recorder: said.recorder\n    } as Partial<MasterValueClaim>)\n\n    standing = await standingClaims(manager, domain, said.target, undefined)\n  }\n  const from = ms(validFrom)\n  const to = validTo ? ms(validTo) : undefined\n\n  const overlapping = standing.filter(one => {\n    const start = one.validFrom ? ms(one.validFrom) : Number.NEGATIVE_INFINITY\n    const end = one.validTo ? ms(one.validTo) : undefined\n\n    return (to === undefined || start < to) && (end === undefined || from < end)\n  })\n\n  /*\n   * **읽은 뒤에 바뀌었으면 거절한다.** 부르는 쪽이 읽은 것을 주면 지금 서 있는 것과 견준다 —\n   * 다르면 그 사이에 누가 고친 것이고, 내 정정이 그 판단을 덮는다.\n   */\n  if (said.expecting) {\n    const now = new Set(overlapping.map(one => one.id))\n    const read = new Set(said.expecting)\n    const changed = now.size !== read.size || [...now].some(id => !read.has(id))\n\n    if (changed) {\n      throw new Refusal(\n        'master-value-claim-superseded',\n        { axis: said.target.axis, field: said.target.field },\n        'this history changed while you were editing. read it again and decide again.'\n      )\n    }\n  }\n\n  for (const one of overlapping) {\n    /*\n     * 이미 물러난 것을 다시 물러나게 하려는 것은 **동시 정정**이다. 덮지 않고 거절한다.\n     */\n    if (one.supersededAt) {\n      throw new Refusal(\n        'master-value-claim-superseded',\n        { axis: said.target.axis, field: said.target.field },\n        'this history changed while you were editing. read it again and decide again.'\n      )\n    }\n\n    await manager.save(MasterValueClaim, { ...one, supersededAt: now })\n\n    /* 앞 조각 — 물러난 주장이 이 정정보다 먼저 시작했으면 그만큼은 그대로였다. 앞끝이 비면 「쭉」이다. */\n    if (!one.validFrom || ms(one.validFrom) < from) {\n      await manager.save(MasterValueClaim, {\n        domain, axis: said.target.axis, rowId: said.target.rowId, field: said.target.field,\n        value: one.value ?? null, validFrom: one.validFrom, validTo: validFrom,\n        recordedAt: now, reason: 'remainder', recorder: said.recorder\n      } as Partial<MasterValueClaim>)\n    }\n\n    /* 뒤 조각 — 정정이 끝난 뒤에도 그 주장이 이어졌으면 그만큼도 그대로였다. */\n    const end = one.validTo ? ms(one.validTo) : undefined\n\n    if (to !== undefined && (end === undefined || end > to)) {\n      await manager.save(MasterValueClaim, {\n        domain, axis: said.target.axis, rowId: said.target.rowId, field: said.target.field,\n        value: one.value ?? null, validFrom: validTo as Date, validTo: one.validTo,\n        recordedAt: now, reason: 'remainder', recorder: said.recorder\n      } as Partial<MasterValueClaim>)\n    }\n  }\n\n  return manager.save(MasterValueClaim, {\n    domain, axis: said.target.axis, rowId: said.target.rowId, field: said.target.field,\n    value, validFrom, validTo, recordedAt: now, reason: said.reason, recorder: said.recorder\n  } as Partial<MasterValueClaim>)\n}\n\n/**\n * 도래한 미래 주장을 마스터 행에 옮긴다 — **앱의 주기 작업이 부른다.**\n *\n * ops-master 는 라이브러리라 스스로 돌지 않는다. 그 사이 본행은 낡아 있고, **정확해야 하는 소비처는\n * 본행이 아니라 주장을 읽는다.**\n */\nexport async function projectDueClaims(\n  manager: EntityManager,\n  domain: Domain,\n  entities: { axis: string; entity: Function }[],\n  now = new Date()\n): Promise<number> {\n  let moved = 0\n\n  for (const { axis, entity } of entities) {\n    const fields = [...new Set(claimedFieldsOfAxis(axis))]\n\n    for (const field of fields) {\n      const due = await manager.find(MasterValueClaim, {\n        where: {\n          domain: { id: domain.id }, axis, field,\n          supersededAt: IsNull(), validFrom: LessThanOrEqual(now), reason: Not('remainder')\n        }\n      })\n\n      for (const claim of due) {\n        const current = await claimAt(manager, domain, { axis, rowId: claim.rowId, field }, { asOfBusiness: now })\n\n        if (!current || current.id !== claim.id) {\n          continue\n        }\n\n        const row = await manager.findOne(entity as never, { where: { id: claim.rowId, domain: { id: domain.id } } } as never)\n\n        if (!row) {\n          continue\n        }\n\n        const next = valueOnRow(claim)\n\n        if ((row as Record<string, unknown>)[field] !== next) {\n          await manager.save(entity as never, { ...(row as object), [field]: next } as never)\n          moved++\n        }\n      }\n    }\n  }\n\n  return moved\n}\n\nfunction claimedFieldsOfAxis(axis: string): string[] {\n  return CLAIMED_FIELDS.filter(one => one.axis === axis).map(one => one.field)\n}\n\n/**\n * 주장의 값을 마스터 칸이 드는 모양으로. 「선언 없음」은 `null` 이다.\n *\n * ⚠ **관계 칸에는 이름을 돌려준다** — 그 칸이 이름을 담기 때문이다. 식별자는 주장 안에만 있고,\n * 그것이 이름이 바뀌어도 과거가 안 끊기는 까닭이다.\n */\nexport function valueOnRow(claim: MasterValueClaim): unknown {\n  const value = claim.value\n\n  if (value === null || value === undefined) {\n    return null\n  }\n\n  if (Array.isArray((value as { names?: unknown }).names)) {\n    return (value as { names: unknown[] }).names\n  }\n\n  const said = value as { ref?: unknown; label?: unknown }\n\n  return said.label ?? said.ref ?? null\n}\n\n/**\n * 값이 이 칸의 모양인가, 그리고 **우리 도메인의 것인가.**\n *\n * 다른 도메인의 행을 가리키면 그 도메인이 자기 자료를 고쳐도 이쪽 과거가 흔들린다. 그리고 부모\n * 관계는 **그 시점에** 도는지 본다 — 지금 안 돌아도 그때는 돌 수 있다.\n */\nasync function assertUsableValue(\n  manager: EntityManager,\n  domain: Domain,\n  declared: { axis: string; field: string; kind: 'relation' | 'names' | 'literal'; target?: string },\n  said: RecordClaim,\n  now: Date\n): Promise<void> {\n  const value = said.value\n\n  if (value === null || value === undefined) {\n    return\n  }\n\n  if (declared.kind === 'literal') {\n    if (typeof (value as { literal?: unknown }).literal !== 'string') {\n      throw new Refusal('claim-value-shape', { field: declared.field }, 'this field takes the value itself, as written.')\n    }\n\n    return\n  }\n\n  if (declared.kind === 'names') {\n    if (!Array.isArray((value as { names?: unknown }).names)) {\n      throw new Refusal('assignment-value-shape', { field: declared.field }, 'this field takes a list of names.')\n    }\n\n    return\n  }\n\n  const ref = (value as { ref?: unknown }).ref\n\n  if (typeof ref !== 'string' || !ref) {\n    throw new Refusal(\n      'assignment-value-shape',\n      { field: declared.field },\n      'this field points at a row, so it needs that row identifier — not its name.'\n    )\n  }\n\n  const axis = MASTER_AXES.find(one => one.key === declared.target)\n\n  if (!axis) {\n    return\n  }\n\n  /* 이름으로 적힌 칸도 있으므로 둘 다 찾아 본다(§`rowOf`). */\n  const pointed = await rowOf(manager, domain, declared.target, ref)\n\n  if (!pointed) {\n    throw new Refusal(\n      'assignment-value-unknown',\n      { field: declared.field, ref },\n      'that row is not in this site. point at a row that is.'\n    )\n  }\n\n  if (declared.field === 'parentId') {\n    /*\n     * **푼 식별자로 걷는다.** 안 풀고 걸으면 이름으로 온 값은 아무 주장도 못 찾아 고리를 그냥\n     * 지나간다 — 실제로 그랬다(2026-09-22).\n     */\n    await assertNoCycleAt(manager, domain, said.target.rowId, pointed.id, said.validFrom ?? now)\n  }\n}\n\n/** 그 시점의 부모 사슬을 걸어 본다. 자기 자신에 닿으면 고리다. */\nasync function assertNoCycleAt(\n  manager: EntityManager,\n  domain: Domain,\n  rowId: string,\n  parentRef: string,\n  at: Date\n): Promise<void> {\n  const walked = new Set<string>([rowId])\n  let cursor: string | undefined = parentRef\n\n  while (cursor) {\n    if (walked.has(cursor)) {\n      throw new Refusal(\n        'assignment-parent-cycle',\n        { at: at.toISOString() },\n        'this parent makes a loop at that moment. choose another parent.'\n      )\n    }\n\n    walked.add(cursor)\n\n    const claim = await claimAt(manager, domain, { axis: 'operationalLocation', rowId: cursor, field: 'parentId' }, { asOfBusiness: at })\n\n    cursor = claim ? ((claim.value as { ref?: string } | null)?.ref ?? undefined) : undefined\n  }\n}\n\n/**\n * 도입할 때 — **지금 값을 초기 상태로 적는다.**\n *\n * 과거를 소급해 만드는 것과 다르다. 「도입 시각에 이 값이었다는 것을 확인했다」는 주장이고, **그\n * 전은 결측 그대로** 둔다. 이것이 없으면 **한 번도 안 옮긴 설비가 영영 이력이 빈다** — 그런 설비가\n * 가장 많다.\n *\n * 이미 주장이 있는 행은 건너뛴다. 두 번 불러도 같다.\n */\n\n/** 이름으로 왔든 식별자로 왔든 **식별자와 그때의 이름**으로 만든다. */\nasync function normalisedValue(\n  manager: EntityManager,\n  domain: Domain,\n  declared: { kind: 'relation' | 'names' | 'literal'; target?: string },\n  value: Record<string, unknown> | null | undefined\n): Promise<Record<string, unknown> | null> {\n  if (!value || declared.kind !== 'relation') {\n    return value ?? null\n  }\n\n  const found = await rowOf(manager, domain, declared.target, String((value as { ref?: unknown }).ref ?? ''))\n\n  return found ? { ref: found.id, label: found.name } : value\n}\n"]}

package/dist-server/service/assignment/assignment-write.d.ts

@@ -0,0 +1,42 @@
+import { EntityManager, ObjectLiteral } from 'typeorm';
+import { Domain } from '@things-factory/shell';
+import { claimedField } from './master-value-claim';
+/**
+ * 그리드가 보낸 변경에서 **배정·선언 칸을 골라 주장으로 남긴다.**
+ *
+ * ── 왜 본행을 되돌려 놓나 ──────────────────────────────────────────────────
+ * 적용 시각이 미래면 **본행은 그대로여야 한다.** 그리드는 값을 보냈지만 그것은 「다음 달부터」라는
+ * 뜻이고, 오늘의 값이 아니다. 그래서 `keepOnRow` 로 옛 값을 되돌려 저장에 얹는다 — 도래하면
+ * `projectDueClaims` 가 옮긴다.
+ *
+ * ── 마스터 변경과 한 트랜잭션이다 ──────────────────────────────────────────
+ * 부르는 쪽이 `saveMasterPatches` 안이므로 같은 `manager` 다. 갈라지면 값은 바뀌고 이력은 없는
+ * 상태가 생긴다.
+ */
+export declare function claimAssignmentChanges(manager: EntityManager, domain: Domain, axis: string, found: ObjectLiteral, values: ObjectLiteral, user: unknown, options: {
+    appliedAt?: Date;
+    appliedKind?: 'change' | 'correction';
+    appliedUntil?: Date;
+}): Promise<{
+    keepOnRow: ObjectLiteral;
+}>;
+/**
+ * 마스터 칸의 값 → 주장의 값. 「선언 없음」은 `null` 이다.
+ *
+ * ⚠ **관계 칸은 UUID 가 아니라 이름을 담는다.** `ops_equipment.home_location` 에 `UNCOIL-01` 이
+ * 들어 있고, `parentId` 는 id 일 수도 이름일 수도 있다(이 제품의 규약). 처음에 칸 값을 그대로
+ * 식별자로 썼다가 **정상 편집이 전부 거절됐다**(2026-09-22, 화면에서 드러남).
+ *
+ * 그래서 여기서 **가리키는 행을 찾아 식별자와 그때의 이름을 함께 담는다.** 마스터 칸은 그대로
+ * 이름을 들고, 주장은 이름이 바뀌어도 안 끊긴다.
+ */
+export declare function toClaimValue(manager: EntityManager, domain: Domain, declared: {
+    kind: 'relation' | 'names' | 'literal';
+    target?: string;
+}, value: unknown): Promise<Record<string, unknown> | null>;
+/** 이름으로도 id 로도 찾는다 — 이 제품의 관계 칸이 둘 다 담는다. */
+export declare function rowOf(manager: EntityManager, domain: Domain, targetAxis: string | undefined, given: string): Promise<{
+    id: string;
+    name: string;
+} | undefined>;
+export { claimedField };

package/dist-server/service/assignment/assignment-write.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.claimedField = void 0;
+exports.claimAssignmentChanges = claimAssignmentChanges;
+exports.toClaimValue = toClaimValue;
+exports.rowOf = rowOf;
+const master_value_claim_1 = require("./master-value-claim");
+Object.defineProperty(exports, "claimedField", { enumerable: true, get: function () { return master_value_claim_1.claimedField; } });
+const master_axis_1 = require("../master-axis");
+const assignment_history_1 = require("./assignment-history");
+/**
+ * 그리드가 보낸 변경에서 **배정·선언 칸을 골라 주장으로 남긴다.**
+ *
+ * ── 왜 본행을 되돌려 놓나 ──────────────────────────────────────────────────
+ * 적용 시각이 미래면 **본행은 그대로여야 한다.** 그리드는 값을 보냈지만 그것은 「다음 달부터」라는
+ * 뜻이고, 오늘의 값이 아니다. 그래서 `keepOnRow` 로 옛 값을 되돌려 저장에 얹는다 — 도래하면
+ * `projectDueClaims` 가 옮긴다.
+ *
+ * ── 마스터 변경과 한 트랜잭션이다 ──────────────────────────────────────────
+ * 부르는 쪽이 `saveMasterPatches` 안이므로 같은 `manager` 다. 갈라지면 값은 바뀌고 이력은 없는
+ * 상태가 생긴다.
+ */
+async function claimAssignmentChanges(manager, domain, axis, found, values, user, options) {
+    const keepOnRow = {};
+    const fields = master_value_claim_1.CLAIMED_FIELDS.filter(one => one.axis === axis);
+    if (!fields.length) {
+        return { keepOnRow };
+    }
+    const now = new Date();
+    const appliedAt = options.appliedAt ?? now;
+    const future = appliedAt.getTime() > now.getTime();
+    for (const declared of fields) {
+        if (!(declared.field in values)) {
+            continue;
+        }
+        const next = values[declared.field];
+        /* 안 바뀐 칸은 주장을 남기지 않는다 — 같은 값을 다시 적으면 이력이 뜻 없이 길어진다. */
+        if (sameValue(found[declared.field], next)) {
+            continue;
+        }
+        await (0, assignment_history_1.recordClaim)(manager, domain, {
+            target: { axis, rowId: String(found.id), field: declared.field },
+            value: await toClaimValue(manager, domain, declared, next),
+            /* 바뀌기 전 값 — 첫 주장이면 그 앞을 덮는 줄이 같이 선다(§`recordClaim`). */
+            previous: await toClaimValue(manager, domain, declared, found[declared.field]),
+            validFrom: appliedAt,
+            validTo: options.appliedUntil,
+            reason: options.appliedKind === 'correction' ? 'correction' : 'change',
+            recorder: user
+        }, now);
+        if (future) {
+            keepOnRow[declared.field] = found[declared.field] ?? null;
+        }
+    }
+    return { keepOnRow };
+}
+/**
+ * 마스터 칸의 값 → 주장의 값. 「선언 없음」은 `null` 이다.
+ *
+ * ⚠ **관계 칸은 UUID 가 아니라 이름을 담는다.** `ops_equipment.home_location` 에 `UNCOIL-01` 이
+ * 들어 있고, `parentId` 는 id 일 수도 이름일 수도 있다(이 제품의 규약). 처음에 칸 값을 그대로
+ * 식별자로 썼다가 **정상 편집이 전부 거절됐다**(2026-09-22, 화면에서 드러남).
+ *
+ * 그래서 여기서 **가리키는 행을 찾아 식별자와 그때의 이름을 함께 담는다.** 마스터 칸은 그대로
+ * 이름을 들고, 주장은 이름이 바뀌어도 안 끊긴다.
+ */
+async function toClaimValue(manager, domain, declared, value) {
+    if (value === null || value === undefined || value === '') {
+        return null;
+    }
+    /* 값 그 자체인 칸 — 가리키는 것이 없으므로 푸는 일도 없다. */
+    if (declared.kind === 'literal') {
+        return { literal: String(value) };
+    }
+    if (declared.kind === 'names') {
+        return { names: Array.isArray(value) ? value.map(String) : [String(value)] };
+    }
+    const found = await rowOf(manager, domain, declared.target, String(value));
+    /* 못 찾으면 그대로 담는다 — 검증이 그 다음에 거절한다. 여기서 지어내지 않는다. */
+    return found ? { ref: found.id, label: found.name } : { ref: String(value) };
+}
+/** 이름으로도 id 로도 찾는다 — 이 제품의 관계 칸이 둘 다 담는다. */
+async function rowOf(manager, domain, targetAxis, given) {
+    const axis = master_axis_1.MASTER_AXES.find(one => one.key === targetAxis);
+    if (!axis) {
+        return undefined;
+    }
+    const byId = UUID.test(given)
+        ? await manager.findOne(axis.entity, { where: { id: given, domain: { id: domain.id } } })
+        : undefined;
+    const found = byId ?? (await manager.findOne(axis.entity, { where: { name: given, domain: { id: domain.id } } }));
+    return found;
+}
+const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function sameValue(before, after) {
+    if (Array.isArray(before) || Array.isArray(after)) {
+        return JSON.stringify(before ?? null) === JSON.stringify(after ?? null);
+    }
+    return (before ?? null) === (after ?? null);
+}
+//# sourceMappingURL=assignment-write.js.map

package/dist-server/service/assignment/assignment-write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assignment-write.js","sourceRoot":"","sources":["../../../server/service/assignment/assignment-write.ts"],"names":[],"mappings":"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","sourcesContent":["import { EntityManager, ObjectLiteral } from 'typeorm'\nimport { Domain } from '@things-factory/shell'\n\nimport { CLAIMED_FIELDS, claimedField } from './master-value-claim'\nimport { MASTER_AXES } from '../master-axis'\nimport { recordClaim } from './assignment-history'\n\n/**\n * 그리드가 보낸 변경에서 **배정·선언 칸을 골라 주장으로 남긴다.**\n *\n * ── 왜 본행을 되돌려 놓나 ──────────────────────────────────────────────────\n * 적용 시각이 미래면 **본행은 그대로여야 한다.** 그리드는 값을 보냈지만 그것은 「다음 달부터」라는\n * 뜻이고, 오늘의 값이 아니다. 그래서 `keepOnRow` 로 옛 값을 되돌려 저장에 얹는다 — 도래하면\n * `projectDueClaims` 가 옮긴다.\n *\n * ── 마스터 변경과 한 트랜잭션이다 ──────────────────────────────────────────\n * 부르는 쪽이 `saveMasterPatches` 안이므로 같은 `manager` 다. 갈라지면 값은 바뀌고 이력은 없는\n * 상태가 생긴다.\n */\nexport async function claimAssignmentChanges(\n  manager: EntityManager,\n  domain: Domain,\n  axis: string,\n  found: ObjectLiteral,\n  values: ObjectLiteral,\n  user: unknown,\n  options: { appliedAt?: Date; appliedKind?: 'change' | 'correction'; appliedUntil?: Date }\n): Promise<{ keepOnRow: ObjectLiteral }> {\n  const keepOnRow: ObjectLiteral = {}\n  const fields = CLAIMED_FIELDS.filter(one => one.axis === axis)\n\n  if (!fields.length) {\n    return { keepOnRow }\n  }\n\n  const now = new Date()\n  const appliedAt = options.appliedAt ?? now\n  const future = appliedAt.getTime() > now.getTime()\n\n  for (const declared of fields) {\n    if (!(declared.field in values)) {\n      continue\n    }\n\n    const next = values[declared.field]\n\n    /* 안 바뀐 칸은 주장을 남기지 않는다 — 같은 값을 다시 적으면 이력이 뜻 없이 길어진다. */\n    if (sameValue(found[declared.field], next)) {\n      continue\n    }\n\n    await recordClaim(\n      manager,\n      domain,\n      {\n        target: { axis, rowId: String(found.id), field: declared.field },\n        value: await toClaimValue(manager, domain, declared, next),\n        /* 바뀌기 전 값 — 첫 주장이면 그 앞을 덮는 줄이 같이 선다(§`recordClaim`). */\n        previous: await toClaimValue(manager, domain, declared, found[declared.field]),\n        validFrom: appliedAt,\n        validTo: options.appliedUntil,\n        reason: options.appliedKind === 'correction' ? 'correction' : 'change',\n        recorder: user\n      },\n      now\n    )\n\n    if (future) {\n      keepOnRow[declared.field] = found[declared.field] ?? null\n    }\n  }\n\n  return { keepOnRow }\n}\n\n/**\n * 마스터 칸의 값 → 주장의 값. 「선언 없음」은 `null` 이다.\n *\n * ⚠ **관계 칸은 UUID 가 아니라 이름을 담는다.** `ops_equipment.home_location` 에 `UNCOIL-01` 이\n * 들어 있고, `parentId` 는 id 일 수도 이름일 수도 있다(이 제품의 규약). 처음에 칸 값을 그대로\n * 식별자로 썼다가 **정상 편집이 전부 거절됐다**(2026-09-22, 화면에서 드러남).\n *\n * 그래서 여기서 **가리키는 행을 찾아 식별자와 그때의 이름을 함께 담는다.** 마스터 칸은 그대로\n * 이름을 들고, 주장은 이름이 바뀌어도 안 끊긴다.\n */\nexport async function toClaimValue(\n  manager: EntityManager,\n  domain: Domain,\n  declared: { kind: 'relation' | 'names' | 'literal'; target?: string },\n  value: unknown\n): Promise<Record<string, unknown> | null> {\n  if (value === null || value === undefined || value === '') {\n    return null\n  }\n\n  /* 값 그 자체인 칸 — 가리키는 것이 없으므로 푸는 일도 없다. */\n  if (declared.kind === 'literal') {\n    return { literal: String(value) }\n  }\n\n  if (declared.kind === 'names') {\n    return { names: Array.isArray(value) ? value.map(String) : [String(value)] }\n  }\n\n  const found = await rowOf(manager, domain, declared.target, String(value))\n\n  /* 못 찾으면 그대로 담는다 — 검증이 그 다음에 거절한다. 여기서 지어내지 않는다. */\n  return found ? { ref: found.id, label: found.name } : { ref: String(value) }\n}\n\n/** 이름으로도 id 로도 찾는다 — 이 제품의 관계 칸이 둘 다 담는다. */\nexport async function rowOf(\n  manager: EntityManager,\n  domain: Domain,\n  targetAxis: string | undefined,\n  given: string\n): Promise<{ id: string; name: string } | undefined> {\n  const axis = MASTER_AXES.find(one => one.key === targetAxis)\n\n  if (!axis) {\n    return undefined\n  }\n\n  const byId = UUID.test(given)\n    ? await manager.findOne(axis.entity as never, { where: { id: given, domain: { id: domain.id } } } as never)\n    : undefined\n\n  const found = byId ?? (await manager.findOne(axis.entity as never, { where: { name: given, domain: { id: domain.id } } } as never))\n\n  return found as unknown as { id: string; name: string } | undefined\n}\n\nconst UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i\n\nfunction sameValue(before: unknown, after: unknown): boolean {\n  if (Array.isArray(before) || Array.isArray(after)) {\n    return JSON.stringify(before ?? null) === JSON.stringify(after ?? null)\n  }\n\n  return (before ?? null) === (after ?? null)\n}\n\nexport { claimedField }\n"]}