ReckfellThread

public ReckfellThread();

Создаёт незапущенный поток движка. Это не System.Threading.Thread и не Task. Удерживайте объект и цель Callable до завершения; после успешного Start обязательно выполните WaitToFinish до Dispose/повторного запуска. Уничтожение wrapper не является отменой задачи.

public string GetId();

Возвращает строку ID, назначенного движком этому запуску. До Start и после WaitToFinish — "0". После завершения callback до join ID остаётся назначенным. Не равен гарантированно OS thread ID или ManagedThreadId; не используйте как постоянный ключ между запусками.

public bool IsAlive();

Показывает, что callback ещё выполняется, включая блокировку на Semaphore/Mutex. False не означает, что поток уже собран: после выполнения всё ещё нужен WaitToFinish. Это не проверка успешности результата и не отмена.

public static bool IsMainThread();

Проверяет вызывающий поток, а не состояние конкретного экземпляра. True на главном потоке движка, false в проверенном worker. Не делает доступ к любому Resource/Entity автоматически безопасным.

public bool IsStarted();

True после успешного Start до WaitToFinish, даже если callback уже вернул результат. Не синоним IsAlive. До join повторный Start отклоняется; завершённый, но несобранный поток всё ещё требует cleanup.

public static void SetThreadSafetyChecksEnabled(bool enabled);

Меняет проверки доступа для текущего worker-потока; вызов на главном потоке запрещён. enabled=false не добавляет блокировки и не делает активное дерево/ресурсы потокобезопасными. Не используйте для сокрытия race condition. В QA из worker проверен только true; отключение и ошибочный main-thread вызов не исполнялись.

public Error Start(Callable callable, ReckfellThread.Priority priority = ReckfellThread.Priority.Normal);

Запускает Callable без передаваемых аргументов; результат затем читается через WaitToFinish. Error.Ok означает принятие запуска, не успешное окончание работы. Поток нельзя запустить повторно до join; недействительный Callable/priority дают InvalidParameter. Цель Callable должна оставаться живой. Приоритет — запрос планировщику, не гарантия времени выполнения. Контракт переноса исключений/отмены как у Task отсутствует; для остановки реализуйте свой согласованный флаг и пробуждение ожидающего worker.

public Variant WaitToFinish();

Блокирует вызывающий поток до завершения callback, возвращает его Variant и собирает native-поток. После этого IsStarted=false и разрешён новый Start. Не вызывайте из самого worker, до Start или удерживая mutex, нужный worker: это ошибка/взаимная блокировка. Сначала обеспечьте выход worker из ожидания. False от IsAlive не отменяет необходимость join. Сам callback может зависеть от главного потока — не блокируйте его без проверки этой зависимости.