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 の計算式の定義や計算、エンティティの永続化、識別情報や認可に関する判断は行いません。

エントリーポイント

パッケージマニフェストは次を公開します。

• @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 を使います。