@operato/twin-kernel 0.8.1 → 0.8.2

package/dist/master-data.js

@@ -1,168 +0,0 @@
-import { ILMD_ATTR } from "./epcis.js";
-/*
- * **마스터데이터 — 변하지 않는 속성이 들어오는 문** (2026-08-28).
- *
- * ── 무엇이 없어서 무엇이 망가졌나 ───────────────────────────────────────────
- * 커널에 마스터데이터라는 개념이 없었다. 그래서 유통기한 같은 값이 갈 곳이 **사건밖에** 없었고,
- * 표준은 그 값을 `ObjectEvent(action=ADD)` 와 변환 사건에만 실을 수 있게 한다(EPCIS 2.0 §7.3.8).
- *
- * 그 제약이 유입 쪽에서 이렇게 나타났다. 전량을 읽는 원본(식품 제조 MES)이 재고를 다시 말할 때마다,
- * 유통기한을 실으려고 **들어오지 않은 것을 `ADD` 라고** 말했다. 그리고 `ilmd` 는 사건 단위라서 자리별로
- * 묶을 수도 없어 낱개로 나갔다 — 재기동 한 번에 2,665건이다.
- *
- * 나르는 방법의 제약이 사실의 뜻을 정한 것이고, 순서가 거꾸로였다.
- *
- * ── 표준이 둔 자리 ──────────────────────────────────────────────────────────
- * 표준은 이런 값을 **어휘 요소의 속성**으로 담는 자리를 사건과 별개로 갖고 있다.
- *
- *   어휘 타입   urn:epcglobal:epcis:vtype:EPCClass · ReadPoint · BizLocation
- *   어휘 요소   { id, attributes }
- *
- * 속성 **이름**은 EPCIS 본문이 정하지 않고 상위 문서(CBV 마스터데이터)의 몫이다(§7.3.8 이 미룬다).
- * 그래서 이 모듈은 이름을 해석하지 않고 **그대로 보관한다** — 아는 이름만 상태 축으로 옮기고, 모르는
- * 것은 잃지 않는다. 우리가 생산할 때 쓰는 이름은 `ILMD_ATTR` 한 곳에 모여 있고 사건 경로와 같은
- * 상수다(이름이 바뀌면 한 곳만 고친다).
- *
- * ── 무엇을 이 문으로 보내지 않나 ────────────────────────────────────────────
- * **변하는 값은 사건이다.** 수량·위치·상태·진행은 이 문으로 오지 않는다. 여기 오는 것은 그 물건의
- * 생애 동안 같은 값뿐이고, 그래서 「그때는 얼마였나」라는 물음이 성립하지 않는다 — 시각축이 없는 값이다.
- *
- * 그 성질이 「지난 기록에 적지 않는다」의 근거다. 사건에서 파생되는 상태가 아니라 **선언된 것**이므로
- * 모델·자재 선언과 같은 자리에 산다. 다만 중간 저장본에는 담는다(되세울 때 원본을 다시 읽지 않게).
- *
- * 설계: `operato-twin/design/plans/master-data.md`
- */
-/** 표준 어휘 타입 — 이 세 가지가 우리 상태 축에 닿는다. 그 밖은 보관하고 알린다. */
-export const VOCABULARY_TYPE = {
-    /** 품목·로트 클래스의 속성 — 유통기한·로트번호가 여기 온다. */
-    epcClass: 'urn:epcglobal:epcis:vtype:EPCClass',
-    /** 관측 지점의 속성. */
-    readPoint: 'urn:epcglobal:epcis:vtype:ReadPoint',
-    /** 업무 자리의 속성. */
-    bizLocation: 'urn:epcglobal:epcis:vtype:BizLocation'
-};
-/** 이 레코드가 마스터데이터인가 — 갈래 판정은 **커널이 한 곳에서** 한다(어휘 넷을 가르는 방식과 같다). */
-export function isMasterDataRecord(record) {
-    if (!record || typeof record !== 'object')
-        return false;
-    const r = record;
-    return typeof r.vocabularyType === 'string' && !!r.vocabularyType && typeof r.id === 'string' && !!r.id && isPlainObject(r.attributes);
-}
-function isPlainObject(v) {
-    return !!v && typeof v === 'object' && !Array.isArray(v);
-}
-/**
- * 마스터데이터를 받아들인다 — **거부한 것은 이유와 함께 남는다**(다른 어휘와 같은 규율).
- *
- * 빈 속성은 거부한다: 「이 로트에 대해 아무것도 모른다」를 보내는 것은 아무 뜻이 없고, 받아 두면
- * 기존 값을 지우려는 것인지 아무 말도 아닌지 구별할 수 없다.
- */
-export function ingestMasterData(records) {
-    const arr = Array.isArray(records) ? records : records ? [records] : [];
-    const accepted = [];
-    const rejected = [];
-    for (const r of arr) {
-        const errors = [];
-        if (!isMasterDataRecord(r))
-            errors.push('vocabularyType · id · attributes 가 있어야 한다');
-        else if (!Object.keys(r.attributes).length)
-            errors.push('attributes 가 비었다 — 아무 뜻이 없는 진술이다');
-        /* 값이 `null` 인 속성은 「지운다」는 뜻이므로 빈 진술이 아니다(위 검사가 이름 수를 세므로 통과한다). */
-        if (errors.length)
-            rejected.push({ record: r, errors });
-        else
-            accepted.push({ vocabularyType: r.vocabularyType, id: r.id, attributes: { ...r.attributes } });
-    }
-    return { accepted, rejected };
-}
-/**
- * 클래스 단위 마스터 표 — 관측 리듀서가 든다.
- *
- * 물품은 자리마다 따로 서지만(`클래스@자리`) 이 속성은 **클래스의 것**이다. 그래서 물품마다 복사해
- * 두지 않고 클래스로 한 번 들고, 물품을 세울 때 본다. 마스터가 관측보다 늦게 와도 값이 서는 이유다.
- */
-export class ClassMasterTable {
-    byId = new Map();
-    /**
-     * 속성을 **합친다** — 덮지 않는다(한 번에 일부만 오는 원본이 있다). 바뀐 식별자를 돌려준다.
-     *
-     * ── 지우는 법 ───────────────────────────────────────────────────────────────
-     * 값에 `null` 을 실으면 **그 속성을 지운다**(「모름으로 되돌린다」). 합치기만 하면 원본에서 지운 값이
-     * 트윈에 영원히 남고, 그것을 표현할 방법이 없으면 「지웠다」와 「이번엔 말하지 않았다」가 같아진다.
-     *
-     * `undefined` 는 지우지 않는다 — 그것은 「이 진술에 그 속성이 없다」이고, 원본이 일부만 보내는
-     * 정상이다. 두 뜻을 갈라 둔다.
-     *
-     * 속성이 하나도 남지 않으면 그 요소를 표에서 버린다(빈 껍데기를 들고 있지 않는다).
-     */
-    merge(elements) {
-        const touched = [];
-        for (const e of elements) {
-            const next = { ...(this.byId.get(e.id) ?? {}) };
-            for (const [name, value] of Object.entries(e.attributes)) {
-                if (value === null)
-                    delete next[name];
-                else if (value !== undefined)
-                    next[name] = value;
-            }
-            if (Object.keys(next).length)
-                this.byId.set(e.id, next);
-            else
-                this.byId.delete(e.id);
-            touched.push(e.id);
-        }
-        return touched;
-    }
-    /**
-     * 그 식별자의 항목을 버린다 — **아무도 가리키지 않게 된 뒤**에만 부른다.
-     *
-     * 로트는 계속 새로 생기므로 이 표는 스스로 줄지 않는다. 하루 수백 로트면 1년에 수십만 항목이고,
-     * 그것을 아무도 지우지 않으면 재기동으로만 줄어든다(그리고 중간 저장본이 그만큼 커진다).
-     */
-    forget(id) {
-        return this.byId.delete(id);
-    }
-    attributesOf(id) {
-        return id ? this.byId.get(id) : undefined;
-    }
-    get size() {
-        return this.byId.size;
-    }
-    serialize() {
-        return Object.fromEntries(this.byId);
-    }
-    restore(saved) {
-        this.byId.clear();
-        if (!isPlainObject(saved))
-            return;
-        for (const [id, attrs] of Object.entries(saved))
-            if (isPlainObject(attrs))
-                this.byId.set(id, { ...attrs });
-    }
-    clear() {
-        this.byId.clear();
-    }
-}
-/** 마스터 속성에서 유통기한을 읽는다 — 사건의 `ilmd` 와 **같은 이름**을 본다. */
-export function expiryFromAttributes(attrs) {
-    return readEpochMs(attrs?.[ILMD_ATTR.expiry]);
-}
-/** 마스터 속성에서 로트 번호를 읽는다 — 사건의 `ilmd` 와 같은 이름. */
-export function lotFromAttributes(attrs) {
-    const v = attrs?.[ILMD_ATTR.lot];
-    return typeof v === 'string' && v.trim() ? v.trim() : undefined;
-}
-/**
- * 시각 값을 밀리초로 — 숫자와 문자열을 모두 읽는다(원본이 둘 다 쓴다).
- *
- * 읽을 수 없으면 `undefined` 다. 「지금」으로 메우면 기한이 지난 재고가 멀쩡해 보이고, 0 으로 메우면
- * 멀쩡한 재고가 기한 지난 것으로 보인다 — 둘 다 사실이 아니다.
- */
-function readEpochMs(raw) {
-    if (typeof raw === 'number')
-        return Number.isFinite(raw) ? raw : undefined;
-    if (typeof raw !== 'string' || !raw.trim())
-        return undefined;
-    const at = Date.parse(raw);
-    return Number.isNaN(at) ? undefined : at;
-}

package/dist/mes-profile.d.ts

@@ -1,14 +0,0 @@
-import type { TwinTypeInfo } from './domain-catalog.ts';
-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";
-};
-/** 작업지시(Work Order) = 생산 오더 거래 유형. */
-export declare const BTT_PRODORDER = "urn:epcglobal:cbv:btt:prodorder";
-/** 직렬 SGTIN URI (원자재 단위·완제품). */
-export declare function sgtinUri(companyPrefix: string, itemRef: string, serial: number): string;
-/** MES 자리 타입 카탈로그 — 커널이 키로 쓰는 제조 로케이션 타입(locationByType/.type). 도메인 SSOT.
- * 트레일러 제조 라인: 자재→프레임 절단→용접→도장→조립→완성차(kernel ROUTE 와 일치). */
-export declare const MES_LOCATION_TYPES: readonly ["raw-store", "cut-station", "weld-station", "paint-booth", "assembly-line", "fg-store"];
-export declare const MES_TYPES: TwinTypeInfo[];

package/dist/mes-profile.js

@@ -1,59 +0,0 @@
-// MES bizStep — CBV 재사용. producing = commissioning(신규 제품 커미셔닝).
-export const MES_BIZSTEP = {
-    receiving: 'urn:epcglobal:cbv:bizstep:receiving', // 원자재 수령
-    producing: 'urn:epcglobal:cbv:bizstep:commissioning', // 생산(제품 최초 생성)
-    storing: 'urn:epcglobal:cbv:bizstep:storing' // 완제품 저장
-};
-/** 작업지시(Work Order) = 생산 오더 거래 유형. */
-export const BTT_PRODORDER = 'urn:epcglobal:cbv:btt:prodorder';
-/** 직렬 SGTIN URI (원자재 단위·완제품). */
-export function sgtinUri(companyPrefix, itemRef, serial) {
-    return `urn:epc:id:sgtin:${companyPrefix}.${itemRef}.${serial}`;
-}
-/** MES 자리 타입 카탈로그 — 커널이 키로 쓰는 제조 로케이션 타입(locationByType/.type). 도메인 SSOT.
- * 트레일러 제조 라인: 자재→프레임 절단→용접→도장→조립→완성차(kernel ROUTE 와 일치). */
-export const MES_LOCATION_TYPES = ['raw-store', 'cut-station', 'weld-station', 'paint-booth', 'assembly-line', 'fg-store'];
-/*
- * 트윈 타입 서술(ADR-0018 확장) — 자리 키는 MES_LOCATION_TYPES 단일 출처에서 파생 + 설비(자원) 타입 추가.
- * MES=ISA-95 앵커: 스테이션=WorkCenter, 저장소=bizLocation. 설비(가공설비)=Equipment/자산(GIAI). key 는 flow resourceType 과 일치.
- */
-// label 은 언어 중립 i18n 키(twin.type.<key>) — cls(표준 클래스)만 자리별 메타로 유지. 사람 언어는 표현계층(L2).
-const MES_LOCATION_CLS = {
-    'raw-store': { epcis: 'bizLocation' },
-    'cut-station': { isa95: 'WorkCenter', epcis: 'bizLocation' },
-    'weld-station': { isa95: 'WorkCenter', epcis: 'bizLocation' },
-    'paint-booth': { isa95: 'WorkCenter', epcis: 'bizLocation' },
-    'assembly-line': { isa95: 'WorkCenter', epcis: 'bizLocation' },
-    'fg-store': { epcis: 'bizLocation' }
-};
-/**
- * 자리의 **ISA-95 계층 단** — 여기가 단이 가장 크게 갈리는 곳이다.
- *
- *  · `assembly-line` = 라인 → `ProductionLine`(`WorkCenter` 의 한 종류)
- *  · `cut-station`·`weld-station`·`paint-booth` = 라인 안의 작업 자리 → `WorkCell`(`WorkUnit` 의 한 종류)
- *  · `raw-store`·`fg-store` = 보관 구역 → `StorageZone`
- *
- * ── 남은 어긋남 (2026-08-14, 지금 고치지 않는다) ─────────────────────────────
- * 스테이션들의 `standardClass.isa95` 는 예전부터 `WorkCenter` 로 적혀 있다. 그런데 `WorkCenter` 는
- * ProcessCell·ProductionLine·ProductionUnit·StorageZone 의 **총칭**이므로, 라인 안의 작업 자리는
- * 엄밀히는 `WorkUnit` 계열이다. 즉 클래스 투영이 한 단 위를 가리키고 있다.
- *
- * 여기서 그것을 바꾸지 않는다: `standardClass` 는 적합성 표가 세는 값이고(`isa95-coverage`),
- * 바꾸면 그 표의 숫자가 함께 움직인다. **단(`level`)과 클래스(`standardClass`)는 다른 축**이므로
- * 단을 옳게 적는 것으로 계층 질의는 살아난다. 클래스 재검토는 적합성 표와 함께 다룰 일이다.
- */
-const MES_LOCATION_LEVEL = {
-    'raw-store': 'StorageZone',
-    'cut-station': 'WorkCell',
-    'weld-station': 'WorkCell',
-    'paint-booth': 'WorkCell',
-    'assembly-line': 'ProductionLine',
-    'fg-store': 'StorageZone'
-};
-export const MES_TYPES = [
-    ...MES_LOCATION_TYPES.map((k) => ({ key: k, role: 'location', label: `twin.type.${k}`, standardClass: MES_LOCATION_CLS[k] ?? {}, identity: { scheme: 'gs1:SGLN' }, level: MES_LOCATION_LEVEL[k], capabilities: ['storable'] })),
-    { key: 'cutter', role: 'equipment', label: 'twin.type.cutter', standardClass: { isa95: 'Equipment', iso55000: 'Asset' }, identity: { scheme: 'gs1:GIAI' }, capabilities: ['processable', 'operable'] },
-    { key: 'welder', role: 'equipment', label: 'twin.type.welder', standardClass: { isa95: 'Equipment', iso55000: 'Asset' }, identity: { scheme: 'gs1:GIAI' }, capabilities: ['processable', 'operable'] },
-    { key: 'painter', role: 'equipment', label: 'twin.type.painter', standardClass: { isa95: 'Equipment', iso55000: 'Asset' }, identity: { scheme: 'gs1:GIAI' }, capabilities: ['processable', 'operable'] },
-    { key: 'assembler', role: 'equipment', label: 'twin.type.assembler', standardClass: { isa95: 'Equipment', iso55000: 'Asset' }, identity: { scheme: 'gs1:GIAI' }, capabilities: ['processable', 'operable'] }
-];

package/dist/operational-ingest.d.ts

@@ -1,44 +0,0 @@
-import type { IngestResult } from './face2-adapter.ts';
-/** 이 문이 받는 여섯 가지 — 리듀서가 다루는 것과 같은 목록(주목 확인은 우리 안의 행위라 제외). */
-export type OperationalKind = 'task' | 'equipment' | 'person' | 'asset' | 'order' | 'quality' | 'test' | 'observation' | 'complete';
-/**
- * 정규 운영 레코드 — **델타의 필드 이름 + 시각(`at`)**.
- *
- * `at` 은 봉투의 `eventTime` 이 된다(리듀서가 늦게 온 옛 사실을 걸러내는 기준). 페이로드에는 싣지
- * 않는다 — 델타에 없는 필드이고, 같은 사실이 두 시각을 갖지 않게.
- */
-export interface OperationalRecordEnvelopeFields {
-    /** 발생 시각(ISO) — 없으면 `defaultEventTime`, 그것도 없으면 거부한다. */
-    at?: string;
-    /** 기록 시각(ISO) — 같은 발생 시각이 겹칠 때의 보조 순서. 리듀서가 페이로드에서 읽는다. */
-    recordTime?: string;
-}
-export type OperationalRecord = Record<string, unknown> & OperationalRecordEnvelopeFields;
-export interface OperationalIngestOptions {
-    tenantId: string;
-    /** 레코드에 시각이 없을 때 쓸 값 — 주지 않으면 그 레코드를 거부한다. */
-    defaultEventTime?: string;
-}
-/**
- * 이 레코드가 어느 운영 사실인가 — **라우팅 판정을 한 곳에 둔다**(소비처가 각자 짐작하지 않게).
- *
- * EPCIS·에너지와 겹치지 않게 본다: `epc`·`meterId` 가 있으면 그쪽 어휘이고, `equipmentId` 는 설비
- * **에너지** 상태의 이름이다(운영 설비는 `moverId`). 품질은 설비와 정체 필드를 공유하므로 `good` 으로
- * 가른다 — 둘 다 아니면 어느 쪽인지 모르는 것이고, 모르면 받지 않는다.
- *
- * ── 순서가 뜻을 갖는다: **주체와 참조는 다르다** ────────────────────────────
- * 정체 필드는 하나만 오지 않는다. 설비·사람·자산 델타는 「지금 붙어 있는 작업」(`taskId`)을 함께 싣고,
- * 작업 델타는 「소속 오더」(`orderId`)를 함께 싣는다. 그래서 아무 정체 필드나 먼저 보면 **참조를 주체로
- * 읽는다** — 실제로 그랬다: `moverId` + `taskId` 인 설비 사실을 작업으로 읽어 「계약에 없는 필드」로
- * 거부했다. 자원(설비·사람·자산)을 먼저 보고, 작업을 오더보다 먼저 본다.
- */
-export declare function operationalKindOf(record: unknown): OperationalKind | undefined;
-/** 이 레코드가 운영 사실인가 — 호스트의 라우팅이 묻는 자리. */
-export declare function isOperationalRecord(record: unknown): boolean;
-/**
- * 운영 레코드들을 봉투로 — 유효한 것만 통과하고 나머지는 **이유와 함께** 남는다.
- *
- * 봉투는 다른 어휘와 같은 것을 쓴다(`CanonicalEnvelope`) — 그래서 저널·리플레이·시간여행·성과 폴드를
- * 그대로 얻는다. 어휘만 자기 것이다.
- */
-export declare function ingestOperationalRecords(records: OperationalRecord | OperationalRecord[] | undefined | null, opts: OperationalIngestOptions): IngestResult;