@operato/ops-contract 0.9.20 → 0.9.23

package/dist/contract.js

@@ -1112,7 +1112,7 @@ export const OP_EVENT = {
      * 승인은 자재를 움직이지 않는다. 자재가 트윈 밖으로 나가는 것은 EPCIS `shipping` 사건이다. 둘을 한 사건으로
      * 접지 않는다 — 승인됐는데 안 나간 배치가 트윈이 보여야 할 상태다.
      */
-    materialLot: 'material-lot.status',
+    materialLot: 'material-lot.status', // 레코드: { lotId(표준 MaterialLotID = ItemState.epc 의 값), status, decidedBy?, reason?, decidedAt? }
     /**
      * **이 목록이 전부다** — 연결된 시스템이 현재 목록을 한 바퀴 다 보낸 뒤 그것을 알린다.
      *

package/dist/domain-definition.d.ts

@@ -374,3 +374,24 @@ export interface DomainDefinition {
  * 도메인 정의는 데이터 아티팩트라 로드 시점에 런타임 검증한다(컴파일타임 아님).
  */
 export declare function validateDomainDefinition(def: DomainDefinition): string[];
+export interface DomainCatalog extends DomainDefinition {
+    /** semver. 같은 업종의 정의가 고쳐지면 이것이 오른다. */
+    version: string;
+    supplier?: string;
+    standards?: string[];
+    description?: string;
+}
+/** 스토어 목록·발견용 요약 — 정의 전체를 열지 않고 고르게 한다. */
+export interface CatalogSummary {
+    id: string;
+    version: string;
+    label: string;
+    supplier?: string;
+}
+/**
+ * 배포 아티팩트 검증 = 정의 검증 + 판 번호.
+ *
+ * 정의의 참조무결성은 `validateDomainDefinition` 이 소유한다 — 여기서 다시 쓰지 않는다. 위반 목록을
+ * 돌려주고, 빈 배열이 유효다.
+ */
+export declare function validateCatalog(cat: DomainCatalog): string[];

package/dist/domain-definition.js

@@ -3,8 +3,8 @@
  * 커널이 "무엇이 있고 어떻게 흐르나"(타입 + 공정 route/BOM)를 **데이터로** 받는 형식. zero-dep(자기 타입).
  *
  * 특정 공정이 커널 코드에 하드코딩되던 것을 이 데이터 계약으로 대체한다(design/plans/domain-catalog-layering.md).
- * 스토어 패키지 `@operato/twin-catalog` 가 이 타입을 import type { EffectivePeriod } from './contract.ts'
-import 해 스토어 메타(version/supplier)를 얹어 배포한다(catalog → kernel 의존).
+ * 판을 붙여 주고받는 꼴은 이 파일 아래쪽의 `DomainCatalog` 다 — 전에는 `@operato/twin-catalog` 라는
+ * 별도 패키지였고, 2026-09-17 에 여기로 접었다.
  * 표준 앵커: GS1 EPCIS 2.0(bizStep) · ISA-95(WorkCenter·OperationsDefinition·BOM) · ISO 55000(Asset).
  */
 /**
@@ -136,3 +136,17 @@ export function validateDomainDefinition(def) {
     }
     return v;
 }
+const CATALOG_SEMVER = /^\d+\.\d+\.\d+([-+].+)?$/;
+/**
+ * 배포 아티팩트 검증 = 정의 검증 + 판 번호.
+ *
+ * 정의의 참조무결성은 `validateDomainDefinition` 이 소유한다 — 여기서 다시 쓰지 않는다. 위반 목록을
+ * 돌려주고, 빈 배열이 유효다.
+ */
+export function validateCatalog(cat) {
+    const v = validateDomainDefinition(cat);
+    if (typeof cat?.version !== 'string' || !CATALOG_SEMVER.test(cat?.version || '')) {
+        v.push(`version semver 아님: ${cat?.version}`);
+    }
+    return v;
+}

package/dist/mes-profile.d.ts

@@ -4,12 +4,6 @@ export declare const MES_BIZSTEP: {
     readonly receiving: "urn:epcglobal:cbv:bizstep:receiving";
     readonly producing: "urn:epcglobal:cbv:bizstep:commissioning";
     readonly storing: "urn:epcglobal:cbv:bizstep:storing";
-    /**
-     * **출하** — CBV `shipping`: 물품이 시설을 떠난다. 자재를 트윈 밖으로 내는 것은 이 사건이다(disposition
-     * `in_transit`, readPoint = 출하 dock). 출하 **승인**은 이 사건이 아니라 로트 상태(`OP_EVENT.materialLot`)다 —
-     * 승인됐는데 안 나간 배치가 보여야 한다(2026-09-16, ADR-0046 곁).
-     */
-    readonly shipping: "urn:epcglobal:cbv:bizstep:shipping";
 };
 /** 작업지시(Work Order) = 생산 오더 거래 유형. */
 export declare const BTT_PRODORDER = "urn:epcglobal:cbv:btt:prodorder";

package/dist/mes-profile.js

@@ -2,13 +2,7 @@
 export const MES_BIZSTEP = {
     receiving: 'urn:epcglobal:cbv:bizstep:receiving', // 원자재 수령
     producing: 'urn:epcglobal:cbv:bizstep:commissioning', // 생산(제품 최초 생성)
-    storing: 'urn:epcglobal:cbv:bizstep:storing', // 완제품 저장
-    /**
-     * **출하** — CBV `shipping`: 물품이 시설을 떠난다. 자재를 트윈 밖으로 내는 것은 이 사건이다(disposition
-     * `in_transit`, readPoint = 출하 dock). 출하 **승인**은 이 사건이 아니라 로트 상태(`OP_EVENT.materialLot`)다 —
-     * 승인됐는데 안 나간 배치가 보여야 한다(2026-09-16, ADR-0046 곁).
-     */
-    shipping: 'urn:epcglobal:cbv:bizstep:shipping'
+    storing: 'urn:epcglobal:cbv:bizstep:storing' // 완제품 저장
 };
 /** 작업지시(Work Order) = 생산 오더 거래 유형. */
 export const BTT_PRODORDER = 'urn:epcglobal:cbv:btt:prodorder';

package/dist/operational-ingest.d.ts

@@ -65,6 +65,12 @@ export interface ObjectShape {
  * 거부했다. 자원(설비·사람·자산)을 먼저 보고, 작업을 오더보다 먼저 본다.
  */
 export declare function operationalKindOf(record: unknown): OperationalKind | undefined;
+/**
+ * 어느 갈래도 아닐 때의 거절 문장 — **표에서 세어 만든다.** 손으로 적은 목록은 다섯에서 멈춰 있었다(kind 는 열둘).
+ * 그 문장은 보내는 쪽이 실제로 읽는 것이라, 빠진 갈래는 「애초에 못 보내는 것」으로 읽힌다(2026-09-16, 인티그레이션
+ * 레인 측정). 여기서 만들면 kind 가 늘 때 문장도 함께 는다.
+ */
+export declare function unknownKindReason(): string;
 /** 이 레코드가 운영 사실인가 — 호스트의 라우팅이 묻는 자리. */
 /**
  * 그 종류의 사실을 **무엇이 가리키나** — 선언된 identity 칸의 이름.

package/dist/operational-ingest.js

@@ -323,17 +323,19 @@ const SPECS = {
     /*
      * **로트 상태** — ISA-95 `MaterialLot.Status`. 출하 승인(batch release)이 들어오는 문(§`OP_EVENT.materialLot`).
      *
-     * `disposition`(subjectId + decision) 과 필드가 겹치지 않는다 — 여기는 `epc` + `status`. 상태 낱말은 열려
-     * 있어 enum 이 없다(오더 상태와 같은 규율). 로트 전체의 사실이므로 `subLotId` 는 받지 않는다 — 부분마다 다른
-     * 상태가 필요해지면 그것은 다른 사실이다.
+     * `disposition`(subjectId + decision) 과 필드가 겹치지 않는다 — 여기는 `lotId` + `status`. 정체 이름이 표준
+     * `MaterialLotID` 인 이유가 하나 더 있다: 이 문은 `epc` 를 든 레코드를 EPCIS 어휘로 보고 받지 않는다
+     * (§`operationalKindOf`). 값은 로트의 식별자(`ItemState.epc` 와 같은 값)다. 상태 낱말은 열려 있어 enum 이
+     * 없다(오더 상태와 같은 규율). 로트 전체의 사실이므로 부분(`subLotId`)은 받지 않는다 — 부분마다 다른 상태가
+     * 필요해지면 그것은 다른 사실이다.
      */
     'material-lot': {
         eventType: OP_EVENT.materialLot,
-        match: ['epc', 'status'],
+        match: ['lotId', 'status'],
         matchOrder: 85,
-        identity: 'epc',
-        required: ['epc', 'status'],
-        fields: { epc: 'string', status: 'string', decidedBy: 'string', reason: 'string', decidedAt: 'string', recordTime: 'string' }
+        identity: 'lotId',
+        required: ['lotId', 'status'],
+        fields: { lotId: 'string', status: 'string', decidedBy: 'string', reason: 'string', decidedAt: 'string', recordTime: 'string' }
     },
     test: {
         eventType: OP_EVENT.test,
@@ -425,6 +427,20 @@ export function operationalKindOf(record) {
     }
     return undefined;
 }
+/**
+ * 어느 갈래도 아닐 때의 거절 문장 — **표에서 세어 만든다.** 손으로 적은 목록은 다섯에서 멈춰 있었다(kind 는 열둘).
+ * 그 문장은 보내는 쪽이 실제로 읽는 것이라, 빠진 갈래는 「애초에 못 보내는 것」으로 읽힌다(2026-09-16, 인티그레이션
+ * 레인 측정). 여기서 만들면 kind 가 늘 때 문장도 함께 는다.
+ */
+export function unknownKindReason() {
+    const shapes = MATCH_ORDER.map(kind => {
+        const spec = SPECS[kind];
+        const fields = spec.match ?? [spec.identity];
+        return `${kind}: ${fields.join('+')}`;
+    });
+    // vocabulary-guard: allow 거부 이유가 계약 필드 이름을 말한다
+    return `어느 운영 사실인지 모른다 — 갈래를 정하는 필드가 필요하다(${shapes.join(' · ')}). epc 를 든 레코드는 EPCIS 문으로 간다`;
+}
 /**
  * 판정 순서 — 표의 `matchOrder` 에서 한 번만 만든다.
  *
@@ -471,10 +487,7 @@ export function ingestOperationalRecords(records, opts) {
     for (const record of arr) {
         const kind = operationalKindOf(record);
         if (!kind) {
-            rejected.push({
-                record,
-                errors: ['어느 운영 사실인지 모른다 — 정체 필드가 필요하다(taskId · moverId(+good=품질) · personId · assetId · orderId)'] // vocabulary-guard: allow 거부 이유가 계약 필드 이름을 말한다
-            });
+            rejected.push({ record, errors: [unknownKindReason()] });
             continue;
         }
         const spec = SPECS[kind];

package/dist-cjs/index.cjs

@@ -230,6 +230,8 @@ __export(index_exports, {
   transactionEvent: () => transactionEvent,
   transformationEvent: () => transformationEvent,
   unavailableVerdict: () => unavailableVerdict,
+  unknownKindReason: () => unknownKindReason,
+  validateCatalog: () => validateCatalog,
   validateDomainDefinition: () => validateDomainDefinition,
   validateEpcisEvent: () => validateEpcisEvent,
   validatePerformance: () => validatePerformance,
@@ -925,6 +927,7 @@ var OP_EVENT = {
    * 접지 않는다 — 승인됐는데 안 나간 배치가 트윈이 보여야 할 상태다.
    */
   materialLot: "material-lot.status",
+  // 레코드: { lotId(표준 MaterialLotID = ItemState.epc 의 값), status, decidedBy?, reason?, decidedAt? }
   /**
    * **이 목록이 전부다** — 연결된 시스템이 현재 목록을 한 바퀴 다 보낸 뒤 그것을 알린다.
    *
@@ -1316,14 +1319,8 @@ var MES_BIZSTEP = {
   // 원자재 수령
   producing: "urn:epcglobal:cbv:bizstep:commissioning",
   // 생산(제품 최초 생성)
-  storing: "urn:epcglobal:cbv:bizstep:storing",
+  storing: "urn:epcglobal:cbv:bizstep:storing"
   // 완제품 저장
-  /**
-   * **출하** — CBV `shipping`: 물품이 시설을 떠난다. 자재를 트윈 밖으로 내는 것은 이 사건이다(disposition
-   * `in_transit`, readPoint = 출하 dock). 출하 **승인**은 이 사건이 아니라 로트 상태(`OP_EVENT.materialLot`)다 —
-   * 승인됐는데 안 나간 배치가 보여야 한다(2026-09-16, ADR-0046 곁).
-   */
-  shipping: "urn:epcglobal:cbv:bizstep:shipping"
 };
 var BTT_PRODORDER = "urn:epcglobal:cbv:btt:prodorder";
 function sgtinUri(companyPrefix, itemRef, serial) {
@@ -2181,6 +2178,14 @@ function validateDomainDefinition(def) {
   }
   return v;
 }
+var CATALOG_SEMVER = /^\d+\.\d+\.\d+([-+].+)?$/;
+function validateCatalog(cat) {
+  const v = validateDomainDefinition(cat);
+  if (typeof cat?.version !== "string" || !CATALOG_SEMVER.test(cat?.version || "")) {
+    v.push(`version semver \uC544\uB2D8: ${cat?.version}`);
+  }
+  return v;
+}
 
 // src/energy-ingest.ts
 function isEnergyRecord(record) {
@@ -3713,17 +3718,19 @@ var SPECS = {
   /*
    * **로트 상태** — ISA-95 `MaterialLot.Status`. 출하 승인(batch release)이 들어오는 문(§`OP_EVENT.materialLot`).
    *
-   * `disposition`(subjectId + decision) 과 필드가 겹치지 않는다 — 여기는 `epc` + `status`. 상태 낱말은 열려
-   * 있어 enum 이 없다(오더 상태와 같은 규율). 로트 전체의 사실이므로 `subLotId` 는 받지 않는다 — 부분마다 다른
-   * 상태가 필요해지면 그것은 다른 사실이다.
+   * `disposition`(subjectId + decision) 과 필드가 겹치지 않는다 — 여기는 `lotId` + `status`. 정체 이름이 표준
+   * `MaterialLotID` 인 이유가 하나 더 있다: 이 문은 `epc` 를 든 레코드를 EPCIS 어휘로 보고 받지 않는다
+   * (§`operationalKindOf`). 값은 로트의 식별자(`ItemState.epc` 와 같은 값)다. 상태 낱말은 열려 있어 enum 이
+   * 없다(오더 상태와 같은 규율). 로트 전체의 사실이므로 부분(`subLotId`)은 받지 않는다 — 부분마다 다른 상태가
+   * 필요해지면 그것은 다른 사실이다.
    */
   "material-lot": {
     eventType: OP_EVENT.materialLot,
-    match: ["epc", "status"],
+    match: ["lotId", "status"],
     matchOrder: 85,
-    identity: "epc",
-    required: ["epc", "status"],
-    fields: { epc: "string", status: "string", decidedBy: "string", reason: "string", decidedAt: "string", recordTime: "string" }
+    identity: "lotId",
+    required: ["lotId", "status"],
+    fields: { lotId: "string", status: "string", decidedBy: "string", reason: "string", decidedAt: "string", recordTime: "string" }
   },
   test: {
     eventType: OP_EVENT.test,
@@ -3805,6 +3812,14 @@ function operationalKindOf(record) {
   }
   return void 0;
 }
+function unknownKindReason() {
+  const shapes = MATCH_ORDER.map((kind) => {
+    const spec = SPECS[kind];
+    const fields = spec.match ?? [spec.identity];
+    return `${kind}: ${fields.join("+")}`;
+  });
+  return `\uC5B4\uB290 \uC6B4\uC601 \uC0AC\uC2E4\uC778\uC9C0 \uBAA8\uB978\uB2E4 \u2014 \uAC08\uB798\uB97C \uC815\uD558\uB294 \uD544\uB4DC\uAC00 \uD544\uC694\uD558\uB2E4(${shapes.join(" \xB7 ")}). epc \uB97C \uB4E0 \uB808\uCF54\uB4DC\uB294 EPCIS \uBB38\uC73C\uB85C \uAC04\uB2E4`;
+}
 var MATCH_ORDER = Object.keys(SPECS).sort(
   (a, b) => (SPECS[a].matchOrder ?? 1e3) - (SPECS[b].matchOrder ?? 1e3)
 );
@@ -3822,11 +3837,7 @@ function ingestOperationalRecords(records, opts) {
   for (const record of arr) {
     const kind = operationalKindOf(record);
     if (!kind) {
-      rejected.push({
-        record,
-        errors: ["\uC5B4\uB290 \uC6B4\uC601 \uC0AC\uC2E4\uC778\uC9C0 \uBAA8\uB978\uB2E4 \u2014 \uC815\uCCB4 \uD544\uB4DC\uAC00 \uD544\uC694\uD558\uB2E4(taskId \xB7 moverId(+good=\uD488\uC9C8) \xB7 personId \xB7 assetId \xB7 orderId)"]
-        // vocabulary-guard: allow 거부 이유가 계약 필드 이름을 말한다
-      });
+      rejected.push({ record, errors: [unknownKindReason()] });
       continue;
     }
     const spec = SPECS[kind];
@@ -4790,6 +4801,8 @@ function nonEmpty(value) {
   transactionEvent,
   transformationEvent,
   unavailableVerdict,
+  unknownKindReason,
+  validateCatalog,
   validateDomainDefinition,
   validateEpcisEvent,
   validatePerformance,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@operato/ops-contract",
-  "version": "0.9.20",
+  "version": "0.9.23",
   "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",