@operato/twin-kernel 0.5.0 → 0.6.0

package/dist/contract.d.ts

@@ -362,7 +362,7 @@ export declare function conversionFactorOf(def: MaterialDefinition | undefined,
  * 되풀이를 간단히 적기 위한 선택이고, 그러면 **어느 기준의 06:00 인가**가 반드시 필요하다 —
  * Rosarito(UTC−7)의 06:00 을 UTC 로 읽으면 7시간이 틀린다.
  *
- * 그래서 `BoardDef.utcOffsetMinutes` 가 그 기준이다. **선언하지 않으면 UTC 로 읽고, 그 사실을 여기
+ * 그래서 `TwinModelDef.utcOffsetMinutes` 가 그 기준이다. **선언하지 않으면 UTC 로 읽고, 그 사실을 여기
  * 밝힌다**(조용히 가정하지 않기 위해). 프레임워크에는 이미 테넌트 시간대(`Domain.timezone`)와
  * 교대→절대구간 변환(`@things-factory/work-shift` `work-shift-range`, moment-timezone)이 있으므로,
  * **기준을 푸는 일은 호스트의 몫**이다(커널은 zero-dep — 시간대 데이터를 들 수 없다).
@@ -1267,14 +1267,14 @@ export type Unsubscribe = () => void;
  * 이 함수를 거치지 않고 `def.locations` 를 직접 읽는 코드를 두지 않는다 — 하나라도 남으면 그 경로에서만
  * 옛 보드의 자리가 조용히 사라진다(빈 배열 = 자리 없는 트윈 = 아무 일도 일어나지 않는다).
  */
-export declare function readBoardLocations(def: BoardDef | (Record<string, unknown> & {
+export declare function readBoardLocations(def: TwinModelDef | (Record<string, unknown> & {
     locations?: unknown;
     nodes?: unknown;
-})): BoardDef['locations'];
-export declare function readBoardEquipment(def: BoardDef | Record<string, unknown>): BoardDef['equipment'];
+})): TwinModelDef['locations'];
+export declare function readBoardEquipment(def: TwinModelDef | Record<string, unknown>): TwinModelDef['equipment'];
 /** 저장된 보드의 반복사용 자산 — 설비와 같은 정규화를 거친다. */
-export declare function readBoardAssets(def: BoardDef | Record<string, unknown>): NonNullable<BoardDef['assets']>;
-export interface BoardDef {
+export declare function readBoardAssets(def: TwinModelDef | Record<string, unknown>): NonNullable<TwinModelDef['assets']>;
+export interface TwinModelDef {
     /** parallelism = 동시 처리 수(LocationState.parallelism 참조). capacity 는 저장 용량. */
     locations: {
         id: string;
@@ -1396,7 +1396,7 @@ export interface BoardDef {
      *
      * ── 왜 이제야 선언하나 (2026-08-08) ──────────────────────────────────────────
      * 이 자리는 **이미 쓰이고 있었다.** 마스터 인제스트가 `board.operations` 로 통과시키고 호스트가
-     * `applyOperations` 로 커널에 싣는다. 그런데 `BoardDef` 는 그것을 말한 적이 없다.
+     * `applyOperations` 로 커널에 싣는다. 그런데 `TwinModelDef` 는 그것을 말한 적이 없다.
      *
      * 바로 위 `productionSpec` 이 겪은 것과 **같은 일**이다 — "계약에 없으니 아무도 이 자리를 발견할
      * 수 없었다. 타입이 말해 주지 않는 필드는 없는 필드다." 그때 배운 것을 여기 적용한다.
@@ -1422,7 +1422,7 @@ export interface ProductionSpec {
     recipeKey?: string;
 }
 export interface TwinKernel {
-    loadBoard(def: BoardDef): void;
+    loadTwinModel(def: TwinModelDef): void;
     getSnapshot(): StateSnapshot;
     onEvent(handler: EventHandler): Unsubscribe;
     dispatch(cmd: Command): CommandAck;

package/dist/domain-catalog.d.ts

@@ -30,7 +30,7 @@ export interface DomainProfileInfo {
 export declare const DOMAIN_CATALOG: Record<DomainSystem, DomainProfileInfo>;
 export interface TwinAxisInfo {
     /**
-     * 축의 이름 — 화면·관계 선언이 쓰는 키. 최상위 축은 `BoardDef` 의 키 **그대로**다
+     * 축의 이름 — 화면·관계 선언이 쓰는 키. 최상위 축은 `TwinModelDef` 의 키 **그대로**다
      * (저장·계약의 이름과 갈라지면 그 순간 방언이 생긴다).
      */
     axis: string;

package/dist/domain-definition.js

@@ -1,5 +1,5 @@
 /*
- * 도메인 정의(DomainDefinition) — 커널의 선언적 도메인 계약. `BoardDef`(토폴로지 입력)의 확장 격.
+ * 도메인 정의(DomainDefinition) — 커널의 선언적 도메인 계약. `TwinModelDef`(토폴로지 입력)의 확장 격.
  * 커널이 "무엇이 있고 어떻게 흐르나"(타입 + 공정 route/BOM)를 **데이터로** 받는 형식. zero-dep(자기 타입).
  *
  * 특정 공정이 커널 코드에 하드코딩되던 것을 이 데이터 계약으로 대체한다(design/plans/domain-catalog-layering.md).

package/dist/event-journal.d.ts

@@ -1,4 +1,4 @@
-import type { BoardDef, CanonicalEnvelope } from './contract.ts';
+import type { TwinModelDef, CanonicalEnvelope } from './contract.ts';
 import { type ProjectedState } from './state-projector.ts';
 export declare class EventJournal {
     private events;
@@ -14,10 +14,10 @@ export declare class EventJournal {
     untilSimTime(iso: string): CanonicalEnvelope[];
 }
 /** 이벤트열 → 상태 재구성(시간여행). board = 마스터(토폴로지·설비). */
-export declare function replay(board: BoardDef, events: readonly CanonicalEnvelope[]): ProjectedState;
+export declare function replay(board: TwinModelDef, events: readonly CanonicalEnvelope[]): ProjectedState;
 /** 한 구조 아래에서 일어난 이벤트들 — 재생의 한 마디. */
 export interface StructureSegment {
-    board: BoardDef;
+    board: TwinModelDef;
     events: readonly CanonicalEnvelope[];
 }
 /** 구조가 바뀐 지점마다 무엇이 사라졌는지. 조용히 넘어가지 않는다. */

package/dist/flow-engine.d.ts

@@ -1,4 +1,4 @@
-import type { ISOTime, MaterialQuantity, WorkCalendarEntry, EffectivePeriod, Effectivity, OffCalendarReason, ResourceProperty, ResourceClassDef, MaterialDefinition, Attention, BoardDef, CanonicalEnvelope, Command, CommandAck, EventHandler, EquipmentMotion, OeeMetrics, AssetState, GeneratorSpec, OrderState, PersonState, ScenarioControl, StateSnapshot, TwinKernel, Unsubscribe, LocationState, ItemState, EquipmentState, OrderStatusDelta, TaskState } from './contract.ts';
+import type { ISOTime, MaterialQuantity, WorkCalendarEntry, EffectivePeriod, Effectivity, OffCalendarReason, ResourceProperty, ResourceClassDef, MaterialDefinition, Attention, TwinModelDef, CanonicalEnvelope, Command, CommandAck, EventHandler, EquipmentMotion, OeeMetrics, AssetState, GeneratorSpec, OrderState, PersonState, ScenarioControl, StateSnapshot, TwinKernel, Unsubscribe, LocationState, ItemState, EquipmentState, OrderStatusDelta, TaskState } from './contract.ts';
 import type { EpcisEvent, BizTransactionElement } from './epcis.ts';
 import type { AllocationPolicy, SlotView } from './allocation-policy.ts';
 import type { DurationEstimator, DurationContext } from './duration-estimator.ts';
@@ -283,7 +283,7 @@ export declare abstract class FlowEngine implements TwinKernel {
     private observedDirty;
     private observeMode;
     /** 관측 구동이 투영기를 세울 때 필요한 원본 보드(구조는 이벤트가 아니라 마스터에서 온다). */
-    protected boardDef?: BoardDef;
+    protected boardDef?: TwinModelDef;
     /** 명세 소비 기록 — 무엇을 선언값으로, 무엇을 기본값으로 계산했나(정직한 자기보고). */
     private specUse;
     protected epcSeq: number;
@@ -310,9 +310,9 @@ export declare abstract class FlowEngine implements TwinKernel {
      * 이동(WMS/YMS: from→to 이동) 이든 변환(MES: 소비→생산) 이든 여기서 결정 → base 가 이동-중립.
      */
     protected abstract onTaskComplete(task: FlowTask): void;
-    loadBoard(def: BoardDef): void;
+    loadTwinModel(def: TwinModelDef): void;
     /**
-     * what-if 구성 변주 — fork(또는 실행 중) 엔진에 설비 추가. loadBoard 설비 삽입과 동일 규약.
+     * what-if 구성 변주 — fork(또는 실행 중) 엔진에 설비 추가. loadTwinModel 설비 삽입과 동일 규약.
      * 기본은 mtbf 미지정(고장 없는 신뢰 자원) → sampleExp(rng) 무소비라 baseline fork 와 깨끗이 비교 가능.
      */
     addEquipment(m: {

package/dist/flow-engine.js

@@ -253,7 +253,7 @@ export class FlowEngine {
         this.policy = policy;
     }
     // ── TwinKernel (mechanics, 도메인 무관) ───────────────────────────────────
-    loadBoard(def) {
+    loadTwinModel(def) {
         this.boardDef = def;
         /*
          * **생산 선언은 어느 커널이든 싣는다.** 예전에는 MES 커널만 생성자에서 이것을 실었고(그 시절
@@ -283,7 +283,7 @@ export class FlowEngine {
         }
     }
     /**
-     * what-if 구성 변주 — fork(또는 실행 중) 엔진에 설비 추가. loadBoard 설비 삽입과 동일 규약.
+     * what-if 구성 변주 — fork(또는 실행 중) 엔진에 설비 추가. loadTwinModel 설비 삽입과 동일 규약.
      * 기본은 mtbf 미지정(고장 없는 신뢰 자원) → sampleExp(rng) 무소비라 baseline fork 와 깨끗이 비교 가능.
      */
     addEquipment(m) {

package/dist/observed-reducer.d.ts

@@ -1,4 +1,4 @@
-import type { AssetState, BoardDef, CanonicalEnvelope, LocationState, ItemState, EquipmentState, PersonState, TaskState, OrderState } from './contract.ts';
+import type { AssetState, TwinModelDef, CanonicalEnvelope, LocationState, ItemState, EquipmentState, PersonState, TaskState, OrderState } from './contract.ts';
 /**
  * 마스터 동기 — 선언적 로케이션 upsert/remove.
  *
@@ -72,7 +72,7 @@ export declare class ObservedReducer {
     private shifts;
     /** 시각 해석 기준(보드 선언) — 없으면 UTC. 캘린더의 `HH:MM` 이 어느 기준인지 정한다. */
     private utcOffsetMinutes?;
-    constructor(board: BoardDef);
+    constructor(board: TwinModelDef);
     /**
      * **구조를 갈아탄다** — 관측된 사실은 지키고 토폴로지만 새 선언으로 바꾼다.
      *
@@ -91,7 +91,7 @@ export declare class ObservedReducer {
      * 관측으로 알게 된 자리(`origin: 'observed'`)는 **새 마스터에 없어도 남긴다** — 마스터가 모르는
      * 자리에서 물건이 실제로 보였다는 사실은 구조를 바꾼다고 사라지지 않는다.
      */
-    adoptStructure(board: BoardDef): {
+    adoptStructure(board: TwinModelDef): {
         locationsAdded: number;
         locationsDropped: number;
         equipmentDropped: number;

package/dist-cjs/index.cjs

@@ -2280,7 +2280,7 @@ var FlowEngine = class {
     this.policy = policy;
   }
   // ── TwinKernel (mechanics, 도메인 무관) ───────────────────────────────────
-  loadBoard(def) {
+  loadTwinModel(def) {
     this.boardDef = def;
     if (def.productionSpec?.definition?.operations?.length) this.loadOperations(def.productionSpec.definition.operations);
     for (const n of readBoardLocations(def)) this.locations.set(n.id, { id: n.id, type: n.type, capacity: n.capacity, parallelism: n.parallelism, occupancy: 0, status: "idle", parentId: n.parentId });
@@ -2299,7 +2299,7 @@ var FlowEngine = class {
     }
   }
   /**
-   * what-if 구성 변주 — fork(또는 실행 중) 엔진에 설비 추가. loadBoard 설비 삽입과 동일 규약.
+   * what-if 구성 변주 — fork(또는 실행 중) 엔진에 설비 추가. loadTwinModel 설비 삽입과 동일 규약.
    * 기본은 mtbf 미지정(고장 없는 신뢰 자원) → sampleExp(rng) 무소비라 baseline fork 와 깨끗이 비교 가능.
    */
   addEquipment(m) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@operato/twin-kernel",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "type": "module",
   "description": "Twin Domain Kernel — framework-agnostic, zero-dep (domain + sim + 3-channel contract). WMS/YMS/MES, EPCIS 2.0 · ISA-95.",
   "publishConfig": {