@gravito/launchpad 1.2.0 → 1.2.1

package/.turbo/turbo-build.log

@@ -0,0 +1,18 @@
+
+$ tsup src/index.ts --format cjs,esm --dts
+CLI Building entry: src/index.ts
+CLI Using tsconfig: tsconfig.json
+CLI tsup v8.5.1
+CLI Target: esnext
+CJS Build start
+ESM Build start
+CJS You have emitDecoratorMetadata enabled but @swc/core was not installed, skipping swc plugin
+ESM You have emitDecoratorMetadata enabled but @swc/core was not installed, skipping swc plugin
+CJS dist/index.js 27.01 KB
+CJS ⚡️ Build success in 24ms
+ESM dist/index.mjs 25.50 KB
+ESM ⚡️ Build success in 24ms
+DTS Build start
+DTS ⚡️ Build success in 1979ms
+DTS dist/index.d.ts  5.14 KB
+DTS dist/index.d.mts 5.14 KB

package/.turbo/turbo-test$colon$coverage.log

@@ -0,0 +1,183 @@
+$ bun test --coverage --coverage-threshold=80
+bun test v1.3.4 (5eb2145b)
+
+tests/mission.test.ts:
+(pass) Mission > exposes mission properties [0.31ms]
+
+tests/Telemetry.test.ts:
+[MissionControl] 準備發射任務: pr-1
+[MissionControl] 任務 pr-1 映射端口: 3000
+(pass) MissionControl Telemetry > 發射時應該能正確啟動日誌串流與效能監控 [6.79ms]
+
+tests/mission-control.test.ts:
+[MissionControl] 準備發射任務: mission-telemetry
+[MissionControl] 任務 mission-telemetry 映射端口: 3000
+[MissionControl] 任務 mission-telemetry TTL 已到期，執行自動回收...
+(pass) MissionControl timers > emits stats and schedules recycle [2.17ms]
+
+tests/pool-manager.test.ts:
+[LaunchPad] 正在熱機，準備發射 2 架新火箭...
+(pass) PoolManager > warms up the pool with base containers [1.23ms]
+[LaunchPad] 正在熱機，準備發射 1 架新火箭...
+[LaunchPad] 資源吃緊，正在緊急呼叫後援火箭...
+(pass) PoolManager > assigns missions to idle rockets or creates new ones [1.90ms]
+[LaunchPad] 正在熱機，準備發射 1 架新火箭...
+(pass) PoolManager > recycles rockets through refurbish flow [2.99ms]
+
+tests/enterprise-coverage.test.ts:
+(pass) Launchpad enterprise coverage > covers core enterprise primitives [0.56ms]
+
+tests/repository.test.ts:
+(pass) InMemoryRocketRepository > stores and retrieves rockets [0.75ms]
+(pass) InMemoryRocketRepository > finds idle rockets [0.19ms]
+
+tests/Rocket.test.ts:
+(pass) Rocket > transitions through mission lifecycle and emits events [0.17ms]
+(pass) Rocket > guards invalid transitions [0.19ms]
+(pass) Rocket > assigns domain and serializes/deserializes [0.15ms]
+(pass) Rocket > rejects assigning mission when not idle [0.06ms]
+
+tests/Refurbishment.test.ts:
+(pass) RefurbishUnit (Rocket Recovery) > 應該能執行深度清理並將火箭重置為 IDLE [1.11ms]
+[RefurbishUnit] 正在翻新火箭: r1 (容器: c1)
+[RefurbishUnit] 火箭 r1 翻新完成，已進入 IDLE 狀態。
+[RefurbishUnit] 正在翻新火箭: r2 (容器: c2)
+[RefurbishUnit] 清理失敗: Disk Full
+(pass) RefurbishUnit (Rocket Recovery) > 如果清理失敗應該將火箭除役 [0.28ms]
+
+tests/payload-injector.test.ts:
+(pass) PayloadInjector > throws when rocket has no mission [1.02ms]
+[PayloadInjector] 正在拉取代碼: https://example.com/repo.git (main)
+[PayloadInjector] 正在注入載荷至容器: container-10
+[PayloadInjector] 正在安裝依賴...
+[PayloadInjector] 點火！
+(pass) PayloadInjector > deploys payload and ignites rocket [0.78ms]
+[PayloadInjector] 正在拉取代碼: https://example.com/repo.git (main)
+[PayloadInjector] 正在注入載荷至容器: container-11
+[PayloadInjector] 正在安裝依賴...
+(pass) PayloadInjector > throws when install fails [4.37ms]
+[PayloadInjector] 正在拉取代碼: https://example.com/repo.git (main)
+[PayloadInjector] 正在注入載荷至容器: container-12
+[PayloadInjector] 正在安裝依賴...
+[PayloadInjector] 點火！
+(pass) PayloadInjector > logs when run command fails but still ignites [8.24ms]
+
+tests/docker-adapter.test.ts:
+(pass) DockerAdapter > creates base container when stdout has container id [8.90ms]
+(pass) DockerAdapter > returns container id even when exit code is zero but id is invalid [0.28ms]
+(pass) DockerAdapter > throws when container creation fails [0.70ms]
+(pass) DockerAdapter > getExposedPort parses the first line [1.64ms]
+(pass) DockerAdapter > getExposedPort throws on empty output [6.46ms]
+(pass) DockerAdapter > getExposedPort throws on invalid output [4.70ms]
+(pass) DockerAdapter > copyFiles throws on non-zero exit code [0.54ms]
+(pass) DockerAdapter > removeContainerByLabel removes containers when ids exist [0.72ms]
+(pass) DockerAdapter > executeCommand returns stdout and stderr [3.41ms]
+(pass) DockerAdapter > removeContainer executes docker rm [1.66ms]
+(pass) DockerAdapter > getStats parses cpu and memory output [0.39ms]
+(pass) DockerAdapter > streamLogs forwards stdout and stderr [43.53ms]
+
+tests/Integration.test.ts:
+[LaunchPad] 正在熱機，準備發射 1 架新火箭...
+[Test] 容器內 Bun 版本: 1.0.36
+(pass) LaunchPad 集成測試 (真實 Docker) > 應該能成功熱機並在容器內執行指令 [3201.00ms]
+
+tests/Deployment.test.ts:
+[LaunchPad] 資源吃緊，正在緊急呼叫後援火箭...
+[PayloadInjector] 正在拉取代碼: http://git (dev)
+[PayloadInjector] 正在注入載荷至容器: cid-1
+[PayloadInjector] 正在安裝依賴...
+[PayloadInjector] 點火！
+(pass) Payload Injection Flow > 應該能從指派任務到成功點火 [1.02ms]
+
+tests/PoolManager.test.ts:
+(pass) PoolManager (Application Service) > 應該能正確熱機並指派任務 [1.54ms]
+------------------------------------------------------------|---------|---------|-------------------
+File                                                        | % Funcs | % Lines | Uncovered Line #s
+[LaunchPad] 正在熱機，準備發射 2 架新火箭...
+------------------------------------------------------------|---------|---------|-------------------
+All files                                                   |   30.25 |   42.00 |
+ ../core/src/Application.ts                                 |    0.00 |    8.87 | 139-313,325-326,336-337,348,358,368,375,382
+ ../core/src/ConfigManager.ts                               |    0.00 |   14.04 | 16-22,29-34,42-75,82
+ ../core/src/Container.ts                                   |    0.00 |   28.95 | 26,34,41,48-67,74,81-82
+ ../core/src/ErrorHandler.ts                                |    0.00 |    3.45 | 23-41,49-75,101-297,304-325,332-357,365-381
+ ../core/src/Event.ts                                       |  100.00 |  100.00 | 
+ ../core/src/EventManager.ts                                |    0.00 |    7.01 | 78,85,108-126,136-243,250-256,263-271
+ ../core/src/GlobalErrorHandlers.ts                         |    0.00 |    1.19 | 58-72,78-88,92-101,106-186,191-210,214-228,239-252
+ ../core/src/GravitoServer.ts                               |    0.00 |    8.77 | 25-76
+ ../core/src/HookManager.ts                                 |    0.00 |    8.33 | 37-73,93-121
+ ../core/src/Logger.ts                                      |    0.00 |   55.56 | 17,21,25
+ ../core/src/PlanetCore.ts                                  |    0.00 |   10.53 | 117-131,162-208,218-227,237-269,273-390,394-443,453-468,485-501
+ ../core/src/Route.ts                                       |    0.00 |   44.44 | 18-22,28-29,44,55,66,77,88,92,96
+ ../core/src/Router.ts                                      |    0.00 |    7.68 | 68-121,131-154,182-184,190-193,201-205,212,224-232,243-251,262-270,281-289,300-308,312-354,365-380,414-459,466-471,478-505,512,522-524,531,538-553,557-600,607,614,622,636-644,658-666,680-688,702-710,724-732,743-758,765-803,810-892,899-913
+ ../core/src/ServiceProvider.ts                             |    0.00 |   15.07 | 58,91,114-150,179-188,198-209
+ ../core/src/adapters/GravitoEngineAdapter.ts               |    0.00 |   30.43 | 27-31,35-44,48-50,54,58,62-65,69,73,78-81,85-86
+ ../core/src/adapters/PhotonAdapter.ts                      |    0.00 |   13.93 | 46,53-55,62-108,112,116,120,124,130-163,167-168,191-195,203-207,214-257,261-262,266-269,273-276,280-283,287-298,302-309,313-318,322,326,330,334,341-355,359,363,367-446,462-467,471-473,487-492,501-512,521-528,564-584,592,596-612,616-626,630-635,639,643-651,656,660-675,683-695,708-710
+ ../core/src/adapters/bun/BunContext.ts                     |    0.00 |   12.58 | 38-44,52-75,80-86,90-96,100-106,110-116,120-125,129-134,138,142,146,150-182,189-205,209,214,218-223
+ ../core/src/adapters/bun/BunNativeAdapter.ts               |    0.00 |   10.23 | 21-23,32-36,40-46,50,54,58-87,91,95,99-207
+ ../core/src/adapters/bun/BunRequest.ts                     |    0.00 |   10.62 | 13-17,22-34,39,43,47-55,59-62,68-108,114,118-131,135-146
+ ../core/src/adapters/bun/RadixNode.ts                      |    0.00 |   17.65 | 39-40,44-52,56-72
+ ../core/src/adapters/bun/RadixRouter.ts                    |    0.00 |    8.13 | 17,24-62,69-84,88-148,152-162,169-175,182-193
+ ../core/src/adapters/bun/types.ts                          |  100.00 |  100.00 | 
+ ../core/src/adapters/types.ts                              |    0.00 |    0.00 | 280-287
+ ../core/src/engine/AOTRouter.ts                            |    0.00 |   10.78 | 67-85,93-133,144-145,157-159,172-208,215,228-272,279,294-306,320-327,334-345
+ ../core/src/engine/FastContext.ts                          |    0.00 |   19.09 | 30,37-45,52-61,65-84,88-89,93-94,98-101,105-109,113-129,133-134,138-169,192-198,208-212,219-223,231-236,240-245,249-254,258-263,267-271,275-280,284,288,292,296-319,329-334,338,349,353,361-363
+ ../core/src/engine/Gravito.ts                              |    0.00 |   14.67 | 38-52,82-103,118,125,132,139,146,153,160,167-171,184-197,208-214,225-226,233-255,293-322,330-367,374-391,398-410,417-421,428-456,463-519
+ ../core/src/engine/MinimalContext.ts                       |    0.00 |   21.57 | 23-37,41,45,52-64,68,72-84,88,92-112,130,139-142,146-149,153-156,160-163,167-170,174-177,183-187,195-198,202,206,210,214-225,229,235-237
+ ../core/src/engine/analyzer.ts                             |    0.00 |    2.08 | 25-49,56-77
+ ../core/src/engine/constants.ts                            |  100.00 |  100.00 | 
+ ../core/src/engine/index.ts                                |  100.00 |  100.00 | 
+ ../core/src/engine/path.ts                                 |    0.00 |    2.63 | 22-43,51-65
+ ../core/src/engine/pool.ts                                 |    0.00 |   16.67 | 44-46,58-64,76-79,89-103,114-119
+ ../core/src/exceptions/AuthenticationException.ts          |    0.00 |   42.86 | 8-11
+ ../core/src/exceptions/AuthorizationException.ts           |    0.00 |   42.86 | 8-11
+ ../core/src/exceptions/GravitoException.ts                 |    0.00 |   19.05 | 24-34,39-44
+ ../core/src/exceptions/HttpException.ts                    |    0.00 |   60.00 | 9-10
+ ../core/src/exceptions/ModelNotFoundException.ts           |    0.00 |   25.00 | 11-19
+ ../core/src/exceptions/ValidationException.ts              |    0.00 |   35.71 | 22-26,30-31,35-36
+ ../core/src/exceptions/index.ts                            |  100.00 |  100.00 | 
+ ../core/src/helpers.ts                                     |    0.00 |   23.14 | 19,54-59,81-82,107-108,133-139,143-147,176-196,218,222-228,248-253,272-277,306-308,323,335,356-359,381-384,403,417,438-441,461-463,483-489
+ ../core/src/helpers/Arr.ts                                 |    0.00 |   14.58 | 9-13,17,21,25-28,32-41,45-54,58-64,68-75,79-92,96-109,113-120
+ ../core/src/helpers/Str.ts                                 |    0.00 |   18.56 | 5-10,14-17,27,31,35-41,45-51,55-61,65-66,70-71,75-77,81-89,93-95,99-105,109-117,121-124,128-134
+ ../core/src/helpers/data.ts                                |    0.00 |    2.17 | 13-30,34-47,51-64,68-88,96-113,121-134,142-177
+ ../core/src/helpers/errors.ts                              |    0.00 |    7.69 | 26-43,51-53,61-63
+ ../core/src/helpers/response.ts                            |    0.00 |   12.50 | 29,37-44,52-56,64-70
+ ../core/src/http/CookieJar.ts                              |    0.00 |   12.33 | 33-46,53-74,81,88,95-117,124-126
+ ../core/src/http/middleware/BodySizeLimit.ts               |    0.00 |    2.70 | 20-55
+ ../core/src/http/middleware/Cors.ts                        |    0.00 |    1.64 | 23-35,43-89
+ ../core/src/http/middleware/Csrf.ts                        |    0.00 |    5.05 | 19-24,28-34,38,42-67,75-91,99-135
+ ../core/src/http/middleware/HeaderTokenGate.ts             |    0.00 |    4.55 | 25-35,45-54
+ ../core/src/http/middleware/SecurityHeaders.ts             |    0.00 |    1.67 | 28,32-35,39-46,54-99
+ ../core/src/http/middleware/ThrottleRequests.ts            |    0.00 |    8.51 | 31-73
+ ../core/src/index.ts                                       |    0.00 |   96.97 | 
+ ../core/src/runtime.ts                                     |   21.05 |   11.87 | 118-131,138-145,149-166,175,188-190,193-216,221-225,230-325,330-420,425-448,467-470,481-518,526-533
+ ../core/src/security/Encrypter.ts                          |    0.00 |   13.70 | 21-35,42-59,66-82,86-88,92-97,102-103,110-111
+ ../core/src/security/Hasher.ts                             |    0.00 |    9.09 | 25-43
+ ../core/src/testing/HttpTester.ts                          |    0.00 |    4.27 | 11-121
+ ../core/src/testing/TestResponse.ts                        |    0.00 |   10.92 | 16-17,24,31,38,45,52,59-124,131-132,139-169
+ ../core/src/testing/index.ts                               |  100.00 |  100.00 | 
+ ../core/src/types/events.ts                                |    0.00 |   14.29 | 91-93,101-104,111-125,132-139
+ ../enterprise/src/Application/Command.ts                   |  100.00 |  100.00 | 
+ ../enterprise/src/Application/Query.ts                     |  100.00 |  100.00 | 
+ ../enterprise/src/Application/UseCase.ts                   |  100.00 |  100.00 | 
+ ../enterprise/src/Domain/AggregateRoot.ts                  |   50.00 |   55.56 | 1-8
+ ../enterprise/src/Domain/DomainEvent.ts                    |   50.00 |   55.56 | 16-19
+ ../enterprise/src/Domain/Entity.ts                         |  100.00 |  100.00 | 
+ ../enterprise/src/Domain/Repository.ts                     |  100.00 |  100.00 | 
+ ../enterprise/src/Domain/ValueObject.ts                    |  100.00 |  100.00 | 
+ ../enterprise/src/index.ts                                 |  100.00 |  100.00 | 
+ src/Application/MissionControl.ts                          |  100.00 |  100.00 | 
+ src/Application/PayloadInjector.ts                         |  100.00 |  100.00 | 
+ src/Application/PoolManager.ts                             |  100.00 |  100.00 | 
+ src/Application/RefurbishUnit.ts                           |  100.00 |  100.00 | 
+ src/Domain/Events.ts                                       |  100.00 |  100.00 | 
+ src/Domain/Mission.ts                                      |   83.33 |  100.00 | 
+ src/Domain/Rocket.ts                                       |  100.00 |  100.00 | 
+ src/Domain/RocketStatus.ts                                 |  100.00 |  100.00 | 
+ src/Infrastructure/Docker/DockerAdapter.ts                 |   94.44 |  100.00 | 
+ src/Infrastructure/Persistence/InMemoryRocketRepository.ts |   90.91 |  100.00 | 
+------------------------------------------------------------|---------|---------|-------------------
+
+ 34 pass
+ 0 fail
+ 99 expect() calls
+Ran 34 tests across 13 files. [4.34s]

package/.turbo/turbo-test.log

@@ -0,0 +1,100 @@
+
+$ bun test
+bun test v1.3.4 (5eb2145b)
+
+tests/mission.test.ts:
+✓ Mission > exposes mission properties [0.45ms]
+
+tests/Telemetry.test.ts:
+[MissionControl] 準備發射任務: pr-1
+[MissionControl] 任務 pr-1 映射端口: 3000
+✓ MissionControl Telemetry > 發射時應該能正確啟動日誌串流與效能監控 [1.84ms]
+
+tests/mission-control.test.ts:
+[MissionControl] 準備發射任務: mission-telemetry
+[MissionControl] 任務 mission-telemetry 映射端口: 3000
+[MissionControl] 任務 mission-telemetry TTL 已到期，執行自動回收...
+✓ MissionControl timers > emits stats and schedules recycle [0.92ms]
+
+tests/pool-manager.test.ts:
+[LaunchPad] 正在熱機，準備發射 2 架新火箭...
+✓ PoolManager > warms up the pool with base containers [0.62ms]
+[LaunchPad] 正在熱機，準備發射 1 架新火箭...
+[LaunchPad] 資源吃緊，正在緊急呼叫後援火箭...
+✓ PoolManager > assigns missions to idle rockets or creates new ones [1.08ms]
+[LaunchPad] 正在熱機，準備發射 1 架新火箭...
+✓ PoolManager > recycles rockets through refurbish flow [0.34ms]
+
+tests/enterprise-coverage.test.ts:
+✓ Launchpad enterprise coverage > covers core enterprise primitives [0.20ms]
+
+tests/repository.test.ts:
+✓ InMemoryRocketRepository > stores and retrieves rockets [0.11ms]
+✓ InMemoryRocketRepository > finds idle rockets [0.10ms]
+
+tests/Rocket.test.ts:
+✓ Rocket > transitions through mission lifecycle and emits events [0.25ms]
+✓ Rocket > guards invalid transitions [0.12ms]
+✓ Rocket > assigns domain and serializes/deserializes [0.04ms]
+✓ Rocket > rejects assigning mission when not idle [0.12ms]
+
+tests/Refurbishment.test.ts:
+[RefurbishUnit] 正在翻新火箭: r1 (容器: c1)
+[RefurbishUnit] 火箭 r1 翻新完成，已進入 IDLE 狀態。
+✓ RefurbishUnit (Rocket Recovery) > 應該能執行深度清理並將火箭重置為 IDLE [0.66ms]
+[RefurbishUnit] 正在翻新火箭: r2 (容器: c2)
+[RefurbishUnit] 清理失敗: Disk Full
+✓ RefurbishUnit (Rocket Recovery) > 如果清理失敗應該將火箭除役 [0.18ms]
+
+tests/payload-injector.test.ts:
+✓ PayloadInjector > throws when rocket has no mission [0.51ms]
+[PayloadInjector] 正在拉取代碼: https://example.com/repo.git (main)
+[PayloadInjector] 正在注入載荷至容器: container-10
+[PayloadInjector] 正在安裝依賴...
+[PayloadInjector] 點火！
+✓ PayloadInjector > deploys payload and ignites rocket [0.28ms]
+[PayloadInjector] 正在拉取代碼: https://example.com/repo.git (main)
+[PayloadInjector] 正在注入載荷至容器: container-11
+[PayloadInjector] 正在安裝依賴...
+✓ PayloadInjector > throws when install fails [0.14ms]
+[PayloadInjector] 正在拉取代碼: https://example.com/repo.git (main)
+[PayloadInjector] 正在注入載荷至容器: container-12
+[PayloadInjector] 正在安裝依賴...
+[PayloadInjector] 點火！
+✓ PayloadInjector > logs when run command fails but still ignites [1.62ms]
+
+tests/docker-adapter.test.ts:
+✓ DockerAdapter > creates base container when stdout has container id [9.55ms]
+✓ DockerAdapter > returns container id even when exit code is zero but id is invalid [0.19ms]
+✓ DockerAdapter > throws when container creation fails [0.09ms]
+✓ DockerAdapter > getExposedPort parses the first line [1.81ms]
+✓ DockerAdapter > getExposedPort throws on empty output [3.29ms]
+✓ DockerAdapter > getExposedPort throws on invalid output [1.47ms]
+✓ DockerAdapter > copyFiles throws on non-zero exit code [0.33ms]
+✓ DockerAdapter > removeContainerByLabel removes containers when ids exist [0.22ms]
+✓ DockerAdapter > executeCommand returns stdout and stderr [0.12ms]
+✓ DockerAdapter > removeContainer executes docker rm [0.09ms]
+✓ DockerAdapter > getStats parses cpu and memory output [0.13ms]
+✓ DockerAdapter > streamLogs forwards stdout and stderr [4.70ms]
+
+tests/Integration.test.ts:
+[LaunchPad] 正在熱機，準備發射 1 架新火箭...
+[Test] 容器內 Bun 版本: 1.0.36
+✓ LaunchPad 集成測試 (真實 Docker) > 應該能成功熱機並在容器內執行指令 [1171.83ms]
+
+tests/Deployment.test.ts:
+[LaunchPad] 資源吃緊，正在緊急呼叫後援火箭...
+[PayloadInjector] 正在拉取代碼: http://git (dev)
+[PayloadInjector] 正在注入載荷至容器: cid-1
+[PayloadInjector] 正在安裝依賴...
+[PayloadInjector] 點火！
+✓ Payload Injection Flow > 應該能從指派任務到成功點火 [0.29ms]
+
+tests/PoolManager.test.ts:
+[LaunchPad] 正在熱機，準備發射 2 架新火箭...
+✓ PoolManager (Application Service) > 應該能正確熱機並指派任務 [0.24ms]
+
+ 34 pass
+ 0 fail
+ 99 expect() calls
+Ran 34 tests across 13 files. [1499.00ms]

package/.turbo/turbo-typecheck.log

@@ -0,0 +1 @@
+$ bun tsc -p tsconfig.json --noEmit --skipLibCheck

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @gravito/launchpad
 
+## 1.2.1
+
+### Patch Changes
+
+- Updated dependencies
+  - @gravito/core@1.2.1
+  - @gravito/enterprise@1.0.3
+  - @gravito/ripple@3.0.1
+  - @gravito/stasis@3.0.1
+
 ## 1.2.0
 
 ### Minor Changes

package/debug-launch.ts

@@ -21,7 +21,10 @@ async function run() {
       console.log('🧹 Cleaning up old containers...')
       await runtime.spawn(['docker', 'rm', '-f', ...containers.trim().split('\n')]).exited
     }
-  } catch (_e) {}
+  } catch {
+    // Intentionally ignored: Container cleanup is best-effort.
+    // Failure could mean containers don't exist or Docker is unavailable, which is acceptable.
+  }
 
   // 2. Start Server
   const config = await bootstrapLaunchpad()

package/dist/index.js

@@ -648,10 +648,6 @@ var BunProxyAdapter = class {
 var LaunchpadServiceProvider = class extends import_core4.ServiceProvider {
   register(container) {
     if (!container.has("cache")) {
-      const cacheFromServices = this.core?.services?.get("cache");
-      if (cacheFromServices) {
-        container.instance("cache", cacheFromServices);
-      }
     }
     container.singleton("launchpad.docker", () => new DockerAdapter());
     container.singleton("launchpad.git", () => new ShellGitAdapter());

package/dist/index.mjs

@@ -616,10 +616,6 @@ var BunProxyAdapter = class {
 var LaunchpadServiceProvider = class extends ServiceProvider {
   register(container) {
     if (!container.has("cache")) {
-      const cacheFromServices = this.core?.services?.get("cache");
-      if (cacheFromServices) {
-        container.instance("cache", cacheFromServices);
-      }
     }
     container.singleton("launchpad.docker", () => new DockerAdapter());
     container.singleton("launchpad.git", () => new ShellGitAdapter());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gravito/launchpad",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "Container lifecycle management system for flash deployments",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/Application/MissionControl.ts

@@ -3,6 +3,15 @@ import type { Mission } from '../Domain/Mission'
 import type { PayloadInjector } from './PayloadInjector'
 import type { PoolManager } from './PoolManager'
 
+/**
+ * MissionControl orchestrates the high-level process of launching missions.
+ *
+ * it coordinates between the `PoolManager`, `PayloadInjector`, and `DockerAdapter`
+ * to deploy code into containers, assign domains, and monitor execution.
+ *
+ * @public
+ * @since 3.0.0
+ */
 export class MissionControl {
   constructor(
     private poolManager: PoolManager,

package/src/Application/PayloadInjector.ts

@@ -1,6 +1,15 @@
 import type { IDockerAdapter, IGitAdapter } from '../Domain/Interfaces'
 import type { Rocket } from '../Domain/Rocket'
 
+/**
+ * PayloadInjector is responsible for deploying application code into Rocket containers.
+ *
+ * It clones the repository, copies files into the container, installs
+ * dependencies (using Bun), and starts the application.
+ *
+ * @public
+ * @since 3.0.0
+ */
 export class PayloadInjector {
   constructor(
     private docker: IDockerAdapter,

package/src/Application/PoolManager.ts

@@ -3,6 +3,15 @@ import type { Mission } from '../Domain/Mission'
 import { Rocket } from '../Domain/Rocket'
 import type { RefurbishUnit } from './RefurbishUnit'
 
+/**
+ * PoolManager handles the lifecycle and pooling of Rocket containers.
+ *
+ * It manages a pool of pre-warmed containers to ensure fast deployment of
+ * new missions. It also handles rocket assignment and recycling (refurbishment).
+ *
+ * @public
+ * @since 3.0.0
+ */
 export class PoolManager {
   constructor(
     private dockerAdapter: IDockerAdapter,

package/src/Application/RefurbishUnit.ts

@@ -1,6 +1,16 @@
 import type { IDockerAdapter } from '../Domain/Interfaces'
 import type { Rocket } from '../Domain/Rocket'
 
+/**
+ * RefurbishUnit handles the cleaning and restoration of Rocket containers.
+ *
+ * After a mission is complete, this unit resets the container environment
+ * (clearing files, stopping processes) so the container can be returned
+ * to the idle pool for future reuse.
+ *
+ * @public
+ * @since 3.0.0
+ */
 export class RefurbishUnit {
   constructor(private docker: IDockerAdapter) {}
 

package/src/Domain/Events.ts

@@ -1,5 +1,11 @@
 import { DomainEvent } from '@gravito/enterprise'
 
+/**
+ * Event emitted when a mission is assigned to a rocket.
+ *
+ * @public
+ * @since 3.0.0
+ */
 export class MissionAssigned extends DomainEvent {
   constructor(
     public readonly rocketId: string,
@@ -9,18 +15,36 @@ export class MissionAssigned extends DomainEvent {
   }
 }
 
+/**
+ * Event emitted when a rocket starts its mission (application started).
+ *
+ * @public
+ * @since 3.0.0
+ */
 export class RocketIgnited extends DomainEvent {
   constructor(public readonly rocketId: string) {
     super()
   }
 }
 
+/**
+ * Event emitted when a rocket mission is completed or terminated.
+ *
+ * @public
+ * @since 3.0.0
+ */
 export class RocketSplashedDown extends DomainEvent {
   constructor(public readonly rocketId: string) {
     super()
   }
 }
 
+/**
+ * Event emitted when a rocket has finished the refurbishment process.
+ *
+ * @public
+ * @since 3.0.0
+ */
 export class RefurbishmentCompleted extends DomainEvent {
   constructor(public readonly rocketId: string) {
     super()

package/src/Domain/Mission.ts

@@ -7,6 +7,15 @@ interface MissionProps {
   commitSha: string // Commit Hash
 }
 
+/**
+ * Mission represents a deployment task for a specific code version.
+ *
+ * It is a Value Object containing information about the source repository,
+ * branch, and commit to be deployed.
+ *
+ * @public
+ * @since 3.0.0
+ */
 export class Mission extends ValueObject<MissionProps> {
   get id() {
     return this.props.id

package/src/Domain/Rocket.ts

@@ -8,6 +8,16 @@ import {
 import type { Mission } from './Mission'
 import { RocketStatus } from './RocketStatus'
 
+/**
+ * Rocket represents a managed application container within Launchpad.
+ *
+ * It acts as an Aggregate Root in the domain, maintaining its lifecycle state
+ * (IDLE, PREPARING, ORBITING, etc.) and emitting domain events when
+ * state transitions occur.
+ *
+ * @public
+ * @since 3.0.0
+ */
 export class Rocket extends AggregateRoot<string> {
   private _status: RocketStatus = RocketStatus.IDLE
   private _currentMission: Mission | null = null

package/src/Infrastructure/Docker/DockerAdapter.ts

@@ -1,6 +1,15 @@
 import { getRuntimeAdapter } from '@gravito/core'
 import type { IDockerAdapter } from '../../Domain/Interfaces'
 
+/**
+ * DockerAdapter implements the `IDockerAdapter` interface using the Docker CLI.
+ *
+ * It manages the lifecycle of Docker containers used as "Rockets" in Launchpad,
+ * including creation, command execution, file copying, and metrics collection.
+ *
+ * @public
+ * @since 3.0.0
+ */
 export class DockerAdapter implements IDockerAdapter {
   private baseImage = 'oven/bun:1.0-slim'
   private runtime = getRuntimeAdapter()

package/src/Infrastructure/Git/ShellGitAdapter.ts

@@ -2,6 +2,15 @@ import { mkdir } from 'node:fs/promises'
 import { getRuntimeAdapter } from '@gravito/core'
 import type { IGitAdapter } from '../../Domain/Interfaces'
 
+/**
+ * ShellGitAdapter implements the `IGitAdapter` interface using the Git CLI.
+ *
+ * It provides methods for cloning repositories to a temporary directory
+ * for deployment into Rocket containers.
+ *
+ * @public
+ * @since 3.0.0
+ */
 export class ShellGitAdapter implements IGitAdapter {
   private baseDir = '/tmp/gravito-launchpad-git'
 

package/src/Infrastructure/GitHub/OctokitGitHubAdapter.ts

@@ -2,6 +2,15 @@ import { createHmac, timingSafeEqual } from 'node:crypto'
 import { Octokit } from '@octokit/rest'
 import type { IGitHubAdapter } from '../../Domain/Interfaces'
 
+/**
+ * OctokitGitHubAdapter implements the `IGitHubAdapter` interface using the Octokit library.
+ *
+ * It provides methods for verifying GitHub webhook signatures and interacting with
+ * the GitHub API, such as posting comments on Pull Requests.
+ *
+ * @public
+ * @since 3.0.0
+ */
 export class OctokitGitHubAdapter implements IGitHubAdapter {
   private octokit: Octokit
 

package/src/Infrastructure/Persistence/CachedRocketRepository.ts

@@ -2,6 +2,15 @@ import type { CacheService } from '@gravito/core'
 import type { IRocketRepository } from '../../Domain/Interfaces'
 import { Rocket } from '../../Domain/Rocket'
 
+/**
+ * CachedRocketRepository implements the `IRocketRepository` interface using Gravito's `CacheService`.
+ *
+ * It provides a persistent (depending on cache driver) storage for Rocket
+ * metadata, allowing Launchpad to track container states across requests.
+ *
+ * @public
+ * @since 3.0.0
+ */
 export class CachedRocketRepository implements IRocketRepository {
   private CACHE_KEY = 'launchpad:rockets'
 

package/src/Infrastructure/Persistence/InMemoryRocketRepository.ts

@@ -2,6 +2,15 @@ import type { IRocketRepository } from '../../Domain/Interfaces'
 import type { Rocket } from '../../Domain/Rocket'
 import { RocketStatus } from '../../Domain/RocketStatus'
 
+/**
+ * InMemoryRocketRepository implements the `IRocketRepository` interface using an in-memory Map.
+ *
+ * This repository is suitable for testing or development environments where
+ * persistence across restarts is not required.
+ *
+ * @public
+ * @since 3.0.0
+ */
 export class InMemoryRocketRepository implements IRocketRepository {
   private rockets = new Map<string, Rocket>()
 

package/src/Infrastructure/Router/BunProxyAdapter.ts

@@ -1,6 +1,15 @@
 import { getRuntimeAdapter } from '@gravito/core'
 import type { IRouterAdapter } from '../../Domain/Interfaces'
 
+/**
+ * BunProxyAdapter implements the `IRouterAdapter` interface using Bun's native HTTP server.
+ *
+ * It provides a dynamic reverse proxy that routes requests to specific Rocket
+ * containers based on the `Host` header.
+ *
+ * @public
+ * @since 3.0.0
+ */
 export class BunProxyAdapter implements IRouterAdapter {
   private routes = new Map<string, string>() // domain -> targetUrl
 

package/src/index.ts

@@ -26,10 +26,8 @@ export * from './Domain/RocketStatus'
 class LaunchpadServiceProvider extends ServiceProvider {
   register(container: Container): void {
     if (!container.has('cache')) {
-      const cacheFromServices = this.core?.services?.get('cache')
-      if (cacheFromServices) {
-        container.instance('cache', cacheFromServices)
-      }
+      // 在新的架構中，如果 core 有預設綁定，可以直接通過 container.make 獲取
+      // 這裡如果只是想從父容器繼承，通常不需要額外操作，除非是在不同的 instance 中。
     }
 
     container.singleton('launchpad.docker', () => new DockerAdapter())
@@ -101,11 +99,24 @@ class LaunchpadServiceProvider extends ServiceProvider {
 }
 
 /**
- * Gravito Launchpad Orbit
+ * LaunchpadOrbit provides automated deployment and preview capabilities for Gravito.
+ * It integrates with Docker and GitHub to provide "Preview Deployments" for Pull Requests.
+ *
+ * @public
  */
 export class LaunchpadOrbit implements GravitoOrbit {
+  /**
+   * Create a new LaunchpadOrbit instance.
+   * @param ripple - Ripple instance for real-time telemetry communication.
+   */
   constructor(private ripple: OrbitRipple) {}
 
+  /**
+   * Install the Launchpad orbit into PlanetCore.
+   * Registers the service provider and sets up webhook routes for deployment.
+   *
+   * @param core - The PlanetCore instance.
+   */
   async install(core: PlanetCore): Promise<void> {
     core.register(new LaunchpadServiceProvider())
 
@@ -139,7 +150,7 @@ export class LaunchpadOrbit implements GravitoOrbit {
 
           const ctrl = core.container.make<MissionControl>('launchpad.ctrl')
           const rocketId = await ctrl.launch(mission, (type, data) => {
-            // 修正：使用正確的 broadcast 方法
+            // Correctly broadcast telemetry data via Ripple
             this.ripple.getServer().broadcast('telemetry', 'telemetry.data', { type, data })
           })
 
@@ -188,7 +199,12 @@ export class LaunchpadOrbit implements GravitoOrbit {
 }
 
 /**
- * 一鍵啟動 Launchpad 應用程式
+ * Bootstrap the Launchpad application.
+ * Initializes PlanetCore with necessary orbits (Cache, Ripple, Launchpad)
+ * and returns the configuration for the server entry point.
+ *
+ * @returns Server configuration object including port and fetch handler.
+ * @public
  */
 export async function bootstrapLaunchpad() {
   const ripple = new OrbitRipple({ path: '/ws' })
@@ -199,11 +215,7 @@ export async function bootstrapLaunchpad() {
       PORT: 4000,
       CACHE_DRIVER: 'file',
     },
-    orbits: [
-      new OrbitCache(),
-      ripple,
-      new LaunchpadOrbit(ripple), // 傳入實例
-    ],
+    orbits: [new OrbitCache(), ripple, new LaunchpadOrbit(ripple)],
   })
 
   await core.bootstrap()