v1.1.1 — vá bảo mật công cụ dev, thêm CI

Bản patch sau 1.1.0: vá các cảnh báo bảo mật trong công cụ dev và thêm CI cho mọi pull request. Hành vi của CLI và plugin không đổi.

Cài đặt / nâng cấp

npm install -g @tomosia/agent-stack@1.1.1

Plugin Claude Code: /plugin marketplace update agent-stack, rồi cài lại agent-stack@agent-stack.

Note

Bản 1.1.0 chỉ có trên GitHub, chưa từng lên npm. Trên npm, phiên bản đi thẳng từ 1.0.0 lên 1.1.1, nên ai cài qua npm sẽ nhận luôn mọi thứ của 1.1.0: agent-stack check, bảo vệ file đã sửa tay, và /generate nhận một câu. Xem ghi chú v1.1.0.

Có gì mới

• Vá 7 cảnh báo Dependabot (1 critical, 1 high, 5 medium), tất cả nằm trong dev dependency: vitest lên ^4.1.11, vite lên 8.x theo vitest, esbuild lên ^0.28.2. npm audit giờ báo 0 lỗ hổng (#8).
  • Không lên vitest 5, vì bản đó bỏ Node 20 mà engines vẫn hỗ trợ.
  • esbuild mới đổi cách viết ra dist/agent-stack.mjs, không đổi việc nó làm.
• CI trên GitHub Actions. Mỗi pull request và mỗi lần push lên main đều chạy npm run check trên Node 20 và 22. CI báo đỏ nếu bản build lại làm dist/ khác với bản đã commit (#7).

Tương thích

Không có thay đổi phá vỡ. Cờ CLI, cấu trúc --json, bố cục knowledge/ và manifest đều giữ nguyên. Chạy CLI vẫn chỉ cần Node 20+.

Nếu bạn đóng góp code: công cụ dev (Vitest, Vite 8) giờ cần Node 20.19+ hoặc 22.12+. Node 22.0.0 đi kèm npm 10.5.1, bản này lỗi Cannot read properties of null (reading 'edgesOut') khi npm install. Hãy nâng Node lên bản vá mới nhất.

Toàn bộ thay đổi: v1.1.0...v1.1.1

v1.1.0 — bảo vệ file đã sửa, check, và nhập bằng câu

Bản minor đầu tiên sau 1.0.0. Ba thay đổi, đều giữ nguyên nguyên tắc chọn, không sinh: không dòng nội dung nào do model viết, cùng đầu vào vẫn ra cùng kết quả.

Cài đặt / nâng cấp

npm install -g @tomosia/agent-stack@1.1.0

Plugin Claude Code: /plugin marketplace update agent-stack, rồi cài lại agent-stack@agent-stack.

Có gì mới

• File đã sinh mà bạn sửa tay thì không bị đè nữa. Manifest giờ ghi sha256 của từng file đã copy (trường mới checksums). Nếu một file agent-stack đã ghi bị sửa, hoặc thư mục skill đã sinh có thêm file, lần chạy sau sẽ để nó yên và đưa nó ra khỏi manifest. Lần chạy báo cảnh báo modified-file. Chỉ --overwrite, hoặc tick trong checklist, mới lấy lại được file đó. File đã sửa mà không còn được chọn thì không bị xoá (cảnh báo retained-file). Xoá một file thì không tính là sửa, nên lần sau nó được ghi lại.
• agent-stack check — dự án đã theo kịp knowledge base chưa? Lệnh này chạy đúng pipeline của generate, không ghi gì, rồi liệt kê từng đường dẫn mà generate sẽ add, update hay remove. Không truyền --framework thì nó lấy framework mà lần chạy trước đã ghi trong manifest. Exit 0 là đã cập nhật, 3 là đang cũ, nên đặt được làm bước trong CI. Trong Claude Code thì dùng /check.
• /generate nhận một câu tiếng người. Ví dụ: /generate một app SaaS bằng Rails, dùng Postgres. Command quy câu đó về --framework rails, rồi đưa bảng ánh xạ cho bạn duyệt trước khi chạy: từ nào thành cờ, từ nào không dùng và vì sao. Không từ nào bị bỏ đi mà không báo. CLI không đổi, đầu vào vẫn chỉ có framework.

Tương thích

Không có thay đổi phá vỡ. Bản này chỉ thêm: lệnh check, exit code 3, trường emit.retained và kept[].state trong --json, hai mã cảnh báo modified-file / retained-file, và trường checksums trong manifest.

Một lưu ý khi nâng cấp: manifest do 1.0.0 ghi chưa có checksum. Vì vậy lần chạy đầu tiên sau khi nâng cấp chưa phân biệt được file đã sửa và vẫn xử lý như trước. Từ lần thứ hai trở đi, file đã sửa mới được bảo vệ. Nếu bạn đã sửa tay file nào trong .claude/, hãy sao lưu trước lần chạy đó.

Toàn bộ thay đổi: v1.0.0...v1.1.0

v1.0.0 — chọn rule, không sinh rule

Bản phát hành đầu tiên. agent-stack dựng CLAUDE.md và .claude/ cho một dự án bằng cách chọn rule, skill và command từ một knowledge base có kiểm duyệt, nằm trong Git — không có dòng nội dung nào do model viết.

Cài đặt

npm install -g @tomosia/agent-stack
agent-stack generate --framework rails --write

Hoặc cài như plugin Claude Code, để dùng /generate và /catalog:

/plugin marketplace add TOMOSIA-VIETNAM/agent-stack
/plugin install agent-stack@agent-stack

Cần Node 20+. Không cần API key, và lúc generate không gọi network.

Có gì trong bản này

• Chọn tất định. Phân giải dependency, kiểm tra tương thích, kết hợp và kiểm tra đều là TypeScript trong src/. Cùng framework vào thì cùng file ra, giống tới từng byte. Model chỉ làm hai việc: ánh xạ một câu tiếng người sang cờ CLI, và chuyển tiếp xung đột cho operator.
• Xung đột làm dừng cả lần chạy. Khi hai technology được khai là không tương thích, generator nêu tên xung đột và in ra cờ để bỏ qua; nó không tự chọn bên thắng.
• Checklist duyệt trước khi ghi. generate --write trong terminal liệt kê từng artifact kèm đường dẫn đích; tick cái nào ghi cái đó. Checklist chỉ thu hẹp kết quả, không bao giờ thêm vào.
• Không đè file của bạn. CLAUDE.md merge trong cặp marker agent-stack:begin / agent-stack:end. File agent-stack chưa từng ghi thì mặc định để yên, trừ khi bạn tick nó hoặc chạy --overwrite. Chỉ file nằm trong manifest của lần chạy trước mới bị xoá.
• Đường dẫn là metadata. File trong knowledge/ được copy nguyên văn — agent-stack không đọc, không sửa, không dựng lại front matter. Ngoại lệ duy nhất là claude-md/, được inline vào CLAUDE.md.
• Agent detect đọc Gemfile.lock, composer.lock và cấu trúc thư mục để suy ra framework, gắn nhãn found / uncertain / missing, rồi đưa bạn duyệt trước khi generate.

Phạm vi nội dung

• Layer global — 26 skill và 9 command copy từ addyosmani/agent-skills, cùng bộ hướng dẫn hành vi từ multica-ai/andrej-karpathy-skills, đều ghim theo commit trong upstream.yaml và giữ giấy phép MIT gốc.
• Layer framework — Ruby, Rails và Active Record, tất cả gate bằng rails.
• Catalog có hai entry: Rails và Laravel. Laravel chưa có nội dung nào; validator ghi nhận là uncovered-technology chứ không làm hỏng lần chạy. Bổ sung nội dung cho nó là đóng góp có giá trị nhất lúc này — xem CONTRIBUTING.md.

Cam kết tương thích

Từ 1.0.0, ba thứ này theo SemVer: cờ CLI, hợp đồng --json, và bố cục thư mục knowledge/. Thay đổi phá vỡ chúng sẽ lên major.

Giấy phép

Apache-2.0. Nội dung trong knowledge/ copy từ dự án khác giữ giấy phép riêng; xem NOTICE. Mỗi dự án được generate ghi lại phần ghi công trong .claude/agent-stack-manifest.json.