@operato/twin-kernel 0.0.6 → 0.1.0

package/dist/index.d.ts

@@ -12,6 +12,7 @@ export * from './domain-catalog.ts';
 export * from './allocation-policy.ts';
 export * from './duration-estimator.ts';
 export * from './state-projector.ts';
+export * from './task-fold.ts';
 export * from './face2-adapter.ts';
 export * from './runtime.ts';
 export * from './yms-profile.ts';

package/dist/index.js

@@ -12,6 +12,7 @@ export * from "./domain-catalog.js";
 export * from "./allocation-policy.js";
 export * from "./duration-estimator.js";
 export * from "./state-projector.js";
+export * from "./task-fold.js";
 export * from "./face2-adapter.js";
 export * from "./runtime.js";
 export * from "./yms-profile.js";

package/dist/task-fold.d.ts

@@ -0,0 +1,56 @@
+import type { TaskStatusDelta } from './contract.ts';
+/**
+ * 되읽을 저널 한 줄 — 필요한 것만.
+ *
+ * `data`(정본 봉투) 와 `payload`(호스트가 감싸 저장한 형태) 를 모두 받는다. 저장 계층마다 감싸는 방식이
+ * 달라 소비처가 각자 벗기고 있었고, 그 벗기는 규칙이 또 갈라졌다.
+ */
+export interface TaskDeltaRow {
+    /** ISO 시각. 파싱 불가하면 그 줄은 버린다(조용히 0 으로 세지 않는다). */
+    eventTime?: string;
+    data?: Partial<TaskStatusDelta>;
+    payload?: {
+        data?: Partial<TaskStatusDelta>;
+    } | Partial<TaskStatusDelta>;
+}
+/** 작업에 붙어 있는 축의 값 — 어느 전이에서 왔든 모은다. */
+export interface TaskFacets {
+    /** 수행 자원(무버). 설계상 자원을 쓰지 않는 공정(체류)에서는 없는 것이 정상이다. */
+    resource?: string;
+    /** 작업 종류(커널 어휘 — 사람이 읽는 라벨은 표현 계층의 몫). */
+    kind?: string;
+    /** 소속 오더. **없으면 없는 것이다** — 다른 식별자로 대체하지 않는다. */
+    order?: string;
+    /** 가장 최근 도착 지점. 진행에 따라 바뀌므로 마지막 것이 사실이다. */
+    node?: string;
+}
+/** 작업 하나의 이정표 — 소비처가 이것으로 구간·지표를 만든다. */
+export interface TaskRecord {
+    taskId: string;
+    /** 생성 시각. 같은 전이가 여러 번 오면 **마지막** 것(등록 정보 정정이 뒤에 온다). */
+    createdMs?: number;
+    /** 착수 시각. **처음** 것 — 재시도로 다시 착수 전이가 와도 실제 시작은 처음이다. */
+    startedMs?: number;
+    /** 완료 시각. **나중** 것 — 완료는 종결 상태라 작업당 하나이고 재전송이면 나중 것이 사실이다. */
+    completedMs?: number;
+    facets: TaskFacets;
+}
+export interface TaskFoldResult {
+    /** 작업별 기록(입력에서 처음 등장한 순서). */
+    records: TaskRecord[];
+    /** 읽어들인 줄 수(시각을 파싱한 것만). 저널이 비었는지 구별하는 값. */
+    rowsRead: number;
+    /** 본 시각 중 가장 늦은 것(ms). 없으면 0 — 라이브 엣지·창 기준의 재료. */
+    latestMs: number;
+}
+/**
+ * `task.status` 델타를 작업 단위 기록으로 접는다.
+ *
+ * 입력은 **시간순일 필요가 없다**(revision 순·역순 모두 허용) — 이정표는 min/max 로 고르고 축의 값은
+ * 처음 본 것을 남기므로 순서에 의존하지 않는다. 단 `createdMs` 는 "마지막 생성 전이" 이므로 같은 작업의
+ * 생성이 두 번 오면 **입력 순서상 나중** 것이 남는다.
+ *
+ * 자원이 실리지 않은 전이도 읽는다 — 생성 전이에만 종류·오더가 실리는 구현이 있어, 그 줄을 건너뛰면
+ * 축이 통째로 빈다. "자원이 없어 그릴 수 없다" 는 판단은 소비처가 기록을 보고 한다.
+ */
+export declare function foldTaskRecords(rows: TaskDeltaRow[]): TaskFoldResult;

package/dist/task-fold.js

@@ -0,0 +1,60 @@
+function ms(value) {
+    if (!value)
+        return null;
+    const t = Date.parse(value);
+    return Number.isFinite(t) ? t : null;
+}
+/** 저장 형태 차이를 여기서 한 번만 벗긴다(소비처가 각자 벗기면 그 규칙이 갈라진다). */
+function deltaOf(row) {
+    const p = row.payload;
+    return (row.data ?? p?.data ?? p ?? {});
+}
+/**
+ * `task.status` 델타를 작업 단위 기록으로 접는다.
+ *
+ * 입력은 **시간순일 필요가 없다**(revision 순·역순 모두 허용) — 이정표는 min/max 로 고르고 축의 값은
+ * 처음 본 것을 남기므로 순서에 의존하지 않는다. 단 `createdMs` 는 "마지막 생성 전이" 이므로 같은 작업의
+ * 생성이 두 번 오면 **입력 순서상 나중** 것이 남는다.
+ *
+ * 자원이 실리지 않은 전이도 읽는다 — 생성 전이에만 종류·오더가 실리는 구현이 있어, 그 줄을 건너뛰면
+ * 축이 통째로 빈다. "자원이 없어 그릴 수 없다" 는 판단은 소비처가 기록을 보고 한다.
+ */
+export function foldTaskRecords(rows) {
+    const byTask = new Map();
+    let rowsRead = 0;
+    let latestMs = 0;
+    for (const row of rows) {
+        const at = ms(row.eventTime);
+        if (at === null)
+            continue;
+        const d = deltaOf(row);
+        const id = d.taskId;
+        if (!id)
+            continue;
+        rowsRead++;
+        latestMs = Math.max(latestMs, at);
+        let rec = byTask.get(id);
+        if (!rec) {
+            rec = { taskId: id, facets: {} };
+            byTask.set(id, rec);
+        }
+        /* 축의 값 — 처음 본 것을 남긴다(작업의 종류·오더·자원은 바뀌지 않는다). 노드는 예외로 마지막 것. */
+        const f = rec.facets;
+        if (f.resource === undefined && d.resourceRef)
+            f.resource = d.resourceRef;
+        if (f.kind === undefined && d.kind)
+            f.kind = d.kind;
+        if (f.order === undefined && d.orderId)
+            f.order = d.orderId;
+        const node = d.toNode ?? d.fromNode;
+        if (node)
+            f.node = node;
+        if (d.status === 'created')
+            rec.createdMs = at;
+        else if (d.status === 'in-progress')
+            rec.startedMs = rec.startedMs != null ? Math.min(rec.startedMs, at) : at;
+        else if (d.status === 'completed')
+            rec.completedMs = rec.completedMs != null ? Math.max(rec.completedMs, at) : at;
+    }
+    return { records: [...byTask.values()], rowsRead, latestMs };
+}

package/dist-cjs/index.cjs

@@ -61,6 +61,7 @@ __export(index_exports, {
   deriveAttentions: () => deriveAttentions,
   fefoPolicy: () => fefoPolicy,
   firstFitPolicy: () => firstFitPolicy,
+  foldTaskRecords: () => foldTaskRecords,
   gdtiUri: () => gdtiUri,
   graiUri: () => graiUri,
   ingest: () => ingest,
@@ -679,7 +680,47 @@ var fefoPolicy = {
 };
 
 // src/duration-estimator.ts
-var constantDuration = (ms) => ({ estimate: () => ms });
+var constantDuration = (ms2) => ({ estimate: () => ms2 });
+
+// src/task-fold.ts
+function ms(value) {
+  if (!value) return null;
+  const t = Date.parse(value);
+  return Number.isFinite(t) ? t : null;
+}
+function deltaOf(row) {
+  const p = row.payload;
+  return row.data ?? p?.data ?? p ?? {};
+}
+function foldTaskRecords(rows) {
+  const byTask = /* @__PURE__ */ new Map();
+  let rowsRead = 0;
+  let latestMs = 0;
+  for (const row of rows) {
+    const at = ms(row.eventTime);
+    if (at === null) continue;
+    const d = deltaOf(row);
+    const id = d.taskId;
+    if (!id) continue;
+    rowsRead++;
+    latestMs = Math.max(latestMs, at);
+    let rec = byTask.get(id);
+    if (!rec) {
+      rec = { taskId: id, facets: {} };
+      byTask.set(id, rec);
+    }
+    const f = rec.facets;
+    if (f.resource === void 0 && d.resourceRef) f.resource = d.resourceRef;
+    if (f.kind === void 0 && d.kind) f.kind = d.kind;
+    if (f.order === void 0 && d.orderId) f.order = d.orderId;
+    const node = d.toNode ?? d.fromNode;
+    if (node) f.node = node;
+    if (d.status === "created") rec.createdMs = at;
+    else if (d.status === "in-progress") rec.startedMs = rec.startedMs != null ? Math.min(rec.startedMs, at) : at;
+    else if (d.status === "completed") rec.completedMs = rec.completedMs != null ? Math.max(rec.completedMs, at) : at;
+  }
+  return { records: [...byTask.values()], rowsRead, latestMs };
+}
 
 // src/face2-adapter.ts
 function get(obj, path) {
@@ -1990,6 +2031,7 @@ var MesKernel = class extends FlowEngine {
   deriveAttentions,
   fefoPolicy,
   firstFitPolicy,
+  foldTaskRecords,
   gdtiUri,
   graiUri,
   ingest,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@operato/twin-kernel",
-  "version": "0.0.6",
+  "version": "0.1.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": {