@operato/twin-kernel 0.8.2 → 0.8.4

package/dist-cjs/index.cjs

@@ -63,7 +63,7 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
-// ../ops-contract/dist/capability.js
+// node_modules/@operato/ops-contract/dist/capability.js
 var CAPABILITIES = {
   operable: {
     key: "operable",
@@ -198,7 +198,7 @@ function stateFieldsOf(caps) {
   return [...out];
 }
 
-// ../ops-contract/dist/contract.js
+// node_modules/@operato/ops-contract/dist/contract.js
 var ORDER_TERMINAL_STATUS = ["completed", "cancelled"];
 function isOrderTerminal(o) {
   const status = String(o?.status ?? "").trim().toLowerCase();
@@ -218,6 +218,32 @@ function locationStatusOf(n) {
   const r = (n.occupancy ?? 0) / cap;
   return r >= 1 ? "full" : r >= LOCATION_SATURATION_NEAR ? "near-full" : "available";
 }
+var DISPOSITION_DECISION = [
+  /** 원 규격으로 되돌린다 — 공정에 다시 들어가고, 산출물은 원 품목이다. */
+  "rework",
+  /**
+   * 쓸 수 있게 만들되 **원 규격은 아니다** — 공정에 다시 들어가지만 산출물이 원 품목이 아니다.
+   *
+   * `rework` 와 나눈 이유는 이름이 아니라 **효과**다. 되돌린 것과 고쳐 쓴 것은 산출물의 정체성이
+   * 다르고, 그것을 한 낱말로 묶으면 계보가 「원 품목을 만들었다」고 거짓을 말한다.
+   */
+  "repair",
+  /** 그대로 쓴다 — 공정도 정체성도 바뀌지 않는다. */
+  "use-as-is",
+  /**
+   * **등급을 내려 다른 품목으로 판다** — 공정에 다시 들어가지 않고, 그 자리에서 품목 정의가 바뀐다.
+   *
+   * 다른 넷과 축이 다르다. 폐기도 특채도 아니고 **자재의 품목 자체가 달라진다**(GTIN 이 바뀐다).
+   * 식품·철강·섬유에서 일상이다.
+   */
+  "regrade",
+  /** 재고에서 뺀다. */
+  "scrap",
+  /** 공급자에게 돌려보낸다 — 재고에서 빠지되 폐기와 다른 사실이다. */
+  "return-to-supplier",
+  /** 아직 정하지 않았다 — 묶어 두고 쓰지 않는다. */
+  "hold"
+];
 function testPassedAt(r, at) {
   if (r.result !== "pass")
     return false;
@@ -779,7 +805,7 @@ function gs1Namespaces(prefix) {
   return [`urn:epc:idpat:sgtin:${prefix}.`, `urn:epc:class:lgtin:${prefix}.`, `urn:epc:id:sgtin:${prefix}.`];
 }
 
-// ../ops-contract/dist/capacity.js
+// node_modules/@operato/ops-contract/dist/capacity.js
 function isoDurationHours(iso2) {
   if (!iso2)
     return 0;
@@ -887,7 +913,7 @@ function analyzeCapacity(input) {
   };
 }
 
-// ../ops-contract/dist/wms-profile.js
+// node_modules/@operato/ops-contract/dist/wms-profile.js
 var BIZSTEP = {
   receiving: "urn:epcglobal:cbv:bizstep:receiving",
   storing: "urn:epcglobal:cbv:bizstep:storing",
@@ -917,7 +943,7 @@ var WMS_TYPES = [
   { key: "packer", role: "equipment", label: "twin.type.packer", standardClass: { epcis: "object", isa95: "Equipment" }, identity: { scheme: "gs1:GIAI" }, capabilities: ["processable", "operable"] }
 ];
 
-// ../ops-contract/dist/yms-profile.js
+// node_modules/@operato/ops-contract/dist/yms-profile.js
 var YARD_BIZSTEP = {
   arriving: "urn:epcglobal:cbv:bizstep:arriving",
   // 게이트-인
@@ -943,7 +969,7 @@ var YMS_TYPES = [
   { key: "hostler", role: "equipment", label: "twin.type.hostler", standardClass: { epcis: "object", iso55000: "Asset" }, identity: { scheme: "gs1:GIAI" }, capabilities: ["mobile", "operable"] }
 ];
 
-// ../ops-contract/dist/mes-profile.js
+// node_modules/@operato/ops-contract/dist/mes-profile.js
 var MES_BIZSTEP = {
   receiving: "urn:epcglobal:cbv:bizstep:receiving",
   // 원자재 수령
@@ -981,7 +1007,7 @@ var MES_TYPES = [
   { key: "assembler", role: "equipment", label: "twin.type.assembler", standardClass: { isa95: "Equipment", iso55000: "Asset" }, identity: { scheme: "gs1:GIAI" }, capabilities: ["processable", "operable"] }
 ];
 
-// ../ops-contract/dist/ems-profile.js
+// node_modules/@operato/ops-contract/dist/ems-profile.js
 var EMS_LOCATION_TYPES = ["incoming", "feeder", "submeter-zone"];
 var METER_DIRECTION = ["import", "export", "bidirectional"];
 var EMS_PROPERTY = {
@@ -1302,7 +1328,7 @@ function isElectricalLocationType(type) {
   return EMS_LOCATION_TYPES.includes(type);
 }
 
-// ../ops-contract/dist/domain-catalog.js
+// node_modules/@operato/ops-contract/dist/domain-catalog.js
 var locationKeys = (types) => types.filter((t) => t.role === "location").map((t) => t.key);
 var DOMAIN_CATALOG = {
   // label 은 언어 중립 i18n 키(twin.system.<code>) — 사람 언어는 표현계층이 렌더(L2).
@@ -1312,7 +1338,7 @@ var DOMAIN_CATALOG = {
   ems: { system: "ems", label: "twin.system.ems", types: EMS_TYPES, locationTypes: locationKeys(EMS_TYPES) }
 };
 
-// ../ops-contract/dist/domain-definition.js
+// node_modules/@operato/ops-contract/dist/domain-definition.js
 var OP_PARAM = {
   /** 양품률(0..1, 무차원). 없으면 커널 기본값 — 기본값을 쓴 사실은 `specCoverage()` 가 밝힌다. */
   yield: "yield",
@@ -1321,7 +1347,7 @@ var OP_PARAM = {
   setupDuration: "setupDuration"
 };
 
-// ../ops-contract/dist/energy-ingest.js
+// node_modules/@operato/ops-contract/dist/energy-ingest.js
 function resolveSubject(kind, localId, opts) {
   const declared = opts.identityOf?.(kind, localId);
   if (declared)
@@ -1332,7 +1358,7 @@ function periodFactId(tenantId, kind, subject, from, to) {
   return [tenantId, kind, subject, from, to].join("|");
 }
 
-// ../ops-contract/dist/epcis.js
+// node_modules/@operato/ops-contract/dist/epcis.js
 var EPCIS_CONTEXT = "https://ref.gs1.org/standards/epcis/2.0.0/epcis-context.jsonld";
 var UTC_OFFSET = "+00:00";
 var DISP = {
@@ -1591,7 +1617,7 @@ function transformationEvent(p) {
   return e;
 }
 
-// ../ops-contract/dist/iso-duration.js
+// node_modules/@operato/ops-contract/dist/iso-duration.js
 var RE = /^(-)?P(?:(\d+(?:\.\d+)?)W)?(?:(\d+(?:\.\d+)?)D)?(?:T(?:(\d+(?:\.\d+)?)H)?(?:(\d+(?:\.\d+)?)M)?(?:(\d+(?:\.\d+)?)S)?)?$/;
 function parseIsoDuration(text) {
   if (typeof text !== "string")
@@ -1617,7 +1643,7 @@ function parseIsoDuration(text) {
   return sign ? -ms2 : ms2;
 }
 
-// ../ops-contract/dist/master-data.js
+// node_modules/@operato/ops-contract/dist/master-data.js
 function expiryFromAttributes(attrs) {
   return readEpochMs(attrs?.[ILMD_ATTR.expiry]);
 }
@@ -1634,7 +1660,7 @@ function readEpochMs(raw) {
   return Number.isNaN(at) ? void 0 : at;
 }
 
-// ../ops-contract/dist/operational-ingest.js
+// node_modules/@operato/ops-contract/dist/operational-ingest.js
 var TASK_STATUS = ["created", "assigned", "in-progress", "completed"];
 var EQUIPMENT_STATUS = ["idle", "busy", "down"];
 var PERSON_STATUS = ["idle", "busy"];
@@ -1783,6 +1809,39 @@ var SPECS = {
    * `propertyMeasurements` 안쪽은 재검사하지 않는다 — 그 모양은 `PropertyMeasurement` 계약이고,
    * 여기서 두 번 지키면 두 벌이 된다(설비 `motion` 과 같은 규율).
    */
+  /*
+   * **부적합 처분** — 재고 판정을 받은 것을 어떻게 하기로 정했나.
+   *
+   * ── 이 통이 늦게 생긴 이유 (2026-08-30) ──────────────────────────────────
+   * 사건 이름(`OP_EVENT.disposition`)과 모양(`DispositionFact`)을 먼저 만들고 **여기로 오는 길을
+   * 내지 않았다.** 그래서 처분 사실을 보내면 어느 통도 아니어서 떨어진 목록에도 남지 않고 사라졌다.
+   * MES 전문가가 소스를 읽다 찾았다.
+   *
+   * 이 파일의 위 주석이 말한 부류 그대로다 — `OP_EVENT.test` 와 `OP_EVENT.observation` 이 같은 일을
+   * 겪었고 이번이 셋째다. **계약에 자리를 만드는 것과 그 자리로 가는 길을 내는 것은 다른 일이다.**
+   *
+   * ── 판정과 다른 사실이다 ─────────────────────────────────────────────────
+   * 근거가 된 판정(`specId`)을 가리킬 수 있지만 **필수가 아니다** — 판정 없이 현장 재량으로 빼는 일이
+   * 정상이다. 그래서 정체성은 처분 대상(`subjectId`)이다.
+   */
+  disposition: {
+    eventType: OP_EVENT.disposition,
+    identity: "subjectId",
+    /* 무엇을 어떻게 하기로 했나 — 둘 중 하나가 없으면 그 결정은 아무 데도 붙지 못한다. */
+    required: ["subjectId", "decision"],
+    fields: {
+      subjectId: "string",
+      decision: "string",
+      quantity: "number",
+      uom: "string",
+      specId: "string",
+      decidedBy: "string",
+      reason: "string",
+      decidedAt: "string",
+      recordTime: "string"
+    },
+    enums: { decision: DISPOSITION_DECISION }
+  },
   test: {
     eventType: OP_EVENT.test,
     identity: "testableObjectId",
@@ -1842,7 +1901,7 @@ var SPECS = {
   }
 };
 
-// ../ops-contract/dist/operations-capability.js
+// node_modules/@operato/ops-contract/dist/operations-capability.js
 function workingHoursBetween(calendar, fromMs, toMs, utcOffsetMinutes) {
   if (!(toMs > fromMs))
     return 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@operato/twin-kernel",
-  "version": "0.8.2",
+  "version": "0.8.4",
   "type": "module",
   "description": "Twin Domain Kernel — framework-agnostic, zero-dep (domain + sim + 3-channel contract). WMS/YMS/MES, EPCIS 2.0 · ISA-95.",
   "publishConfig": {
@@ -28,6 +28,6 @@
     "test": "node --test test/*.test.ts"
   },
   "dependencies": {
-    "@operato/ops-contract": "^0.1.0"
+    "@operato/ops-contract": "^0.4.0"
   }
 }