@operato/ops-contract 0.5.0 → 0.6.0

package/dist/contract.d.ts

@@ -3256,6 +3256,8 @@ export interface TwinModelDef {
     /** parallelism = 동시 처리 수(LocationState.parallelism 참조). capacity 는 저장 용량. */
     locations: (EffectivePeriod & {
         id: string;
+        name?: string;
+        gs1Id?: string;
         type: string;
         capacity: number;
         parallelism?: number;
@@ -3269,6 +3271,7 @@ export interface TwinModelDef {
      */
     equipment: (EffectivePeriod & {
         id: string;
+        name?: string;
         kind: string;
         homeLocation: string;
         identity?: string;

package/dist/domain-definition.d.ts

@@ -133,6 +133,7 @@ export interface DurationVariability {
 export interface OperationDef extends EffectivePeriod {
     key: string;
     label: string;
+    name?: string;
     intent: OperationIntent;
     /** 오퍼레이션이 수행되는 자리 타입(LocationTypeDef.key). 커널이 locationByType 로 위치 해소. */
     locationType?: string;

package/dist/operational-ingest.js

@@ -60,6 +60,8 @@ const ASSET_STATUS = ['idle', 'in-use'];
 const SPECS = {
     task: {
         eventType: OP_EVENT.task,
+        match: ['taskId'],
+        matchOrder: 50,
         identity: 'taskId',
         /* 종류가 없으면 성과를 종류별로 모을 수 없고(선언된 시간·수율이 종류로 붙는다) 지어낼 수도 없다. */
         required: ['taskId', 'kind', 'status'],
@@ -79,6 +81,8 @@ const SPECS = {
     },
     equipment: {
         eventType: OP_EVENT.equipment,
+        match: ['moverId'],
+        matchOrder: 20,
         identity: 'moverId', // vocabulary-guard: allow 저널 와이어 필드(델타의 이름이 계약이다)
         required: ['moverId', 'kind', 'status'], // vocabulary-guard: allow 위와 같은 이유
         fields: {
@@ -94,6 +98,8 @@ const SPECS = {
     },
     person: {
         eventType: OP_EVENT.person,
+        match: ['personId'],
+        matchOrder: 30,
         identity: 'personId',
         required: ['personId', 'status'],
         fields: {
@@ -104,6 +110,8 @@ const SPECS = {
     },
     asset: {
         eventType: OP_EVENT.asset,
+        match: ['assetId'],
+        matchOrder: 40,
         identity: 'assetId',
         required: ['assetId', 'status'],
         fields: {
@@ -114,6 +122,8 @@ const SPECS = {
     },
     order: {
         eventType: OP_EVENT.order,
+        match: ['orderId'],
+        matchOrder: 60,
         identity: 'orderId',
         /*
          * 요청량·이행량을 **함께** 받는다. 없으면 리듀서가 진척을 0 으로 적는데(`requested ? … : 0`),
@@ -129,6 +139,8 @@ const SPECS = {
     },
     quality: {
         eventType: OP_EVENT.quality,
+        match: ['moverId', 'good'],
+        matchOrder: 15,
         identity: 'moverId', // vocabulary-guard: allow 저널 와이어 필드
         /* 누적 카운터가 없으면 OEE 가 양품률을 못 센다 — 판정 하나만으로는 비율이 나오지 않는다. */
         required: ['moverId', 'good', 'goodCount', 'scrapCount'], // vocabulary-guard: allow
@@ -170,6 +182,8 @@ const SPECS = {
      */
     'equipment-period': {
         eventType: OP_EVENT.equipmentPeriod,
+        match: ['moverId', 'status', 'from', 'to'],
+        matchOrder: 10,
         identity: 'moverId', // vocabulary-guard: allow 저널 와이어 필드 — 전이와 같은 이름을 쓴다
         required: ['moverId', 'status', 'from', 'to'], // vocabulary-guard: allow 위와 같은 이유
         fields: {
@@ -196,6 +210,8 @@ const SPECS = {
      */
     disposition: {
         eventType: OP_EVENT.disposition,
+        match: ['subjectId', 'decision'],
+        matchOrder: 80,
         identity: 'subjectId',
         /* 무엇을 어떻게 하기로 했나 — 둘 중 하나가 없으면 그 결정은 아무 데도 붙지 못한다. */
         required: ['subjectId', 'decision'],
@@ -207,6 +223,8 @@ const SPECS = {
     },
     test: {
         eventType: OP_EVENT.test,
+        match: ['testableObjectId'],
+        matchOrder: 70,
         identity: 'testableObjectId',
         /* 무엇을 어느 기준으로 시험했나 — 둘 중 하나가 없으면 그 결과는 아무 데도 붙지 못한다. */
         required: ['testableObjectId', 'specId'],
@@ -234,12 +252,16 @@ const SPECS = {
      */
     complete: {
         eventType: OP_EVENT.complete,
+        match: ['completeAxis'],
+        matchOrder: 100,
         identity: 'completeAxis',
         required: ['completeAxis', 'since'],
         fields: { completeAxis: 'string', since: 'string', recordTime: 'string' }
     },
     observation: {
         eventType: OP_EVENT.observation,
+        match: ['locationId', 'propertyId'],
+        matchOrder: 90,
         identity: 'locationId',
         /* 자리와 속성 — 둘 중 하나가 없으면 그 관측은 아무 데도 붙지 못한다. */
         required: ['locationId', 'propertyId'],
@@ -268,68 +290,34 @@ export function operationalKindOf(record) {
     if (!record || typeof record !== 'object')
         return undefined;
     const r = record;
-    if (r.epc !== undefined || r.meterId !== undefined || r.equipmentId !== undefined)
-        return undefined;
-    const has = (k) => typeof r[k] === 'string' && r[k].trim().length > 0;
-    /* vocabulary-guard: allow 저널 와이어 필드로 가른다 */
-    /*
-     * 구간이 있으면 **마감된 상태 구간**이지 시점의 전이가 아니다. 전이보다 먼저 본다 — 뒤에 두면
-     * 사람이 되돌아가 적은 구간이 「지금 이 상태다」로 읽혀 트윈의 상태가 과거로 끌린다.
-     */
-    if (has('moverId') && has('from') && has('to'))
-        return 'equipment-period';
-    if (has('moverId'))
-        return r.good !== undefined ? 'quality' : 'equipment';
-    if (has('personId'))
-        return 'person';
-    if (has('assetId'))
-        return 'asset';
-    if (has('taskId'))
-        return 'task'; // 작업이 든 `orderId` 는 소속(참조)이다
-    if (has('orderId'))
-        return 'order';
-    /*
-     * ── ★ **채널을 열고 들어오는 길을 내지 않았다** (2026-08-24) ─────────────────
-     * `OP_EVENT.test` 를 계약에 냈는데 이 라우팅이 `testableObjectId` 를 보지 않았다. 그래서 커넥터의
-     * 시험 결과가 **어느 통도 아니어서 조용히 버려졌다** — 거부 목록에도 남지 않았다(운영 경로를 아예
-     * 지나지 않으므로).
-     *
-     * 같은 부류가 하루에 세 번 났다: `ilmd`(매핑에 자리 없음) · 사건 시각(이름 어긋남) · 그리고 이것.
-     * **계약에 자리를 만드는 것과 그 자리로 가는 길을 내는 것은 다른 일이다.** 앞의 것만 하면 보내는
-     * 쪽에는 「실었다」로 보이고 화면에는 「없다」로 보인다.
-     *
-     * 순서상 뒤에 둔다 — 시험 결과가 작업·오더를 함께 가리킬 수 있고, 그때 그것은 **그 작업의 사실**이다.
-     */
-    if (has('testableObjectId'))
-        return 'test';
-    /*
-     * **처분** — 같은 부류가 또 났다(2026-08-30). `OP_EVENT.disposition` 을 계약에 내고 여기로 오는 길을
-     * 내지 않아, MES 가 보내면 어느 통도 아니어서 사라졌다. 위 주석이 적은 것이 **셋째**다.
-     *
-     * 시험 결과 뒤에 둔다 — 처분은 판정을 가리킬 수 있고(`specId`), 그때 정체성은 처분 대상이지
-     * 시험 대상이 아니다. 앞에 두면 판정에 딸린 처분이 시험으로 읽힌다.
-     */
-    if (has('subjectId') && has('decision'))
-        return 'disposition';
     /*
-     * ── ★ **채널을 열고 또 길을 내지 않았다** (2026-08-24) ──────────────────────
-     * `OP_EVENT.observation`(`location.measured`)을 내고 상태(`LocationState.observations`)와 조회
-     * (`observationAt`)까지 붙였는데 **이 라우팅이 `locationId` 를 보지 않았다.** 커넥터가 방의 온습도를
-     * 실어 보내면 「어느 운영 사실인지 모른다」로 거부됐다.
-     *
-     * 같은 부류를 하루에 일곱 번 만났다. 다만 이번엔 **거부되고 이유가 남았다** — 시험 결과 때는 어느
-     * 통도 아니어서 조용히 사라졌다. 그 차이가 이것을 5분 만에 찾게 했다(§`isOperationalRecord`).
-     *
-     * **둘을 함께 요구한다.** `locationId` 만으로는 자리를 말하는 다른 사실과 섞인다. 관측은 「어느
-     * 자리의 **무엇**을 쟀나」이므로 속성 없이는 담을 곳이 없다 — 그때는 받지 않는 것이 옳다.
+     * EPCIS·에너지와 겹치지 않게 본다: `epc`·`meterId` 가 있으면 그쪽 어휘이고, `equipmentId` 는 설비
+     * **에너지** 상태의 이름이다(운영 설비는 `moverId`).
      */
-    if (has('locationId') && has('propertyId'))
-        return 'observation';
-    /* 「이 목록이 전부다」 — 어느 목록인지를 스스로 말하므로 다른 사실과 섞이지 않는다. */
-    if (has('completeAxis'))
-        return 'complete';
+    if (r.epc !== undefined || r.meterId !== undefined || r.equipmentId !== undefined)
+        return undefined;
+    /* 문자열은 비어 있으면 없는 것으로 본다 — 공백만 실은 필드는 말한 것이 아니다. */
+    const present = (k) => {
+        const v = r[k];
+        if (v === undefined || v === null)
+            return false;
+        return typeof v === 'string' ? v.trim().length > 0 : true;
+    };
+    for (const kind of MATCH_ORDER) {
+        const spec = SPECS[kind];
+        const fields = spec.match ?? [spec.identity];
+        if (fields.every(present))
+            return kind;
+    }
     return undefined;
 }
+/**
+ * 판정 순서 — 표의 `matchOrder` 에서 한 번만 만든다.
+ *
+ * 좁은 것이 먼저다. 그리고 자원(설비·사람·자산)을 작업보다, 작업을 오더보다 먼저 본다 — 정체 필드는
+ * 하나만 오지 않고, 아무거나 먼저 보면 **참조를 주체로 읽는다**(설비 델타가 든 `taskId` 는 소속이다).
+ */
+const MATCH_ORDER = Object.keys(SPECS).sort((a, b) => (SPECS[a].matchOrder ?? 1000) - (SPECS[b].matchOrder ?? 1000));
 /** 이 레코드가 운영 사실인가 — 호스트의 라우팅이 묻는 자리. */
 export function isOperationalRecord(record) {
     return operationalKindOf(record) !== undefined;

package/dist-cjs/index.cjs

@@ -3165,6 +3165,8 @@ var ASSET_STATUS = ["idle", "in-use"];
 var SPECS = {
   task: {
     eventType: OP_EVENT.task,
+    match: ["taskId"],
+    matchOrder: 50,
     identity: "taskId",
     /* 종류가 없으면 성과를 종류별로 모을 수 없고(선언된 시간·수율이 종류로 붙는다) 지어낼 수도 없다. */
     required: ["taskId", "kind", "status"],
@@ -3201,6 +3203,8 @@ var SPECS = {
   },
   equipment: {
     eventType: OP_EVENT.equipment,
+    match: ["moverId"],
+    matchOrder: 20,
     identity: "moverId",
     // vocabulary-guard: allow 저널 와이어 필드(델타의 이름이 계약이다)
     required: ["moverId", "kind", "status"],
@@ -3227,6 +3231,8 @@ var SPECS = {
   },
   person: {
     eventType: OP_EVENT.person,
+    match: ["personId"],
+    matchOrder: 30,
     identity: "personId",
     required: ["personId", "status"],
     fields: {
@@ -3244,6 +3250,8 @@ var SPECS = {
   },
   asset: {
     eventType: OP_EVENT.asset,
+    match: ["assetId"],
+    matchOrder: 40,
     identity: "assetId",
     required: ["assetId", "status"],
     fields: {
@@ -3261,6 +3269,8 @@ var SPECS = {
   },
   order: {
     eventType: OP_EVENT.order,
+    match: ["orderId"],
+    matchOrder: 60,
     identity: "orderId",
     /*
      * 요청량·이행량을 **함께** 받는다. 없으면 리듀서가 진척을 0 으로 적는데(`requested ? … : 0`),
@@ -3290,6 +3300,8 @@ var SPECS = {
   },
   quality: {
     eventType: OP_EVENT.quality,
+    match: ["moverId", "good"],
+    matchOrder: 15,
     identity: "moverId",
     // vocabulary-guard: allow 저널 와이어 필드
     /* 누적 카운터가 없으면 OEE 가 양품률을 못 센다 — 판정 하나만으로는 비율이 나오지 않는다. */
@@ -3334,6 +3346,8 @@ var SPECS = {
    */
   "equipment-period": {
     eventType: OP_EVENT.equipmentPeriod,
+    match: ["moverId", "status", "from", "to"],
+    matchOrder: 10,
     identity: "moverId",
     // vocabulary-guard: allow 저널 와이어 필드 — 전이와 같은 이름을 쓴다
     required: ["moverId", "status", "from", "to"],
@@ -3368,6 +3382,8 @@ var SPECS = {
    */
   disposition: {
     eventType: OP_EVENT.disposition,
+    match: ["subjectId", "decision"],
+    matchOrder: 80,
     identity: "subjectId",
     /* 무엇을 어떻게 하기로 했나 — 둘 중 하나가 없으면 그 결정은 아무 데도 붙지 못한다. */
     required: ["subjectId", "decision"],
@@ -3386,6 +3402,8 @@ var SPECS = {
   },
   test: {
     eventType: OP_EVENT.test,
+    match: ["testableObjectId"],
+    matchOrder: 70,
     identity: "testableObjectId",
     /* 무엇을 어느 기준으로 시험했나 — 둘 중 하나가 없으면 그 결과는 아무 데도 붙지 못한다. */
     required: ["testableObjectId", "specId"],
@@ -3419,12 +3437,16 @@ var SPECS = {
    */
   complete: {
     eventType: OP_EVENT.complete,
+    match: ["completeAxis"],
+    matchOrder: 100,
     identity: "completeAxis",
     required: ["completeAxis", "since"],
     fields: { completeAxis: "string", since: "string", recordTime: "string" }
   },
   observation: {
     eventType: OP_EVENT.observation,
+    match: ["locationId", "propertyId"],
+    matchOrder: 90,
     identity: "locationId",
     /* 자리와 속성 — 둘 중 하나가 없으면 그 관측은 아무 데도 붙지 못한다. */
     required: ["locationId", "propertyId"],
@@ -3446,19 +3468,21 @@ function operationalKindOf(record) {
   if (!record || typeof record !== "object") return void 0;
   const r = record;
   if (r.epc !== void 0 || r.meterId !== void 0 || r.equipmentId !== void 0) return void 0;
-  const has = (k) => typeof r[k] === "string" && r[k].trim().length > 0;
-  if (has("moverId") && has("from") && has("to")) return "equipment-period";
-  if (has("moverId")) return r.good !== void 0 ? "quality" : "equipment";
-  if (has("personId")) return "person";
-  if (has("assetId")) return "asset";
-  if (has("taskId")) return "task";
-  if (has("orderId")) return "order";
-  if (has("testableObjectId")) return "test";
-  if (has("subjectId") && has("decision")) return "disposition";
-  if (has("locationId") && has("propertyId")) return "observation";
-  if (has("completeAxis")) return "complete";
+  const present = (k) => {
+    const v = r[k];
+    if (v === void 0 || v === null) return false;
+    return typeof v === "string" ? v.trim().length > 0 : true;
+  };
+  for (const kind of MATCH_ORDER) {
+    const spec = SPECS[kind];
+    const fields = spec.match ?? [spec.identity];
+    if (fields.every(present)) return kind;
+  }
   return void 0;
 }
+var MATCH_ORDER = Object.keys(SPECS).sort(
+  (a, b) => (SPECS[a].matchOrder ?? 1e3) - (SPECS[b].matchOrder ?? 1e3)
+);
 function isOperationalRecord(record) {
   return operationalKindOf(record) !== void 0;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@operato/ops-contract",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Operations domain contract — the standard vocabulary that producers and readers agree on (EPCIS 2.0/GS1, ISA-95, IEC 61850/ISO 50001). Types, guards, validation. No state, no engine.",
   "type": "module",
   "main": "./dist-cjs/index.cjs",