@things-factory/headless-twin 10.0.7 → 10.0.9

package/test/warm-start.test.ts

@@ -8,7 +8,7 @@
 import { test } from 'node:test'
 import assert from 'node:assert/strict'
 
-import { planWarmStart } from '../server/engine/warm-start.ts'
+import { planWarmStart, unwrapState } from '../server/engine/warm-start.ts'
 
 const STATE = {
   locations: [{ id: 'dock-recv' }, { id: 'rack-1' }],
@@ -27,13 +27,82 @@ test('상태가 있으면 심는다 — 재고·노드·무버', () => {
   assert.deepEqual(plan.seed.locations, STATE.locations)
 })
 
-test('오더는 심지 않는다 — 스냅샷에 requested/fulfilled 가 없어 지어내야 하기 때문', () => {
+test('원값 없는 오더는 심지 않는다 — 남은 수량을 알 수 없어 지어내야 하기 때문', () => {
+  /* STATE 의 오더는 progress 만 들고 있다 — 커널 판정(requested !== undefined)과 같은 기준으로 뺀다. */
   const plan = planWarmStart(STATE, undefined, true)
   assert.equal(plan.action, 'hydrate')
   if (plan.action !== 'hydrate') return
+  assert.equal(plan.seed.orders, undefined)
+  assert.equal(plan.orderCount, 0)
+  assert.equal(plan.ordersWithoutDemand, 1)
+})
+
+test('뺀 오더의 수를 센다 — "주문이 없다" 와 "주문을 못 심었다" 가 같아지면 안 된다', () => {
+  /*
+   * 이 숫자가 로그의 근거다. 세지 않고 조용히 빼면, 재기동 후 빈 주문 목록을 보고
+   * 사용자는 "원래 없었다" 로 읽는다. 실제로 그 화면이 오래 남아 있었다.
+   */
+  const mixed = {
+    ...STATE,
+    orders: [
+      { id: 'SO-1', kind: 'outbound', status: 'created', progress: 0.5 },
+      { id: 'SO-2', kind: 'outbound', status: 'created', requested: 100, fulfilled: 40 },
+      { id: 'SO-3', kind: 'outbound', status: 'created', requested: 30 }
+    ]
+  }
+  const plan = planWarmStart(mixed, undefined, true)
+  assert.equal(plan.action, 'hydrate')
+  if (plan.action !== 'hydrate') return
+  assert.equal(plan.orderCount, 2)
+  assert.equal(plan.ordersWithoutDemand, 1)
+  assert.deepEqual((plan.seed.orders as any[]).map(o => o.id), ['SO-2', 'SO-3'])
+})
+
+test('진행 중 주문을 심는다 — 재기동하면 주문이 사라졌던 결함의 회귀 방지', () => {
+  /*
+   * 예전에는 씨앗이 자리·물품·설비 셋만 넘겨, 재고는 맞는데 주문 목록이 비었다. 원값이 있는
+   * 오더는 반드시 씨앗에 실려야 한다 — 이 단언이 그 결함으로 되돌아가는 것을 막는다.
+   */
+  const plan = planWarmStart(
+    { ...STATE, orders: [{ id: 'SO-9', kind: 'outbound', status: 'created', requested: 50, fulfilled: 10, lines: [{ gtin: 'g1', requested: 50 }] }] },
+    undefined,
+    true
+  )
+  assert.equal(plan.action, 'hydrate')
+  if (plan.action !== 'hydrate') return
+  assert.equal(plan.orderCount, 1)
+  assert.equal(plan.ordersWithoutDemand, 0)
+  assert.equal((plan.seed.orders as any[])[0].requested, 50)
+  assert.equal((plan.seed.orders as any[])[0].fulfilled, 10)
+})
+
+test('작업·사람·자산도 함께 심는다 — 커널이 심을 수 있는 축을 호스트가 버리지 않는다', () => {
+  const plan = planWarmStart(
+    { ...STATE, persons: [{ id: 'p1' }, { id: 'p2' }], assets: [{ id: 'pallet-1' }] },
+    undefined,
+    true
+  )
+  assert.equal(plan.action, 'hydrate')
+  if (plan.action !== 'hydrate') return
+  assert.equal(plan.taskCount, 1)
+  assert.equal(plan.personCount, 2)
+  assert.equal(plan.assetCount, 1)
+  assert.deepEqual(plan.seed.tasks, STATE.tasks)
+  assert.equal((plan.seed.persons as any[]).length, 2)
+})
+
+test('없는 축은 씨앗에 키를 만들지 않는다 — 빈 배열로 커널 판정을 흐리지 않는다', () => {
+  const plan = planWarmStart({ locations: [{ id: 'n1' }], items: [], equipment: [] }, undefined, true)
+  assert.equal(plan.action, 'hydrate')
+  if (plan.action !== 'hydrate') return
   assert.deepEqual(Object.keys(plan.seed).sort(), ['equipment', 'items', 'locations'])
-  assert.equal((plan.seed as any).orders, undefined)
-  assert.equal((plan.seed as any).tasks, undefined)
+})
+
+test('오더만 있어도 심는다 — 구조가 보드에서 오는 경우가 있다', () => {
+  const plan = planWarmStart({ orders: [{ id: 'SO-1', requested: 10 }] } as any, undefined, true)
+  assert.equal(plan.action, 'hydrate')
+  if (plan.action !== 'hydrate') return
+  assert.equal(plan.orderCount, 1)
 })
 
 test('벤치 트윈에는 심지 않는다 — 새 시작에서 용량을 재는 것이 목적이다', () => {
@@ -76,3 +145,68 @@ test('빠진 배열은 빈 배열로 다뤄지되 없는 것을 지어내지 않
   assert.deepEqual(plan.seed.equipment, [])
   assert.equal(plan.itemCount, 1)
 })
+
+test('확인해 둔 주목 신호를 이어받는다 — 재기동하면 다시 빨개지던 것', () => {
+  /*
+   * 확인 처리는 상태에서 파생되지 않는 유일한 축이다. 씨앗에서 빠지면 재기동 후 확인해 둔 신호가
+   * 전부 다시 활성으로 뜬다 — 오류는 나지 않고, 사용자는 "또 터졌다" 로 읽는다.
+   */
+  const plan = planWarmStart({ ...STATE, acked: ['bottleneck:bin-1', 'breakdown:fk-1'] } as any, undefined, true)
+  assert.equal(plan.action, 'hydrate')
+  if (plan.action !== 'hydrate') return
+  assert.deepEqual(plan.seed.acked, ['bottleneck:bin-1', 'breakdown:fk-1'])
+  assert.equal(plan.ackedCount, 2)
+})
+
+test('확인 처리만 있어도 심는다 — 신호를 확인해 둔 사실 자체가 이어받을 값어치가 있다', () => {
+  const plan = planWarmStart({ acked: ['bottleneck:bin-1'] } as any, undefined, true)
+  assert.equal(plan.action, 'hydrate')
+  if (plan.action !== 'hydrate') return
+  assert.equal(plan.ackedCount, 1)
+})
+
+test('확인 처리가 문자열 목록이 아니면 없는 것으로 본다 — 지어내지 않는다', () => {
+  const plan = planWarmStart({ ...STATE, acked: 'nope' } as any, undefined, true)
+  assert.equal(plan.action, 'hydrate')
+  if (plan.action !== 'hydrate') return
+  assert.equal(plan.ackedCount, 0)
+  assert.equal(plan.seed.acked, undefined)
+})
+
+/*
+ * ── 겹포장 회귀 방지 (2026-08-05) ──────────────────────────────────────────
+ * 체크포인트가 `{revision, state:{revision, state:{실제}}}` 로 저장돼, 꺼낸 값에 축이 하나도 없었다.
+ * 판정은 "심을 것이 없다"(no-state)로 답하고 **조용히** 넘어갔다 — 저널에 수천 건이 있고 캐시도
+ * 최신인데 트윈이 빈 채로 떴다. 오류도 로그도 없어서 이 경로가 처음부터 죽어 있었다.
+ */
+test('봉투로 감싸여 와도 벗겨서 심는다 — 체크포인트가 겹포장돼 복원이 죽었던 자리', () => {
+  const enveloped = { revision: 2684, state: { revision: 2684, state: STATE } }
+  const plan = planWarmStart(enveloped as any, undefined, true)
+  assert.equal(plan.action, 'hydrate', '봉투를 받으면 심을 것이 없다고 답하면 안 된다')
+  if (plan.action !== 'hydrate') return
+  assert.equal(plan.itemCount, 3)
+  assert.deepEqual(plan.seed.locations, STATE.locations)
+})
+
+test('한 겹 봉투도 벗긴다 — 저장 방식이 바뀌는 동안 두 모양이 함께 남는다', () => {
+  const plan = planWarmStart({ revision: 1, state: STATE } as any, undefined, true)
+  assert.equal(plan.action, 'hydrate')
+  if (plan.action !== 'hydrate') return
+  assert.equal(plan.itemCount, 3)
+})
+
+test('벗길 것이 없으면 그대로 쓴다 — 상태를 봉투로 착각하지 않는다', () => {
+  const plan = planWarmStart(STATE, undefined, true)
+  assert.equal(plan.action, 'hydrate')
+  if (plan.action !== 'hydrate') return
+  assert.equal(plan.itemCount, 3)
+})
+
+test('빈 봉투는 여전히 no-state — 벗겼는데도 아무 축이 없으면 심을 것이 없다', () => {
+  assert.deepEqual(planWarmStart({ revision: 5, state: { revision: 5 } } as any, undefined, true), { action: 'skip', reason: 'no-state' })
+})
+
+test('unwrapState 는 상태를 먼저 알아본다 — state 라는 이름의 축이 있어도 벗기지 않는다', () => {
+  const st = { items: [{ epc: 'a' }], state: 'whatever' }
+  assert.equal(unwrapState(st as any), st, '축이 있으면 그것이 상태다')
+})