@operato/ops-contract 0.9.9 → 0.9.11

package/dist/operational-ingest.d.ts

@@ -62,6 +62,25 @@ export interface ObjectShape {
  */
 export declare function operationalKindOf(record: unknown): OperationalKind | undefined;
 /** 이 레코드가 운영 사실인가 — 호스트의 라우팅이 묻는 자리. */
+/**
+ * 그 종류의 사실을 **무엇이 가리키나** — 선언된 identity 칸의 이름.
+ *
+ * ── 왜 내보내나 (2026-09-06) ───────────────────────────────────────────────
+ * 이 선언은 여기 있는데 밖에서 읽을 수 없었다. 그래서 중복 판정(`ingest-dedupe.ts`)이 같은 목록을
+ * **손으로 옮겨** 들고 있었고, 새 종류가 생길 때마다 조용히 뒤처졌다.
+ *
+ * 실제로 두 번 그랬다.
+ *
+ * ```
+ * subjectId          처분 · 목록에 없어 정체를 아예 못 만들었다 → dedupe 밖
+ * testableObjectId   시험 · 목록에 없어 같은 명세·같은 시각의 다른 로트가 뭉칠 수 있었다
+ * ```
+ *
+ * 뒤엣것이 더 나쁘다. 중복은 눈에 보이지만 뭉친 것은 **사실 하나가 사라진 것**이고 아무 흔적이 없다.
+ *
+ * 모르는 종류에는 `undefined` 를 낸다 — 짐작으로 이름을 내지 않는다.
+ */
+export declare function operationalIdentityField(kind: OperationalKind | undefined): string | undefined;
 export declare function isOperationalRecord(record: unknown): boolean;
 /**
  * 운영 레코드들을 봉투로 — 유효한 것만 통과하고 나머지는 **이유와 함께** 남는다.

package/dist/operational-ingest.js

@@ -401,6 +401,27 @@ export function operationalKindOf(record) {
  */
 const MATCH_ORDER = Object.keys(SPECS).sort((a, b) => (SPECS[a].matchOrder ?? 1000) - (SPECS[b].matchOrder ?? 1000));
 /** 이 레코드가 운영 사실인가 — 호스트의 라우팅이 묻는 자리. */
+/**
+ * 그 종류의 사실을 **무엇이 가리키나** — 선언된 identity 칸의 이름.
+ *
+ * ── 왜 내보내나 (2026-09-06) ───────────────────────────────────────────────
+ * 이 선언은 여기 있는데 밖에서 읽을 수 없었다. 그래서 중복 판정(`ingest-dedupe.ts`)이 같은 목록을
+ * **손으로 옮겨** 들고 있었고, 새 종류가 생길 때마다 조용히 뒤처졌다.
+ *
+ * 실제로 두 번 그랬다.
+ *
+ * ```
+ * subjectId          처분 · 목록에 없어 정체를 아예 못 만들었다 → dedupe 밖
+ * testableObjectId   시험 · 목록에 없어 같은 명세·같은 시각의 다른 로트가 뭉칠 수 있었다
+ * ```
+ *
+ * 뒤엣것이 더 나쁘다. 중복은 눈에 보이지만 뭉친 것은 **사실 하나가 사라진 것**이고 아무 흔적이 없다.
+ *
+ * 모르는 종류에는 `undefined` 를 낸다 — 짐작으로 이름을 내지 않는다.
+ */
+export function operationalIdentityField(kind) {
+    return kind ? SPECS[kind]?.identity : undefined;
+}
 export function isOperationalRecord(record) {
     return operationalKindOf(record) !== undefined;
 }

package/dist-cjs/index.cjs

@@ -179,6 +179,7 @@ __export(index_exports, {
   observationAt: () => observationAt,
   offCalendarAt: () => offCalendarAt,
   offCalendarReasonAt: () => offCalendarReasonAt,
+  operationalIdentityField: () => operationalIdentityField,
   operationalKindOf: () => operationalKindOf,
   operationsCapabilityOf: () => operationsCapabilityOf,
   outsideLimit: () => outsideLimit,
@@ -3700,6 +3701,9 @@ function operationalKindOf(record) {
 var MATCH_ORDER = Object.keys(SPECS).sort(
   (a, b) => (SPECS[a].matchOrder ?? 1e3) - (SPECS[b].matchOrder ?? 1e3)
 );
+function operationalIdentityField(kind) {
+  return kind ? SPECS[kind]?.identity : void 0;
+}
 function isOperationalRecord(record) {
   return operationalKindOf(record) !== void 0;
 }
@@ -4497,6 +4501,7 @@ function commandSpecGaps(specs, command) {
   observationAt,
   offCalendarAt,
   offCalendarReasonAt,
+  operationalIdentityField,
   operationalKindOf,
   operationsCapabilityOf,
   outsideLimit,

package/package.json

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