@hile/core 1.0.20 → 1.0.21

package/README.md

@@ -94,7 +94,7 @@ export const userService = defineService(async (shutdown) => {
 
 ### 5) 资源销毁（Shutdown）
 
-当服务初始化失败或手动执行全局关闭时，容器会按规则执行已注册的清理回调。
+当服务初始化失败或手动执行全局关闭时，容器会按规则执行已注册的清理回调。`container.shutdown()` 会循环处理队列直到清空，并让出一次事件循环（`setImmediate`），确保在 shutdown 进行中才完成启动并注册的 teardown 也会被执行。
 
 ```typescript
 export const connectionService = defineService(async (shutdown) => {
@@ -168,11 +168,13 @@ const startupOrder = container.getStartupOrder()
 import container from '@hile/core'
 
 process.on('SIGTERM', async () => {
-  await container.shutdown()
+  await container.shutdown()  // 执行所有已注册的 teardown，含晚注册的
   process.exit(0)
 })
 ```
 
+保证：每个在 defineService 中通过 `shutdown(fn)` 注册的回调都会在 `shutdown()` 时被执行；若某服务在 shutdown 期间才完成启动并调用 `shutdown(fn)`，也会在下一轮事件循环中被关掉。
+
 ### 9) 服务校验（isService）
 
 ```typescript

package/SKILL.md

@@ -16,6 +16,7 @@ description: "@hile/core 的代码生成与使用规范。适用于定义/加载
 5. 禁止在模块顶层缓存 `await loadService(...)` 结果。
 6. 依赖服务必须在服务函数内部加载。
 7. 多个 teardown 默认按 LIFO 顺序执行。
+8. `container.shutdown()` 必须执行所有已通过 `shutdown(fn)` 注册的回调；在 shutdown 进行中才完成启动并调用 `curDown` 的服务，也会在让出一次事件循环后被关掉（避免竞态漏关）。
 
 ## 2. 生命周期与超时约束
 
@@ -110,3 +111,4 @@ export const good = defineService(async (shutdown) => {
 - [ ] teardown 抛错是否不覆盖原始业务错误
 - [ ] 并发 resolve 同一服务是否只初始化一次
 - [ ] shutdown 重复调用是否幂等
+- [ ] shutdown 期间才注册的 teardown 是否在一次 setImmediate 让出后被正确执行

package/dist/index.js

@@ -238,9 +238,15 @@ export class Container {
     async shutdown() {
         const startedAt = Date.now();
         this.emit({ type: 'container:shutdown:start' });
-        let i = this.shutdownQueues.length;
-        while (i--) {
-            await this.shutdownService(this.shutdownQueues[i]);
+        // 循环直到队列清空；再让出一次事件循环，处理「shutdown 期间才调用 curDown」的晚注册 teardown
+        while (true) {
+            while (this.shutdownQueues.length > 0) {
+                const id = this.shutdownQueues[this.shutdownQueues.length - 1];
+                await this.shutdownService(id);
+            }
+            await new Promise(r => setImmediate(r));
+            if (this.shutdownQueues.length === 0)
+                break;
         }
         this.shutdownFunctions.clear();
         this.shutdownQueues.length = 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hile/core",
-  "version": "1.0.20",
+  "version": "1.0.21",
   "description": "Hile core - lightweight async service container",
   "type": "module",
   "main": "./dist/index.js",
@@ -24,5 +24,5 @@
     "fix-esm-import-path": "^1.10.3",
     "vitest": "^4.0.18"
   },
-  "gitHead": "07067534cbd2e1c4011c72f74d16d18506081aac"
+  "gitHead": "f5d59f9f131456cf14e5ca62eeea6becde84ebef"
 }