SDK

@langdrift/sdk triển khai phiên bản giao thức/lược đồ 1 cho mô hình chuẩn:

Định hướng (Vision) → Chu trình (Loop) → Bằng chứng (Evidence)

Drift là một kiểu tài liệu bằng chứng, không phải trụ cột thứ tư. Bản ghi (Record) ghi lại một sự kiện thực tế. Sự kiện sai lệch (Drift Event) diễn giải các dữ kiện theo mục tiêu định hướng (Vision Target), có bằng chứng hỗ trợ.

Môi trường chạy

• Node.js 24 trở lên
• Mô-đun ECMAScript kèm khai báo TypeScript
• Trình kiểm tra JSON Schema Draft 2020-12 của AJV và trình phân tích yaml
• Không phụ thuộc React, hệ thống phía máy chủ, cơ sở dữ liệu, lớp vận chuyển hay LLM

SDK kiểm tra và chuẩn hóa dữ liệu do bên gọi cung cấp. Nó không định nghĩa công thức Product Vision, tính Product Vision, lưu trữ thực thể hay quyết định về định danh và phân quyền.

Điểm vào

Tệp khai báo gói cung cấp:

• @langdrift/sdk — toàn bộ API công khai, được xuất lại theo mô-đun
• @langdrift/sdk/schema — lược đồ và hằng số lược đồ
• @langdrift/sdk/mcp — tạo dữ liệu gửi và hợp đồng lớp vận chuyển được truyền vào
• @langdrift/sdk/integrations — bộ ánh xạ GitHub và các giao diện tích hợp

API gốc nhóm các kiểu, lỗi, chẩn đoán, lược đồ, kiểm tra, đường dẫn an toàn, dự án, hiện vật, tham chiếu, Records và Drift Events, vận chuyển dữ liệu cùng các tích hợp.

Mô hình thực thi

Các thao tác hệ thống tệp là bất đồng bộ:

• findRepositoryRoot
• resolveSafePath và readProjectFile
• loadProject
• discoverArtifacts
• resolveReferences

Phân tích, kiểm tra, tạo sự kiện, tạo dữ liệu gửi, phân giải thông tin xác thực, chẩn đoán và bộ ánh xạ GitHub đều là đồng bộ. sendPayload là bất đồng bộ vì nó gọi lớp vận chuyển được truyền vào.

Việc kiểm tra là nghiêm ngặt. SDK không ép kiểu giá trị, thêm giá trị mặc định, xóa trường không xác định hay di chuyển phiên bản lược đồ không được hỗ trợ. Lỗi kiểm tra và đường dẫn an toàn dùng LangDriftError, với code ổn định và issues theo từng trường.