Lược đồ

Phiên bản giao thức 1 dùng JSON Schema Draft 2020-12:

https://json-schema.org/draft/2020-12/schema

Mô hình chuẩn có đúng ba trụ cột:

• Định hướng (Vision) — research, prd, context
• Chu trình (Loop) — triage, design-document, spec, ticket
• Bằng chứng (Evidence) — adr, audit, record, drift

Drift là một kiểu bằng chứng, không phải trụ cột. Chín kiểu đầu là các nhóm tài liệu Markdown. Records và Drift Events là vỏ bọc JSON.

Các thành phần được xuất

@langdrift/sdk/schema xuất:

• SCHEMA_VERSION, hiện có giá trị cố định 1
• schemas, một lược đồ cho mỗi kiểu hiện vật
• projectSchema
• pillarSchemas.vision, .loop và .evidence
• artifactPillars, ánh xạ kiểu sang trụ cột

Mỗi lược đồ trụ cột nhúng các định nghĩa và cấu trúc hiện vật cần thiết, vì vậy tệp lược đồ được tạo là tự chứa.

Hành vi kiểm tra

Lược đồ yêu cầu schema_version: 1 tường minh. ID hiện vật không được rỗng hay chứa khoảng trắng. Siêu dữ liệu Markdown yêu cầu type, schema_version, id, title và ít nhất một owner. Các trường của Record, Drift Event, tham chiếu, chủ thể và dự án được định nghĩa riêng.

Đối tượng từ chối thuộc tính không xác định khi giao thức định nghĩa cấu trúc đóng. Trình kiểm tra không ép kiểu, áp dụng mặc định, xóa trường hay di chuyển phiên bản không được hỗ trợ. Kiểm tra định dạng bao gồm ngày, ngày giờ và các chuỗi đặc thù khác của giao thức.

x-langdrift là hướng dẫn giao thức bên cạnh các khẳng định JSON Schema chuẩn. Nó ghi thông tin như kiểu tài liệu, phiên bản, mẫu đường dẫn nguồn do gói quản lý, không gian tên và trường bắt buộc của phần đầu tài liệu, quan hệ tham chiếu, trụ cột và tài nguyên dữ liệu gửi. Trình kiểm tra JSON Schema thông thường có thể bỏ qua phần mở rộng này; LangDrift dùng nó để mô tả cách diễn giải.

Lược đồ mô tả đầu vào có thể chuyển đổi giữa môi trường. Chúng không định nghĩa công thức Product Vision hay chứng minh một hệ thống phía máy chủ, tích hợp hoặc máy chủ MCP tồn tại.