SDK

@langdrift/sdk 為以下標準模型實作協定／結構定義版本 1：

Vision → Loop → Evidence

Drift 是 Evidence 文件類型，不是第四個支柱。 Record 記錄事實。Drift Event 則根據 Evidence，解釋事實與 Vision Target 的關係。

執行環境

• Node.js 24 或更新版本
• 附有 TypeScript 宣告的 ECMAScript 模組
• AJV 的 JSON Schema Draft 2020-12 驗證器與 yaml 剖析器
• 不依賴 React、後端、資料庫、傳輸機制或 LLM

SDK 驗證並正規化呼叫端提供的資料。 它不會定義 Product Vision 公式、計算 Product Vision、持久儲存實體，或做出身分與授權決策。

進入點

套件資訊清單公開以下介面：

• @langdrift/sdk — 依模組重新匯出的完整公開 API
• @langdrift/sdk/schema — 結構定義與相關常數
• @langdrift/sdk/mcp — 酬載建構與注入式傳輸契約
• @langdrift/sdk/integrations — GitHub 對應器與整合介面

根 API 涵蓋型別、錯誤、診斷、結構定義、驗證、安全路徑、專案、產出物、參照、Record 與 Drift Event、酬載傳輸及整合。

執行模型

檔案系統操作為非同步：

• findRepositoryRoot
• resolveSafePath 和 readProjectFile
• loadProject
• discoverArtifacts
• resolveReferences

解析、驗證、建立事件、建構酬載、解析憑證、診斷及 GitHub 對應器為同步操作。 sendPayload 會呼叫注入的傳輸機制，因此是非同步操作。

驗證採嚴格模式。SDK 不會強制轉換值、加入預設值、移除未知欄位或遷移不支援的結構定義版本。 驗證和安全路徑檢查失敗時，會使用具備穩定 code 與各欄位 issues 的 LangDriftError。