@things-factory/headless-twin 10.0.6 → 10.0.7

package/test/vocabulary-guard.test.ts

@@ -0,0 +1,43 @@
+/*
+ * 어휘 가드 — 규칙은 커널이 한 벌 들고 있고(`@operato/twin-kernel` `retiredVocabularyIn`),
+ * 이 테스트는 **자기 패키지 소스를 훑는다.** 판정이 패키지마다 갈릴 수 없다.
+ *
+ * 계기(2026-08-01): 개명을 손으로 쓸다 같은 실수를 세 번 반복했다. 단어 경계로 찾으면 파생 식별자가
+ * 빠지고(`moverCount`·`locationType`), 빠진 것은 다음 파도에서야 드러난다. 그 사이 코드에는 두 어휘가
+ * 섞여 있고 다음 사람은 어느 쪽을 믿을지 모른다.
+ *
+ * 실패하면 위반 목록이 그대로 나온다 — 고치거나, 정당하면 그 줄에 `vocabulary-guard: allow <이유>` 를
+ * 남긴다(예외가 코드에 이유와 함께 남는다).
+ */
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { readdirSync, readFileSync, statSync } from 'node:fs'
+import { join } from 'node:path'
+
+import { retiredVocabularyIn } from '@operato/twin-kernel'
+
+const ROOTS = ['server', 'client'].map(d => new URL(`../${d}`, import.meta.url).pathname)
+
+function walk(dir: string, out: string[] = []): string[] {
+  let entries: string[]
+  try { entries = readdirSync(dir) } catch { return out }
+  for (const e of entries) {
+    const p = join(dir, e)
+    if (statSync(p).isDirectory()) walk(p, out)
+    else if (p.endsWith('.ts') && !p.endsWith('.d.ts')) out.push(p)
+  }
+  return out
+}
+
+test('소스에 은퇴한 어휘(location·mover)가 남아 있지 않다', () => {
+  const bad: string[] = []
+  for (const root of ROOTS) {
+    for (const f of walk(root)) {
+      readFileSync(f, 'utf-8').split('\n').forEach((line, i) => {
+        const hits = retiredVocabularyIn(line)
+        if (hits.length) bad.push(`${f.split('/').slice(-2).join('/')}:${i + 1}  ${[...new Set(hits)].join(', ')}`)
+      })
+    }
+  }
+  assert.deepEqual(bad, [], `은퇴 어휘 ${bad.length}곳:\n${bad.slice(0, 60).join('\n')}${bad.length > 60 ? `\n… ${bad.length - 60} more` : ''}`)
+})

package/test/warm-start.test.ts

@@ -11,9 +11,9 @@ import assert from 'node:assert/strict'
 import { planWarmStart } from '../server/engine/warm-start.ts'
 
 const STATE = {
-  nodes: [{ id: 'dock-recv' }, { id: 'rack-1' }],
+  locations: [{ id: 'dock-recv' }, { id: 'rack-1' }],
   items: [{ epc: 'a' }, { epc: 'b' }, { epc: 'c' }],
-  movers: [{ id: 'fork-1' }],
+  equipment: [{ id: 'fork-1' }],
   orders: [{ id: 'SO-1', kind: 'outbound', status: 'created', progress: 0.5 }],
   tasks: [{ id: 't1' }]
 }
@@ -23,15 +23,15 @@ test('상태가 있으면 심는다 — 재고·노드·무버', () => {
   assert.equal(plan.action, 'hydrate')
   if (plan.action !== 'hydrate') return
   assert.equal(plan.itemCount, 3)
-  assert.equal(plan.moverCount, 1)
-  assert.deepEqual(plan.seed.nodes, STATE.nodes)
+  assert.equal(plan.equipmentCount, 1)
+  assert.deepEqual(plan.seed.locations, STATE.locations)
 })
 
 test('오더는 심지 않는다 — 스냅샷에 requested/fulfilled 가 없어 지어내야 하기 때문', () => {
   const plan = planWarmStart(STATE, undefined, true)
   assert.equal(plan.action, 'hydrate')
   if (plan.action !== 'hydrate') return
-  assert.deepEqual(Object.keys(plan.seed).sort(), ['items', 'movers', 'nodes'])
+  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)
 })
@@ -49,11 +49,11 @@ test('벤치 판정은 상태 유무보다 먼저다 — 상태가 없어도 이
 test('심을 상태가 없으면 조용히 넘어간다 — 처음 만든 트윈의 정상 경로다', () => {
   assert.deepEqual(planWarmStart(null, undefined, true), { action: 'skip', reason: 'no-state' })
   assert.deepEqual(planWarmStart(undefined, undefined, true), { action: 'skip', reason: 'no-state' })
-  assert.deepEqual(planWarmStart({ nodes: [], items: [], movers: [] }, undefined, true), { action: 'skip', reason: 'no-state' })
+  assert.deepEqual(planWarmStart({ locations: [], items: [], equipment: [] }, undefined, true), { action: 'skip', reason: 'no-state' })
 })
 
 test('노드만 있어도 심는다 — 구조 배치가 복원되면 화면이 살아난다', () => {
-  const plan = planWarmStart({ nodes: [{ id: 'n1' }], items: [], movers: [] }, undefined, true)
+  const plan = planWarmStart({ locations: [{ id: 'n1' }], items: [], equipment: [] }, undefined, true)
   assert.equal(plan.action, 'hydrate')
   if (plan.action !== 'hydrate') return
   assert.equal(plan.itemCount, 0)
@@ -72,7 +72,7 @@ test('빠진 배열은 빈 배열로 다뤄지되 없는 것을 지어내지 않
   const plan = planWarmStart({ items: [{ epc: 'a' }] } as any, undefined, true)
   assert.equal(plan.action, 'hydrate')
   if (plan.action !== 'hydrate') return
-  assert.deepEqual(plan.seed.nodes, [])
-  assert.deepEqual(plan.seed.movers, [])
+  assert.deepEqual(plan.seed.locations, [])
+  assert.deepEqual(plan.seed.equipment, [])
   assert.equal(plan.itemCount, 1)
 })