Cài đặt và chạy CLI

Cần Node.js 24 trở lên. Gói @anhcodo13/lattice đã phát hành trên npm và cung cấp lệnh lattice. CLI từ chối Node phiên bản cũ hơn.

Cài trong app của bạn

Với app của bạn, pin phiên bản chính xác rồi kiểm tra lần đầu:

npm install --save-dev --save-exact @anhcodo13/lattice@0.5.0
npx lattice --version
npx lattice governance check . --expect-apps 1

Lệnh mặc định dùng policy đi kèm gói. Hãy commit manifest và lockfile sau khi cài. Nếu cần policy từ một revision core khác đã review, truyền --policy tường minh; xem Quản trị dự án.

Kiểm tra ứng dụng của bạn

Chạy phân tích kiến trúc mà không cần kết nối đến dịch vụ ngoài:

npx lattice doctor .
npx lattice analyze .

Mở .nklattice-report/report.html tại máy. File analysis.json bên cạnh chứa các finding và quan hệ module để dùng trong tự động hóa. Muốn đổi nơi xuất, thêm --output /path/to/reports.

Với monorepo pnpm, quét từ gốc hoặc thư mục app và đặt --workspace-root tới thư mục chứa lockfile chung. Tạo .nklattice-apps.json để khai báo chính xác các ứng dụng cần quản trị; số app khác kỳ vọng phải làm gate triển khai thất bại. Policy đi kèm gói nằm tại node_modules/@anhcodo13/lattice/governance/policy.json. Đọc Quản trị dự án trước khi thu thập bằng chứng kiểm thử và bảo mật bên ngoài cho bản đánh giá tám miền.

npx lattice governance run . --expect-apps 1 \
  --evidence /tmp/nklattice-governance-evidence.json

Bản đánh giá ghi .nklattice-governance/assessment.json và report.html mở được tại máy. Kiểm tra bị thiếu sẽ cho kết luận chưa đủ bằng chứng; nó không tự chuyển thành đạt. Muốn chỉnh ngưỡng kiến trúc hoặc thêm ranh giới module, tạo .nklattice.json bằng npx lattice init ., rồi xem Policy kiến trúc.

Nếu lần chạy đầu thất bại

Đầu ra	Cần kiểm tra
No supported source files found	Đường dẫn phân tích có file JS/TS hỗ trợ ngoài các thư mục bị bỏ qua không?
No managed applications found	Đường dẫn governance và profile suy ra/khai báo của app có đúng không?
No lockfile found	Commit lockfile npm/pnpm trong app hoặc tại workspace root.
required ... declared ... locked ...	Đồng bộ package.json, tạo lại lockfile rồi chạy governance.