@things-factory/headless-twin 10.0.11 → 10.0.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (369) hide show
  1. package/dist-server/engine/canonical-ingest.d.ts +81 -3
  2. package/dist-server/engine/canonical-ingest.js +89 -10
  3. package/dist-server/engine/canonical-ingest.js.map +1 -1
  4. package/dist-server/engine/command-routing.js +1 -1
  5. package/dist-server/engine/command-routing.js.map +1 -1
  6. package/dist-server/engine/declared-stimulus.d.ts +43 -0
  7. package/dist-server/engine/declared-stimulus.js +57 -0
  8. package/dist-server/engine/declared-stimulus.js.map +1 -0
  9. package/dist-server/engine/index.d.ts +5 -0
  10. package/dist-server/engine/index.js +6 -0
  11. package/dist-server/engine/index.js.map +1 -1
  12. package/dist-server/engine/ingest-health.d.ts +335 -0
  13. package/dist-server/engine/ingest-health.js +434 -0
  14. package/dist-server/engine/ingest-health.js.map +1 -0
  15. package/dist-server/engine/integration-coverage.d.ts +76 -0
  16. package/dist-server/engine/integration-coverage.js +73 -0
  17. package/dist-server/engine/integration-coverage.js.map +1 -0
  18. package/dist-server/engine/integration-probes.d.ts +65 -0
  19. package/dist-server/engine/integration-probes.js +100 -0
  20. package/dist-server/engine/integration-probes.js.map +1 -0
  21. package/dist-server/engine/integration-runner.d.ts +45 -0
  22. package/dist-server/engine/integration-runner.js +59 -0
  23. package/dist-server/engine/integration-runner.js.map +1 -0
  24. package/dist-server/engine/integration-target-profile.d.ts +57 -0
  25. package/dist-server/engine/integration-target-profile.js +79 -0
  26. package/dist-server/engine/integration-target-profile.js.map +1 -0
  27. package/dist-server/engine/kpi-fold.d.ts +39 -0
  28. package/dist-server/engine/kpi-fold.js +68 -5
  29. package/dist-server/engine/kpi-fold.js.map +1 -1
  30. package/dist-server/engine/kpi-query.d.ts +3 -3
  31. package/dist-server/engine/kpi-query.js +132 -18
  32. package/dist-server/engine/kpi-query.js.map +1 -1
  33. package/dist-server/engine/live-feed-registry.d.ts +1 -1
  34. package/dist-server/engine/live-feed-registry.js +3 -17
  35. package/dist-server/engine/live-feed-registry.js.map +1 -1
  36. package/dist-server/engine/load-meter.d.ts +1 -1
  37. package/dist-server/engine/load-meter.js +12 -3
  38. package/dist-server/engine/load-meter.js.map +1 -1
  39. package/dist-server/engine/local-declarations.d.ts +3 -6
  40. package/dist-server/engine/local-declarations.js +97 -16
  41. package/dist-server/engine/local-declarations.js.map +1 -1
  42. package/dist-server/engine/log.d.ts +18 -0
  43. package/dist-server/engine/log.js +80 -0
  44. package/dist-server/engine/log.js.map +1 -0
  45. package/dist-server/engine/loop-lag.d.ts +54 -0
  46. package/dist-server/engine/loop-lag.js +87 -0
  47. package/dist-server/engine/loop-lag.js.map +1 -0
  48. package/dist-server/engine/measured-yield.d.ts +42 -0
  49. package/dist-server/engine/measured-yield.js +75 -0
  50. package/dist-server/engine/measured-yield.js.map +1 -0
  51. package/dist-server/engine/model-gap.d.ts +108 -0
  52. package/dist-server/engine/model-gap.js +95 -0
  53. package/dist-server/engine/model-gap.js.map +1 -0
  54. package/dist-server/engine/operation-basis.d.ts +16 -0
  55. package/dist-server/engine/operation-basis.js +20 -2
  56. package/dist-server/engine/operation-basis.js.map +1 -1
  57. package/dist-server/engine/property-effects.js +17 -0
  58. package/dist-server/engine/property-effects.js.map +1 -1
  59. package/dist-server/engine/restart-policy.d.ts +13 -0
  60. package/dist-server/engine/restart-policy.js +52 -0
  61. package/dist-server/engine/restart-policy.js.map +1 -0
  62. package/dist-server/engine/runtime-key.js +1 -1
  63. package/dist-server/engine/runtime-key.js.map +1 -1
  64. package/dist-server/engine/spec-coverage.d.ts +8 -0
  65. package/dist-server/engine/spec-coverage.js +3 -1
  66. package/dist-server/engine/spec-coverage.js.map +1 -1
  67. package/dist-server/engine/stage-path.d.ts +83 -0
  68. package/dist-server/engine/stage-path.js +118 -0
  69. package/dist-server/engine/stage-path.js.map +1 -0
  70. package/dist-server/engine/twin-engine.d.ts +400 -31
  71. package/dist-server/engine/twin-engine.js +1198 -187
  72. package/dist-server/engine/twin-engine.js.map +1 -1
  73. package/dist-server/index.js +35 -3
  74. package/dist-server/index.js.map +1 -1
  75. package/dist-server/migrations/1786100000000-PromoteEventActionAndSyncWarnings.d.ts +5 -0
  76. package/dist-server/migrations/1786100000000-PromoteEventActionAndSyncWarnings.js +58 -0
  77. package/dist-server/migrations/1786100000000-PromoteEventActionAndSyncWarnings.js.map +1 -0
  78. package/dist-server/migrations/1786200000000-CarryLiveFeedCursor.d.ts +5 -0
  79. package/dist-server/migrations/1786200000000-CarryLiveFeedCursor.js +55 -0
  80. package/dist-server/migrations/1786200000000-CarryLiveFeedCursor.js.map +1 -0
  81. package/dist-server/migrations/index.js +7 -1
  82. package/dist-server/migrations/index.js.map +1 -1
  83. package/dist-server/service/index.d.ts +5 -2
  84. package/dist-server/service/index.js +18 -7
  85. package/dist-server/service/index.js.map +1 -1
  86. package/dist-server/service/reference/control-routing.d.ts +14 -0
  87. package/dist-server/service/reference/control-routing.js +64 -0
  88. package/dist-server/service/reference/control-routing.js.map +1 -0
  89. package/dist-server/service/reference/discovery-result.d.ts +1 -1
  90. package/dist-server/service/reference/discovery-result.js +1 -1
  91. package/dist-server/service/reference/discovery-result.js.map +1 -1
  92. package/dist-server/service/reference/index.d.ts +5 -1
  93. package/dist-server/service/reference/index.js +8 -1
  94. package/dist-server/service/reference/index.js.map +1 -1
  95. package/dist-server/service/reference/reference-adapter.d.ts +251 -3
  96. package/dist-server/service/reference/reference-adapter.js +43 -1
  97. package/dist-server/service/reference/reference-adapter.js.map +1 -1
  98. package/dist-server/service/reference/reference-assessment.d.ts +68 -0
  99. package/dist-server/service/reference/reference-assessment.js +136 -0
  100. package/dist-server/service/reference/reference-assessment.js.map +1 -0
  101. package/dist-server/service/reference/reference-live.d.ts +12 -1
  102. package/dist-server/service/reference/reference-live.js +119 -14
  103. package/dist-server/service/reference/reference-live.js.map +1 -1
  104. package/dist-server/service/reference/reference-master.d.ts +47 -1
  105. package/dist-server/service/reference/reference-master.js +34 -4
  106. package/dist-server/service/reference/reference-master.js.map +1 -1
  107. package/dist-server/service/reference/reference-probe.d.ts +92 -0
  108. package/dist-server/service/reference/reference-probe.js +186 -0
  109. package/dist-server/service/reference/reference-probe.js.map +1 -0
  110. package/dist-server/service/reference/reference-progress-subscription.d.ts +17 -0
  111. package/dist-server/service/reference/reference-progress-subscription.js +94 -0
  112. package/dist-server/service/reference/reference-progress-subscription.js.map +1 -0
  113. package/dist-server/service/reference/reference-progress.d.ts +38 -0
  114. package/dist-server/service/reference/reference-progress.js +71 -0
  115. package/dist-server/service/reference/reference-progress.js.map +1 -0
  116. package/dist-server/service/reference/reference-resolver.d.ts +3 -3
  117. package/dist-server/service/reference/reference-resolver.js +242 -58
  118. package/dist-server/service/reference/reference-resolver.js.map +1 -1
  119. package/dist-server/service/reference/twin-reference.d.ts +32 -0
  120. package/dist-server/service/reference/twin-reference.js +10 -0
  121. package/dist-server/service/reference/twin-reference.js.map +1 -1
  122. package/dist-server/service/twin-audit/command-audit.d.ts +34 -0
  123. package/dist-server/service/twin-audit/command-audit.js +15 -1
  124. package/dist-server/service/twin-audit/command-audit.js.map +1 -1
  125. package/dist-server/service/twin-audit/twin-audit-event.d.ts +3 -0
  126. package/dist-server/service/twin-audit/twin-audit-event.js +10 -0
  127. package/dist-server/service/twin-audit/twin-audit-event.js.map +1 -1
  128. package/dist-server/service/twin-control/twin-control-mutation.d.ts +15 -2
  129. package/dist-server/service/twin-control/twin-control-mutation.js +88 -36
  130. package/dist-server/service/twin-control/twin-control-mutation.js.map +1 -1
  131. package/dist-server/service/twin-event/journal-count.d.ts +21 -0
  132. package/dist-server/service/twin-event/journal-count.js +26 -0
  133. package/dist-server/service/twin-event/journal-count.js.map +1 -0
  134. package/dist-server/service/twin-event/twin-event-keys.d.ts +9 -0
  135. package/dist-server/service/twin-event/twin-event-keys.js +15 -18
  136. package/dist-server/service/twin-event/twin-event-keys.js.map +1 -1
  137. package/dist-server/service/twin-event/twin-event-type.d.ts +3 -1
  138. package/dist-server/service/twin-event/twin-event-type.js +18 -1
  139. package/dist-server/service/twin-event/twin-event-type.js.map +1 -1
  140. package/dist-server/service/twin-event/twin-event.d.ts +1 -0
  141. package/dist-server/service/twin-event/twin-event.js +9 -1
  142. package/dist-server/service/twin-event/twin-event.js.map +1 -1
  143. package/dist-server/service/twin-forecast/twin-forecast-query.js +2 -1
  144. package/dist-server/service/twin-forecast/twin-forecast-query.js.map +1 -1
  145. package/dist-server/service/twin-ingest-window/index.d.ts +5 -0
  146. package/dist-server/service/twin-ingest-window/index.js +10 -0
  147. package/dist-server/service/twin-ingest-window/index.js.map +1 -0
  148. package/dist-server/service/twin-ingest-window/twin-ingest-window-query.d.ts +12 -0
  149. package/dist-server/service/twin-ingest-window/twin-ingest-window-query.js +123 -0
  150. package/dist-server/service/twin-ingest-window/twin-ingest-window-query.js.map +1 -0
  151. package/dist-server/service/twin-ingest-window/twin-ingest-window-writer.d.ts +1 -0
  152. package/dist-server/service/twin-ingest-window/twin-ingest-window-writer.js +51 -0
  153. package/dist-server/service/twin-ingest-window/twin-ingest-window-writer.js.map +1 -0
  154. package/dist-server/service/twin-ingest-window/twin-ingest-window.d.ts +16 -0
  155. package/dist-server/service/twin-ingest-window/twin-ingest-window.js +108 -0
  156. package/dist-server/service/twin-ingest-window/twin-ingest-window.js.map +1 -0
  157. package/dist-server/service/twin-instance/twin-instance.d.ts +1 -1
  158. package/dist-server/service/twin-instance/twin-instance.js +2 -2
  159. package/dist-server/service/twin-instance/twin-instance.js.map +1 -1
  160. package/dist-server/service/twin-journal/twin-journal-query.js +58 -5
  161. package/dist-server/service/twin-journal/twin-journal-query.js.map +1 -1
  162. package/dist-server/service/twin-lifecycle/twin-lifecycle-mutation.d.ts +14 -0
  163. package/dist-server/service/twin-lifecycle/twin-lifecycle-mutation.js +74 -3
  164. package/dist-server/service/twin-lifecycle/twin-lifecycle-mutation.js.map +1 -1
  165. package/dist-server/service/twin-metrics/twin-metrics-query.d.ts +1 -0
  166. package/dist-server/service/twin-metrics/twin-metrics-query.js +78 -3
  167. package/dist-server/service/twin-metrics/twin-metrics-query.js.map +1 -1
  168. package/dist-server/service/twin-model/axis-journal-evidence.d.ts +2 -0
  169. package/dist-server/service/twin-model/axis-journal-evidence.js +89 -0
  170. package/dist-server/service/twin-model/axis-journal-evidence.js.map +1 -0
  171. package/dist-server/service/twin-model/epcis-coverage.d.ts +1 -1
  172. package/dist-server/service/twin-model/epcis-coverage.js +19 -7
  173. package/dist-server/service/twin-model/epcis-coverage.js.map +1 -1
  174. package/dist-server/service/twin-model/iec61850-coverage.d.ts +1 -1
  175. package/dist-server/service/twin-model/iec61850-coverage.js +18 -7
  176. package/dist-server/service/twin-model/iec61850-coverage.js.map +1 -1
  177. package/dist-server/service/twin-model/isa95-coverage.d.ts +14 -0
  178. package/dist-server/service/twin-model/isa95-coverage.js +23 -9
  179. package/dist-server/service/twin-model/isa95-coverage.js.map +1 -1
  180. package/dist-server/service/twin-model/item-ref.d.ts +24 -0
  181. package/dist-server/service/twin-model/item-ref.js +88 -0
  182. package/dist-server/service/twin-model/item-ref.js.map +1 -0
  183. package/dist-server/service/twin-model/name-index.d.ts +36 -0
  184. package/dist-server/service/twin-model/name-index.js +116 -0
  185. package/dist-server/service/twin-model/name-index.js.map +1 -0
  186. package/dist-server/service/twin-model/project-structure.js +1 -1
  187. package/dist-server/service/twin-model/project-structure.js.map +1 -1
  188. package/dist-server/service/twin-model/status-tally.d.ts +9 -0
  189. package/dist-server/service/twin-model/status-tally.js +37 -0
  190. package/dist-server/service/twin-model/status-tally.js.map +1 -0
  191. package/dist-server/service/twin-model/twin-lineage-query.js +40 -12
  192. package/dist-server/service/twin-model/twin-lineage-query.js.map +1 -1
  193. package/dist-server/service/twin-model/twin-model-item-query.js +38 -39
  194. package/dist-server/service/twin-model/twin-model-item-query.js.map +1 -1
  195. package/dist-server/service/twin-model/twin-model-query.js +157 -5
  196. package/dist-server/service/twin-model/twin-model-query.js.map +1 -1
  197. package/dist-server/service/twin-model/twin-model-tree-query.js +7 -0
  198. package/dist-server/service/twin-model/twin-model-tree-query.js.map +1 -1
  199. package/dist-server/service/twin-readiness/index.d.ts +2 -0
  200. package/dist-server/service/twin-readiness/index.js +6 -0
  201. package/dist-server/service/twin-readiness/index.js.map +1 -0
  202. package/dist-server/service/twin-readiness/twin-readiness-query.d.ts +3 -0
  203. package/dist-server/service/twin-readiness/twin-readiness-query.js +103 -0
  204. package/dist-server/service/twin-readiness/twin-readiness-query.js.map +1 -0
  205. package/dist-server/service/twin-space/twin-space-resolver.d.ts +2 -2
  206. package/dist-server/service/twin-space/twin-space-resolver.js +5 -4
  207. package/dist-server/service/twin-space/twin-space-resolver.js.map +1 -1
  208. package/dist-shared/entity-delta.d.ts +23 -3
  209. package/dist-shared/entity-delta.js +12 -8
  210. package/dist-shared/entity-delta.js.map +1 -1
  211. package/dist-shared/kpi-broadcast.js +1 -1
  212. package/dist-shared/kpi-broadcast.js.map +1 -1
  213. package/dist-shared/touched-items.d.ts +7 -0
  214. package/dist-shared/touched-items.js +80 -0
  215. package/dist-shared/touched-items.js.map +1 -0
  216. package/package.json +7 -7
  217. package/server/engine/canonical-ingest.ts +164 -15
  218. package/server/engine/command-routing.ts +1 -1
  219. package/server/engine/declared-stimulus.ts +66 -0
  220. package/server/engine/index.ts +6 -0
  221. package/server/engine/ingest-health.ts +704 -0
  222. package/server/engine/integration-coverage.ts +147 -0
  223. package/server/engine/integration-probes.ts +144 -0
  224. package/server/engine/integration-runner.ts +95 -0
  225. package/server/engine/integration-target-profile.ts +103 -0
  226. package/server/engine/kpi-fold.ts +101 -5
  227. package/server/engine/kpi-query.ts +137 -23
  228. package/server/engine/live-feed-registry.ts +4 -3
  229. package/server/engine/load-meter.ts +12 -3
  230. package/server/engine/local-declarations.ts +97 -19
  231. package/server/engine/log.ts +72 -0
  232. package/server/engine/loop-lag.ts +120 -0
  233. package/server/engine/measured-yield.ts +89 -0
  234. package/server/engine/model-gap.ts +168 -0
  235. package/server/engine/operation-basis.ts +33 -2
  236. package/server/engine/property-effects.ts +17 -0
  237. package/server/engine/restart-policy.ts +55 -0
  238. package/server/engine/runtime-key.ts +1 -1
  239. package/server/engine/spec-coverage.ts +23 -3
  240. package/server/engine/stage-path.ts +172 -0
  241. package/server/engine/twin-engine.ts +1318 -186
  242. package/server/index.ts +36 -3
  243. package/server/migrations/1786100000000-PromoteEventActionAndSyncWarnings.ts +54 -0
  244. package/server/migrations/1786200000000-CarryLiveFeedCursor.ts +53 -0
  245. package/server/migrations/index.ts +7 -1
  246. package/server/service/index.ts +11 -0
  247. package/server/service/reference/control-routing.ts +62 -0
  248. package/server/service/reference/discovery-result.ts +1 -1
  249. package/server/service/reference/index.ts +7 -1
  250. package/server/service/reference/reference-adapter.ts +275 -5
  251. package/server/service/reference/reference-assessment.ts +215 -0
  252. package/server/service/reference/reference-live.ts +126 -14
  253. package/server/service/reference/reference-master.ts +64 -4
  254. package/server/service/reference/reference-probe.ts +264 -0
  255. package/server/service/reference/reference-progress-subscription.ts +73 -0
  256. package/server/service/reference/reference-progress.ts +95 -0
  257. package/server/service/reference/reference-resolver.ts +246 -19
  258. package/server/service/reference/twin-reference.ts +39 -1
  259. package/server/service/twin-audit/command-audit.ts +34 -1
  260. package/server/service/twin-audit/twin-audit-event.ts +20 -0
  261. package/server/service/twin-control/twin-control-mutation.ts +78 -30
  262. package/server/service/twin-event/journal-count.ts +53 -0
  263. package/server/service/twin-event/twin-event-keys.ts +16 -1
  264. package/server/service/twin-event/twin-event-type.ts +26 -2
  265. package/server/service/twin-event/twin-event.ts +7 -0
  266. package/server/service/twin-forecast/twin-forecast-query.ts +2 -1
  267. package/server/service/twin-ingest-window/index.ts +7 -0
  268. package/server/service/twin-ingest-window/twin-ingest-window-query.ts +125 -0
  269. package/server/service/twin-ingest-window/twin-ingest-window-writer.ts +57 -0
  270. package/server/service/twin-ingest-window/twin-ingest-window.ts +113 -0
  271. package/server/service/twin-instance/twin-instance.ts +16 -10
  272. package/server/service/twin-journal/twin-journal-query.ts +59 -5
  273. package/server/service/twin-lifecycle/twin-lifecycle-mutation.ts +79 -4
  274. package/server/service/twin-metrics/twin-metrics-query.ts +81 -3
  275. package/server/service/twin-model/axis-journal-evidence.ts +57 -0
  276. package/server/service/twin-model/epcis-coverage.ts +2 -8
  277. package/server/service/twin-model/iec61850-coverage.ts +2 -8
  278. package/server/service/twin-model/isa95-coverage.ts +22 -9
  279. package/server/service/twin-model/item-ref.ts +80 -0
  280. package/server/service/twin-model/name-index.ts +94 -0
  281. package/server/service/twin-model/project-structure.ts +1 -1
  282. package/server/service/twin-model/status-tally.ts +37 -0
  283. package/server/service/twin-model/twin-lineage-query.ts +38 -9
  284. package/server/service/twin-model/twin-model-item-query.ts +26 -27
  285. package/server/service/twin-model/twin-model-query.ts +156 -5
  286. package/server/service/twin-model/twin-model-tree-query.ts +7 -0
  287. package/server/service/twin-readiness/index.ts +3 -0
  288. package/server/service/twin-readiness/twin-readiness-query.ts +96 -0
  289. package/server/service/twin-space/twin-space-resolver.ts +5 -4
  290. package/shared/entity-delta.ts +31 -7
  291. package/shared/kpi-broadcast.ts +1 -1
  292. package/shared/touched-items.ts +73 -0
  293. package/test/adopt-structure-live.test.ts +7 -7
  294. package/test/axis-journal-evidence.test.ts +71 -0
  295. package/test/axis-read.test.ts +101 -1
  296. package/test/boot-resume.test.ts +93 -27
  297. package/test/broadcast-cost-baseline.test.ts +200 -0
  298. package/test/broadcast-period.test.ts +58 -0
  299. package/test/canonical-ingest-vocabularies.test.ts +36 -1
  300. package/test/canonical-quantity-door.test.ts +61 -0
  301. package/test/command-routing.test.ts +1 -1
  302. package/test/control-capability.test.ts +103 -0
  303. package/test/declared-location-types.test.ts +89 -0
  304. package/test/declared-stimulus.test.ts +88 -0
  305. package/test/discovery-result.test.ts +1 -1
  306. package/test/duration-estimators.test.ts +1 -1
  307. package/test/entity-delta.test.ts +2 -2
  308. package/test/ingest-bench.test.ts +3 -3
  309. package/test/ingest-health-engine.test.ts +248 -0
  310. package/test/ingest-health-wiring.test.ts +119 -0
  311. package/test/ingest-health.test.ts +306 -0
  312. package/test/ingest-history.test.ts +247 -0
  313. package/test/ingest-running-guard.test.ts +5 -5
  314. package/test/instance-cache-lifecycle.test.ts +1 -1
  315. package/test/integration-probes.test.ts +103 -0
  316. package/test/integration-runner.test.ts +95 -0
  317. package/test/item-ref.test.ts +78 -0
  318. package/test/journal-read-discipline.test.ts +177 -0
  319. package/test/journal-retention.test.ts +133 -0
  320. package/test/journal-sort-axis.test.ts +142 -0
  321. package/test/journal-write-door.test.ts +110 -0
  322. package/test/journal-write-trend.test.ts +115 -0
  323. package/test/kernel-kind-guard.test.ts +4 -4
  324. package/test/kpi-baseline-db.test.ts +1 -1
  325. package/test/kpi-fold.test.ts +90 -3
  326. package/test/kpi-query-bench.test.ts +3 -3
  327. package/test/lineage-survives-restart.test.ts +20 -4
  328. package/test/live-cursor-wiring.test.ts +87 -0
  329. package/test/live-feed-registry.test.ts +15 -7
  330. package/test/live-kernel-facts.test.ts +7 -7
  331. package/test/live-mirror-parity.test.ts +6 -0
  332. package/test/load-meter.test.ts +29 -15
  333. package/test/local-declarations.test.ts +109 -2
  334. package/test/log-stamp.test.ts +59 -0
  335. package/test/loop-lag.test.ts +82 -0
  336. package/test/measured-yield.test.ts +90 -0
  337. package/test/model-gap.test.ts +153 -0
  338. package/test/oee-accumulator.test.ts +4 -0
  339. package/test/operation-basis.test.ts +28 -1
  340. package/test/operational-vocabulary.test.ts +108 -0
  341. package/test/operations-capability-db.test.ts +4 -4
  342. package/test/project-structure-db.test.ts +1 -1
  343. package/test/projection-reaches-screen.test.ts +1 -1
  344. package/test/property-effects.test.ts +28 -0
  345. package/test/read-failure-visible.test.ts +145 -0
  346. package/test/reference-grounding.test.ts +70 -0
  347. package/test/resolve-ts-siblings.mjs +52 -0
  348. package/test/restart-policy.test.ts +111 -0
  349. package/test/resync-origin-site.test.ts +7 -1
  350. package/test/revision-axis.test.ts +93 -0
  351. package/test/runtime-key.test.ts +2 -2
  352. package/test/scale-twin-bench.test.ts +2 -2
  353. package/test/source-outcome-audit.test.ts +104 -0
  354. package/test/spec-coverage.test.ts +1 -1
  355. package/test/stage-path.test.ts +95 -0
  356. package/test/standard-coverage.test.ts +15 -3
  357. package/test/status-tally.test.ts +55 -0
  358. package/test/structure-revision-db.test.ts +31 -27
  359. package/test/tenant-registry-db.test.ts +3 -3
  360. package/test/time-range.test.ts +152 -0
  361. package/test/touched-items.test.ts +61 -0
  362. package/test/twin-event-keys.test.ts +10 -2
  363. package/test/twin-model-item-db.test.ts +5 -3
  364. package/test/twin-model-tree-db.test.ts +7 -7
  365. package/test/twin-origin-resync.test.ts +4 -4
  366. package/test/warm-start-seam.test.ts +4 -0
  367. package/test/yield-loop.test.ts +199 -0
  368. package/tsconfig.shared.tsbuildinfo +1 -1
  369. package/tsconfig.tsbuildinfo +1 -1
@@ -1 +1 @@
1
- {"version":3,"file":"local-declarations.js","sourceRoot":"","sources":["../../server/engine/local-declarations.ts"],"names":[],"mappings":";;AAwIA,sDAEC;AAGD,4CAEC;AA6GD,sCAKC;AAQD,0DAmBC;AAOD,8DAwFC;AAQD,wDAqBC;AAYD,wDA4GC;AAsBD,0DA2BC;AAUD,wCA4DC;AAgBD,wDAoCC;AA3rBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,sDAAgG;AAEhG,+DAAwE;AACxE,+DAA4D;AAuF5D,qDAAqD;AACrD,SAAS,MAAM,CAAC,IAAwB,EAAE,UAAkB;IAC1D,8DAA8D;IAC9D,OAAO,uBAAuB,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,UAAU,CAAC,CAAA;AACrE,CAAC;AAED,qDAAqD;AACrD,SAAgB,qBAAqB,CAAC,IAAwB;IAC5D,OAAO,IAAI,KAAK,KAAK,CAAA;AACvB,CAAC;AAED,sDAAsD;AACtD,SAAgB,gBAAgB,CAAC,IAAwB;IACvD,OAAO,uBAAuB,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAA;AACjD,CAAC;AAmCD;;;;;;;;GAQG;AACH;;;;;GAKG;AACH,MAAM,eAAe,GAA2B,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,CAAA;AAE3F,MAAM,YAAY,GAA6B;IAC7C;;;;;;OAMG;IACH;QACE,EAAE,EAAE,gCAAkB,CAAC,eAAe;QACtC,GAAG,EAAE,GAAG;QACR,QAAQ,EAAE,WAAW;QACrB,KAAK,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC;QACf,IAAI,EAAE,oIAAoI;KAC3I;IACD;QACE,EAAE,EAAE,gCAAkB,CAAC,SAAS;QAChC,GAAG,EAAE,GAAG;QACR,QAAQ,EAAE,WAAW;QACrB,KAAK,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC;QACf,IAAI,EAAE,0IAA0I;KACjJ;IACD;QACE,EAAE,EAAE,gCAAkB,CAAC,eAAe;QACtC,QAAQ,EAAE,WAAW;QACrB,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,+HAA+H;KACtI;IACD;QACE,EAAE,EAAE,wCAAkB,CAAC,KAAK;QAC5B,QAAQ,EAAE,WAAW;QACrB,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC;QACjB,IAAI,EAAE,0GAA0G;QAChH,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,kCAAY,CAAC;KACtC;IACD;;;;;;OAMG;IACH;QACE,EAAE,EAAE,gCAAkB,CAAC,QAAQ;QAC/B,QAAQ,EAAE,WAAW;QACrB,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC;QACrB,IAAI,EAAE,+KAA+K;QACrL,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC;KACzC;CACF,CAAA;AAED;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,KAAsB,EAAE,GAAW;IAC/D,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IACvB,MAAM,GAAG,GAAG,eAAe,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;IACrD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAA;IAC3D,OAAO,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,IAAI,GAAG,CAAA;AACjC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,uBAAuB,CAAC,IAAwB;IAC9D,MAAM,MAAM,GAAG,qBAAqB,CAAC,IAAI,CAAC;QACxC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,+BAAwC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5E,EAAE;YACF,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtC,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAyB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC,CAAC;QACL,CAAC,CAAC,EAAE,CAAA;IACN;;;OAGG;IACH,MAAM,GAAG,GAA6B,CAAC,GAAG,YAAY,EAAE,GAAG,MAAM,CAAC,CAAA;IAClE,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;QACjB,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,IAAA,0CAAoB,EAAC,CAAC,CAAC,EAAE,CAAC,CAAA;QACvD,OAAO,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;IACxC,CAAC,CAAC,CAAA;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAgB,yBAAyB,CACvC,IAAwB,EACxB,YAA4D,EAC5D,IAQC;IAED,MAAM,QAAQ,GAAuB,EAAE,CAAA;IACvC,MAAM,QAAQ,GAA0B,EAAE,CAAA;IAC1C,KAAK,MAAM,CAAC,IAAI,YAAY,IAAI,EAAE,EAAE,CAAC;QACnC,MAAM,MAAM,GAAsB,CAAC,EAAE,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAA;QAChI,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;QACrC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,qDAAqD;YACrD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAA;YACzE,SAAQ;QACV,CAAC;QACD,MAAM,KAAK,GAAoC,EAAE,CAAA;QACjD,KAAK,MAAM,CAAC,IAAI,CAAC,EAAE,UAAU,IAAI,EAAE,EAAE,CAAC;YACpC,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;YAC7C,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAA;gBACvE,SAAQ;YACV,CAAC;YACD,MAAM,GAAG,GAAG,CAAC,EAAE,KAAK,CAAA;YACpB,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;gBACnE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAA;gBAChE,SAAQ;YACV,CAAC;YACD,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,wBAAwB,EAAE,CAAC,CAAA;gBAC3E,SAAQ;YACV,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;YACrC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC,CAAA;gBACrE,SAAQ;YACV,CAAC;YACD;;;eAGG;YACH,IAAI,IAAI,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,UAAU,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAA;gBAChH,SAAQ;YACV,CAAC;YACD,yDAAyD;YACzD,IAAI,MAAM,KAAK,WAAW,IAAI,IAAI,EAAE,eAAe,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC1F,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,mBAAmB,EAAE,QAAQ,EAAE,UAAU,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAA;gBAClI,SAAQ;YACV,CAAC;YACD,IAAI,IAAI,CAAC,QAAQ,KAAK,WAAW,EAAE,CAAC;gBAClC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;gBACrB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;oBACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;oBACtF,SAAQ;gBACV,CAAC;gBACD,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC3D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;oBACtF,SAAQ;gBACV,CAAC;YACH,CAAC;YACD;;;eAGG;YACH,MAAM,GAAG,GAAG,MAAM,CAAE,CAAS,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;YAChD,IAAI,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;gBAC5B,IAAI,CAAC,GAAG,EAAE,CAAC;oBACT,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,UAAU,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAA;oBACnH,SAAQ;gBACV,CAAC;gBACD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;oBACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAA;oBAClH,SAAQ;gBACV,CAAC;YACH,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;QAC7E,CAAC;QACD,IAAI,KAAK,CAAC,MAAM;YAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAA;IACpE,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAA;AAC/B,CAAC;AAED;;;;;GAKG;AACH,SAAgB,sBAAsB,CACpC,OAAuD,EACvD,QAAqC;IAErC,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAU,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAA;IACnD,MAAM,GAAG,GAAG,IAAI,GAAG,EAA4B,CAAA;IAC/C,KAAK,MAAM,CAAC,IAAI,OAAO,IAAI,EAAE;QAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC,CAAA;IACpG,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAA;QAC7B,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QACtB,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC,CAAA;YACnD,SAAQ;QACV,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;YAC7B,MAAM,EAAE,GAAG,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAA;YACvD,IAAI,EAAE,IAAI,CAAC;gBAAE,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAA;;gBACrC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAA;QACpC,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,CAAA;AAC1B,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,sBAAsB,CACpC,KAAQ,EACR,YAA4D;IAa5D,MAAM,KAAK,GAAG,YAAY,IAAI,EAAE,CAAA;IAChC,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAA;IAElF,MAAM,cAAc,GAAqC,EAAE,CAAA;IAC3D,MAAM,UAAU,GAAyD,EAAE,CAAA;IAC3E,wDAAwD;IACxD,MAAM,KAAK,GAAuB,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAE3G,MAAM,GAAG,GAAG,CAAC,IAAuB,EAAE,CAAmB,EAAE,IAAsB,EAAW,EAAE;QAC5F,MAAM,IAAI,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAA;QACjE,IAAI,CAAC,IAAI;YAAE,OAAO,KAAK,CAAA;QACvB,MAAM,KAAK,GAAU,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QAC/E,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7C,MAAM,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;YACzB,MAAM,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAA;YAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;YAChC;;;;;;;;;;;eAWG;YACH,IAAI,EAAE,GAAG,CAAC;gBAAE,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAA;iBAC5B,IAAI,KAAK,CAAC,EAAE,CAAC,EAAE,MAAM,KAAK,SAAS;gBAAE,KAAK,CAAC,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC,CAAA;YACzF;;;;;;eAMG;YACH,MAAM,IAAI,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,GAAG,CAAE,CAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAE,CAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,OAAgB,EAAE,CAAA;YACvI,IAAI,EAAE,IAAI,CAAC;gBAAE,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,CAAA;;gBAC7C,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACvB,CAAC;QACD,IAAI,CAAC,UAAU,GAAG,KAAK,CAAA;QACvB,OAAO,IAAI,CAAA;IACb,CAAC,CAAA;IAED;;;;;;;;;;OAUG;IACH,MAAM,YAAY,GAAG,CAAC,SAAiC,EAAE,CAAmB,EAAE,IAAsB,EAAQ,EAAE;QAC5G,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7C,MAAM,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;YACzB,IAAI,CAAC,CAAC,EAAE,KAAK,gCAAkB,CAAC,QAAQ,EAAE,CAAC;gBACzC,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;gBACpE,SAAQ;YACV,CAAC;YACD,MAAM,GAAG,GAAG,aAAa,CAAC,CAAC,CAAC,KAAK,EAAE,MAAM,CAAE,CAAS,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAA;YAChE,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;gBACpE,SAAQ;YACV,CAAC;YACD,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,CAAA;YACrB,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAA;QACpC,CAAC;IACH,CAAC,CAAA;IAED,sDAAsD;IACtD,MAAM,IAAI,GAAQ;QAChB,GAAG,KAAK;QACR,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5I,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5I,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,EAAE,GAAG,KAAK,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjF,CAAA;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;QAClB,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAC7B,6DAA6D;YAC7D,MAAM,KAAK,GAA2B,IAAI,CAAC,cAAc,IAAI,EAAE,CAAA;YAC/D,YAAY,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;YAChC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM;gBAAE,IAAI,CAAC,cAAc,GAAG,KAAK,CAAA;YAC1D,SAAQ;QACV,CAAC;QACD,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;QACvF,IAAI,CAAC,EAAE;YAAE,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IAC9D,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAS,EAAE,cAAc,EAAE,UAAU,EAAE,KAAK,EAAE,CAAA;AAChE,CAAC;AAcD;;;;;;;GAOG;AACH,SAAgB,uBAAuB,CACrC,OAAuD,EACvD,WAAgE;IAEhE,MAAM,KAAK,GAAuB,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IACrH,MAAM,OAAO,GAAyB,EAAE,CAAA;IACxC,MAAM,QAAQ,GAA4B,EAAE,CAAA;IAE5C,KAAK,MAAM,CAAC,IAAI,WAAW,IAAI,EAAE,EAAE,CAAC;QAClC,MAAM,MAAM,GAAsB,CAAC,EAAE,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAA;QAChI,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;QACrC,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,EAAE,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;QACrD,IAAI,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;YACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,CAAA;YACzC,SAAQ;QACV,CAAC;QACD,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;QAC7D,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QACpE,IAAI,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;YACjB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,CAAA;YACzC,SAAQ;QACV,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;QACzC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;IACtG,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAA;AAC7E,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,cAAc,CAC5B,KAAQ,EACR,OAAsC;IAEtC,IAAI,CAAC,OAAO,CAAC,MAAM;QAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,CAAA;IAE1F,MAAM,IAAI,GAAQ;QAChB,GAAG,KAAK;QACR,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5I,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5I,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,EAAE,GAAG,KAAK,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjF,CAAA;IACD,MAAM,QAAQ,GAAyB,EAAE,CAAA;IACzC,MAAM,aAAa,GAA4B,EAAE,CAAA;IACjD,MAAM,cAAc,GAAqC,EAAE,CAAA;IAE3D,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB;;;WAGG;QACH,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAC7B,MAAM,KAAK,GAA2B,IAAI,CAAC,cAAc,IAAI,EAAE,CAAA;YAC/D,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,KAAK,CAAC,EAAE,CAAC;gBACrB,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;gBACnD,SAAQ;YACV,CAAC;YACD,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;YAClB,mDAAmD;YACnD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM;gBAAE,OAAO,IAAI,CAAC,cAAc,CAAA;;gBACrD,IAAI,CAAC,cAAc,GAAG,KAAK,CAAA;YAChC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YAChB,SAAQ;QACV,CAAC;QACD,MAAM,IAAI,GAAU,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAA;QACtF,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAA;QACzD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;YACnD,SAAQ;QACV,CAAC;QACD,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,EAAE,CAAC;YACvB,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAA;YAC5E,SAAQ;QACV,CAAC;QACD,MAAM,KAAK,GAAU,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QAC/E,MAAM,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,CAAA;QACrE,IAAI,CAAC,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YACxB,IAAI,EAAE,IAAI,CAAC;gBAAE,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;QAClC,CAAC;aAAM,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;YACnB,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,CAAA;YACrD,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAA;QACpD,CAAC;aAAM,CAAC;YACN,oDAAoD;YACpD,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;QAC7D,CAAC;QACD,IAAI,CAAC,UAAU,GAAG,KAAK,CAAA;QACvB,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAClB,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,cAAc,EAAE,CAAA;AACtE,CAAC;AAKD;;;;;;;;;;GAUG;AACH,SAAgB,sBAAsB,CACpC,KAAQ,EACR,UAA0D,EAC1D,aAA6D;IAW7D,MAAM,KAAK,GAAG,sBAAsB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAA;IACvD,MAAM,MAAM,GAAG,sBAAsB,CAAC,KAAK,CAAC,KAAK,EAAE,aAAa,CAAC,CAAA;IACjE,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,iBAAiB,EAAE,KAAK,CAAC,KAAK;QAC9B,oBAAoB,EAAE,MAAM,CAAC,KAAK;QAClC,UAAU,EAAE;YACV,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,OAAgB,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YACjE,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,UAAmB,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;SACtE;QACD;;;;;;WAMG;QACH,cAAc,EAAE;YACd,GAAG,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,OAAgB,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YACrE,GAAG,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,UAAmB,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;SAC1E;KACF,CAAA;AACH,CAAC","sourcesContent":["/*\n * 로컬 선언 — **구조는 원천이, 수는 우리가.**\n *\n * ── 낱말부터: `reference` ↔ `local` (2026-08-18 확정) ───────────────────────\n * 이 파일이 다루는 축은 **「이 값을 누가 말했나」** 하나다. 답은 둘뿐이다.\n *\n * · `reference` — 외부 원천 시스템이 준 값(SCADA·WMS·MES 의 마스터). 우리가 고르지 않았다.\n * · `local` — **이 트윈 쪽에서 정한 값.** 원천이 모르는 수를 운영 주체가 넣은 것이다.\n *\n * 「사람이 넣었나」가 아니라 **「권위가 어디 있나」**가 기준이다 — 앞으로 AI 가 사용자 대리로 채워도\n * 여전히 `local` 이다. 표식은 커널 계약의 `PropertySource` 로 선언돼 있고, **표식이 없으면 모델을 그린\n * 쪽**(참조에서 그렸으면 원천, 템플릿으로 만들었으면 그 템플릿)이다.\n *\n * 장소 낱말을 쓰지 않는 이유(옛 이름 `siteDeclarations` 를 버린 이유):\n * · `site` — 이 코드에서는 **외부 시스템이 부르는 사업장**이다(SAP 는 `P3`, Oracle 은 `W01` 로 같은\n * 현장을 부른다). 여기 담기는 것은 그 시스템이 **모르는** 값이므로 이름이 내용과 정반대다.\n * · `facility` — 화면에 나가는 영어(현장)이고, 코드에 남은 것은 남의 API 필드뿐이다(Oracle lgfapi).\n * · `space` — 「어디」에 답하는 낱말이다(트윈이 서는 그릇). 이 축은 「누가」에 답한다. 게다가 공간\n * 수준 선언(한 현장의 여러 트윈이 함께 읽는 요금)은 앞으로 정말 필요할 수 있어 비워 둔다.\n *\n * ── 왜 필요한가 ─────────────────────────────────────────────────────────────\n * 커넥터로 만든 트윈은 구조를 원 시스템에서 읽어 온다(계통도·계량 지점·설비). 그런데 요금 단가·계약\n * 정보·축전지 충전율은 원 시스템이 모른다 — SCADA 게이트웨이는 우리 전기 계약을 알지 못한다. 그래서 그\n * 값들을 넣을 문이 없었고, 계량이 흐르는 트윈에서도 금액이 영원히 나오지 않았다(실제로 그 벽에 부딪혔다).\n *\n * ── 왜 모델에 바로 쓰지 않고 겹으로 두나 ────────────────────────────────────\n * 모델은 **원천의 사본**이다. 다시 읽기(resync)는 그 사본을 새로 그리므로, 모델에 직접 쓴 값은 다음\n * 다시 읽기에서 **조용히 사라진다** — 요금이 사라지면 금액도 사라지고, 사용자는 이유를 알 수 없다.\n * 그래서 로컬 선언은 따로 보관하고, 모델을 그릴 때마다 그 위에 얹는다. 덤으로 「누가 말한 값인가」에\n * 답할 수 있다 — 이 시스템이 근거를 값과 함께 다니게 하는 규율과 같다(`basis`·`derived` 와 한 결).\n *\n * ── 지어낸 속성을 받지 않는다 ───────────────────────────────────────────────\n * 커널이 읽는 속성만 받는다. 모르는 id 를 받아 두면 사용자는 값을 넣었다고 믿고 화면은 아무것도 바뀌지\n * 않는다 — 그 침묵이 가장 비싼 오류다. 단위·범위도 커널의 명세(`EMS_PROPERTY_SPEC`)로 검사한다:\n * 「SOC 80%」를 `0.8` 로 넣으면 배터리가 0.8% 로 서고, 그 사실을 아무도 모른 채 피크가 깎이지 않는다.\n *\n * **속성 어휘는 사용자가 정의하지 않는다** — 커널이 정한 속성에 값을 넣는 문이다(그래서 이름도\n * 「사용자 정의 속성」이 아니다).\n */\nimport { ATTENTION_PROPERTY, EMS_PROPERTY_SPEC, OPERATION_PROPERTY } from '@operato/twin-kernel'\n\nimport { EQUIPMENT_PROPERTY, SPEED_TO_MPS } from './travel-estimator.ts'\nimport { declarationTargetsOf } from './property-effects.ts'\n\n/** 로컬 선언이 겨눌 수 있는 대상 — 자원 둘과 **공정 종류**(자원이 아니라 명세다). */\nexport type DeclarationTarget = 'location' | 'equipment' | 'operation'\n\n/** 한 대상(자리·설비·공정)에 얹을 로컬 선언. */\nexport interface LocalDeclaration {\n target: DeclarationTarget\n /** 대상 id — 모델에 있는 그 이름. */\n id: string\n properties: {\n id: string\n value: string | number\n /**\n * 단위(UN/CEFACT 코드) — **어떤 값은 단위 없이는 뜻이 없다.**\n *\n * 속도가 그렇다: 단위가 없으면 이동 시간 추정기가 그 설비를 **거절한다**(그러면 공정 시간이 조용히\n * 사라진다). 명세가 단위를 요구하면(`uomChoices`) 받고, 그 목록에 없는 코드는 거절한다 — 읽는 쪽이\n * 모르는 단위를 받아 두면 화면은 넣었다고 말하고 계산은 그 값을 버린다.\n */\n uom?: string\n /**\n * 이 선언이 **덮은 원천 값** — 철회하면 이것으로 되돌린다.\n *\n * ── 왜 기억해야 하나 (2026-08-18) ────────────────────────────────────────\n * 선언은 모델에 얹혀 **저장된 모델에 구워진다.** 그래서 겹에서 줄만 지워도 원래 값이 돌아오지\n * 않는다 — 실제로 되돌릴 방법이 없어서, 잘못 넣은 값을 「원래 값을 다시 선언하는」 우회로만\n * 고칠 수 있었다(사용자가 원래 값을 알고 있어야 한다는 뜻이다).\n *\n * · 문자열 — 원천이 그 자리에 갖고 있던 값이다.\n * · `null` — 원천에는 그 속성이 **없었다**(철회하면 속성을 지운다).\n * · 없음 — **우리가 모른다**(이 필드가 생기기 전에 선언된 것). 지어내지 않고 그렇게 말한다.\n *\n * 사용자가 넣는 값이 아니라 얹을 때 우리가 채우는 값이다(매 원천 재읽기마다 새로 채워져 낡지 않는다).\n */\n replaced?: string | null\n }[]\n}\n\nexport interface RejectedDeclaration {\n target: string\n id: string\n propertyId: string\n /**\n * 왜 받지 않았나 — 언어중립 코드(화면이 옮긴다).\n * · `unknown-property` — 커널이 읽지 않는 속성 id 다\n * · `out-of-range` — 명세가 정한 범위 밖이다(단위를 잘못 읽은 값이 대개 여기 걸린다)\n * · `not-a-number` — 수를 요구하는 속성에 수가 아닌 값이 왔다\n * · `empty-value` — 값이 비어 있다(지우려면 그 뜻을 따로 말해야 한다)\n * · `no-property-vocabulary` — 이 종류의 트윈에는 선언 어휘가 아직 없다\n * · `no-target-id` — 어느 대상에 얹을지 말하지 않았다(선언의 모양이 틀렸다)\n * · `no-property-id` — 어느 속성인지 말하지 않았다(선언의 모양이 틀렸다)\n *\n * 뒤의 둘이 있는 이유: 예전에는 대상 id·속성 id 가 비면 **아무 말 없이 건너뛰었다.** 그래서 필드 이름을\n * 틀린 호출이 「받아준 선언이 없다」는 답만 받고 `rejected` 는 비어 있었다 — 무엇이 틀렸는지 알 길이\n * 없는 침묵이다(실제로 그 침묵에 걸렸다).\n */\n reason:\n | 'unknown-property'\n | 'out-of-range'\n | 'not-a-number'\n | 'empty-value'\n | 'no-property-vocabulary'\n | 'no-target-id'\n | 'no-property-id'\n /** 단위를 요구하는 속성인데 오지 않았다(그 값은 읽는 쪽이 버린다). */\n | 'uom-required'\n /** 읽는 쪽이 모르는 단위 코드다(명세가 받는 목록에 없다). */\n | 'unknown-uom'\n /**\n * 이 속성은 그 종류의 대상에 얹히지 않는다 — 읽는 코드가 다른 축을 본다.\n *\n * 예전에는 지게차에 계약전력을 넣을 수 있었다(문은 받고 화면은 「넣었습니다」라고 말하는데 읽는\n * 쪽은 자리만 본다). 어느 축의 속성인지는 효과 등록부가 이미 알고 있으므로 그것으로 거절한다.\n */\n | 'wrong-target'\n /**\n * 그 이름의 공정을 이 트윈에서 확인할 수 없다 — 커널이 돌린 적도 없고 명세 행에도 없다.\n *\n * 공정 선언은 자리·설비와 달리 **모델에 행이 없어도 성립한다**(창고·야드에는 행이 아예 없다).\n * 그래서 오타를 잡아 줄 것이 이름 대조뿐이다 — 그마저 없으면 값은 조용히 아무 일도 하지 않는다.\n */\n | 'unknown-operation'\n /** 무엇을 기대했나 — 사람이 고칠 수 있게(명세의 문장). */\n expected?: string\n}\n\n/** 이 종류의 트윈에서 커널이 읽는 선언 명세. 없으면 그 종류에는 선언 어휘가 없다. */\nfunction specOf(kind: string | undefined, propertyId: string): DeclarablePropertySpec | undefined {\n /* 종류 어휘와 공용 어휘를 함께 본다 — 속도는 어느 트윈에서나 읽히므로 EMS 밖에서도 받아야 한다. */\n return declarablePropertySpecs(kind).find(s => s.id === propertyId)\n}\n\n/** 이 종류의 트윈에 선언 어휘가 있나 — 없으면 검사할 근거가 없으므로 받지 않는다. */\nexport function hasPropertyVocabulary(kind: string | undefined): boolean {\n return kind === 'ems'\n}\n\n/** 이 종류에 선언할 수 있는 것이 하나라도 있나 — 공용 어휘가 있으므로 대개 참이다. */\nexport function hasAnyDeclarable(kind: string | undefined): boolean {\n return declarablePropertySpecs(kind).length > 0\n}\n\n/**\n * 이 종류의 트윈에 **선언할 수 있는 속성 목록** — 화면이 도메인의 모양을 알지 않게.\n *\n * 화면이 「에너지 트윈이면 계약전력·요금 단가…」를 알고 있으면, 도메인이 늘 때마다 화면을 고쳐야 하고\n * 단위·범위가 두 곳에 적힌다(ADR-0031: 카탈로그가 선언하고 화면은 그린다). 그래서 커널의 명세를 그대로\n * 낸다 — 화면은 받은 것을 렌더할 뿐이다.\n *\n * 어휘가 없는 종류는 **빈 목록**이다(「아직 없다」와 「아무 값이나 받는다」는 다르다).\n */\nexport interface DeclarablePropertySpec {\n id: string\n /** 사람이 읽는 단위(명세가 정한 것) — 값에 붙여 보인다. */\n uom?: string\n dataType: string\n range?: [number, number]\n note: string\n /**\n * 값과 **함께 단위를 골라야 하는** 속성 — 그 목록(UN/CEFACT 코드).\n *\n * 어떤 값은 단위 없이는 뜻이 없다: 속도는 단위가 없으면 추정기가 **거절한다**(「speed has no unit of\n * measure」). 그래서 명세가 「단위를 받아야 한다」와 「무엇을 받나」를 함께 말한다 — 화면이 목록을\n * 지어내면 화면이 받아 준 단위를 읽는 쪽이 모르는 일이 생긴다.\n */\n uomChoices?: string[]\n /**\n * 어느 종류의 대상에 얹히나(효과 등록부의 축) — 없으면 **우리가 제한을 모른다**(받아 준다).\n *\n * 화면은 이것으로 속성 목록을 대상에 맞게 좁힌다: 공정 시간을 설비에 넣으려는 선택지를 아예 보이지\n * 않게 하는 것이, 넣게 하고 거절하는 것보다 낫다.\n */\n targets?: string[]\n}\n\n/**\n * **어느 종류에나 있는 선언** — 「읽는 코드가 있는 것」만.\n *\n * 효과 등록부(`PROPERTY_EFFECTS`)가 그 목록의 근거다: 값이 계산을 바꾸는 속성만 여기 온다. 지금은\n * 설비의 `speed` 하나다(이동 시간 추정이 읽는다) — 자재의 `perBaseUnit` 은 자원 축이 아니라 자재\n * 정의에 얹히므로 이 화면의 대상이 아니다.\n *\n * 지어내지 않는다: 새 효과를 코드로 붙이는 사람이 등록부에 한 줄을 더하면 여기에도 따라 나온다.\n */\n/**\n * 시간 단위(UN/CEFACT) → ms. **목록은 여기 하나** — 화면·AI 는 명세의 `uomChoices` 로 받아 간다.\n *\n * 셋만 두는 이유: 현장이 공정 시간을 말할 때 쓰는 단위가 초·분·시간이다. 일 단위는 공정이 아니라 체류에\n * 가깝고, 그때는 그 값을 넣는 사람이 시간으로 환산해 말하는 편이 오해가 없다.\n */\nconst DURATION_UOM_MS: Record<string, number> = { SEC: 1_000, MIN: 60_000, HUR: 3_600_000 }\n\nconst COMMON_SPECS: DeclarablePropertySpec[] = [\n /*\n * 주의 판정 기준 — **경보가 소음이 되지 않게 현장이 정한다.**\n *\n * 혼잡 90%·불량 15%는 우리가 정한 수였다. 통로를 95%로 채워 쓰는 창고는 그 기준에서 영구히 「병목」\n * 이고, 초기 라인은 계속 「불량 과다」로 운다 — 그때 진짜 경보도 함께 묻힌다. 선언이 없으면 기본값을\n * 쓰되 주의가 `basis: 'default'` 로 그 사실을 밝힌다(조용히 기본값을 진실로 두지 않는다).\n */\n {\n id: ATTENTION_PROPERTY.congestionRatio,\n uom: '%',\n dataType: 'xs:double',\n range: [1, 100],\n note: 'congestion threshold as a percentage 1-100 (95 means 95% of capacity) — above it this location is called a bottleneck. default 90.'\n },\n {\n id: ATTENTION_PROPERTY.scrapRate,\n uom: '%',\n dataType: 'xs:double',\n range: [1, 100],\n note: 'scrap threshold as a percentage 1-100 (25 means 25%) — above it this equipment is called high-scrap, and twice it is severe. default 15.'\n },\n {\n id: ATTENTION_PROPERTY.scrapMinSamples,\n dataType: 'xs:double',\n range: [1, 100000],\n note: 'how many pieces must be counted before the scrap rate is judged at all — a ratio over few pieces is not evidence. default 10.'\n },\n {\n id: EQUIPMENT_PROPERTY.speed,\n dataType: 'xs:double',\n range: [0.01, 50],\n note: 'travel speed of this equipment — the estimator turns distance into duration with it. a unit is required.',\n uomChoices: Object.keys(SPEED_TO_MPS)\n },\n /*\n * 공정 소요시간 — **측정이 없을 때 상수를 대신한다.**\n *\n * 대상은 자리·설비가 아니라 **공정 종류**(`putaway`·`pick`·`spot`…)이고, 그 종류에 명세 행이 없어도\n * 성립한다(실측: 창고·야드 트윈에는 행이 0개다). 단위를 반드시 받는다 — 「4」만으로는 4초인지 4분인지\n * 알 수 없고, 짐작하면 예측이 60배 틀린다.\n */\n {\n id: OPERATION_PROPERTY.duration,\n dataType: 'xs:double',\n range: [0.01, 100000],\n note: 'how long this operation takes at this site — the simulation and the forecast use it instead of the built-in constant. a unit is required. history still wins where it exists.',\n uomChoices: Object.keys(DURATION_UOM_MS)\n }\n]\n\n/**\n * 값 + 단위 → **ISO 8601 기간** — 커널이 읽는 표기로 바꾼다(커널은 초·분을 모른다, 표준 표기만 안다).\n *\n * 읽을 수 없으면 `undefined` — 부르는 쪽이 그 사실을 거절 사유로 올린다(0 을 만들지 않는다: 소요 0 인\n * 작업은 영원히 끝나지 않는다).\n */\nexport function isoDurationOf(value: string | number, uom: string): string | undefined {\n const n = Number(value)\n const per = DURATION_UOM_MS[String(uom ?? '').trim()]\n if (!Number.isFinite(n) || n <= 0 || !per) return undefined\n return `PT${(n * per) / 1000}S`\n}\n\n/**\n * 이 종류의 트윈에 **선언할 수 있는 속성 목록** — 화면이 도메인의 모양을 알지 않게.\n *\n * 종류와 무관한 것(효과 등록부에서 온다) + 그 종류의 어휘(지금은 EMS 뿐). 어휘가 없는 종류도 **빈손이\n * 아니다**: 속도는 어느 트윈에서나 읽히므로 창고·야드·생산 트윈에서도 넣을 수 있어야 한다.\n */\nexport function declarablePropertySpecs(kind: string | undefined): DeclarablePropertySpec[] {\n const domain = hasPropertyVocabulary(kind)\n ? Object.entries(EMS_PROPERTY_SPEC as Record<string, any>).map(([id, spec]) => ({\n id,\n ...(spec.uom ? { uom: spec.uom } : {}),\n dataType: spec.dataType,\n ...(spec.range ? { range: spec.range as [number, number] } : {}),\n note: spec.note\n }))\n : []\n /*\n * **어느 대상에 얹히나는 효과 등록부가 답한다** — 명세에 손으로 또 적지 않는다(두 곳에 적으면 한쪽만\n * 바뀐다). 등록부에 없는 속성은 제한을 **모르는** 것이므로 그대로 둔다(속성은 열려 있다).\n */\n const all: DeclarablePropertySpec[] = [...COMMON_SPECS, ...domain]\n return all.map(s => {\n const targets = s.targets ?? declarationTargetsOf(s.id)\n return targets ? { ...s, targets } : s\n })\n}\n\n/**\n * 로컬 선언을 검사한다 — **받은 것과 받지 않은 것을 함께** 돌려준다.\n *\n * 조용히 걸러내지 않는 이유: 사용자는 값을 넣었다고 믿는다. 무엇이 왜 빠졌는지 말해야 고칠 수 있다.\n */\nexport function validateLocalDeclarations(\n kind: string | undefined,\n declarations: readonly LocalDeclaration[] | undefined | null,\n opts?: {\n /**\n * 이 트윈에서 확인된 공정 이름들 — 있으면 그 밖의 이름을 거절한다(오타를 잡는 유일한 수단이다).\n *\n * **모르면 넘기지 않고 모른다고 둔다**: 아직 돌지 않은 트윈은 어떤 공정을 돌릴지 알 수 없으므로\n * 목록을 주지 않고(=undefined) 받아 준다. 부르는 쪽이 「확인하지 못했다」는 사실을 답에 싣는다.\n */\n knownOperations?: readonly string[]\n }\n): { accepted: LocalDeclaration[]; rejected: RejectedDeclaration[] } {\n const accepted: LocalDeclaration[] = []\n const rejected: RejectedDeclaration[] = []\n for (const d of declarations ?? []) {\n const target: DeclarationTarget = d?.target === 'equipment' ? 'equipment' : d?.target === 'operation' ? 'operation' : 'location'\n const id = String(d?.id ?? '').trim()\n if (!id) {\n /* 어느 대상인지 모르면 얹을 자리가 없다 — 그 사실을 말한다(조용히 버리지 않는다). */\n rejected.push({ target, id: '', propertyId: '', reason: 'no-target-id' })\n continue\n }\n const props: { id: string; value: string }[] = []\n for (const p of d?.properties ?? []) {\n const propertyId = String(p?.id ?? '').trim()\n if (!propertyId) {\n rejected.push({ target, id, propertyId: '', reason: 'no-property-id' })\n continue\n }\n const raw = p?.value\n if (raw === undefined || raw === null || String(raw).trim() === '') {\n rejected.push({ target, id, propertyId, reason: 'empty-value' })\n continue\n }\n if (!hasAnyDeclarable(kind)) {\n rejected.push({ target, id, propertyId, reason: 'no-property-vocabulary' })\n continue\n }\n const spec = specOf(kind, propertyId)\n if (!spec) {\n rejected.push({ target, id, propertyId, reason: 'unknown-property' })\n continue\n }\n /*\n * **읽는 쪽이 보는 축에만 얹는다** — 지게차에 계약전력을 넣을 수 있던 구멍을 여기서 막는다.\n * 명세가 제한을 말하지 않으면(등록부에 없는 속성) 받아 준다: 속성은 열려 있고, 효과만 닫혀 있다.\n */\n if (spec.targets?.length && !spec.targets.includes(target)) {\n rejected.push({ target, id, propertyId, reason: 'wrong-target', expected: `one of ${spec.targets.join(', ')}` })\n continue\n }\n /* 공정 이름은 대조로만 걸러진다 — 모델에 행이 없어도 성립하는 선언이라 다른 안전망이 없다. */\n if (target === 'operation' && opts?.knownOperations && !opts.knownOperations.includes(id)) {\n rejected.push({ target, id, propertyId, reason: 'unknown-operation', expected: `one of ${[...opts.knownOperations].join(', ')}` })\n continue\n }\n if (spec.dataType === 'xs:double') {\n const n = Number(raw)\n if (!Number.isFinite(n)) {\n rejected.push({ target, id, propertyId, reason: 'not-a-number', expected: spec.note })\n continue\n }\n if (spec.range && (n < spec.range[0] || n > spec.range[1])) {\n rejected.push({ target, id, propertyId, reason: 'out-of-range', expected: spec.note })\n continue\n }\n }\n /*\n * 단위를 요구하는 속성은 **단위까지 검사한다** — 값만 받아 두면 읽는 쪽이 그 설비를 건너뛴다.\n * 목록은 명세가 든다(`uomChoices`): 화면이 목록을 지어내면 화면이 받아 준 단위를 계산이 모른다.\n */\n const uom = String((p as any)?.uom ?? '').trim()\n if (spec.uomChoices?.length) {\n if (!uom) {\n rejected.push({ target, id, propertyId, reason: 'uom-required', expected: `one of ${spec.uomChoices.join(', ')}` })\n continue\n }\n if (!spec.uomChoices.includes(uom)) {\n rejected.push({ target, id, propertyId, reason: 'unknown-uom', expected: `one of ${spec.uomChoices.join(', ')}` })\n continue\n }\n }\n props.push({ id: propertyId, value: String(raw), ...(uom ? { uom } : {}) })\n }\n if (props.length) accepted.push({ target, id, properties: props })\n }\n return { accepted, rejected }\n}\n\n/**\n * 겹을 합친다 — 같은 대상·같은 속성이면 **새 값이 이긴다**(현장이 값을 고치는 일은 흔하다).\n *\n * 대상이나 속성을 지우는 일은 여기서 하지 않는다: 지움은 「값을 모르는 상태로 되돌린다」는 뜻이고,\n * 그것은 값을 넣는 것과 다른 결정이므로 다른 문으로 말해야 한다.\n */\nexport function mergeLocalDeclarations(\n current: readonly LocalDeclaration[] | undefined | null,\n incoming: readonly LocalDeclaration[]\n): LocalDeclaration[] {\n const key = (t: string, id: string) => `${t}:${id}`\n const out = new Map<string, LocalDeclaration>()\n for (const d of current ?? []) out.set(key(d.target, d.id), { ...d, properties: [...d.properties] })\n for (const d of incoming) {\n const k = key(d.target, d.id)\n const cur = out.get(k)\n if (!cur) {\n out.set(k, { ...d, properties: [...d.properties] })\n continue\n }\n for (const p of d.properties) {\n const at = cur.properties.findIndex(x => x.id === p.id)\n if (at >= 0) cur.properties[at] = { ...p }\n else cur.properties.push({ ...p })\n }\n }\n return [...out.values()]\n}\n\n/**\n * 모델 위에 로컬 선언을 얹는다 — **모델을 바꾸지 않고 새 모델을 돌려준다.**\n *\n * 원천이 같은 속성을 이미 말했으면 **로컬 값이 이긴다**: 계약전력을 게이트웨이가 말하더라도, 우리가\n * 고쳐 넣었다는 것은 「원천의 값이 낡았다」는 뜻이다. 다만 그 사실이 보여야 하므로 `source: 'local'` 를\n * 값에 붙인다 — 화면·감사가 「누가 말한 값인가」를 되짚을 수 있다.\n *\n * 모델에 없는 대상에 얹으려 하면 **조용히 버리지 않고** 그 사실을 돌려준다(구조가 바뀌어 그 설비가\n * 사라졌을 수 있고, 그때 사용자의 선언은 갈 곳이 없다).\n */\nexport function applyLocalDeclarations<T extends { locations?: any[]; equipment?: any[]; localDurations?: Record<string, string> }>(\n model: T,\n declarations: readonly LocalDeclaration[] | undefined | null\n): {\n model: T\n missingTargets: { target: string; id: string }[]\n /**\n * 읽을 수 있는 값으로 바꿀 수 없었던 선언 — **조용히 버리지 않기 위한 자리.**\n *\n * 지금은 공정 시간에서만 난다(단위가 없거나 수가 아니면 ISO 8601 기간을 만들 수 없다). 문에서 이미\n * 검사하므로 정상 경로에서는 비어 있고, 옛 겹이나 손으로 넣은 데이터에서 드러난다.\n */\n unreadable: { target: string; id: string; propertyId: string }[]\n layer: LocalDeclaration[]\n} {\n const decls = declarations ?? []\n if (!decls.length) return { model, missingTargets: [], unreadable: [], layer: [] }\n\n const missingTargets: { target: string; id: string }[] = []\n const unreadable: { target: string; id: string; propertyId: string }[] = []\n /* 얹으면서 **무엇을 덮었는지** 함께 적어 돌려준다 — 철회는 그 기억이 있어야 성립한다. */\n const layer: LocalDeclaration[] = decls.map(d => ({ ...d, properties: d.properties.map(p => ({ ...p })) }))\n\n const put = (list: any[] | undefined, d: LocalDeclaration, memo: LocalDeclaration): boolean => {\n const item = (list ?? []).find(x => String(x?.id ?? '') === d.id)\n if (!item) return false\n const props: any[] = Array.isArray(item.properties) ? [...item.properties] : []\n for (let i = 0; i < d.properties.length; i++) {\n const p = d.properties[i]\n const at = props.findIndex(x => String(x?.id ?? '') === p.id)\n const noted = memo.properties[i]\n /*\n * 기억은 **표식이 없는 값일 때만** 갱신한다 — ADR-0034 의 규칙 그대로: 표식이 없으면 모델을 그린\n * 쪽(대개 원천)이 말한 값이고, 표식이 있으면 **누군가 찍은 것**이므로 맨 원천 값이 아니다.\n *\n * 이 함수는 원천에서 새로 그린 모델에도, 이미 선언이 구워진 저장 모델에도 얹힌다. 뒤쪽에서\n * 무턱대고 적으면 **우리 값을 원천 값으로 기억**하게 되고(600 을 원천이 말한 것으로 적는다),\n * 철회해도 같은 값으로 되돌아간다.\n *\n * `!== 'local'` 로 보지 않는 이유: 옛 표식(`'site'`)이 구워진 모델이 남아 있고, 그것을 「표식\n * 아님」으로 읽으면 바로 그 오인이 일어난다. 호환 코드를 두는 것이 아니라 **규칙을 그대로 적는\n * 것**이다 — 표식의 종류를 따지지 않는다.\n */\n if (at < 0) noted.replaced = null\n else if (props[at]?.source === undefined) noted.replaced = String(props[at]?.value ?? '')\n /*\n * **단위도 함께 얹는다** (2026-08-18 실측으로 고침).\n *\n * 겹에는 단위를 담고도 모델에 얹을 때 떨어뜨리고 있었다 — 그러면 속도를 넣어도 이동 시간 추정기가\n * 그 설비를 **버린다**(「speed has no unit of measure」). 화면은 「넣었습니다」라고 말하고 계산은\n * 그 값을 못 쓰는, 가장 조용한 종류의 결함이다.\n */\n const next = { id: p.id, value: String(p.value), ...((p as any).uom ? { uom: String((p as any).uom) } : {}), source: 'local' as const }\n if (at >= 0) props[at] = { ...props[at], ...next }\n else props.push(next)\n }\n item.properties = props\n return true\n }\n\n /**\n * 공정 시간은 **자원 속성이 아니다** — 종류별 표(`localDurations`)에 담는다.\n *\n * 왜 자리·설비처럼 속성으로 담지 않나: 커널의 공정 명세 행(`OperationDef`)은 `label`·`intent` 를\n * 요구하는데(ISA-95 `OperationsSegment`) 창고·야드 트윈에는 그 행이 **아예 없다**(실측: 35개 중\n * WMS·YMS 전부 0개). 행을 지어 만들면 지어낸 `intent` 가 능력 계산까지 오염시킨다 — 「몇 분 걸리나」를\n * 말하려고 「무슨 작업인가」를 발명하지 않는다.\n *\n * 이 표는 **전부 우리가 정한 값**이다(원천이 그리는 자리가 아니다). 그래서 기억(`replaced`)은 언제나\n * `null` 이고, 철회는 「표에서 뺀다」로 끝난다 — 그러면 원천 명세나 커널 상수가 다시 답한다.\n */\n const putOperation = (durations: Record<string, string>, d: LocalDeclaration, memo: LocalDeclaration): void => {\n for (let i = 0; i < d.properties.length; i++) {\n const p = d.properties[i]\n if (p.id !== OPERATION_PROPERTY.duration) {\n unreadable.push({ target: 'operation', id: d.id, propertyId: p.id })\n continue\n }\n const iso = isoDurationOf(p.value, String((p as any).uom ?? ''))\n if (!iso) {\n unreadable.push({ target: 'operation', id: d.id, propertyId: p.id })\n continue\n }\n durations[d.id] = iso\n memo.properties[i].replaced = null\n }\n }\n\n /* 얕은 복사로는 안 된다 — 자리·설비 항목을 손대므로 그 배열과 항목까지 새로 만든다. */\n const next: any = {\n ...model,\n ...(model.locations ? { locations: model.locations.map(n => ({ ...n, ...(n?.properties ? { properties: [...n.properties] } : {}) })) } : {}),\n ...(model.equipment ? { equipment: model.equipment.map(e => ({ ...e, ...(e?.properties ? { properties: [...e.properties] } : {}) })) } : {}),\n ...(model.localDurations ? { localDurations: { ...model.localDurations } } : {})\n }\n for (let i = 0; i < decls.length; i++) {\n const d = decls[i]\n if (d.target === 'operation') {\n /* 빈 표를 남기지 않는다 — 「선언이 있다」와 「읽을 수 있는 선언이 하나도 없다」는 다른 사실이다. */\n const table: Record<string, string> = next.localDurations ?? {}\n putOperation(table, d, layer[i])\n if (Object.keys(table).length) next.localDurations = table\n continue\n }\n const ok = put(d.target === 'equipment' ? next.equipment : next.locations, d, layer[i])\n if (!ok) missingTargets.push({ target: d.target, id: d.id })\n }\n return { model: next as T, missingTargets, unreadable, layer }\n}\n\n/** 철회 요청 하나 — 어느 대상의 어느 속성을 원천으로 되돌리나. */\nexport interface DeclarationRevocation {\n target: DeclarationTarget\n id: string\n propertyId: string\n}\n\n/** 철회된 항목 — 되돌릴 값을 함께 든다(모르면 `replaced` 가 없다). */\nexport interface RevokedDeclaration extends DeclarationRevocation {\n replaced?: string | null\n}\n\n/**\n * 겹에서 선언을 **뺀다** — 값을 넣는 것과 다른 결정이므로 다른 문이다.\n *\n * 없는 것을 뺐다고 말하지 않는다: 겹에 없던 대상·속성은 `notFound` 로 돌려준다(조용히 성공하면\n * 사용자는 지웠다고 믿고 값은 그대로 남는다 — 가장 비싼 종류의 침묵이다).\n *\n * 속성이 하나도 남지 않은 대상은 겹에서 사라진다(빈 껍데기를 남기지 않는다).\n */\nexport function revokeLocalDeclarations(\n current: readonly LocalDeclaration[] | undefined | null,\n revocations: readonly DeclarationRevocation[] | undefined | null\n): { layer: LocalDeclaration[]; revoked: RevokedDeclaration[]; notFound: DeclarationRevocation[] } {\n const layer: LocalDeclaration[] = (current ?? []).map(d => ({ ...d, properties: d.properties.map(p => ({ ...p })) }))\n const revoked: RevokedDeclaration[] = []\n const notFound: DeclarationRevocation[] = []\n\n for (const r of revocations ?? []) {\n const target: DeclarationTarget = r?.target === 'equipment' ? 'equipment' : r?.target === 'operation' ? 'operation' : 'location'\n const id = String(r?.id ?? '').trim()\n const propertyId = String(r?.propertyId ?? '').trim()\n if (!id || !propertyId) {\n notFound.push({ target, id, propertyId })\n continue\n }\n const d = layer.find(x => x.target === target && x.id === id)\n const at = d ? d.properties.findIndex(p => p.id === propertyId) : -1\n if (!d || at < 0) {\n notFound.push({ target, id, propertyId })\n continue\n }\n const [gone] = d.properties.splice(at, 1)\n revoked.push({ target, id, propertyId, ...('replaced' in gone ? { replaced: gone.replaced } : {}) })\n }\n\n return { layer: layer.filter(d => d.properties.length), revoked, notFound }\n}\n\n/**\n * 철회한 속성을 **모델에서 원천 값으로 되돌린다** — 저장된 모델에 값이 구워져 있기 때문이다.\n *\n * · 기억한 값이 있으면 그 값으로 되돌리고 `source: 'local'` 표식을 뗀다(다시 원천이 말한 값이다).\n * · `null` 이면 원천에 없던 속성이므로 **지운다**.\n * · 기억이 없으면(옛 선언) **손대지 않고** `unknownSource` 로 말한다 — 원래 값을 지어내는 것은\n * 잘못 넣은 값을 그대로 두는 것보다 나쁘다(다음 원천 재읽기가 그 자리를 바로잡는다).\n */\nexport function restoreRevoked<T extends { locations?: any[]; equipment?: any[]; localDurations?: Record<string, string> }>(\n model: T,\n revoked: readonly RevokedDeclaration[]\n): { model: T; restored: RevokedDeclaration[]; unknownSource: DeclarationRevocation[]; missingTargets: { target: string; id: string }[] } {\n if (!revoked.length) return { model, restored: [], unknownSource: [], missingTargets: [] }\n\n const next: any = {\n ...model,\n ...(model.locations ? { locations: model.locations.map(n => ({ ...n, ...(n?.properties ? { properties: [...n.properties] } : {}) })) } : {}),\n ...(model.equipment ? { equipment: model.equipment.map(e => ({ ...e, ...(e?.properties ? { properties: [...e.properties] } : {}) })) } : {}),\n ...(model.localDurations ? { localDurations: { ...model.localDurations } } : {})\n }\n const restored: RevokedDeclaration[] = []\n const unknownSource: DeclarationRevocation[] = []\n const missingTargets: { target: string; id: string }[] = []\n\n for (const r of revoked) {\n /*\n * 공정 시간은 표에서 **뺀다** — 되돌릴 원천 값이 없는 자리다(전부 우리가 정한 값이었다).\n * 빼면 원천 명세(있으면)나 커널 상수가 다시 답한다: 그것이 「선언 이전」의 상태다.\n */\n if (r.target === 'operation') {\n const table: Record<string, string> = next.localDurations ?? {}\n if (!(r.id in table)) {\n missingTargets.push({ target: r.target, id: r.id })\n continue\n }\n delete table[r.id]\n /* 빈 표는 남기지 않는다 — 「선언이 있다」와 「빈 표가 있다」가 구별되지 않는다. */\n if (!Object.keys(table).length) delete next.localDurations\n else next.localDurations = table\n restored.push(r)\n continue\n }\n const list: any[] = (r.target === 'equipment' ? next.equipment : next.locations) ?? []\n const item = list.find(x => String(x?.id ?? '') === r.id)\n if (!item) {\n missingTargets.push({ target: r.target, id: r.id })\n continue\n }\n if (!('replaced' in r)) {\n unknownSource.push({ target: r.target, id: r.id, propertyId: r.propertyId })\n continue\n }\n const props: any[] = Array.isArray(item.properties) ? [...item.properties] : []\n const at = props.findIndex(x => String(x?.id ?? '') === r.propertyId)\n if (r.replaced === null) {\n if (at >= 0) props.splice(at, 1)\n } else if (at >= 0) {\n const { source: _dropped, ...rest } = props[at] ?? {}\n props[at] = { ...rest, value: String(r.replaced) }\n } else {\n /* 겹은 있었는데 모델에는 없다 — 원천 값을 되살려 넣는다(우리가 지웠을 수 있다). */\n props.push({ id: r.propertyId, value: String(r.replaced) })\n }\n item.properties = props\n restored.push(r)\n }\n\n return { model: next as T, restored, unknownSource, missingTargets }\n}\n\n/** 선언이 어느 범위의 것인가 — 좁은 것이 이긴다(`space` 먼저, `instance` 나중). */\nexport type DeclarationScope = 'space' | 'instance'\n\n/**\n * 두 겹을 **순서대로** 얹는다 — 현장 먼저, 트윈이 나중.\n *\n * ── 왜 순서가 규율인가 (2026-08-18) ─────────────────────────────────────────\n * 요금 단가는 현장의 계약이므로 그 현장의 트윈 전부가 같은 값을 읽어야 한다. 그런데 한 트윈만 다른\n * 값으로 실험하는 일이 있다(인상된 단가로 what-if). 그때 현장 값을 고치게 하면 **나머지 트윈이 함께\n * 흔들린다.** 그래서 더 좁은 선언이 이긴다 — 넓은 값은 그대로 두고 좁은 자리에서만 달라진다.\n *\n * 기억(`replaced`)은 각 겹이 **자기가 덮은 값**을 적는다: 트윈 겹의 기억은 「현장 값을 덮었다」가 되고,\n * 철회하면 현장 값으로 돌아간다(원천까지 가지 않는다). 그것이 사람이 기대하는 되돌림이다.\n */\nexport function applyDeclarationLayers<T extends { locations?: any[]; equipment?: any[]; localDurations?: Record<string, string> }>(\n model: T,\n spaceLayer: readonly LocalDeclaration[] | undefined | null,\n instanceLayer: readonly LocalDeclaration[] | undefined | null\n): {\n model: T\n /** 현장 겹을 얹은 결과 — 저장해야 기억이 낡지 않는다. */\n spaceLayerApplied: LocalDeclaration[]\n instanceLayerApplied: LocalDeclaration[]\n /** 갈 곳이 없던 대상 — 어느 범위에서 났는지 함께 낸다(현장 겹은 그 트윈에 없을 수 있다). */\n missingTargets: { scope: DeclarationScope; target: string; id: string }[]\n /** 읽을 수 있는 값으로 바꿀 수 없던 선언 — 범위와 함께(조용히 버리지 않는다). */\n unreadable: { scope: DeclarationScope; target: string; id: string; propertyId: string }[]\n} {\n const first = applyLocalDeclarations(model, spaceLayer)\n const second = applyLocalDeclarations(first.model, instanceLayer)\n return {\n model: second.model,\n spaceLayerApplied: first.layer,\n instanceLayerApplied: second.layer,\n unreadable: [\n ...first.unreadable.map(u => ({ scope: 'space' as const, ...u })),\n ...second.unreadable.map(u => ({ scope: 'instance' as const, ...u }))\n ],\n /*\n * **현장 겹의 「갈 곳 없음」은 오류가 아니다.**\n *\n * 한 현장에는 여러 종류의 트윈이 산다(창고·야드·에너지). 요금을 현장에 선언하면 그 값은 수전 자리를\n * 가진 에너지 트윈에만 얹히고, 창고 트윈에는 얹을 자리가 없다 — 그것이 정상이다. 그래서 범위를 함께\n * 실어 보내고, 부르는 쪽이 현장 겹의 것은 경고로 올리지 않는다.\n */\n missingTargets: [\n ...first.missingTargets.map(t => ({ scope: 'space' as const, ...t })),\n ...second.missingTargets.map(t => ({ scope: 'instance' as const, ...t }))\n ]\n }\n}\n"]}
1
+ {"version":3,"file":"local-declarations.js","sourceRoot":"","sources":["../../server/engine/local-declarations.ts"],"names":[],"mappings":";;AAwIA,sDAEC;AAGD,4CAEC;AA+ID,sCAKC;AAQD,0DAmBC;AAOD,8DAwFC;AAQD,wDAqBC;AAYD,wDA+HC;AAsBD,0DA2BC;AAUD,wCAmFC;AAgBD,wDAsCC;AAzwBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,sDAA0G;AAE1G,+DAAwE;AACxE,+DAA4D;AAuF5D,qDAAqD;AACrD,SAAS,MAAM,CAAC,IAAwB,EAAE,UAAkB;IAC1D,8DAA8D;IAC9D,OAAO,uBAAuB,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,UAAU,CAAC,CAAA;AACrE,CAAC;AAED,qDAAqD;AACrD,SAAgB,qBAAqB,CAAC,IAAwB;IAC5D,OAAO,IAAI,KAAK,KAAK,CAAA;AACvB,CAAC;AAED,sDAAsD;AACtD,SAAgB,gBAAgB,CAAC,IAAwB;IACvD,OAAO,uBAAuB,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAA;AACjD,CAAC;AAmCD;;;;;;;;GAQG;AACH;;;;;GAKG;AACH,MAAM,eAAe,GAA2B,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,CAAA;AAE3F,MAAM,YAAY,GAA6B;IAC7C;;;;;;OAMG;IACH;QACE,EAAE,EAAE,gCAAkB,CAAC,eAAe;QACtC,GAAG,EAAE,GAAG;QACR,QAAQ,EAAE,WAAW;QACrB,KAAK,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC;QACf,IAAI,EAAE,oIAAoI;KAC3I;IACD;QACE,EAAE,EAAE,gCAAkB,CAAC,SAAS;QAChC,GAAG,EAAE,GAAG;QACR,QAAQ,EAAE,WAAW;QACrB,KAAK,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC;QACf,IAAI,EAAE,0IAA0I;KACjJ;IACD;QACE,EAAE,EAAE,gCAAkB,CAAC,eAAe;QACtC,QAAQ,EAAE,WAAW;QACrB,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,+HAA+H;KACtI;IACD;QACE,EAAE,EAAE,wCAAkB,CAAC,KAAK;QAC5B,QAAQ,EAAE,WAAW;QACrB,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC;QACjB,IAAI,EAAE,0GAA0G;QAChH,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,kCAAY,CAAC;KACtC;IACD;;;;;;OAMG;IACH;QACE,EAAE,EAAE,gCAAkB,CAAC,QAAQ;QAC/B,QAAQ,EAAE,WAAW;QACrB,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC;QACrB,IAAI,EAAE,+KAA+K;QACrL,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC;KACzC;IACD;;;;;;OAMG;IACH;QACE,EAAE,EAAE,gCAAkB,CAAC,KAAK;QAC5B,GAAG,EAAE,GAAG;QACR,QAAQ,EAAE,WAAW;QACrB,KAAK,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC;QACf,IAAI,EAAE,mMAAmM;KAC1M;IACD,6DAA6D;IAC7D;QACE,EAAE,EAAE,gCAAkB,CAAC,aAAa;QACpC,QAAQ,EAAE,WAAW;QACrB,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC;QACrB,IAAI,EAAE,+FAA+F;QACrG,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC;KACzC;CACF,CAAA;AAED;;;;;GAKG;AACH;;;;;GAKG;AACH,SAAS,QAAQ,CAAC,IAAS,EAAE,IAAY,EAAE,OAAe,EAAE,KAAa;IACvE,MAAM,KAAK,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,EAAE,CAAA;IAC7C,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAA;IAC1D,IAAI,CAAC,WAAW,GAAG,KAAK,CAAA;AAC1B,CAAC;AAED,SAAgB,aAAa,CAAC,KAAsB,EAAE,GAAW;IAC/D,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IACvB,MAAM,GAAG,GAAG,eAAe,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;IACrD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAA;IAC3D,OAAO,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,IAAI,GAAG,CAAA;AACjC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,uBAAuB,CAAC,IAAwB;IAC9D,MAAM,MAAM,GAAG,qBAAqB,CAAC,IAAI,CAAC;QACxC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,+BAAwC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5E,EAAE;YACF,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtC,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAyB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC,CAAC;QACL,CAAC,CAAC,EAAE,CAAA;IACN;;;OAGG;IACH,MAAM,GAAG,GAA6B,CAAC,GAAG,YAAY,EAAE,GAAG,MAAM,CAAC,CAAA;IAClE,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;QACjB,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,IAAA,0CAAoB,EAAC,CAAC,CAAC,EAAE,CAAC,CAAA;QACvD,OAAO,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;IACxC,CAAC,CAAC,CAAA;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAgB,yBAAyB,CACvC,IAAwB,EACxB,YAA4D,EAC5D,IAQC;IAED,MAAM,QAAQ,GAAuB,EAAE,CAAA;IACvC,MAAM,QAAQ,GAA0B,EAAE,CAAA;IAC1C,KAAK,MAAM,CAAC,IAAI,YAAY,IAAI,EAAE,EAAE,CAAC;QACnC,MAAM,MAAM,GAAsB,CAAC,EAAE,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAA;QAChI,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;QACrC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,qDAAqD;YACrD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAA;YACzE,SAAQ;QACV,CAAC;QACD,MAAM,KAAK,GAAoC,EAAE,CAAA;QACjD,KAAK,MAAM,CAAC,IAAI,CAAC,EAAE,UAAU,IAAI,EAAE,EAAE,CAAC;YACpC,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;YAC7C,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAA;gBACvE,SAAQ;YACV,CAAC;YACD,MAAM,GAAG,GAAG,CAAC,EAAE,KAAK,CAAA;YACpB,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;gBACnE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAA;gBAChE,SAAQ;YACV,CAAC;YACD,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,wBAAwB,EAAE,CAAC,CAAA;gBAC3E,SAAQ;YACV,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;YACrC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC,CAAA;gBACrE,SAAQ;YACV,CAAC;YACD;;;eAGG;YACH,IAAI,IAAI,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,UAAU,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAA;gBAChH,SAAQ;YACV,CAAC;YACD,yDAAyD;YACzD,IAAI,MAAM,KAAK,WAAW,IAAI,IAAI,EAAE,eAAe,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC1F,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,mBAAmB,EAAE,QAAQ,EAAE,UAAU,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAA;gBAClI,SAAQ;YACV,CAAC;YACD,IAAI,IAAI,CAAC,QAAQ,KAAK,WAAW,EAAE,CAAC;gBAClC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;gBACrB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;oBACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;oBACtF,SAAQ;gBACV,CAAC;gBACD,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC3D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;oBACtF,SAAQ;gBACV,CAAC;YACH,CAAC;YACD;;;eAGG;YACH,MAAM,GAAG,GAAG,MAAM,CAAE,CAAS,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;YAChD,IAAI,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;gBAC5B,IAAI,CAAC,GAAG,EAAE,CAAC;oBACT,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,UAAU,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAA;oBACnH,SAAQ;gBACV,CAAC;gBACD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;oBACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAA;oBAClH,SAAQ;gBACV,CAAC;YACH,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;QAC7E,CAAC;QACD,IAAI,KAAK,CAAC,MAAM;YAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAA;IACpE,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAA;AAC/B,CAAC;AAED;;;;;GAKG;AACH,SAAgB,sBAAsB,CACpC,OAAuD,EACvD,QAAqC;IAErC,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAU,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAA;IACnD,MAAM,GAAG,GAAG,IAAI,GAAG,EAA4B,CAAA;IAC/C,KAAK,MAAM,CAAC,IAAI,OAAO,IAAI,EAAE;QAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC,CAAA;IACpG,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAA;QAC7B,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QACtB,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC,CAAA;YACnD,SAAQ;QACV,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;YAC7B,MAAM,EAAE,GAAG,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAA;YACvD,IAAI,EAAE,IAAI,CAAC;gBAAE,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAA;;gBACrC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAA;QACpC,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,CAAA;AAC1B,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,sBAAsB,CAGpC,KAAQ,EACR,YAA4D;IAa5D,MAAM,KAAK,GAAG,YAAY,IAAI,EAAE,CAAA;IAChC,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAA;IAElF,MAAM,cAAc,GAAqC,EAAE,CAAA;IAC3D,MAAM,UAAU,GAAyD,EAAE,CAAA;IAC3E,wDAAwD;IACxD,MAAM,KAAK,GAAuB,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAE3G,MAAM,GAAG,GAAG,CAAC,IAAuB,EAAE,CAAmB,EAAE,IAAsB,EAAW,EAAE;QAC5F,MAAM,IAAI,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAA;QACjE,IAAI,CAAC,IAAI;YAAE,OAAO,KAAK,CAAA;QACvB,MAAM,KAAK,GAAU,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QAC/E,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7C,MAAM,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;YACzB,MAAM,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAA;YAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;YAChC;;;;;;;;;;;eAWG;YACH,IAAI,EAAE,GAAG,CAAC;gBAAE,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAA;iBAC5B,IAAI,KAAK,CAAC,EAAE,CAAC,EAAE,MAAM,KAAK,SAAS;gBAAE,KAAK,CAAC,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC,CAAA;YACzF;;;;;;eAMG;YACH,MAAM,IAAI,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,GAAG,CAAE,CAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAE,CAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,OAAgB,EAAE,CAAA;YACvI,IAAI,EAAE,IAAI,CAAC;gBAAE,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,CAAA;;gBAC7C,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACvB,CAAC;QACD,IAAI,CAAC,UAAU,GAAG,KAAK,CAAA;QACvB,OAAO,IAAI,CAAA;IACb,CAAC,CAAA;IAED;;;;;;;;;;OAUG;IACH,MAAM,YAAY,GAAG,CAAC,IAAS,EAAE,CAAmB,EAAE,IAAsB,EAAQ,EAAE;QACpF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7C,MAAM,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;YACzB,MAAM,GAAG,GAAG,MAAM,CAAE,CAAS,CAAC,GAAG,IAAI,EAAE,CAAC,CAAA;YACxC;;;eAGG;YACH,IAAI,CAAC,CAAC,EAAE,KAAK,gCAAkB,CAAC,QAAQ,EAAE,CAAC;gBACzC,MAAM,GAAG,GAAG,aAAa,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;gBACvC,IAAI,CAAC,GAAG,EAAE,CAAC;oBAAC,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAAC,SAAQ;gBAAC,CAAC;gBAC5F,IAAI,CAAC,cAAc,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,cAAc,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAA;gBACrE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAA;gBAClC,SAAQ;YACV,CAAC;YACD,IAAI,CAAC,CAAC,EAAE,KAAK,gCAAkB,CAAC,aAAa,EAAE,CAAC;gBAC9C,MAAM,GAAG,GAAG,aAAa,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;gBACvC,IAAI,CAAC,GAAG,EAAE,CAAC;oBAAC,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAAC,SAAQ;gBAAC,CAAC;gBAC5F,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,sBAAQ,CAAC,aAAa,EAAE,GAAG,CAAC,CAAA;gBACjD,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAA;gBAClC,SAAQ;YACV,CAAC;YACD,IAAI,CAAC,CAAC,EAAE,KAAK,gCAAkB,CAAC,KAAK,EAAE,CAAC;gBACtC,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;gBAC3B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,GAAG,GAAG,EAAE,CAAC;oBAAC,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAAC,SAAQ;gBAAC,CAAC;gBACtI,8DAA8D;gBAC9D,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,sBAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAA;gBACvD,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAA;gBAClC,SAAQ;YACV,CAAC;YACD,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QACtE,CAAC;IACH,CAAC,CAAA;IAED,sDAAsD;IACtD,MAAM,IAAI,GAAQ;QAChB,GAAG,KAAK;QACR,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5I,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5I,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,EAAE,GAAG,KAAK,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChF,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpI,CAAA;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;QAClB,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAC7B;wDAC4C;YAC5C,YAAY,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;YAC/B,SAAQ;QACV,CAAC;QACD,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;QACvF,IAAI,CAAC,EAAE;YAAE,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IAC9D,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAS,EAAE,cAAc,EAAE,UAAU,EAAE,KAAK,EAAE,CAAA;AAChE,CAAC;AAcD;;;;;;;GAOG;AACH,SAAgB,uBAAuB,CACrC,OAAuD,EACvD,WAAgE;IAEhE,MAAM,KAAK,GAAuB,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IACrH,MAAM,OAAO,GAAyB,EAAE,CAAA;IACxC,MAAM,QAAQ,GAA4B,EAAE,CAAA;IAE5C,KAAK,MAAM,CAAC,IAAI,WAAW,IAAI,EAAE,EAAE,CAAC;QAClC,MAAM,MAAM,GAAsB,CAAC,EAAE,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAA;QAChI,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;QACrC,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,EAAE,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;QACrD,IAAI,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;YACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,CAAA;YACzC,SAAQ;QACV,CAAC;QACD,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;QAC7D,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QACpE,IAAI,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;YACjB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,CAAA;YACzC,SAAQ;QACV,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;QACzC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;IACtG,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAA;AAC7E,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,cAAc,CAG5B,KAAQ,EACR,OAAsC;IAEtC,IAAI,CAAC,OAAO,CAAC,MAAM;QAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,CAAA;IAE1F,MAAM,IAAI,GAAQ;QAChB,GAAG,KAAK;QACR,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5I,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5I,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,EAAE,GAAG,KAAK,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChF,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpI,CAAA;IACD,MAAM,QAAQ,GAAyB,EAAE,CAAA;IACzC,MAAM,aAAa,GAA4B,EAAE,CAAA;IACjD,MAAM,cAAc,GAAqC,EAAE,CAAA;IAE3D,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB;;;WAGG;QACH,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAC7B,4DAA4D;YAC5D,MAAM,OAAO,GACX,CAAC,CAAC,UAAU,KAAK,gCAAkB,CAAC,KAAK;gBACvC,CAAC,CAAC,sBAAQ,CAAC,KAAK;gBAChB,CAAC,CAAC,CAAC,CAAC,UAAU,KAAK,gCAAkB,CAAC,aAAa;oBACjD,CAAC,CAAC,sBAAQ,CAAC,aAAa;oBACxB,CAAC,CAAC,SAAS,CAAA;YACjB,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,MAAM,GAA2C,IAAI,CAAC,WAAW,IAAI,EAAE,CAAA;gBAC7E,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;oBAChD,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;oBACnD,SAAQ;gBACV,CAAC;gBACD,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAA;gBAC5B,qDAAqD;gBACrD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM;oBAAE,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;gBAC1D,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM;oBAAE,OAAO,IAAI,CAAC,WAAW,CAAA;;oBACnD,IAAI,CAAC,WAAW,GAAG,MAAM,CAAA;gBAC9B,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;gBAChB,SAAQ;YACV,CAAC;YACD,MAAM,KAAK,GAA2B,IAAI,CAAC,cAAc,IAAI,EAAE,CAAA;YAC/D,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,KAAK,CAAC,EAAE,CAAC;gBACrB,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;gBACnD,SAAQ;YACV,CAAC;YACD,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;YAClB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM;gBAAE,OAAO,IAAI,CAAC,cAAc,CAAA;;gBACrD,IAAI,CAAC,cAAc,GAAG,KAAK,CAAA;YAChC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YAChB,SAAQ;QACV,CAAC;QACD,MAAM,IAAI,GAAU,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAA;QACtF,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAA;QACzD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;YACnD,SAAQ;QACV,CAAC;QACD,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,EAAE,CAAC;YACvB,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAA;YAC5E,SAAQ;QACV,CAAC;QACD,MAAM,KAAK,GAAU,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QAC/E,MAAM,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,CAAA;QACrE,IAAI,CAAC,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YACxB,IAAI,EAAE,IAAI,CAAC;gBAAE,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;QAClC,CAAC;aAAM,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;YACnB,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,CAAA;YACrD,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAA;QACpD,CAAC;aAAM,CAAC;YACN,oDAAoD;YACpD,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;QAC7D,CAAC;QACD,IAAI,CAAC,UAAU,GAAG,KAAK,CAAA;QACvB,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAClB,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,cAAc,EAAE,CAAA;AACtE,CAAC;AAKD;;;;;;;;;;GAUG;AACH,SAAgB,sBAAsB,CAGpC,KAAQ,EACR,UAA0D,EAC1D,aAA6D;IAW7D,MAAM,KAAK,GAAG,sBAAsB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAA;IACvD,MAAM,MAAM,GAAG,sBAAsB,CAAC,KAAK,CAAC,KAAK,EAAE,aAAa,CAAC,CAAA;IACjE,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,iBAAiB,EAAE,KAAK,CAAC,KAAK;QAC9B,oBAAoB,EAAE,MAAM,CAAC,KAAK;QAClC,UAAU,EAAE;YACV,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,OAAgB,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YACjE,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,UAAmB,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;SACtE;QACD;;;;;;WAMG;QACH,cAAc,EAAE;YACd,GAAG,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,OAAgB,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YACrE,GAAG,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,UAAmB,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;SAC1E;KACF,CAAA;AACH,CAAC","sourcesContent":["/*\n * 로컬 선언 — **구조는 원천이, 수는 우리가.**\n *\n * ── 낱말부터: `reference` ↔ `local` (2026-08-18 확정) ───────────────────────\n * 이 파일이 다루는 축은 **「이 값을 누가 말했나」** 하나다. 답은 둘뿐이다.\n *\n * · `reference` — 외부 원천 시스템이 준 값(SCADA·WMS·MES 의 마스터). 우리가 고르지 않았다.\n * · `local` — **이 트윈 쪽에서 정한 값.** 원천이 모르는 수를 운영 주체가 넣은 것이다.\n *\n * 「사람이 넣었나」가 아니라 **「권위가 어디 있나」**가 기준이다 — 앞으로 AI 가 사용자 대리로 채워도\n * 여전히 `local` 이다. 표식은 커널 계약의 `PropertySource` 로 선언돼 있고, **표식이 없으면 모델을 그린\n * 쪽**(참조에서 그렸으면 원천, 템플릿으로 만들었으면 그 템플릿)이다.\n *\n * 장소 낱말을 쓰지 않는 이유(옛 이름 `siteDeclarations` 를 버린 이유):\n * · `site` — 이 코드에서는 **외부 시스템이 부르는 사업장**이다(SAP 는 `P3`, Oracle 은 `W01` 로 같은\n * 현장을 부른다). 여기 담기는 것은 그 시스템이 **모르는** 값이므로 이름이 내용과 정반대다.\n * · `facility` — 화면에 나가는 영어(현장)이고, 코드에 남은 것은 남의 API 필드뿐이다(Oracle lgfapi).\n * · `space` — 「어디」에 답하는 낱말이다(트윈이 서는 그릇). 이 축은 「누가」에 답한다. 게다가 공간\n * 수준 선언(한 현장의 여러 트윈이 함께 읽는 요금)은 앞으로 정말 필요할 수 있어 비워 둔다.\n *\n * ── 왜 필요한가 ─────────────────────────────────────────────────────────────\n * 커넥터로 만든 트윈은 구조를 원 시스템에서 읽어 온다(계통도·계량 지점·설비). 그런데 요금 단가·계약\n * 정보·축전지 충전율은 원 시스템이 모른다 — SCADA 게이트웨이는 우리 전기 계약을 알지 못한다. 그래서 그\n * 값들을 넣을 문이 없었고, 계량이 흐르는 트윈에서도 금액이 영원히 나오지 않았다(실제로 그 벽에 부딪혔다).\n *\n * ── 왜 모델에 바로 쓰지 않고 겹으로 두나 ────────────────────────────────────\n * 모델은 **원천의 사본**이다. 다시 읽기(resync)는 그 사본을 새로 그리므로, 모델에 직접 쓴 값은 다음\n * 다시 읽기에서 **조용히 사라진다** — 요금이 사라지면 금액도 사라지고, 사용자는 이유를 알 수 없다.\n * 그래서 로컬 선언은 따로 보관하고, 모델을 그릴 때마다 그 위에 얹는다. 덤으로 「누가 말한 값인가」에\n * 답할 수 있다 — 이 시스템이 근거를 값과 함께 다니게 하는 규율과 같다(`basis`·`derived` 와 한 결).\n *\n * ── 지어낸 속성을 받지 않는다 ───────────────────────────────────────────────\n * 커널이 읽는 속성만 받는다. 모르는 id 를 받아 두면 사용자는 값을 넣었다고 믿고 화면은 아무것도 바뀌지\n * 않는다 — 그 침묵이 가장 비싼 오류다. 단위·범위도 커널의 명세(`EMS_PROPERTY_SPEC`)로 검사한다:\n * 「SOC 80%」를 `0.8` 로 넣으면 배터리가 0.8% 로 서고, 그 사실을 아무도 모른 채 피크가 깎이지 않는다.\n *\n * **속성 어휘는 사용자가 정의하지 않는다** — 커널이 정한 속성에 값을 넣는 문이다(그래서 이름도\n * 「사용자 정의 속성」이 아니다).\n */\nimport { ATTENTION_PROPERTY, EMS_PROPERTY_SPEC, OPERATION_PROPERTY, OP_PARAM } from '@operato/twin-kernel'\n\nimport { EQUIPMENT_PROPERTY, SPEED_TO_MPS } from './travel-estimator.ts'\nimport { declarationTargetsOf } from './property-effects.ts'\n\n/** 로컬 선언이 겨눌 수 있는 대상 — 자원 둘과 **공정 종류**(자원이 아니라 명세다). */\nexport type DeclarationTarget = 'location' | 'equipment' | 'operation'\n\n/** 한 대상(자리·설비·공정)에 얹을 로컬 선언. */\nexport interface LocalDeclaration {\n target: DeclarationTarget\n /** 대상 id — 모델에 있는 그 이름. */\n id: string\n properties: {\n id: string\n value: string | number\n /**\n * 단위(UN/CEFACT 코드) — **어떤 값은 단위 없이는 뜻이 없다.**\n *\n * 속도가 그렇다: 단위가 없으면 이동 시간 추정기가 그 설비를 **거절한다**(그러면 공정 시간이 조용히\n * 사라진다). 명세가 단위를 요구하면(`uomChoices`) 받고, 그 목록에 없는 코드는 거절한다 — 읽는 쪽이\n * 모르는 단위를 받아 두면 화면은 넣었다고 말하고 계산은 그 값을 버린다.\n */\n uom?: string\n /**\n * 이 선언이 **덮은 원천 값** — 철회하면 이것으로 되돌린다.\n *\n * ── 왜 기억해야 하나 (2026-08-18) ────────────────────────────────────────\n * 선언은 모델에 얹혀 **저장된 모델에 구워진다.** 그래서 겹에서 줄만 지워도 원래 값이 돌아오지\n * 않는다 — 실제로 되돌릴 방법이 없어서, 잘못 넣은 값을 「원래 값을 다시 선언하는」 우회로만\n * 고칠 수 있었다(사용자가 원래 값을 알고 있어야 한다는 뜻이다).\n *\n * · 문자열 — 원천이 그 자리에 갖고 있던 값이다.\n * · `null` — 원천에는 그 속성이 **없었다**(철회하면 속성을 지운다).\n * · 없음 — **우리가 모른다**(이 필드가 생기기 전에 선언된 것). 지어내지 않고 그렇게 말한다.\n *\n * 사용자가 넣는 값이 아니라 얹을 때 우리가 채우는 값이다(매 원천 재읽기마다 새로 채워져 낡지 않는다).\n */\n replaced?: string | null\n }[]\n}\n\nexport interface RejectedDeclaration {\n target: string\n id: string\n propertyId: string\n /**\n * 왜 받지 않았나 — 언어중립 코드(화면이 옮긴다).\n * · `unknown-property` — 커널이 읽지 않는 속성 id 다\n * · `out-of-range` — 명세가 정한 범위 밖이다(단위를 잘못 읽은 값이 대개 여기 걸린다)\n * · `not-a-number` — 수를 요구하는 속성에 수가 아닌 값이 왔다\n * · `empty-value` — 값이 비어 있다(지우려면 그 뜻을 따로 말해야 한다)\n * · `no-property-vocabulary` — 이 종류의 트윈에는 선언 어휘가 아직 없다\n * · `no-target-id` — 어느 대상에 얹을지 말하지 않았다(선언의 모양이 틀렸다)\n * · `no-property-id` — 어느 속성인지 말하지 않았다(선언의 모양이 틀렸다)\n *\n * 뒤의 둘이 있는 이유: 예전에는 대상 id·속성 id 가 비면 **아무 말 없이 건너뛰었다.** 그래서 필드 이름을\n * 틀린 호출이 「받아준 선언이 없다」는 답만 받고 `rejected` 는 비어 있었다 — 무엇이 틀렸는지 알 길이\n * 없는 침묵이다(실제로 그 침묵에 걸렸다).\n */\n reason:\n | 'unknown-property'\n | 'out-of-range'\n | 'not-a-number'\n | 'empty-value'\n | 'no-property-vocabulary'\n | 'no-target-id'\n | 'no-property-id'\n /** 단위를 요구하는 속성인데 오지 않았다(그 값은 읽는 쪽이 버린다). */\n | 'uom-required'\n /** 읽는 쪽이 모르는 단위 코드다(명세가 받는 목록에 없다). */\n | 'unknown-uom'\n /**\n * 이 속성은 그 종류의 대상에 얹히지 않는다 — 읽는 코드가 다른 축을 본다.\n *\n * 예전에는 지게차에 계약전력을 넣을 수 있었다(문은 받고 화면은 「넣었습니다」라고 말하는데 읽는\n * 쪽은 자리만 본다). 어느 축의 속성인지는 효과 등록부가 이미 알고 있으므로 그것으로 거절한다.\n */\n | 'wrong-target'\n /**\n * 그 이름의 공정을 이 트윈에서 확인할 수 없다 — 커널이 돌린 적도 없고 명세 행에도 없다.\n *\n * 공정 선언은 자리·설비와 달리 **모델에 행이 없어도 성립한다**(창고·야드에는 행이 아예 없다).\n * 그래서 오타를 잡아 줄 것이 이름 대조뿐이다 — 그마저 없으면 값은 조용히 아무 일도 하지 않는다.\n */\n | 'unknown-operation'\n /** 무엇을 기대했나 — 사람이 고칠 수 있게(명세의 문장). */\n expected?: string\n}\n\n/** 이 종류의 트윈에서 커널이 읽는 선언 명세. 없으면 그 종류에는 선언 어휘가 없다. */\nfunction specOf(kind: string | undefined, propertyId: string): DeclarablePropertySpec | undefined {\n /* 종류 어휘와 공용 어휘를 함께 본다 — 속도는 어느 트윈에서나 읽히므로 EMS 밖에서도 받아야 한다. */\n return declarablePropertySpecs(kind).find(s => s.id === propertyId)\n}\n\n/** 이 종류의 트윈에 선언 어휘가 있나 — 없으면 검사할 근거가 없으므로 받지 않는다. */\nexport function hasPropertyVocabulary(kind: string | undefined): boolean {\n return kind === 'ems'\n}\n\n/** 이 종류에 선언할 수 있는 것이 하나라도 있나 — 공용 어휘가 있으므로 대개 참이다. */\nexport function hasAnyDeclarable(kind: string | undefined): boolean {\n return declarablePropertySpecs(kind).length > 0\n}\n\n/**\n * 이 종류의 트윈에 **선언할 수 있는 속성 목록** — 화면이 도메인의 모양을 알지 않게.\n *\n * 화면이 「에너지 트윈이면 계약전력·요금 단가…」를 알고 있으면, 도메인이 늘 때마다 화면을 고쳐야 하고\n * 단위·범위가 두 곳에 적힌다(ADR-0031: 카탈로그가 선언하고 화면은 그린다). 그래서 커널의 명세를 그대로\n * 낸다 — 화면은 받은 것을 렌더할 뿐이다.\n *\n * 어휘가 없는 종류는 **빈 목록**이다(「아직 없다」와 「아무 값이나 받는다」는 다르다).\n */\nexport interface DeclarablePropertySpec {\n id: string\n /** 사람이 읽는 단위(명세가 정한 것) — 값에 붙여 보인다. */\n uom?: string\n dataType: string\n range?: [number, number]\n note: string\n /**\n * 값과 **함께 단위를 골라야 하는** 속성 — 그 목록(UN/CEFACT 코드).\n *\n * 어떤 값은 단위 없이는 뜻이 없다: 속도는 단위가 없으면 추정기가 **거절한다**(「speed has no unit of\n * measure」). 그래서 명세가 「단위를 받아야 한다」와 「무엇을 받나」를 함께 말한다 — 화면이 목록을\n * 지어내면 화면이 받아 준 단위를 읽는 쪽이 모르는 일이 생긴다.\n */\n uomChoices?: string[]\n /**\n * 어느 종류의 대상에 얹히나(효과 등록부의 축) — 없으면 **우리가 제한을 모른다**(받아 준다).\n *\n * 화면은 이것으로 속성 목록을 대상에 맞게 좁힌다: 공정 시간을 설비에 넣으려는 선택지를 아예 보이지\n * 않게 하는 것이, 넣게 하고 거절하는 것보다 낫다.\n */\n targets?: string[]\n}\n\n/**\n * **어느 종류에나 있는 선언** — 「읽는 코드가 있는 것」만.\n *\n * 효과 등록부(`PROPERTY_EFFECTS`)가 그 목록의 근거다: 값이 계산을 바꾸는 속성만 여기 온다. 지금은\n * 설비의 `speed` 하나다(이동 시간 추정이 읽는다) — 자재의 `perBaseUnit` 은 자원 축이 아니라 자재\n * 정의에 얹히므로 이 화면의 대상이 아니다.\n *\n * 지어내지 않는다: 새 효과를 코드로 붙이는 사람이 등록부에 한 줄을 더하면 여기에도 따라 나온다.\n */\n/**\n * 시간 단위(UN/CEFACT) → ms. **목록은 여기 하나** — 화면·AI 는 명세의 `uomChoices` 로 받아 간다.\n *\n * 셋만 두는 이유: 현장이 공정 시간을 말할 때 쓰는 단위가 초·분·시간이다. 일 단위는 공정이 아니라 체류에\n * 가깝고, 그때는 그 값을 넣는 사람이 시간으로 환산해 말하는 편이 오해가 없다.\n */\nconst DURATION_UOM_MS: Record<string, number> = { SEC: 1_000, MIN: 60_000, HUR: 3_600_000 }\n\nconst COMMON_SPECS: DeclarablePropertySpec[] = [\n /*\n * 주의 판정 기준 — **경보가 소음이 되지 않게 현장이 정한다.**\n *\n * 혼잡 90%·불량 15%는 우리가 정한 수였다. 통로를 95%로 채워 쓰는 창고는 그 기준에서 영구히 「병목」\n * 이고, 초기 라인은 계속 「불량 과다」로 운다 — 그때 진짜 경보도 함께 묻힌다. 선언이 없으면 기본값을\n * 쓰되 주의가 `basis: 'default'` 로 그 사실을 밝힌다(조용히 기본값을 진실로 두지 않는다).\n */\n {\n id: ATTENTION_PROPERTY.congestionRatio,\n uom: '%',\n dataType: 'xs:double',\n range: [1, 100],\n note: 'congestion threshold as a percentage 1-100 (95 means 95% of capacity) — above it this location is called a bottleneck. default 90.'\n },\n {\n id: ATTENTION_PROPERTY.scrapRate,\n uom: '%',\n dataType: 'xs:double',\n range: [1, 100],\n note: 'scrap threshold as a percentage 1-100 (25 means 25%) — above it this equipment is called high-scrap, and twice it is severe. default 15.'\n },\n {\n id: ATTENTION_PROPERTY.scrapMinSamples,\n dataType: 'xs:double',\n range: [1, 100000],\n note: 'how many pieces must be counted before the scrap rate is judged at all — a ratio over few pieces is not evidence. default 10.'\n },\n {\n id: EQUIPMENT_PROPERTY.speed,\n dataType: 'xs:double',\n range: [0.01, 50],\n note: 'travel speed of this equipment — the estimator turns distance into duration with it. a unit is required.',\n uomChoices: Object.keys(SPEED_TO_MPS)\n },\n /*\n * 공정 소요시간 — **측정이 없을 때 상수를 대신한다.**\n *\n * 대상은 자리·설비가 아니라 **공정 종류**(`putaway`·`pick`·`spot`…)이고, 그 종류에 명세 행이 없어도\n * 성립한다(실측: 창고·야드 트윈에는 행이 0개다). 단위를 반드시 받는다 — 「4」만으로는 4초인지 4분인지\n * 알 수 없고, 짐작하면 예측이 60배 틀린다.\n */\n {\n id: OPERATION_PROPERTY.duration,\n dataType: 'xs:double',\n range: [0.01, 100000],\n note: 'how long this operation takes at this site — the simulation and the forecast use it instead of the built-in constant. a unit is required. history still wins where it exists.',\n uomChoices: Object.keys(DURATION_UOM_MS)\n },\n /*\n * 양품률 — **퍼센트로 받는다**(80 이 80%다).\n *\n * 커널이 읽는 값은 0..1 이지만(ISA-95 `Parameter` 값 그대로) 사람에게 0.8 을 넣으라고 하면 SOC 에서\n * 겪은 함정을 되풀게 된다(0.8 을 0.8% 로 쓴 일이 있다). 그래서 화면·AI 는 퍼센트로 말하고, 비율로\n * 바꾸는 일은 얹는 자리 한 곳에서 한다.\n */\n {\n id: OPERATION_PROPERTY.yield,\n uom: '%',\n dataType: 'xs:double',\n range: [1, 100],\n note: 'good-output rate of this operation as a percentage 1-100 (95 means 95%) — the kernel reads it as a ratio, and this value replaces the built-in default that also drives the high-scrap attention.'\n },\n /* 셋업·체인지오버 — 가동 앞에 붙는 시간. 소요시간과 같은 단위 목록을 쓴다(같은 종류의 값이다). */\n {\n id: OPERATION_PROPERTY.setupDuration,\n dataType: 'xs:double',\n range: [0.01, 100000],\n note: 'changeover time before this operation runs — added in front of the cycle. a unit is required.',\n uomChoices: Object.keys(DURATION_UOM_MS)\n }\n]\n\n/**\n * 값 + 단위 → **ISO 8601 기간** — 커널이 읽는 표기로 바꾼다(커널은 초·분을 모른다, 표준 표기만 안다).\n *\n * 읽을 수 없으면 `undefined` — 부르는 쪽이 그 사실을 거절 사유로 올린다(0 을 만들지 않는다: 소요 0 인\n * 작업은 영원히 끝나지 않는다).\n */\n/**\n * 공정 모수 표에 한 칸 담는다 — **커널이 읽는 표기 그대로**(수율 0..1, 셋업 ISO 8601).\n *\n * 표를 통째로 새로 만들어 얹는다: 같은 모델 객체를 여러 겹이 지나므로(현장 → 트윈) 그때마다 새 객체여야\n * 앞 겹의 것을 조용히 덮어쓰지 않는다.\n */\nfunction putParam(next: any, kind: string, paramId: string, value: string): void {\n const table = { ...(next.localParams ?? {}) }\n table[kind] = { ...(table[kind] ?? {}), [paramId]: value }\n next.localParams = table\n}\n\nexport function isoDurationOf(value: string | number, uom: string): string | undefined {\n const n = Number(value)\n const per = DURATION_UOM_MS[String(uom ?? '').trim()]\n if (!Number.isFinite(n) || n <= 0 || !per) return undefined\n return `PT${(n * per) / 1000}S`\n}\n\n/**\n * 이 종류의 트윈에 **선언할 수 있는 속성 목록** — 화면이 도메인의 모양을 알지 않게.\n *\n * 종류와 무관한 것(효과 등록부에서 온다) + 그 종류의 어휘(지금은 EMS 뿐). 어휘가 없는 종류도 **빈손이\n * 아니다**: 속도는 어느 트윈에서나 읽히므로 창고·야드·생산 트윈에서도 넣을 수 있어야 한다.\n */\nexport function declarablePropertySpecs(kind: string | undefined): DeclarablePropertySpec[] {\n const domain = hasPropertyVocabulary(kind)\n ? Object.entries(EMS_PROPERTY_SPEC as Record<string, any>).map(([id, spec]) => ({\n id,\n ...(spec.uom ? { uom: spec.uom } : {}),\n dataType: spec.dataType,\n ...(spec.range ? { range: spec.range as [number, number] } : {}),\n note: spec.note\n }))\n : []\n /*\n * **어느 대상에 얹히나는 효과 등록부가 답한다** — 명세에 손으로 또 적지 않는다(두 곳에 적으면 한쪽만\n * 바뀐다). 등록부에 없는 속성은 제한을 **모르는** 것이므로 그대로 둔다(속성은 열려 있다).\n */\n const all: DeclarablePropertySpec[] = [...COMMON_SPECS, ...domain]\n return all.map(s => {\n const targets = s.targets ?? declarationTargetsOf(s.id)\n return targets ? { ...s, targets } : s\n })\n}\n\n/**\n * 로컬 선언을 검사한다 — **받은 것과 받지 않은 것을 함께** 돌려준다.\n *\n * 조용히 걸러내지 않는 이유: 사용자는 값을 넣었다고 믿는다. 무엇이 왜 빠졌는지 말해야 고칠 수 있다.\n */\nexport function validateLocalDeclarations(\n kind: string | undefined,\n declarations: readonly LocalDeclaration[] | undefined | null,\n opts?: {\n /**\n * 이 트윈에서 확인된 공정 이름들 — 있으면 그 밖의 이름을 거절한다(오타를 잡는 유일한 수단이다).\n *\n * **모르면 넘기지 않고 모른다고 둔다**: 아직 돌지 않은 트윈은 어떤 공정을 돌릴지 알 수 없으므로\n * 목록을 주지 않고(=undefined) 받아 준다. 부르는 쪽이 「확인하지 못했다」는 사실을 답에 싣는다.\n */\n knownOperations?: readonly string[]\n }\n): { accepted: LocalDeclaration[]; rejected: RejectedDeclaration[] } {\n const accepted: LocalDeclaration[] = []\n const rejected: RejectedDeclaration[] = []\n for (const d of declarations ?? []) {\n const target: DeclarationTarget = d?.target === 'equipment' ? 'equipment' : d?.target === 'operation' ? 'operation' : 'location'\n const id = String(d?.id ?? '').trim()\n if (!id) {\n /* 어느 대상인지 모르면 얹을 자리가 없다 — 그 사실을 말한다(조용히 버리지 않는다). */\n rejected.push({ target, id: '', propertyId: '', reason: 'no-target-id' })\n continue\n }\n const props: { id: string; value: string }[] = []\n for (const p of d?.properties ?? []) {\n const propertyId = String(p?.id ?? '').trim()\n if (!propertyId) {\n rejected.push({ target, id, propertyId: '', reason: 'no-property-id' })\n continue\n }\n const raw = p?.value\n if (raw === undefined || raw === null || String(raw).trim() === '') {\n rejected.push({ target, id, propertyId, reason: 'empty-value' })\n continue\n }\n if (!hasAnyDeclarable(kind)) {\n rejected.push({ target, id, propertyId, reason: 'no-property-vocabulary' })\n continue\n }\n const spec = specOf(kind, propertyId)\n if (!spec) {\n rejected.push({ target, id, propertyId, reason: 'unknown-property' })\n continue\n }\n /*\n * **읽는 쪽이 보는 축에만 얹는다** — 지게차에 계약전력을 넣을 수 있던 구멍을 여기서 막는다.\n * 명세가 제한을 말하지 않으면(등록부에 없는 속성) 받아 준다: 속성은 열려 있고, 효과만 닫혀 있다.\n */\n if (spec.targets?.length && !spec.targets.includes(target)) {\n rejected.push({ target, id, propertyId, reason: 'wrong-target', expected: `one of ${spec.targets.join(', ')}` })\n continue\n }\n /* 공정 이름은 대조로만 걸러진다 — 모델에 행이 없어도 성립하는 선언이라 다른 안전망이 없다. */\n if (target === 'operation' && opts?.knownOperations && !opts.knownOperations.includes(id)) {\n rejected.push({ target, id, propertyId, reason: 'unknown-operation', expected: `one of ${[...opts.knownOperations].join(', ')}` })\n continue\n }\n if (spec.dataType === 'xs:double') {\n const n = Number(raw)\n if (!Number.isFinite(n)) {\n rejected.push({ target, id, propertyId, reason: 'not-a-number', expected: spec.note })\n continue\n }\n if (spec.range && (n < spec.range[0] || n > spec.range[1])) {\n rejected.push({ target, id, propertyId, reason: 'out-of-range', expected: spec.note })\n continue\n }\n }\n /*\n * 단위를 요구하는 속성은 **단위까지 검사한다** — 값만 받아 두면 읽는 쪽이 그 설비를 건너뛴다.\n * 목록은 명세가 든다(`uomChoices`): 화면이 목록을 지어내면 화면이 받아 준 단위를 계산이 모른다.\n */\n const uom = String((p as any)?.uom ?? '').trim()\n if (spec.uomChoices?.length) {\n if (!uom) {\n rejected.push({ target, id, propertyId, reason: 'uom-required', expected: `one of ${spec.uomChoices.join(', ')}` })\n continue\n }\n if (!spec.uomChoices.includes(uom)) {\n rejected.push({ target, id, propertyId, reason: 'unknown-uom', expected: `one of ${spec.uomChoices.join(', ')}` })\n continue\n }\n }\n props.push({ id: propertyId, value: String(raw), ...(uom ? { uom } : {}) })\n }\n if (props.length) accepted.push({ target, id, properties: props })\n }\n return { accepted, rejected }\n}\n\n/**\n * 겹을 합친다 — 같은 대상·같은 속성이면 **새 값이 이긴다**(현장이 값을 고치는 일은 흔하다).\n *\n * 대상이나 속성을 지우는 일은 여기서 하지 않는다: 지움은 「값을 모르는 상태로 되돌린다」는 뜻이고,\n * 그것은 값을 넣는 것과 다른 결정이므로 다른 문으로 말해야 한다.\n */\nexport function mergeLocalDeclarations(\n current: readonly LocalDeclaration[] | undefined | null,\n incoming: readonly LocalDeclaration[]\n): LocalDeclaration[] {\n const key = (t: string, id: string) => `${t}:${id}`\n const out = new Map<string, LocalDeclaration>()\n for (const d of current ?? []) out.set(key(d.target, d.id), { ...d, properties: [...d.properties] })\n for (const d of incoming) {\n const k = key(d.target, d.id)\n const cur = out.get(k)\n if (!cur) {\n out.set(k, { ...d, properties: [...d.properties] })\n continue\n }\n for (const p of d.properties) {\n const at = cur.properties.findIndex(x => x.id === p.id)\n if (at >= 0) cur.properties[at] = { ...p }\n else cur.properties.push({ ...p })\n }\n }\n return [...out.values()]\n}\n\n/**\n * 모델 위에 로컬 선언을 얹는다 — **모델을 바꾸지 않고 새 모델을 돌려준다.**\n *\n * 원천이 같은 속성을 이미 말했으면 **로컬 값이 이긴다**: 계약전력을 게이트웨이가 말하더라도, 우리가\n * 고쳐 넣었다는 것은 「원천의 값이 낡았다」는 뜻이다. 다만 그 사실이 보여야 하므로 `source: 'local'` 를\n * 값에 붙인다 — 화면·감사가 「누가 말한 값인가」를 되짚을 수 있다.\n *\n * 모델에 없는 대상에 얹으려 하면 **조용히 버리지 않고** 그 사실을 돌려준다(구조가 바뀌어 그 설비가\n * 사라졌을 수 있고, 그때 사용자의 선언은 갈 곳이 없다).\n */\nexport function applyLocalDeclarations<\n T extends { locations?: any[]; equipment?: any[]; localDurations?: Record<string, string>; localParams?: Record<string, Record<string, string>> }\n>(\n model: T,\n declarations: readonly LocalDeclaration[] | undefined | null\n): {\n model: T\n missingTargets: { target: string; id: string }[]\n /**\n * 읽을 수 있는 값으로 바꿀 수 없었던 선언 — **조용히 버리지 않기 위한 자리.**\n *\n * 지금은 공정 시간에서만 난다(단위가 없거나 수가 아니면 ISO 8601 기간을 만들 수 없다). 문에서 이미\n * 검사하므로 정상 경로에서는 비어 있고, 옛 겹이나 손으로 넣은 데이터에서 드러난다.\n */\n unreadable: { target: string; id: string; propertyId: string }[]\n layer: LocalDeclaration[]\n} {\n const decls = declarations ?? []\n if (!decls.length) return { model, missingTargets: [], unreadable: [], layer: [] }\n\n const missingTargets: { target: string; id: string }[] = []\n const unreadable: { target: string; id: string; propertyId: string }[] = []\n /* 얹으면서 **무엇을 덮었는지** 함께 적어 돌려준다 — 철회는 그 기억이 있어야 성립한다. */\n const layer: LocalDeclaration[] = decls.map(d => ({ ...d, properties: d.properties.map(p => ({ ...p })) }))\n\n const put = (list: any[] | undefined, d: LocalDeclaration, memo: LocalDeclaration): boolean => {\n const item = (list ?? []).find(x => String(x?.id ?? '') === d.id)\n if (!item) return false\n const props: any[] = Array.isArray(item.properties) ? [...item.properties] : []\n for (let i = 0; i < d.properties.length; i++) {\n const p = d.properties[i]\n const at = props.findIndex(x => String(x?.id ?? '') === p.id)\n const noted = memo.properties[i]\n /*\n * 기억은 **표식이 없는 값일 때만** 갱신한다 — ADR-0034 의 규칙 그대로: 표식이 없으면 모델을 그린\n * 쪽(대개 원천)이 말한 값이고, 표식이 있으면 **누군가 찍은 것**이므로 맨 원천 값이 아니다.\n *\n * 이 함수는 원천에서 새로 그린 모델에도, 이미 선언이 구워진 저장 모델에도 얹힌다. 뒤쪽에서\n * 무턱대고 적으면 **우리 값을 원천 값으로 기억**하게 되고(600 을 원천이 말한 것으로 적는다),\n * 철회해도 같은 값으로 되돌아간다.\n *\n * `!== 'local'` 로 보지 않는 이유: 옛 표식(`'site'`)이 구워진 모델이 남아 있고, 그것을 「표식\n * 아님」으로 읽으면 바로 그 오인이 일어난다. 호환 코드를 두는 것이 아니라 **규칙을 그대로 적는\n * 것**이다 — 표식의 종류를 따지지 않는다.\n */\n if (at < 0) noted.replaced = null\n else if (props[at]?.source === undefined) noted.replaced = String(props[at]?.value ?? '')\n /*\n * **단위도 함께 얹는다** (2026-08-18 실측으로 고침).\n *\n * 겹에는 단위를 담고도 모델에 얹을 때 떨어뜨리고 있었다 — 그러면 속도를 넣어도 이동 시간 추정기가\n * 그 설비를 **버린다**(「speed has no unit of measure」). 화면은 「넣었습니다」라고 말하고 계산은\n * 그 값을 못 쓰는, 가장 조용한 종류의 결함이다.\n */\n const next = { id: p.id, value: String(p.value), ...((p as any).uom ? { uom: String((p as any).uom) } : {}), source: 'local' as const }\n if (at >= 0) props[at] = { ...props[at], ...next }\n else props.push(next)\n }\n item.properties = props\n return true\n }\n\n /**\n * 공정 시간은 **자원 속성이 아니다** — 종류별 표(`localDurations`)에 담는다.\n *\n * 왜 자리·설비처럼 속성으로 담지 않나: 커널의 공정 명세 행(`OperationDef`)은 `label`·`intent` 를\n * 요구하는데(ISA-95 `OperationsSegment`) 창고·야드 트윈에는 그 행이 **아예 없다**(실측: 35개 중\n * WMS·YMS 전부 0개). 행을 지어 만들면 지어낸 `intent` 가 능력 계산까지 오염시킨다 — 「몇 분 걸리나」를\n * 말하려고 「무슨 작업인가」를 발명하지 않는다.\n *\n * 이 표는 **전부 우리가 정한 값**이다(원천이 그리는 자리가 아니다). 그래서 기억(`replaced`)은 언제나\n * `null` 이고, 철회는 「표에서 뺀다」로 끝난다 — 그러면 원천 명세나 커널 상수가 다시 답한다.\n */\n const putOperation = (next: any, d: LocalDeclaration, memo: LocalDeclaration): void => {\n for (let i = 0; i < d.properties.length; i++) {\n const p = d.properties[i]\n const uom = String((p as any).uom ?? '')\n /*\n * 값을 **커널이 읽는 표기로** 바꿔 담는다 — 시간은 ISO 8601, 수율은 비율(0..1).\n * 바꿀 수 없으면 담지 않고 그 사실을 낸다(조용히 0 이나 빈 값으로 만들지 않는다).\n */\n if (p.id === OPERATION_PROPERTY.duration) {\n const iso = isoDurationOf(p.value, uom)\n if (!iso) { unreadable.push({ target: 'operation', id: d.id, propertyId: p.id }); continue }\n next.localDurations = { ...(next.localDurations ?? {}), [d.id]: iso }\n memo.properties[i].replaced = null\n continue\n }\n if (p.id === OPERATION_PROPERTY.setupDuration) {\n const iso = isoDurationOf(p.value, uom)\n if (!iso) { unreadable.push({ target: 'operation', id: d.id, propertyId: p.id }); continue }\n putParam(next, d.id, OP_PARAM.setupDuration, iso)\n memo.properties[i].replaced = null\n continue\n }\n if (p.id === OPERATION_PROPERTY.yield) {\n const pct = Number(p.value)\n if (!Number.isFinite(pct) || pct <= 0 || pct > 100) { unreadable.push({ target: 'operation', id: d.id, propertyId: p.id }); continue }\n /* 퍼센트 → 비율. 이 환산이 있는 자리는 여기 하나다(두 곳에서 나누면 100 배가 두 번 걸린다). */\n putParam(next, d.id, OP_PARAM.yield, String(pct / 100))\n memo.properties[i].replaced = null\n continue\n }\n unreadable.push({ target: 'operation', id: d.id, propertyId: p.id })\n }\n }\n\n /* 얕은 복사로는 안 된다 — 자리·설비 항목을 손대므로 그 배열과 항목까지 새로 만든다. */\n const next: any = {\n ...model,\n ...(model.locations ? { locations: model.locations.map(n => ({ ...n, ...(n?.properties ? { properties: [...n.properties] } : {}) })) } : {}),\n ...(model.equipment ? { equipment: model.equipment.map(e => ({ ...e, ...(e?.properties ? { properties: [...e.properties] } : {}) })) } : {}),\n ...(model.localDurations ? { localDurations: { ...model.localDurations } } : {}),\n ...(model.localParams ? { localParams: Object.fromEntries(Object.entries(model.localParams).map(([k, v]) => [k, { ...v }])) } : {})\n }\n for (let i = 0; i < decls.length; i++) {\n const d = decls[i]\n if (d.target === 'operation') {\n /* 빈 표를 남기지 않는다 — 「선언이 있다」와 「읽을 수 있는 선언이 하나도 없다」는 다른 사실이다\n (`putOperation` 이 담을 것이 있을 때만 표를 만든다). */\n putOperation(next, d, layer[i])\n continue\n }\n const ok = put(d.target === 'equipment' ? next.equipment : next.locations, d, layer[i])\n if (!ok) missingTargets.push({ target: d.target, id: d.id })\n }\n return { model: next as T, missingTargets, unreadable, layer }\n}\n\n/** 철회 요청 하나 — 어느 대상의 어느 속성을 원천으로 되돌리나. */\nexport interface DeclarationRevocation {\n target: DeclarationTarget\n id: string\n propertyId: string\n}\n\n/** 철회된 항목 — 되돌릴 값을 함께 든다(모르면 `replaced` 가 없다). */\nexport interface RevokedDeclaration extends DeclarationRevocation {\n replaced?: string | null\n}\n\n/**\n * 겹에서 선언을 **뺀다** — 값을 넣는 것과 다른 결정이므로 다른 문이다.\n *\n * 없는 것을 뺐다고 말하지 않는다: 겹에 없던 대상·속성은 `notFound` 로 돌려준다(조용히 성공하면\n * 사용자는 지웠다고 믿고 값은 그대로 남는다 — 가장 비싼 종류의 침묵이다).\n *\n * 속성이 하나도 남지 않은 대상은 겹에서 사라진다(빈 껍데기를 남기지 않는다).\n */\nexport function revokeLocalDeclarations(\n current: readonly LocalDeclaration[] | undefined | null,\n revocations: readonly DeclarationRevocation[] | undefined | null\n): { layer: LocalDeclaration[]; revoked: RevokedDeclaration[]; notFound: DeclarationRevocation[] } {\n const layer: LocalDeclaration[] = (current ?? []).map(d => ({ ...d, properties: d.properties.map(p => ({ ...p })) }))\n const revoked: RevokedDeclaration[] = []\n const notFound: DeclarationRevocation[] = []\n\n for (const r of revocations ?? []) {\n const target: DeclarationTarget = r?.target === 'equipment' ? 'equipment' : r?.target === 'operation' ? 'operation' : 'location'\n const id = String(r?.id ?? '').trim()\n const propertyId = String(r?.propertyId ?? '').trim()\n if (!id || !propertyId) {\n notFound.push({ target, id, propertyId })\n continue\n }\n const d = layer.find(x => x.target === target && x.id === id)\n const at = d ? d.properties.findIndex(p => p.id === propertyId) : -1\n if (!d || at < 0) {\n notFound.push({ target, id, propertyId })\n continue\n }\n const [gone] = d.properties.splice(at, 1)\n revoked.push({ target, id, propertyId, ...('replaced' in gone ? { replaced: gone.replaced } : {}) })\n }\n\n return { layer: layer.filter(d => d.properties.length), revoked, notFound }\n}\n\n/**\n * 철회한 속성을 **모델에서 원천 값으로 되돌린다** — 저장된 모델에 값이 구워져 있기 때문이다.\n *\n * · 기억한 값이 있으면 그 값으로 되돌리고 `source: 'local'` 표식을 뗀다(다시 원천이 말한 값이다).\n * · `null` 이면 원천에 없던 속성이므로 **지운다**.\n * · 기억이 없으면(옛 선언) **손대지 않고** `unknownSource` 로 말한다 — 원래 값을 지어내는 것은\n * 잘못 넣은 값을 그대로 두는 것보다 나쁘다(다음 원천 재읽기가 그 자리를 바로잡는다).\n */\nexport function restoreRevoked<\n T extends { locations?: any[]; equipment?: any[]; localDurations?: Record<string, string>; localParams?: Record<string, Record<string, string>> }\n>(\n model: T,\n revoked: readonly RevokedDeclaration[]\n): { model: T; restored: RevokedDeclaration[]; unknownSource: DeclarationRevocation[]; missingTargets: { target: string; id: string }[] } {\n if (!revoked.length) return { model, restored: [], unknownSource: [], missingTargets: [] }\n\n const next: any = {\n ...model,\n ...(model.locations ? { locations: model.locations.map(n => ({ ...n, ...(n?.properties ? { properties: [...n.properties] } : {}) })) } : {}),\n ...(model.equipment ? { equipment: model.equipment.map(e => ({ ...e, ...(e?.properties ? { properties: [...e.properties] } : {}) })) } : {}),\n ...(model.localDurations ? { localDurations: { ...model.localDurations } } : {}),\n ...(model.localParams ? { localParams: Object.fromEntries(Object.entries(model.localParams).map(([k, v]) => [k, { ...v }])) } : {})\n }\n const restored: RevokedDeclaration[] = []\n const unknownSource: DeclarationRevocation[] = []\n const missingTargets: { target: string; id: string }[] = []\n\n for (const r of revoked) {\n /*\n * 공정 시간은 표에서 **뺀다** — 되돌릴 원천 값이 없는 자리다(전부 우리가 정한 값이었다).\n * 빼면 원천 명세(있으면)나 커널 상수가 다시 답한다: 그것이 「선언 이전」의 상태다.\n */\n if (r.target === 'operation') {\n /* 시간은 시간 표에서, 모수(수율·셋업)는 모수 표에서 뺀다 — 담긴 자리에서 빼야 실제로 빠진다. */\n const paramId =\n r.propertyId === OPERATION_PROPERTY.yield\n ? OP_PARAM.yield\n : r.propertyId === OPERATION_PROPERTY.setupDuration\n ? OP_PARAM.setupDuration\n : undefined\n if (paramId) {\n const params: Record<string, Record<string, string>> = next.localParams ?? {}\n if (!params[r.id] || !(paramId in params[r.id])) {\n missingTargets.push({ target: r.target, id: r.id })\n continue\n }\n delete params[r.id][paramId]\n /* 빈 껍데기를 남기지 않는다 — 「선언이 있다」와 「빈 표가 있다」가 구별되지 않는다. */\n if (!Object.keys(params[r.id]).length) delete params[r.id]\n if (!Object.keys(params).length) delete next.localParams\n else next.localParams = params\n restored.push(r)\n continue\n }\n const table: Record<string, string> = next.localDurations ?? {}\n if (!(r.id in table)) {\n missingTargets.push({ target: r.target, id: r.id })\n continue\n }\n delete table[r.id]\n if (!Object.keys(table).length) delete next.localDurations\n else next.localDurations = table\n restored.push(r)\n continue\n }\n const list: any[] = (r.target === 'equipment' ? next.equipment : next.locations) ?? []\n const item = list.find(x => String(x?.id ?? '') === r.id)\n if (!item) {\n missingTargets.push({ target: r.target, id: r.id })\n continue\n }\n if (!('replaced' in r)) {\n unknownSource.push({ target: r.target, id: r.id, propertyId: r.propertyId })\n continue\n }\n const props: any[] = Array.isArray(item.properties) ? [...item.properties] : []\n const at = props.findIndex(x => String(x?.id ?? '') === r.propertyId)\n if (r.replaced === null) {\n if (at >= 0) props.splice(at, 1)\n } else if (at >= 0) {\n const { source: _dropped, ...rest } = props[at] ?? {}\n props[at] = { ...rest, value: String(r.replaced) }\n } else {\n /* 겹은 있었는데 모델에는 없다 — 원천 값을 되살려 넣는다(우리가 지웠을 수 있다). */\n props.push({ id: r.propertyId, value: String(r.replaced) })\n }\n item.properties = props\n restored.push(r)\n }\n\n return { model: next as T, restored, unknownSource, missingTargets }\n}\n\n/** 선언이 어느 범위의 것인가 — 좁은 것이 이긴다(`space` 먼저, `instance` 나중). */\nexport type DeclarationScope = 'space' | 'instance'\n\n/**\n * 두 겹을 **순서대로** 얹는다 — 현장 먼저, 트윈이 나중.\n *\n * ── 왜 순서가 규율인가 (2026-08-18) ─────────────────────────────────────────\n * 요금 단가는 현장의 계약이므로 그 현장의 트윈 전부가 같은 값을 읽어야 한다. 그런데 한 트윈만 다른\n * 값으로 실험하는 일이 있다(인상된 단가로 what-if). 그때 현장 값을 고치게 하면 **나머지 트윈이 함께\n * 흔들린다.** 그래서 더 좁은 선언이 이긴다 — 넓은 값은 그대로 두고 좁은 자리에서만 달라진다.\n *\n * 기억(`replaced`)은 각 겹이 **자기가 덮은 값**을 적는다: 트윈 겹의 기억은 「현장 값을 덮었다」가 되고,\n * 철회하면 현장 값으로 돌아간다(원천까지 가지 않는다). 그것이 사람이 기대하는 되돌림이다.\n */\nexport function applyDeclarationLayers<\n T extends { locations?: any[]; equipment?: any[]; localDurations?: Record<string, string>; localParams?: Record<string, Record<string, string>> }\n>(\n model: T,\n spaceLayer: readonly LocalDeclaration[] | undefined | null,\n instanceLayer: readonly LocalDeclaration[] | undefined | null\n): {\n model: T\n /** 현장 겹을 얹은 결과 — 저장해야 기억이 낡지 않는다. */\n spaceLayerApplied: LocalDeclaration[]\n instanceLayerApplied: LocalDeclaration[]\n /** 갈 곳이 없던 대상 — 어느 범위에서 났는지 함께 낸다(현장 겹은 그 트윈에 없을 수 있다). */\n missingTargets: { scope: DeclarationScope; target: string; id: string }[]\n /** 읽을 수 있는 값으로 바꿀 수 없던 선언 — 범위와 함께(조용히 버리지 않는다). */\n unreadable: { scope: DeclarationScope; target: string; id: string; propertyId: string }[]\n} {\n const first = applyLocalDeclarations(model, spaceLayer)\n const second = applyLocalDeclarations(first.model, instanceLayer)\n return {\n model: second.model,\n spaceLayerApplied: first.layer,\n instanceLayerApplied: second.layer,\n unreadable: [\n ...first.unreadable.map(u => ({ scope: 'space' as const, ...u })),\n ...second.unreadable.map(u => ({ scope: 'instance' as const, ...u }))\n ],\n /*\n * **현장 겹의 「갈 곳 없음」은 오류가 아니다.**\n *\n * 한 현장에는 여러 종류의 트윈이 산다(창고·야드·에너지). 요금을 현장에 선언하면 그 값은 수전 자리를\n * 가진 에너지 트윈에만 얹히고, 창고 트윈에는 얹을 자리가 없다 — 그것이 정상이다. 그래서 범위를 함께\n * 실어 보내고, 부르는 쪽이 현장 겹의 것은 경고로 올리지 않는다.\n */\n missingTargets: [\n ...first.missingTargets.map(t => ({ scope: 'space' as const, ...t })),\n ...second.missingTargets.map(t => ({ scope: 'instance' as const, ...t }))\n ]\n }\n}\n"]}
@@ -0,0 +1,18 @@
1
+ /**
2
+ * 지역 시각 + 오프셋 — `2026-08-22T05:54:12.345+09:00`.
3
+ *
4
+ * UTC 로 찍지 않는다: 이 로그를 읽는 사람은 현장의 시각으로 이야기하고, 프레임워크의 다른 줄도
5
+ * 지역 시각이다. 두 줄이 다른 기준이면 나란히 놓고 읽을 수 없다.
6
+ */
7
+ export declare function stamp(at?: Date): string;
8
+ /**
9
+ * 인자 여럿을 한 줄로 — **어떤 인자도 버리지 않는다.**
10
+ *
11
+ * `console.error(msg, err)` 처럼 쓰던 자리가 많다. 프레임워크 로거에 그대로 넘기면 두 번째 인자는
12
+ * meta 로 들어가 우리 형식(`message` 만 찍는다)에서 **조용히 사라진다.** 그래서 여기서 문자열로 편다.
13
+ * 오류는 스택까지 — 스택이 없으면 「어디서 났나」를 잃는다.
14
+ */
15
+ export declare function line(args: unknown[]): string;
16
+ export declare const twinLog: (...args: unknown[]) => void;
17
+ export declare const twinWarn: (...args: unknown[]) => void;
18
+ export declare const twinError: (...args: unknown[]) => void;
@@ -0,0 +1,80 @@
1
+ "use strict";
2
+ /*
3
+ * 트윈 로그의 문 — **모든 줄에 시각을 찍는다.** 순수(프레임워크 의존 없음).
4
+ *
5
+ * ── 왜 필요한가 (2026-08-22) ────────────────────────────────────────────────
6
+ * 「서버가 왜 느린가」를 조사하면서 루프가 55초 막힌 것을 계기로 알아냈는데(`loop-lag.ts`),
7
+ * **그 시각에 무슨 일이 있었는지 로그에서 찾을 수 없었다.** 트윈의 로그가 `console.log` 로 나가
8
+ * 시각이 없었기 때문이다. 프레임워크 로그(`2026-08-22T05:54:12+09:00 info: …`)와 섞여 있어서, 어느
9
+ * 줄이 언제 찍혔는지 앞뒤 프레임워크 줄로 짐작해야 했다.
10
+ *
11
+ * ── 왜 프레임워크 로거를 그대로 쓰지 않나 ──────────────────────────────────
12
+ * 재발명을 피하려고 `@things-factory/env` 의 `logger` 를 쓰려 했는데, 실측으로 막혔다: 앱 **밖**에서는
13
+ * 그 로거에 전송지가 하나도 없다(설정이 앱에서 주입된다). 그래서 시험·도구에서 부르면
14
+ *
15
+ * [winston] Attempt to write logs with no transports … {"message":"…","level":"info"}
16
+ *
17
+ * 가 나오고 **메시지 자체가 사라진다.** 트윈 엔진은 시험과 CLI 도구에서도 불려 다니므로, 그 조건에서
18
+ * 로그가 없어지는 것은 바꿔선 안 되는 거동이다(로그가 사라지는 것이 지금 문제의 원인이었다).
19
+ *
20
+ * 그래서 **싱크는 그대로 두고**(console) 빠진 사실 하나만 채운다 — 시각. 형식은 프레임워크와 같은
21
+ * 모양으로 맞춰 한 파일에서 섞여 읽히게 하고, **밀리초까지** 남긴다(계기의 값이 epoch ms 라
22
+ * 초 단위로는 같은 초 안의 순서를 가릴 수 없다).
23
+ */
24
+ Object.defineProperty(exports, "__esModule", { value: true });
25
+ exports.twinError = exports.twinWarn = exports.twinLog = void 0;
26
+ exports.stamp = stamp;
27
+ exports.line = line;
28
+ /** 두 자리·세 자리 0 채우기 — 형식이 흔들리면 정렬해 읽을 수 없다. */
29
+ const p2 = (n) => String(n).padStart(2, '0');
30
+ const p3 = (n) => String(n).padStart(3, '0');
31
+ /**
32
+ * 지역 시각 + 오프셋 — `2026-08-22T05:54:12.345+09:00`.
33
+ *
34
+ * UTC 로 찍지 않는다: 이 로그를 읽는 사람은 현장의 시각으로 이야기하고, 프레임워크의 다른 줄도
35
+ * 지역 시각이다. 두 줄이 다른 기준이면 나란히 놓고 읽을 수 없다.
36
+ */
37
+ function stamp(at = new Date()) {
38
+ const off = -at.getTimezoneOffset();
39
+ const sign = off >= 0 ? '+' : '-';
40
+ const abs = Math.abs(off);
41
+ return (`${at.getFullYear()}-${p2(at.getMonth() + 1)}-${p2(at.getDate())}` +
42
+ `T${p2(at.getHours())}:${p2(at.getMinutes())}:${p2(at.getSeconds())}.${p3(at.getMilliseconds())}` +
43
+ `${sign}${p2(Math.floor(abs / 60))}:${p2(abs % 60)}`);
44
+ }
45
+ /**
46
+ * 인자 여럿을 한 줄로 — **어떤 인자도 버리지 않는다.**
47
+ *
48
+ * `console.error(msg, err)` 처럼 쓰던 자리가 많다. 프레임워크 로거에 그대로 넘기면 두 번째 인자는
49
+ * meta 로 들어가 우리 형식(`message` 만 찍는다)에서 **조용히 사라진다.** 그래서 여기서 문자열로 편다.
50
+ * 오류는 스택까지 — 스택이 없으면 「어디서 났나」를 잃는다.
51
+ */
52
+ function line(args) {
53
+ return args
54
+ .map(a => {
55
+ if (typeof a === 'string')
56
+ return a;
57
+ if (a instanceof Error)
58
+ return a.stack ?? a.message;
59
+ if (a === undefined)
60
+ return 'undefined';
61
+ if (a === null)
62
+ return 'null';
63
+ try {
64
+ return typeof a === 'object' ? JSON.stringify(a) : String(a);
65
+ }
66
+ catch {
67
+ /* 순환 참조 등 — 값을 못 적어도 **무엇이 있었다는 사실**은 남긴다. */
68
+ return String(a);
69
+ }
70
+ })
71
+ .join(' ');
72
+ }
73
+ /* 수준 표기는 프레임워크와 같은 낱말을 쓴다(`info`·`warn`·`error`) — 같은 파일에서 걸러 읽는다. */
74
+ const twinLog = (...args) => console.log(`${stamp()} info: ${line(args)}`);
75
+ exports.twinLog = twinLog;
76
+ const twinWarn = (...args) => console.warn(`${stamp()} warn: ${line(args)}`);
77
+ exports.twinWarn = twinWarn;
78
+ const twinError = (...args) => console.error(`${stamp()} error: ${line(args)}`);
79
+ exports.twinError = twinError;
80
+ //# sourceMappingURL=log.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"log.js","sourceRoot":"","sources":["../../server/engine/log.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;AAYH,sBASC;AASD,oBAeC;AA3CD,8CAA8C;AAC9C,MAAM,EAAE,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;AACpD,MAAM,EAAE,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;AAEpD;;;;;GAKG;AACH,SAAgB,KAAK,CAAC,KAAW,IAAI,IAAI,EAAE;IACzC,MAAM,GAAG,GAAG,CAAC,EAAE,CAAC,iBAAiB,EAAE,CAAA;IACnC,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAA;IACjC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACzB,OAAO,CACL,GAAG,EAAE,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,EAAE;QAClE,IAAI,EAAE,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,eAAe,EAAE,CAAC,EAAE;QACjG,GAAG,IAAI,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,CACrD,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,IAAI,CAAC,IAAe;IAClC,OAAO,IAAI;SACR,GAAG,CAAC,CAAC,CAAC,EAAE;QACP,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,OAAO,CAAC,CAAA;QACnC,IAAI,CAAC,YAAY,KAAK;YAAE,OAAO,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,OAAO,CAAA;QACnD,IAAI,CAAC,KAAK,SAAS;YAAE,OAAO,WAAW,CAAA;QACvC,IAAI,CAAC,KAAK,IAAI;YAAE,OAAO,MAAM,CAAA;QAC7B,IAAI,CAAC;YACH,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;QAC9D,CAAC;QAAC,MAAM,CAAC;YACP,8CAA8C;YAC9C,OAAO,MAAM,CAAC,CAAC,CAAC,CAAA;QAClB,CAAC;IACH,CAAC,CAAC;SACD,IAAI,CAAC,GAAG,CAAC,CAAA;AACd,CAAC;AAED,sEAAsE;AAC/D,MAAM,OAAO,GAAG,CAAC,GAAG,IAAe,EAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,EAAE,UAAU,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;AAArF,QAAA,OAAO,WAA8E;AAC3F,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAe,EAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,EAAE,UAAU,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;AAAvF,QAAA,QAAQ,YAA+E;AAC7F,MAAM,SAAS,GAAG,CAAC,GAAG,IAAe,EAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,EAAE,WAAW,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;AAA1F,QAAA,SAAS,aAAiF","sourcesContent":["/*\n * 트윈 로그의 문 — **모든 줄에 시각을 찍는다.** 순수(프레임워크 의존 없음).\n *\n * ── 왜 필요한가 (2026-08-22) ────────────────────────────────────────────────\n * 「서버가 왜 느린가」를 조사하면서 루프가 55초 막힌 것을 계기로 알아냈는데(`loop-lag.ts`),\n * **그 시각에 무슨 일이 있었는지 로그에서 찾을 수 없었다.** 트윈의 로그가 `console.log` 로 나가\n * 시각이 없었기 때문이다. 프레임워크 로그(`2026-08-22T05:54:12+09:00 info: …`)와 섞여 있어서, 어느\n * 줄이 언제 찍혔는지 앞뒤 프레임워크 줄로 짐작해야 했다.\n *\n * ── 왜 프레임워크 로거를 그대로 쓰지 않나 ──────────────────────────────────\n * 재발명을 피하려고 `@things-factory/env` 의 `logger` 를 쓰려 했는데, 실측으로 막혔다: 앱 **밖**에서는\n * 그 로거에 전송지가 하나도 없다(설정이 앱에서 주입된다). 그래서 시험·도구에서 부르면\n *\n * [winston] Attempt to write logs with no transports … {\"message\":\"…\",\"level\":\"info\"}\n *\n * 가 나오고 **메시지 자체가 사라진다.** 트윈 엔진은 시험과 CLI 도구에서도 불려 다니므로, 그 조건에서\n * 로그가 없어지는 것은 바꿔선 안 되는 거동이다(로그가 사라지는 것이 지금 문제의 원인이었다).\n *\n * 그래서 **싱크는 그대로 두고**(console) 빠진 사실 하나만 채운다 — 시각. 형식은 프레임워크와 같은\n * 모양으로 맞춰 한 파일에서 섞여 읽히게 하고, **밀리초까지** 남긴다(계기의 값이 epoch ms 라\n * 초 단위로는 같은 초 안의 순서를 가릴 수 없다).\n */\n\n/** 두 자리·세 자리 0 채우기 — 형식이 흔들리면 정렬해 읽을 수 없다. */\nconst p2 = (n: number) => String(n).padStart(2, '0')\nconst p3 = (n: number) => String(n).padStart(3, '0')\n\n/**\n * 지역 시각 + 오프셋 — `2026-08-22T05:54:12.345+09:00`.\n *\n * UTC 로 찍지 않는다: 이 로그를 읽는 사람은 현장의 시각으로 이야기하고, 프레임워크의 다른 줄도\n * 지역 시각이다. 두 줄이 다른 기준이면 나란히 놓고 읽을 수 없다.\n */\nexport function stamp(at: Date = new Date()): string {\n const off = -at.getTimezoneOffset()\n const sign = off >= 0 ? '+' : '-'\n const abs = Math.abs(off)\n return (\n `${at.getFullYear()}-${p2(at.getMonth() + 1)}-${p2(at.getDate())}` +\n `T${p2(at.getHours())}:${p2(at.getMinutes())}:${p2(at.getSeconds())}.${p3(at.getMilliseconds())}` +\n `${sign}${p2(Math.floor(abs / 60))}:${p2(abs % 60)}`\n )\n}\n\n/**\n * 인자 여럿을 한 줄로 — **어떤 인자도 버리지 않는다.**\n *\n * `console.error(msg, err)` 처럼 쓰던 자리가 많다. 프레임워크 로거에 그대로 넘기면 두 번째 인자는\n * meta 로 들어가 우리 형식(`message` 만 찍는다)에서 **조용히 사라진다.** 그래서 여기서 문자열로 편다.\n * 오류는 스택까지 — 스택이 없으면 「어디서 났나」를 잃는다.\n */\nexport function line(args: unknown[]): string {\n return args\n .map(a => {\n if (typeof a === 'string') return a\n if (a instanceof Error) return a.stack ?? a.message\n if (a === undefined) return 'undefined'\n if (a === null) return 'null'\n try {\n return typeof a === 'object' ? JSON.stringify(a) : String(a)\n } catch {\n /* 순환 참조 등 — 값을 못 적어도 **무엇이 있었다는 사실**은 남긴다. */\n return String(a)\n }\n })\n .join(' ')\n}\n\n/* 수준 표기는 프레임워크와 같은 낱말을 쓴다(`info`·`warn`·`error`) — 같은 파일에서 걸러 읽는다. */\nexport const twinLog = (...args: unknown[]): void => console.log(`${stamp()} info: ${line(args)}`)\nexport const twinWarn = (...args: unknown[]): void => console.warn(`${stamp()} warn: ${line(args)}`)\nexport const twinError = (...args: unknown[]): void => console.error(`${stamp()} error: ${line(args)}`)\n"]}
@@ -0,0 +1,54 @@
1
+ /** 표본 간격(ms) — 촘촘할 필요가 없다. 긴 정체를 놓치지 않는 정도면 된다. */
2
+ export declare const LAG_SAMPLE_MS = 500;
3
+ /** 이 값을 넘는 지체만 「정체」로 센다(ms). 사람이 화면에서 느끼기 시작하는 크기. */
4
+ export declare const LAG_STALL_MS = 200;
5
+ /** 창 길이(ms) — `twinLoad` 의 창과 같은 크기로 두어 나란히 읽는다. */
6
+ export declare const LAG_WINDOW_MS = 10000;
7
+ export interface LoopLagWindow {
8
+ /** 이 창에서 가장 길게 막힌 시간(ms). */
9
+ maxMs: number;
10
+ /** 정체(문턱 초과) 횟수. */
11
+ stalls: number;
12
+ /** 표본 수 — 분모다. */
13
+ samples: number;
14
+ /** 지체 합(ms) — 평균은 읽는 쪽에서 낸다. */
15
+ totalMs: number;
16
+ /** 창이 열린 시각. */
17
+ startMs: number;
18
+ }
19
+ export interface LoopLagView {
20
+ /** 마지막으로 닫힌 창 — 「지금 어떤가」. 아직 한 창도 안 지났으면 null. */
21
+ recent: (LoopLagWindow & {
22
+ endMs: number;
23
+ }) | null;
24
+ /** 기동 이후 누적. */
25
+ total: LoopLagWindow;
26
+ /** 기동 이후 가장 길게 막힌 시각(ms, epoch) — 언제였는지가 원인을 가리는 데 쓰인다. */
27
+ worstAtMs: number | null;
28
+ /** 표본 간격 — 읽는 쪽이 이 값보다 짧은 정체는 못 본다는 것을 알아야 한다. */
29
+ sampleMs: number;
30
+ /** 정체로 세는 문턱. */
31
+ stallMs: number;
32
+ }
33
+ export declare class LoopLagSampler {
34
+ private window;
35
+ private closed;
36
+ private total;
37
+ private worstAtMs;
38
+ private timer;
39
+ private expectedMs;
40
+ private sampleMs;
41
+ private stallMs;
42
+ private windowMs;
43
+ private now;
44
+ constructor(sampleMs?: number, stallMs?: number, windowMs?: number, now?: () => number);
45
+ /** 표본을 하나 넣는다 — 타이머가 부르고, 시험은 직접 부른다(시계를 밀어 넣어 잰다). */
46
+ sample(atMs?: number): number;
47
+ /** 계기판이 읽는 값. **한 창도 닫히지 않았으면 `recent` 는 null** — 채우는 중인 창은 과소 집계다. */
48
+ view(): LoopLagView;
49
+ /** 표본 타이머 기동(1회) — 프로세스 종료를 막지 않는다. */
50
+ start(): void;
51
+ stop(): void;
52
+ }
53
+ /** 프로세스 하나의 루프를 재는 것이므로 표본기도 하나다. */
54
+ export declare const loopLag: LoopLagSampler;
@@ -0,0 +1,87 @@
1
+ "use strict";
2
+ /*
3
+ * 이벤트 루프 지체 — **화면이 느린 이유를 지어내지 않기 위해.** 순수(import 없음).
4
+ *
5
+ * ── 왜 필요한가 (2026-08-21) ────────────────────────────────────────────────
6
+ * 「UI 반응성이 느리다」를 진단하려 했는데, 있는 계기판으로는 답이 나오지 않았다. `twinLoad` 는 **트윈의
7
+ * 계측된 작업**만 재고, `processCpuRatio` 는 프로세스 전체를 재지만 **언제 얼마나 멈췄나**를 말하지
8
+ * 못한다. 밖에서 HTTP 지연을 재 보니 같은 요청이 44ms 와 5.8초로 갈라졌는데, 그 5.8초가 트윈 때문인지
9
+ * webpack 재빌드 때문인지 남의 재기동 때문인지 **가릴 근거가 없었다.**
10
+ *
11
+ * 근거 없이 원인을 고르면 엉뚱한 곳을 고친다. 그래서 루프가 실제로 얼마나 막혔는지를 잰다.
12
+ *
13
+ * ── 어떻게 재나 ─────────────────────────────────────────────────────────────
14
+ * 일정 간격으로 깨어나는 타이머를 두고, **예정 시각과 실제 시각의 차이**를 본다. 루프가 막혀 있었으면
15
+ * 그만큼 늦게 깨어난다. 재는 비용은 그 차이 계산 하나뿐이다(창마다 값 다섯).
16
+ *
17
+ * 이 값은 **원인을 말하지 않는다** — 「200ms 이상 막힌 일이 이 창에서 세 번, 가장 긴 것은 4.6초」까지가
18
+ * 사실이다. 원인은 그 시각의 트윈 부하(`twinLoad`)와 프로세스 CPU 와 나란히 놓고 사람이 가린다.
19
+ * 재지 않은 것을 0 으로 적지 않는다 — 한 번도 깨어나지 않았으면 `null` 이다.
20
+ */
21
+ Object.defineProperty(exports, "__esModule", { value: true });
22
+ exports.loopLag = exports.LoopLagSampler = exports.LAG_WINDOW_MS = exports.LAG_STALL_MS = exports.LAG_SAMPLE_MS = void 0;
23
+ /** 표본 간격(ms) — 촘촘할 필요가 없다. 긴 정체를 놓치지 않는 정도면 된다. */
24
+ exports.LAG_SAMPLE_MS = 500;
25
+ /** 이 값을 넘는 지체만 「정체」로 센다(ms). 사람이 화면에서 느끼기 시작하는 크기. */
26
+ exports.LAG_STALL_MS = 200;
27
+ /** 창 길이(ms) — `twinLoad` 의 창과 같은 크기로 두어 나란히 읽는다. */
28
+ exports.LAG_WINDOW_MS = 10_000;
29
+ const emptyWindow = (startMs) => ({ maxMs: 0, stalls: 0, samples: 0, totalMs: 0, startMs });
30
+ class LoopLagSampler {
31
+ /* 생성자 파라미터 프로퍼티(`private x = …`)는 쓰지 않는다 — 시험이 소스를 그대로 실행하는데
32
+ (타입 제거 실행 방식) 그 문법은 지원되지 않아 파일 전체가 열리지 않는다. */
33
+ constructor(sampleMs = exports.LAG_SAMPLE_MS, stallMs = exports.LAG_STALL_MS, windowMs = exports.LAG_WINDOW_MS, now = Date.now) {
34
+ this.closed = null;
35
+ this.worstAtMs = null;
36
+ this.sampleMs = sampleMs;
37
+ this.stallMs = stallMs;
38
+ this.windowMs = windowMs;
39
+ this.now = now;
40
+ const t = this.now();
41
+ this.window = emptyWindow(t);
42
+ this.total = emptyWindow(t);
43
+ this.expectedMs = t + sampleMs;
44
+ }
45
+ /** 표본을 하나 넣는다 — 타이머가 부르고, 시험은 직접 부른다(시계를 밀어 넣어 잰다). */
46
+ sample(atMs = this.now()) {
47
+ const lag = Math.max(0, atMs - this.expectedMs);
48
+ this.expectedMs = atMs + this.sampleMs;
49
+ for (const w of [this.window, this.total]) {
50
+ w.samples += 1;
51
+ w.totalMs += lag;
52
+ if (lag > this.stallMs)
53
+ w.stalls += 1;
54
+ if (lag > w.maxMs)
55
+ w.maxMs = lag;
56
+ }
57
+ if (lag >= this.total.maxMs && lag > this.stallMs)
58
+ this.worstAtMs = atMs;
59
+ if (atMs - this.window.startMs >= this.windowMs) {
60
+ this.closed = { ...this.window, endMs: atMs };
61
+ this.window = emptyWindow(atMs);
62
+ }
63
+ return lag;
64
+ }
65
+ /** 계기판이 읽는 값. **한 창도 닫히지 않았으면 `recent` 는 null** — 채우는 중인 창은 과소 집계다. */
66
+ view() {
67
+ return { recent: this.closed, total: this.total, worstAtMs: this.worstAtMs, sampleMs: this.sampleMs, stallMs: this.stallMs };
68
+ }
69
+ /** 표본 타이머 기동(1회) — 프로세스 종료를 막지 않는다. */
70
+ start() {
71
+ if (this.timer)
72
+ return;
73
+ this.timer = setInterval(() => this.sample(), this.sampleMs);
74
+ if (typeof this.timer?.unref === 'function')
75
+ this.timer.unref();
76
+ }
77
+ stop() {
78
+ if (!this.timer)
79
+ return;
80
+ clearInterval(this.timer);
81
+ this.timer = undefined;
82
+ }
83
+ }
84
+ exports.LoopLagSampler = LoopLagSampler;
85
+ /** 프로세스 하나의 루프를 재는 것이므로 표본기도 하나다. */
86
+ exports.loopLag = new LoopLagSampler();
87
+ //# sourceMappingURL=loop-lag.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"loop-lag.js","sourceRoot":"","sources":["../../server/engine/loop-lag.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * 이벤트 루프 지체 — **화면이 느린 이유를 지어내지 않기 위해.** 순수(import 없음).\n *\n * ── 왜 필요한가 (2026-08-21) ────────────────────────────────────────────────\n * 「UI 반응성이 느리다」를 진단하려 했는데, 있는 계기판으로는 답이 나오지 않았다. `twinLoad` 는 **트윈의\n * 계측된 작업**만 재고, `processCpuRatio` 는 프로세스 전체를 재지만 **언제 얼마나 멈췄나**를 말하지\n * 못한다. 밖에서 HTTP 지연을 재 보니 같은 요청이 44ms 와 5.8초로 갈라졌는데, 그 5.8초가 트윈 때문인지\n * webpack 재빌드 때문인지 남의 재기동 때문인지 **가릴 근거가 없었다.**\n *\n * 근거 없이 원인을 고르면 엉뚱한 곳을 고친다. 그래서 루프가 실제로 얼마나 막혔는지를 잰다.\n *\n * ── 어떻게 재나 ─────────────────────────────────────────────────────────────\n * 일정 간격으로 깨어나는 타이머를 두고, **예정 시각과 실제 시각의 차이**를 본다. 루프가 막혀 있었으면\n * 그만큼 늦게 깨어난다. 재는 비용은 그 차이 계산 하나뿐이다(창마다 값 다섯).\n *\n * 이 값은 **원인을 말하지 않는다** — 「200ms 이상 막힌 일이 이 창에서 세 번, 가장 긴 것은 4.6초」까지가\n * 사실이다. 원인은 그 시각의 트윈 부하(`twinLoad`)와 프로세스 CPU 와 나란히 놓고 사람이 가린다.\n * 재지 않은 것을 0 으로 적지 않는다 — 한 번도 깨어나지 않았으면 `null` 이다.\n */\n\n/** 표본 간격(ms) — 촘촘할 필요가 없다. 긴 정체를 놓치지 않는 정도면 된다. */\nexport const LAG_SAMPLE_MS = 500\n/** 이 값을 넘는 지체만 「정체」로 센다(ms). 사람이 화면에서 느끼기 시작하는 크기. */\nexport const LAG_STALL_MS = 200\n/** 창 길이(ms) — `twinLoad` 의 창과 같은 크기로 두어 나란히 읽는다. */\nexport const LAG_WINDOW_MS = 10_000\n\nexport interface LoopLagWindow {\n /** 이 창에서 가장 길게 막힌 시간(ms). */\n maxMs: number\n /** 정체(문턱 초과) 횟수. */\n stalls: number\n /** 표본 수 — 분모다. */\n samples: number\n /** 지체 합(ms) — 평균은 읽는 쪽에서 낸다. */\n totalMs: number\n /** 창이 열린 시각. */\n startMs: number\n}\n\nexport interface LoopLagView {\n /** 마지막으로 닫힌 창 — 「지금 어떤가」. 아직 한 창도 안 지났으면 null. */\n recent: (LoopLagWindow & { endMs: number }) | null\n /** 기동 이후 누적. */\n total: LoopLagWindow\n /** 기동 이후 가장 길게 막힌 시각(ms, epoch) — 언제였는지가 원인을 가리는 데 쓰인다. */\n worstAtMs: number | null\n /** 표본 간격 — 읽는 쪽이 이 값보다 짧은 정체는 못 본다는 것을 알아야 한다. */\n sampleMs: number\n /** 정체로 세는 문턱. */\n stallMs: number\n}\n\nconst emptyWindow = (startMs: number): LoopLagWindow => ({ maxMs: 0, stalls: 0, samples: 0, totalMs: 0, startMs })\n\nexport class LoopLagSampler {\n private window: LoopLagWindow\n private closed: (LoopLagWindow & { endMs: number }) | null = null\n private total: LoopLagWindow\n private worstAtMs: number | null = null\n private timer: any\n private expectedMs: number\n\n private sampleMs: number\n private stallMs: number\n private windowMs: number\n private now: () => number\n\n /* 생성자 파라미터 프로퍼티(`private x = …`)는 쓰지 않는다 — 시험이 소스를 그대로 실행하는데\n (타입 제거 실행 방식) 그 문법은 지원되지 않아 파일 전체가 열리지 않는다. */\n constructor(sampleMs = LAG_SAMPLE_MS, stallMs = LAG_STALL_MS, windowMs = LAG_WINDOW_MS, now: () => number = Date.now) {\n this.sampleMs = sampleMs\n this.stallMs = stallMs\n this.windowMs = windowMs\n this.now = now\n const t = this.now()\n this.window = emptyWindow(t)\n this.total = emptyWindow(t)\n this.expectedMs = t + sampleMs\n }\n\n /** 표본을 하나 넣는다 — 타이머가 부르고, 시험은 직접 부른다(시계를 밀어 넣어 잰다). */\n sample(atMs = this.now()): number {\n const lag = Math.max(0, atMs - this.expectedMs)\n this.expectedMs = atMs + this.sampleMs\n for (const w of [this.window, this.total]) {\n w.samples += 1\n w.totalMs += lag\n if (lag > this.stallMs) w.stalls += 1\n if (lag > w.maxMs) w.maxMs = lag\n }\n if (lag >= this.total.maxMs && lag > this.stallMs) this.worstAtMs = atMs\n if (atMs - this.window.startMs >= this.windowMs) {\n this.closed = { ...this.window, endMs: atMs }\n this.window = emptyWindow(atMs)\n }\n return lag\n }\n\n /** 계기판이 읽는 값. **한 창도 닫히지 않았으면 `recent` 는 null** — 채우는 중인 창은 과소 집계다. */\n view(): LoopLagView {\n return { recent: this.closed, total: this.total, worstAtMs: this.worstAtMs, sampleMs: this.sampleMs, stallMs: this.stallMs }\n }\n\n /** 표본 타이머 기동(1회) — 프로세스 종료를 막지 않는다. */\n start(): void {\n if (this.timer) return\n this.timer = setInterval(() => this.sample(), this.sampleMs)\n if (typeof this.timer?.unref === 'function') this.timer.unref()\n }\n\n stop(): void {\n if (!this.timer) return\n clearInterval(this.timer)\n this.timer = undefined\n }\n}\n\n/** 프로세스 하나의 루프를 재는 것이므로 표본기도 하나다. */\nexport const loopLag = new LoopLagSampler()\n"]}
@@ -0,0 +1,42 @@
1
+ /** 커널 `YieldEstimator` 와 같은 모양(커널 타입에 의존하지 않기 위해 구조로 맞춘다). */
2
+ export interface YieldEstimatorResult {
3
+ estimator?: {
4
+ estimate(ctx: {
5
+ kind: string;
6
+ }): number | undefined;
7
+ };
8
+ /** 작업 종류 → 실측 양품률(0..1). 추정기가 답하는 종류들. */
9
+ learned: Record<string, number>;
10
+ /** 종류별 표본 — 배운 값의 근거 크기(화면·로그가 「몇 건에서 배웠나」를 말할 수 있게). */
11
+ samples: Record<string, {
12
+ good: number;
13
+ scrap: number;
14
+ }>;
15
+ /** 표본이 모자라 쓰지 않은 종류와 판정 건수 — 배우지 못한 것을 밝힌다. */
16
+ skipped: {
17
+ kind: string;
18
+ judged: number;
19
+ }[];
20
+ minSamples: number;
21
+ }
22
+ /**
23
+ * 기본 표본 하한 — 판정 20건 미만이면 그 종류는 배우지 않는다.
24
+ *
25
+ * 소요(5건)보다 높게 잡는 이유: 비율은 **드문 사건**을 재는 값이다. 불량률 5% 인 공정에서 20건을 봐도
26
+ * 불량은 한 건이고, 그 한 건이 있고 없음으로 비율이 0% 와 5% 사이를 오간다. 낮게 잡으면 추정기가
27
+ * 이력이라는 이름으로 잡음을 실어 보낸다.
28
+ */
29
+ export declare const DEFAULT_YIELD_MIN_SAMPLES = 20;
30
+ /**
31
+ * 작업 종류별 KPI 그룹에서 양품률 추정기를 만든다(순수 — DB·커널 모름).
32
+ * `groups` 는 `computeTwinKpi({ groupBy: 'taskKind' })` 의 `groups.items` 를 그대로 넘긴다.
33
+ */
34
+ export declare function buildYieldEstimator(groups: {
35
+ key: string;
36
+ quality?: {
37
+ good: number;
38
+ scrap: number;
39
+ };
40
+ }[] | undefined, opts?: {
41
+ minSamples?: number;
42
+ }): YieldEstimatorResult;