@operato/ops-contract 0.8.0 → 0.8.1

package/dist/domain-definition.d.ts

@@ -239,7 +239,13 @@ export interface OpMaterialSpecification {
     uom?: string;
 }
 /** 라우트(오퍼레이션 시퀀스) — ISA-95 ProcessSegment 연결. */
-export interface RouteDef {
+/**
+ * 공정을 지나는 순서.
+ *
+ * 유효 기간은 레시피와 같은 이유로 있다 — 라우트도 개정되고, 지난 실적이 어느 경로로 만든 것인지
+ * 잃으면 추적이 성립하지 않는다(§`RecipeDef`).
+ */
+export interface RouteDef extends EffectivePeriod {
     key: string;
     label: string;
     /** OperationDef.key 순서. */
@@ -323,8 +329,20 @@ export interface RecipePart {
      */
     operation?: string;
 }
-/** BOM/레시피 — ISA-95 Material Consumed/Produced · EPCIS TransformationEvent(input→output). */
-export interface RecipeDef {
+/**
+ * BOM/레시피 — ISA-95 Material Consumed/Produced · EPCIS TransformationEvent(input→output).
+ *
+ * ── 유효 기간을 왜 여기 두나 (2026-08-31) ────────────────────────────────
+ * **레시피는 개정된다.** 그런데 이 타입에 그 자리가 없어서, 마스터가 `effectiveStart`·`effectiveEnd` 를
+ * 채워 보내도 커널이 오류 없이 지나쳤다 — 값을 넣어도 트윈에 닿지 않았다.
+ *
+ * 그것이 없으면 **지난 실적이 어느 배합으로 만든 것인지 잃는다.** 정산과 추적이 그 위에 선다.
+ * 마스터가 행을 지우지 않고 이 칸을 채우는 이유도 그것이다.
+ *
+ * 선언 적합성 하네스가 잡았다(`ops-master/test/declaration-reaches-contract.test.ts`) — 마스터가
+ * 내보내는 칸이 계약에 실재하는지 보는 시험이다.
+ */
+export interface RecipeDef extends EffectivePeriod {
     key: string;
     label: string;
     inputs: RecipePart[];

package/package.json

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