@operato/twin-kernel 0.8.3 → 0.8.4

package/dist-cjs/index.cjs

@@ -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;
@@ -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",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@operato/twin-kernel",
-  "version": "0.8.3",
+  "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.3.0"
+    "@operato/ops-contract": "^0.4.0"
   }
 }