create-evlog-framework-integration

此技能為將 evlog 可觀測性框架擴展至新的 HTTP 框架（如 Hono、Elysia、Fastify、Express 或 NestJS）提供了一套系統化的藍圖。它專為希望透過將零散的日誌輸出轉化為結構化、請求範圍內的廣域事件來統一日誌策略的軟體工程師與維護者而設計。透過遵循這 16 個步驟的整合流程，您可以確保每個新的框架支援包都能繼承 evlog 的核心優勢：自動請求追蹤、結構化錯誤處理、效能遙測以及與日誌匯入管線的無縫整合。

• 實作 createMiddlewareLogger 工具，以處理完整的請求生命週期，包括強化、過濾與非同步日誌排空。

• 標準化框架專用的膠水程式碼，用於上下文注入、標頭解析（支援 Web API 與 Node.js 格式）以及錯誤元數據附加。

• 在 tsdown.config.ts 與 package.json 中納入全面的建構系統更新，以確保正確的 ESM/CJS 輸出與對等依賴管理。

• 提供強大的測試架構，利用標準輔助工具來監控排空呼叫、斷言敏感標頭過濾並驗證廣域事件結構。

• 促進端到端的文檔覆蓋，自動更新落地頁、安裝指南、功能表與框架特定的使用範例。

• 整合流程由 16 點檢查清單嚴格定義，要求手動驗證原始碼、建構配置、文檔與範例應用程式。

• 所有整合必須利用 shared/middleware、shared/headers 與 shared/storage 工具，以防止邏輯重複並維持一致的可觀測性模式。

• 預期輸入包括在 packages/evlog/src 下的新目錄、apps/docs/content 中的更新文檔，以及一個用於在實際環境中展示功能的新範例應用程式。

• 輸出包含一個生產就緒的框架轉接器、語意版本控制變更集，以及更新的工作流程模板（semantic-pull-request）以支援自動化 CI/CD。

• 此工作流程透過框架特定的模組擴充強化型別安全，確保 useLogger() 上下文能在框架的處理器生態系統中正確存取與定義型別。