@operato/twin-kernel 0.6.5 → 0.6.7

package/dist/contract.d.ts

@@ -168,6 +168,93 @@ export type TestSpecificationRefs = string[];
  * 필요해지면 일정·실적과 같은 방식(`source: 'state'|'journal'`)으로 따로 낸다. 한 축에 둘을 담으면
  * 선언과 관측을 가르는 이 트윈의 뼈대가 무너진다.
  */
+/**
+ * 시험 결과 — **"이 개체가 그 시험을 통과했다"** 는 기록.
+ *
+ * ── 이것은 관측인데 왜 선언 경로로 오나 ───────────────────────────────────────
+ * 결과는 사실이 일어난 것이므로 관측이다. 그런데 그 사실을 **낳는 곳이 트윈이 아니다** — 자격 시험은
+ * 인사 시스템이, 설비 검사는 정비 시스템이 기록한다. 트윈은 그 기록을 **원본에서 받아** 안다.
+ * 그래서 이 값은 자원에 실려 인제스트로 들어온다(저널이 낳는 관측과 다른 길이다).
+ *
+ * ── 없으면 판정하지 않는다 ────────────────────────────────────────────────────
+ * 등급이 시험을 요구하는데(`ResourceClassDef.testSpecificationIds`) 그 사람에게 **결과가 아예 없으면
+ * 막지 않는다.** 없는 것으로 막으면 자격자가 전부 사라져 라인이 영구히 굶고, 그건 "선언한 것만 제약이
+ * 된다" 는 이 커널의 규율에도 어긋난다 — 원본이 결과를 주지 않는 현장에서는 그 제약이 선언되지 않은
+ * 것이다.
+ *
+ * **결과가 선언돼 있으면 그때부터 제약이 된다**: 불합격이거나 유효기간이 지났으면 그 등급으로 자격이
+ * 성립하지 않는다. 그것이 이 값을 싣는 이유다(싣지 않으면 아무 제약도 없다).
+ *
+ * 필드 이름은 최소로 둔다 — 표준 결과 타입(`B2MML-OperationsTest.xsd`)과 아직 대조하지 않았다.
+ */
+export interface TestResult {
+    /** 어느 시험인가 — `TestSpecification.id` 를 가리킨다. */
+    specId: string;
+    /** 합격 여부. 표준의 판정 어휘를 대조하기 전이므로 둘만 둔다(모르는 값을 만들지 않는다). */
+    result: 'pass' | 'fail';
+    /** 언제 통과·불합격했나(ISO). */
+    at?: ISOTime;
+    /**
+     * 언제까지 유효한가(ISO) — 자격에는 대개 유효기간이 있다.
+     *
+     * **없으면 무기한으로 본다.** 여기서 짐작으로 기한을 만들면 멀쩡한 자격자가 조용히 사라진다
+     * (유효기간을 모르는 것과 지난 것은 다르다).
+     */
+    expiresAt?: ISOTime;
+}
+/**
+ * 이 시험 결과가 **이 시각에 유효한 합격인가.**
+ *
+ * 판정을 한 곳에 둔다 — 자리마다 `result === 'pass'` 와 날짜 비교를 다시 적으면 한 곳이 빠지고,
+ * 빠진 쪽은 만료된 자격을 통과시킨다(조용한 결함).
+ */
+export declare function testPassedAt(r: TestResult, at?: ISOTime): boolean;
+/**
+ * 이 개체가 **요구된 시험들을 만족하나** — 등급이 요구하고 개체가 기록을 든다.
+ *
+ * `required` 가 비면 요구가 없으므로 참이다. 요구된 시험에 **결과가 없으면 참**이다(위 머리말의 규율:
+ * 없는 것으로 막지 않는다). 결과가 있으면 그것이 유효한 합격이어야 한다.
+ */
+export declare function meetsTests(required: readonly string[], results: readonly TestResult[] | undefined, at?: ISOTime): boolean;
+/**
+ * 자원이 **지금 쓰일 수 있나, 아니면 왜 못 쓰이나** — ISA-95 `PersonnelCapability`/`EquipmentCapability`.
+ *
+ * ── 왜 계약이 이것을 소유해야 하나 ────────────────────────────────────────────
+ * 커널은 배정할 때 이미 이 판정을 한다(교대·고장·보류·유효기간·시험 만료). 그런데 그 규칙이 **엔진 안의
+ * 필터 조건으로만** 있어서, 화면은 같은 판정을 자기 코드로 다시 만들었다(`reasonOf`). 규칙이 두 벌이면
+ * 반드시 갈라진다 — 배정은 막는데 화면은 "가용" 이라 말하는 순간이 온다. 그 어긋남은 조용하다.
+ *
+ * 그래서 **이유까지 계약이 낸다.** 화면·예측·AI 가 같은 낱말로 말하고, 새 이유가 생기면(시험 만료가
+ * 그랬다) 한 곳만 늘어난다.
+ *
+ * ── 이유의 순서가 뜻이다 ──────────────────────────────────────────────────────
+ * 여러 이유가 겹칠 수 있다(폐기한 설비가 고장 상태로 남아 있는 것). **먼저 오는 것을 답한다** —
+ * "이미 모델 밖" 이 "고장" 보다 앞선다(폐기한 설비의 고장은 고칠 일이 아니다).
+ */
+export type CapabilityReason = 
+/** 유효기간 전 — 아직 없는 자원(도입 예정). 기다릴 일이다. */
+'not-yet'
+/** 유효기간 후 — 이미 없는 자원(폐기·퇴사). 지울 일이다. */
+ | 'retired'
+/** 사람이 막았다(`held`) — 지시로 보류. */
+ | 'held'
+/** 고장 — 설비만. 고칠 일이다. */
+ | 'down'
+/** 근무·가동 시간 밖(교대 사이) — 기다리면 돌아온다. */
+ | 'off-shift'
+/** 근무일이 아니다(휴일) — 하루 통째로 쉰다. `off-shift` 와 기다릴 시간이 다르다. */
+ | 'resting'
+/** 요구된 시험의 결과가 만료·불합격 — 자격이 성립하지 않는다(§TestResult). */
+ | 'test-expired'
+/** 지금 다른 일을 하고 있다 — 능력은 있고 여유가 없다. */
+ | 'working'
+/** 쓸 수 있다. */
+ | 'available';
+/** 가용 여부와 그 이유 — `available` 이면 `reason: 'available'`. */
+export interface Capability {
+    available: boolean;
+    reason: CapabilityReason;
+}
 export interface TestSpecification {
     /** 표준 `ID` — 자원의 `testSpecificationIds` 가 이 값을 가리킨다. */
     id: string;
@@ -348,6 +435,13 @@ export interface MaterialDefinition extends EffectivePeriod {
     properties?: ResourceProperty[];
     /** 적격을 검증한 시험 명세들 — 표준 `MaterialDefinition.TestSpecificationID`. */
     testSpecificationIds?: TestSpecificationRefs;
+    /**
+     * 그 시험들의 **결과** — "언제 통과했고 언제까지 유효한가"(§TestResult).
+     *
+     * 참조만 있으면 "무엇으로 검증한다" 까지고, 결과가 있어야 **자격이 성립하는지**를 말할 수 있다.
+     * 없으면 판정하지 않는다(없는 것으로 막으면 자격자가 전부 사라진다).
+     */
+    testResults?: TestResult[];
 }
 /** 품목 정의 색인 — id(GTIN) → 정의. 소비처가 매번 배열을 훑지 않게. */
 export type MaterialDefinitionIndex = ReadonlyMap<string, MaterialDefinition>;
@@ -523,6 +617,28 @@ export declare function offCalendarAt(r: {
     };
     workCalendar?: WorkCalendarEntry[];
 }, ms: number, utcOffsetMinutes?: number): boolean;
+/**
+ * 자원의 **가용 능력을 판정한다** — 하나의 규칙, 하나의 자리.
+ *
+ * 부르는 쪽이 시각과 시간대를 준다(커널은 `now()`·`utcOffsetMinutes`, 호스트는 관측 시각). 주지 않으면
+ * 시각에 달린 판정(유효기간·교대·시험 만료)은 **하지 않는다** — 모르면 판단하지 않는다는 규율이다.
+ *
+ * `requiredTests` 는 부르는 쪽이 등급에서 모아 넘긴다(등급 정의를 아는 것은 부르는 쪽이다).
+ */
+export declare function capabilityOf(r: {
+    status?: string;
+    held?: boolean;
+    window?: {
+        startHour: number;
+        endHour: number;
+    };
+    workCalendar?: WorkCalendarEntry[];
+    testResults?: TestResult[];
+} & EffectivePeriod, ctx?: {
+    at?: ISOTime;
+    utcOffsetMinutes?: number;
+    requiredTests?: readonly string[];
+}): Capability;
 export interface LocationState {
     id: string;
     type: string;
@@ -734,6 +850,13 @@ export interface EquipmentState extends EffectivePeriod {
     workCalendar?: WorkCalendarEntry[];
     /** 적격을 검증한 시험 명세들 — 표준 `Equipment.TestSpecificationID`(§TestSpecificationRefs). */
     testSpecificationIds?: TestSpecificationRefs;
+    /**
+     * 그 시험들의 **결과** — "언제 통과했고 언제까지 유효한가"(§TestResult).
+     *
+     * 참조만 있으면 "무엇으로 검증한다" 까지고, 결과가 있어야 **자격이 성립하는지**를 말할 수 있다.
+     * 없으면 판정하지 않는다(없는 것으로 막으면 자격자가 전부 사라진다).
+     */
+    testResults?: TestResult[];
 }
 /**
  * 사람 — **ISA-95 `Person`.** 설비와 다른 자원 종류다.
@@ -792,6 +915,13 @@ export interface PersonState extends EffectivePeriod {
     workCalendar?: WorkCalendarEntry[];
     /** 자격을 검증한 시험 명세들 — 표준 `Person.TestSpecificationID`(§TestSpecificationRefs). */
     testSpecificationIds?: TestSpecificationRefs;
+    /**
+     * 그 시험들의 **결과** — "언제 통과했고 언제까지 유효한가"(§TestResult).
+     *
+     * 참조만 있으면 "무엇으로 검증한다" 까지고, 결과가 있어야 **자격이 성립하는지**를 말할 수 있다.
+     * 없으면 판정하지 않는다(없는 것으로 막으면 자격자가 전부 사라진다).
+     */
+    testResults?: TestResult[];
 }
 /**
  * 물리 자산 — **ISA-95 `PhysicalAsset`, GS1 `GRAI`(반복사용 자산).**
@@ -1385,6 +1515,7 @@ export interface TwinModelDef {
         workCalendar?: WorkCalendarEntry[];
         properties?: ResourceProperty[];
         testSpecificationIds?: TestSpecificationRefs;
+        testResults?: TestResult[];
     })[];
     /**
      * 사람 — ISA-95 `Person`. `personnelClasses` 로 **속한 등급들**을 밝히고(복수가 표준), `window` 로
@@ -1402,6 +1533,7 @@ export interface TwinModelDef {
         homeLocation?: string;
         properties?: ResourceProperty[];
         testSpecificationIds?: TestSpecificationRefs;
+        testResults?: TestResult[];
     })[];
     /** 물리 자산(반복사용) — ISA-95 `PhysicalAsset` / GS1 `GRAI`. 선언하지 않으면 자산 제약이 없다. */
     assets?: (EffectivePeriod & {
@@ -1410,6 +1542,7 @@ export interface TwinModelDef {
         homeLocation?: string;
         properties?: ResourceProperty[];
         testSpecificationIds?: TestSpecificationRefs;
+        testResults?: TestResult[];
     })[];
     /**
      * 이 트윈의 **시각 해석 기준**(UTC 로부터의 분). 근무 캘린더의 `HH:MM` 이 어느 기준인지 정한다.

package/dist/contract.js

@@ -127,6 +127,38 @@ export function hierarchyOf(s) {
         }
     };
 }
+/**
+ * 이 시험 결과가 **이 시각에 유효한 합격인가.**
+ *
+ * 판정을 한 곳에 둔다 — 자리마다 `result === 'pass'` 와 날짜 비교를 다시 적으면 한 곳이 빠지고,
+ * 빠진 쪽은 만료된 자격을 통과시킨다(조용한 결함).
+ */
+export function testPassedAt(r, at) {
+    if (r.result !== 'pass')
+        return false;
+    if (!r.expiresAt || !at)
+        return r.result === 'pass';
+    return Date.parse(at) <= Date.parse(r.expiresAt);
+}
+/**
+ * 이 개체가 **요구된 시험들을 만족하나** — 등급이 요구하고 개체가 기록을 든다.
+ *
+ * `required` 가 비면 요구가 없으므로 참이다. 요구된 시험에 **결과가 없으면 참**이다(위 머리말의 규율:
+ * 없는 것으로 막지 않는다). 결과가 있으면 그것이 유효한 합격이어야 한다.
+ */
+export function meetsTests(required, results, at) {
+    if (!required.length)
+        return true;
+    const bySpec = new Map((results ?? []).map(r => [r.specId, r]));
+    for (const specId of required) {
+        const r = bySpec.get(specId);
+        if (!r)
+            continue; // 결과가 선언되지 않았다 — 제약이 아니다
+        if (!testPassedAt(r, at))
+            return false;
+    }
+    return true;
+}
 /**
  * 이 시각에 유효 기간 밖인가 — **한 규칙**으로 개체·등급·설비↔자산 매핑을 모두 판정한다.
  *
@@ -485,6 +517,43 @@ export function offCalendarAt(r, ms, utcOffsetMinutes) {
     const h = Math.floor(minute / 60);
     return !(w.startHour <= w.endHour ? h >= w.startHour && h < w.endHour : h >= w.startHour || h < w.endHour);
 }
+/**
+ * 자원의 **가용 능력을 판정한다** — 하나의 규칙, 하나의 자리.
+ *
+ * 부르는 쪽이 시각과 시간대를 준다(커널은 `now()`·`utcOffsetMinutes`, 호스트는 관측 시각). 주지 않으면
+ * 시각에 달린 판정(유효기간·교대·시험 만료)은 **하지 않는다** — 모르면 판단하지 않는다는 규율이다.
+ *
+ * `requiredTests` 는 부르는 쪽이 등급에서 모아 넘긴다(등급 정의를 아는 것은 부르는 쪽이다).
+ */
+export function capabilityOf(r, ctx) {
+    const at = ctx?.at;
+    /* 순서가 뜻이다 — "이미 모델 밖" 이 "고장" 보다 앞선다(폐기한 설비의 고장은 고칠 일이 아니다). */
+    const eff = effectivityAt(r, at);
+    if (eff === 'not-yet')
+        return { available: false, reason: 'not-yet' };
+    if (eff === 'expired')
+        return { available: false, reason: 'retired' };
+    if (r.held)
+        return { available: false, reason: 'held' };
+    if (r.status === 'down')
+        return { available: false, reason: 'down' };
+    if (at) {
+        const ms = Date.parse(at);
+        if (Number.isFinite(ms)) {
+            const why = offCalendarReasonAt(r, ms, ctx?.utcOffsetMinutes);
+            if (why === 'non-working')
+                return { available: false, reason: 'resting' };
+            if (why === 'off-hours')
+                return { available: false, reason: 'off-shift' };
+        }
+    }
+    /* 자격은 **결과가 선언됐을 때만** 제약이다(§meetsTests) — 없는 것으로 막으면 라인이 굶는다. */
+    if (ctx?.requiredTests?.length && !meetsTests(ctx.requiredTests, r.testResults, at))
+        return { available: false, reason: 'test-expired' };
+    if (r.status && r.status !== 'idle' && r.status !== 'available')
+        return { available: false, reason: 'working' };
+    return { available: true, reason: 'available' };
+}
 // ── 운영 델타(비-EPCIS) — State 채널의 나머지 절반 ──────────────────────────
 // EPCIS 이벤트는 재고/위치만 재구성 가능. tasks·equipment·orders 의 운영 상태는
 // 이 델타로 미러한다. envelope.eventType = 'task.status' | 'equipment.status' | 'order.status'.

package/dist/flow-engine.d.ts

@@ -1,4 +1,4 @@
-import type { ISOTime, MaterialQuantity, WorkCalendarEntry, EffectivePeriod, Effectivity, OffCalendarReason, ResourceProperty, ResourceClassDef, MaterialDefinition, Attention, TwinModelDef, CanonicalEnvelope, Command, CommandAck, EventHandler, EquipmentMotion, OeeMetrics, AssetState, GeneratorSpec, OrderState, PersonState, ScenarioControl, StateSnapshot, TwinKernel, Unsubscribe, LocationState, ItemState, EquipmentState, OrderStatusDelta, TaskState, StructureShift } from './contract.ts';
+import type { TestResult, ISOTime, MaterialQuantity, WorkCalendarEntry, EffectivePeriod, Effectivity, OffCalendarReason, ResourceProperty, ResourceClassDef, MaterialDefinition, Attention, TwinModelDef, CanonicalEnvelope, Command, CommandAck, EventHandler, EquipmentMotion, OeeMetrics, AssetState, GeneratorSpec, OrderState, PersonState, ScenarioControl, StateSnapshot, TwinKernel, Unsubscribe, LocationState, ItemState, EquipmentState, OrderStatusDelta, TaskState, StructureShift } from './contract.ts';
 import type { EpcisEvent, BizTransactionElement } from './epcis.ts';
 import type { AllocationPolicy, SlotView } from './allocation-policy.ts';
 import type { DurationEstimator, DurationContext } from './duration-estimator.ts';
@@ -76,6 +76,13 @@ export interface FlowPerson extends EffectivePeriod {
     properties?: ResourceProperty[];
     /** 자격을 검증한 시험 명세들 — 표준 `TestSpecificationID`. */
     testSpecificationIds?: string[];
+    /**
+     * 그 시험들의 **결과** — 자격이 성립하는지는 이것이 말한다(§TestResult).
+     *
+     * 참조만 있으면 "무엇으로 검증한다" 까지고, 배정 판정은 결과가 있어야 할 수 있다. 없으면 판정하지
+     * 않는다(없는 것으로 막으면 자격자가 전부 사라진다).
+     */
+    testResults?: TestResult[];
 }
 export interface FlowEquipment extends EffectivePeriod {
     id: string;
@@ -793,6 +800,21 @@ export declare abstract class FlowEngine implements TwinKernel {
     private recordMaterialActual;
     /** 확보한 자재를 **작업 시작 시점에 소비**한다 — 수량이 0 이 되면 물품 자체가 사라진다. */
     private consumeMaterials;
+    /**
+     * 이 사람이 **속한 등급들이 요구하는 시험**을 만족하나.
+     *
+     * 요구는 등급이 말하고(`ResourceClassDef.testSpecificationIds`) 기록은 사람이 든다. 상속을 타고 닫은
+     * 등급 전부의 요구를 모아 본다 — 상위 등급이 요구하는 시험도 자격의 조건이다.
+     *
+     * 판정 규칙은 계약이 소유한다(`meetsTests`) — 여기서 다시 적으면 규칙이 두 곳이 되고, 한쪽이 만료를
+     * 조용히 통과시킨다.
+     */
+    /**
+     * 이 사람이 속한 등급들이 **요구하는 시험 목록** — 판정은 계약이 한다(`capabilityOf`).
+     *
+     * 상속을 타고 닫은 등급 전부의 요구를 모은다: 상위 등급이 요구하는 시험도 자격의 조건이다.
+     */
+    private requiredTestsOf;
     private claimPersonnel;
     /**
      * 필요 설비를 고른다 — **인원·자산과 같은 규칙**(등급으로 요구, 부분 확보 없이 전량 아니면 대기).

package/dist/flow-engine.js

@@ -9,7 +9,7 @@
  * 통합 타입은 도메인 필드를 옵셔널로 넓혀(FlowItem.gtin?, FlowOrder.shipmentEpc? 등) 두 도메인을 담는다.
  * (roadmap Phase5 발견 → 추출. [[project_flow_single_base_vision]] FlowLocation 단일 base 방향과 정합.)
  */
-import { OP_EVENT, CMD, locationStatusOf, readBoardEquipment, readBoardLocations, readBoardAssets, classClosure, priorityRank, dueStatusOf, effectivityAt, offCalendarAt, offCalendarReasonAt, minuteOfDayAt, activeShiftAt, subLotIdOf, itemKeyOf } from "./contract.js";
+import { OP_EVENT, CMD, locationStatusOf, readBoardEquipment, readBoardLocations, readBoardAssets, classClosure, capabilityOf, priorityRank, dueStatusOf, effectivityAt, offCalendarAt, offCalendarReasonAt, minuteOfDayAt, activeShiftAt, subLotIdOf, itemKeyOf } from "./contract.js";
 import { ObservedReducer } from "./observed-reducer.js";
 import { transformationEvent, aggregationEvent, objectEvent, parseEpc, DISP, ILMD_ATTR, CBV_BIZSTEP } from "./epcis.js";
 import { parseIsoDuration } from "./iso-duration.js";
@@ -284,10 +284,12 @@ export class FlowEngine {
         return { id: n.id, type: n.type, capacity: n.capacity, parallelism: n.parallelism, occupancy: 0, status: 'idle', parentId: n.parentId };
     }
     buildPerson(p) {
-        return { id: p.id, personnelClassIds: p.personnelClassIds, status: 'idle', taskId: null, window: p.window, ...(p.workCalendar ? { workCalendar: p.workCalendar } : {}), ...(p.homeLocation ? { location: p.homeLocation } : {}), ...(p.properties ? { properties: p.properties } : {}), ...(p.testSpecificationIds ? { testSpecificationIds: p.testSpecificationIds } : {}), ...effectiveOnly(p) };
+        return { id: p.id, personnelClassIds: p.personnelClassIds, status: 'idle', taskId: null, window: p.window, ...(p.workCalendar ? { workCalendar: p.workCalendar } : {}), ...(p.homeLocation ? { location: p.homeLocation } : {}), ...(p.properties ? { properties: p.properties } : {}),
+            ...(p.testResults ? { testResults: p.testResults } : {}), ...(p.testSpecificationIds ? { testSpecificationIds: p.testSpecificationIds } : {}), ...(p.testResults ? { testResults: p.testResults } : {}), ...effectiveOnly(p) };
     }
     buildAsset(a) {
-        return { id: a.id, assetClassIds: a.assetClassIds, location: a.homeLocation, status: 'idle', taskId: null, ...(a.properties ? { properties: a.properties } : {}), ...(a.testSpecificationIds ? { testSpecificationIds: a.testSpecificationIds } : {}), ...effectiveOnly(a) };
+        return { id: a.id, assetClassIds: a.assetClassIds, location: a.homeLocation, status: 'idle', taskId: null, ...(a.properties ? { properties: a.properties } : {}),
+            ...(a.testResults ? { testResults: a.testResults } : {}), ...(a.testSpecificationIds ? { testSpecificationIds: a.testSpecificationIds } : {}), ...(a.testResults ? { testResults: a.testResults } : {}), ...effectiveOnly(a) };
     }
     /**
      * 이 커널이 **관측으로 구동된다**고 선언한다 — 미러가 첫 이벤트를 받기 전에도 그렇다.
@@ -1843,6 +1845,31 @@ export class FlowEngine {
             });
         }
     }
+    /**
+     * 이 사람이 **속한 등급들이 요구하는 시험**을 만족하나.
+     *
+     * 요구는 등급이 말하고(`ResourceClassDef.testSpecificationIds`) 기록은 사람이 든다. 상속을 타고 닫은
+     * 등급 전부의 요구를 모아 본다 — 상위 등급이 요구하는 시험도 자격의 조건이다.
+     *
+     * 판정 규칙은 계약이 소유한다(`meetsTests`) — 여기서 다시 적으면 규칙이 두 곳이 되고, 한쪽이 만료를
+     * 조용히 통과시킨다.
+     */
+    /**
+     * 이 사람이 속한 등급들이 **요구하는 시험 목록** — 판정은 계약이 한다(`capabilityOf`).
+     *
+     * 상속을 타고 닫은 등급 전부의 요구를 모은다: 상위 등급이 요구하는 시험도 자격의 조건이다.
+     */
+    requiredTestsOf(p) {
+        const defs = this.classDefs.personnel;
+        if (!defs?.length)
+            return [];
+        const closure = classClosure(p.personnelClassIds, defs, this.now());
+        const required = [];
+        for (const d of defs)
+            if (closure.has(d.id))
+                required.push(...(d.testSpecificationIds ?? []));
+        return required;
+    }
     claimPersonnel(t) {
         const need = this.operationSpecs.get(t.kind)?.personnelSpecification;
         if (!need?.length)
@@ -1852,13 +1879,21 @@ export class FlowEngine {
             const want = Math.max(0, Math.floor(req.quantity ?? 0));
             if (!want)
                 continue;
-            const avail = [...this.persons.values()].filter(p => p.status === 'idle' &&
-                !picked.includes(p.id) &&
-                !this.personOffShift(p) &&
-                !this.outOfEffect(p) && // 입사 전·퇴사 후는 이 시각의 모델에 없다
+            const avail = [...this.persons.values()].filter(p => !picked.includes(p.id) &&
+                /*
+                 * **판정은 한 벌이다**(`capabilityOf`). 예전에는 이 자리에 조건을 늘어놓았고 화면은 같은
+                 * 판정을 자기 코드로 다시 만들었다 — 규칙이 두 벌이면 갈라지고, 배정은 막는데 화면은
+                 * "가용" 이라 말하는 순간이 온다(그 어긋남은 조용하다).
+                 *
+                 * 요구된 시험은 등급에서 모아 넘긴다 — 등급 정의를 아는 것은 이쪽이다.
+                 */
+                capabilityOf(p, {
+                    at: this.now(),
+                    utcOffsetMinutes: this.boardDef?.utcOffsetMinutes,
+                    requiredTests: this.requiredTestsOf(p)
+                }).available &&
                 /* 자격은 **상속을 타고 닫아** 판정한다 — 사람은 여러 등급에 속할 수 있고(표준), 등급은
-                   다른 등급을 상속한다. "생산직 2명" 요구를 "용접 자격자" 가 만족해야 한다.
-                   유효기간 밖의 등급은 닫힘에서 빠진다(만료된 자격으로 배정되지 않는다). */
+                   다른 등급을 상속한다. "생산직 2명" 요구를 "용접 자격자" 가 만족해야 한다. */
                 (req.personnelClass === undefined ||
                     classClosure(p.personnelClassIds, this.classDefs.personnel, this.now()).has(req.personnelClass)));
             if (avail.length < want)

package/dist-cjs/index.cjs

@@ -73,6 +73,7 @@ __export(index_exports, {
   axisInfo: () => axisInfo,
   axisSource: () => axisSource,
   capabilitiesForType: () => capabilitiesForType,
+  capabilityOf: () => capabilityOf,
   classClosure: () => classClosure,
   compareStates: () => compareStates,
   computeOee: () => computeOee,
@@ -99,6 +100,7 @@ __export(index_exports, {
   lgtinClass: () => lgtinClass,
   locationStatusOf: () => locationStatusOf,
   mapRecord: () => mapRecord,
+  meetsTests: () => meetsTests,
   minuteOfDayAt: () => minuteOfDayAt,
   monteCarloForecast: () => monteCarloForecast,
   objectEvent: () => objectEvent,
@@ -123,6 +125,7 @@ __export(index_exports, {
   ssccUri: () => ssccUri,
   stateFieldsOf: () => stateFieldsOf,
   subLotIdOf: () => subLotIdOf,
+  testPassedAt: () => testPassedAt,
   transactionEvent: () => transactionEvent,
   transformationEvent: () => transformationEvent,
   validateDomainDefinition: () => validateDomainDefinition,
@@ -218,6 +221,21 @@ function hierarchyOf(s) {
     }
   };
 }
+function testPassedAt(r, at) {
+  if (r.result !== "pass") return false;
+  if (!r.expiresAt || !at) return r.result === "pass";
+  return Date.parse(at) <= Date.parse(r.expiresAt);
+}
+function meetsTests(required, results, at) {
+  if (!required.length) return true;
+  const bySpec = new Map((results ?? []).map((r) => [r.specId, r]));
+  for (const specId of required) {
+    const r = bySpec.get(specId);
+    if (!r) continue;
+    if (!testPassedAt(r, at)) return false;
+  }
+  return true;
+}
 function effectivityAt(p, at) {
   if (!p || !at) return void 0;
   const atMs = Date.parse(at);
@@ -392,6 +410,26 @@ function offCalendarAt(r, ms2, utcOffsetMinutes) {
   const h = Math.floor(minute / 60);
   return !(w.startHour <= w.endHour ? h >= w.startHour && h < w.endHour : h >= w.startHour || h < w.endHour);
 }
+function capabilityOf(r, ctx) {
+  const at = ctx?.at;
+  const eff = effectivityAt(r, at);
+  if (eff === "not-yet") return { available: false, reason: "not-yet" };
+  if (eff === "expired") return { available: false, reason: "retired" };
+  if (r.held) return { available: false, reason: "held" };
+  if (r.status === "down") return { available: false, reason: "down" };
+  if (at) {
+    const ms2 = Date.parse(at);
+    if (Number.isFinite(ms2)) {
+      const why = offCalendarReasonAt(r, ms2, ctx?.utcOffsetMinutes);
+      if (why === "non-working") return { available: false, reason: "resting" };
+      if (why === "off-hours") return { available: false, reason: "off-shift" };
+    }
+  }
+  if (ctx?.requiredTests?.length && !meetsTests(ctx.requiredTests, r.testResults, at))
+    return { available: false, reason: "test-expired" };
+  if (r.status && r.status !== "idle" && r.status !== "available") return { available: false, reason: "working" };
+  return { available: true, reason: "available" };
+}
 var OP_EVENT = {
   task: "task.status",
   equipment: "equipment.status",
@@ -2394,10 +2432,34 @@ var FlowEngine = class {
     return { id: n.id, type: n.type, capacity: n.capacity, parallelism: n.parallelism, occupancy: 0, status: "idle", parentId: n.parentId };
   }
   buildPerson(p) {
-    return { id: p.id, personnelClassIds: p.personnelClassIds, status: "idle", taskId: null, window: p.window, ...p.workCalendar ? { workCalendar: p.workCalendar } : {}, ...p.homeLocation ? { location: p.homeLocation } : {}, ...p.properties ? { properties: p.properties } : {}, ...p.testSpecificationIds ? { testSpecificationIds: p.testSpecificationIds } : {}, ...effectiveOnly(p) };
+    return {
+      id: p.id,
+      personnelClassIds: p.personnelClassIds,
+      status: "idle",
+      taskId: null,
+      window: p.window,
+      ...p.workCalendar ? { workCalendar: p.workCalendar } : {},
+      ...p.homeLocation ? { location: p.homeLocation } : {},
+      ...p.properties ? { properties: p.properties } : {},
+      ...p.testResults ? { testResults: p.testResults } : {},
+      ...p.testSpecificationIds ? { testSpecificationIds: p.testSpecificationIds } : {},
+      ...p.testResults ? { testResults: p.testResults } : {},
+      ...effectiveOnly(p)
+    };
   }
   buildAsset(a) {
-    return { id: a.id, assetClassIds: a.assetClassIds, location: a.homeLocation, status: "idle", taskId: null, ...a.properties ? { properties: a.properties } : {}, ...a.testSpecificationIds ? { testSpecificationIds: a.testSpecificationIds } : {}, ...effectiveOnly(a) };
+    return {
+      id: a.id,
+      assetClassIds: a.assetClassIds,
+      location: a.homeLocation,
+      status: "idle",
+      taskId: null,
+      ...a.properties ? { properties: a.properties } : {},
+      ...a.testResults ? { testResults: a.testResults } : {},
+      ...a.testSpecificationIds ? { testSpecificationIds: a.testSpecificationIds } : {},
+      ...a.testResults ? { testResults: a.testResults } : {},
+      ...effectiveOnly(a)
+    };
   }
   /**
    * 이 커널이 **관측으로 구동된다**고 선언한다 — 미러가 첫 이벤트를 받기 전에도 그렇다.
@@ -3799,6 +3861,28 @@ var FlowEngine = class {
       });
     }
   }
+  /**
+   * 이 사람이 **속한 등급들이 요구하는 시험**을 만족하나.
+   *
+   * 요구는 등급이 말하고(`ResourceClassDef.testSpecificationIds`) 기록은 사람이 든다. 상속을 타고 닫은
+   * 등급 전부의 요구를 모아 본다 — 상위 등급이 요구하는 시험도 자격의 조건이다.
+   *
+   * 판정 규칙은 계약이 소유한다(`meetsTests`) — 여기서 다시 적으면 규칙이 두 곳이 되고, 한쪽이 만료를
+   * 조용히 통과시킨다.
+   */
+  /**
+   * 이 사람이 속한 등급들이 **요구하는 시험 목록** — 판정은 계약이 한다(`capabilityOf`).
+   *
+   * 상속을 타고 닫은 등급 전부의 요구를 모은다: 상위 등급이 요구하는 시험도 자격의 조건이다.
+   */
+  requiredTestsOf(p) {
+    const defs = this.classDefs.personnel;
+    if (!defs?.length) return [];
+    const closure = classClosure(p.personnelClassIds, defs, this.now());
+    const required = [];
+    for (const d of defs) if (closure.has(d.id)) required.push(...d.testSpecificationIds ?? []);
+    return required;
+  }
   claimPersonnel(t) {
     const need = this.operationSpecs.get(t.kind)?.personnelSpecification;
     if (!need?.length) return [];
@@ -3807,10 +3891,19 @@ var FlowEngine = class {
       const want = Math.max(0, Math.floor(req.quantity ?? 0));
       if (!want) continue;
       const avail = [...this.persons.values()].filter(
-        (p) => p.status === "idle" && !picked.includes(p.id) && !this.personOffShift(p) && !this.outOfEffect(p) && // 입사 전·퇴사 후는 이 시각의 모델에 없다
-        /* 자격은 **상속을 타고 닫아** 판정한다 — 사람은 여러 등급에 속할 수 있고(표준), 등급은
-           다른 등급을 상속한다. "생산직 2명" 요구를 "용접 자격자" 가 만족해야 한다.
-           유효기간 밖의 등급은 닫힘에서 빠진다(만료된 자격으로 배정되지 않는다). */
+        (p) => !picked.includes(p.id) && /*
+         * **판정은 한 벌이다**(`capabilityOf`). 예전에는 이 자리에 조건을 늘어놓았고 화면은 같은
+         * 판정을 자기 코드로 다시 만들었다 — 규칙이 두 벌이면 갈라지고, 배정은 막는데 화면은
+         * "가용" 이라 말하는 순간이 온다(그 어긋남은 조용하다).
+         *
+         * 요구된 시험은 등급에서 모아 넘긴다 — 등급 정의를 아는 것은 이쪽이다.
+         */
+        capabilityOf(p, {
+          at: this.now(),
+          utcOffsetMinutes: this.boardDef?.utcOffsetMinutes,
+          requiredTests: this.requiredTestsOf(p)
+        }).available && /* 자격은 **상속을 타고 닫아** 판정한다 — 사람은 여러 등급에 속할 수 있고(표준), 등급은
+           다른 등급을 상속한다. "생산직 2명" 요구를 "용접 자격자" 가 만족해야 한다. */
         (req.personnelClass === void 0 || classClosure(p.personnelClassIds, this.classDefs.personnel, this.now()).has(req.personnelClass))
       );
       if (avail.length < want) return null;
@@ -5093,6 +5186,7 @@ function retiredVocabularyIn(line) {
   axisInfo,
   axisSource,
   capabilitiesForType,
+  capabilityOf,
   classClosure,
   compareStates,
   computeOee,
@@ -5119,6 +5213,7 @@ function retiredVocabularyIn(line) {
   lgtinClass,
   locationStatusOf,
   mapRecord,
+  meetsTests,
   minuteOfDayAt,
   monteCarloForecast,
   objectEvent,
@@ -5143,6 +5238,7 @@ function retiredVocabularyIn(line) {
   ssccUri,
   stateFieldsOf,
   subLotIdOf,
+  testPassedAt,
   transactionEvent,
   transformationEvent,
   validateDomainDefinition,

package/package.json

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