@starci/hfs 1.0.0 → 2.0.0

package/runtime/modules/kernel/failure-codes.yaml

@@ -1,3 +1,973 @@
+ARCH_COMPILER_FAILURE:
+  title: "Compiler failed during architecture check"
+  title_vi: "Trình biên dịch lỗi khi kiểm kiến trúc"
+  meaning_vi: "Trình biên dịch TypeScript gặp lỗi không rõ nhóm nên kiểm tra kiến trúc dừng."
+  causes_vi:
+    - "Lỗi trong bộ kiểm tra hoặc môi trường TypeScript"
+    - "Mã nguồn làm hỏng trình biên dịch"
+  nextStep_vi: "Lỗi được ghi thành lỗi đầu vào chưa kiểm; cần xem chi tiết thông báo, nếu là lỗi bộ kiểm tra thì sửa ở lõi."
+  owner: runtime-core
+  kind: check-finding
+
+ARCH_CONFIG_INVALID:
+  title: "Architecture config invalid"
+  title_vi: "Cấu hình kiến trúc không hợp lệ"
+  meaning_vi: "Tệp cấu hình kiến trúc của dự án không đọc hoặc không đúng khuôn."
+  causes_vi:
+    - "Sai cú pháp hoặc thiếu trường bắt buộc"
+  nextStep_vi: "Op dựng khung hoặc sửa mã phải sửa cấu hình rồi chạy lại kiểm tra."
+  owner: op-retry
+  kind: check-finding
+
+ARCH_DYNAMIC_DEPENDENCY_UNPROVEN:
+  title: "Dynamic import cannot be resolved"
+  title_vi: "Phụ thuộc động không xác định được"
+  meaning_vi: "Có import hoặc require dùng tên module không phải chuỗi cố định nên không biết nó phụ thuộc vào đâu."
+  causes_vi:
+    - "Dùng import(biến) hoặc require(biến)"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra; không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+ARCH_EXECUTION_UNAVAILABLE:
+  title: "Architecture checker could not run"
+  title_vi: "Bộ kiểm tra kiến trúc không chạy được"
+  meaning_vi: "Không chạy được tiến trình kiểm kiến trúc."
+  causes_vi:
+    - "Thiếu công cụ hoặc TypeScript trong dự án mục tiêu"
+    - "Tiến trình kiểm tra gặp lỗi"
+  nextStep_vi: "Kết quả ghi là chưa kiểm; cần sửa môi trường hoặc bộ kiểm tra rồi chạy lại."
+  owner: runtime-core
+  kind: check-finding
+
+ARCH_GRAMMAR_CONTRACT_INVALID:
+  title: "Grammar contract invalid"
+  title_vi: "Hợp đồng Grammar không hợp lệ"
+  meaning_vi: "Khai báo Grammar trong package.json của dự án không đúng khuôn."
+  causes_vi:
+    - "Thiếu gói, entry hoặc styleEntry của Grammar"
+  nextStep_vi: "Op sửa package.json cho đúng hợp đồng Grammar rồi chạy lại."
+  owner: op-retry
+  kind: check-finding
+
+ARCH_GRAMMAR_EXPORT_BYPASS:
+  title: "Grammar entry bypassed"
+  title_vi: "Bỏ qua cổng xuất của Grammar"
+  meaning_vi: "Mã giao diện import Grammar không qua entry mã hoặc style được chọn."
+  causes_vi:
+    - "Import thẳng đường dẫn sâu trong gói Grammar"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra; không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+ARCH_INTERNAL_IMPORT_OUTSIDE:
+  title: "Import leaves its own project"
+  title_vi: "Import trỏ ra ngoài dự án"
+  meaning_vi: "Một import nội bộ trỏ tới tệp nằm ngoài các dự án được kiểm."
+  causes_vi:
+    - "Import đường dẫn tương đối vượt khỏi dự án"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra; không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+ARCH_INTERNAL_IMPORT_UNRESOLVED:
+  title: "Internal import unresolved"
+  title_vi: "Import nội bộ không tìm thấy đích"
+  meaning_vi: "Một import nội bộ không phân giải được tới tệp nào."
+  causes_vi:
+    - "Sai đường dẫn hoặc tệp đã bị xoá hay đổi tên"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra; không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+ARCH_KNOWLEDGE_UNAVAILABLE:
+  title: "Architecture knowledge unavailable"
+  title_vi: "Tri thức của bộ kiểm kiến trúc không đọc được"
+  meaning_vi: "Bộ kiểm kiến trúc cần một tệp tri thức đi kèm (danh sách tệp gốc do framework ghim) nhưng không đọc được hoặc sai khuôn, nên không phán xét bằng hợp đồng khác."
+  causes_vi:
+    - "Bản đóng gói của `hfs` thiếu hoặc hỏng tệp tri thức, hoặc tệp tri thức trong runtime bị sửa sai khuôn."
+  nextStep_vi: "Cài lại `@starci/hfs` đúng phiên bản đã ghim; nếu là runtime thì sửa tệp tri thức rồi chạy `node packages/hfs/scripts/sync-runtime.mjs`."
+  owner: runtime-core
+  kind: check-finding
+
+ARCH_NO_SOURCE:
+  title: "No production source found"
+  title_vi: "Không có mã nguồn để kiểm"
+  meaning_vi: "Các dự án TypeScript được cấu hình không chứa mã TypeScript hay JavaScript sản phẩm nào."
+  causes_vi:
+    - "Cấu hình include sai"
+    - "Dự án còn trống"
+  nextStep_vi: "Op phải sửa cấu hình hoặc thêm mã rồi chạy lại."
+  owner: op-retry
+  kind: check-finding
+
+ARCH_OWNER_CYCLE:
+  title: "Owner import cycle"
+  title_vi: "Vòng import giữa các đơn vị sở hữu"
+  meaning_vi: "Các đơn vị sở hữu (feature, module domain, platform, gói...) import lẫn nhau thành vòng khép kín, kể cả bằng import chỉ kiểu. Vòng làm hai đơn vị không thể hiểu, kiểm thử hay thay thế riêng lẻ; bộ kiểm tra báo kèm đường đi của vòng."
+  causes_vi:
+    - "Hai module domain dùng chung một kiểu và import kiểu của nhau"
+    - "Một module gọi ngược lại module đã gọi nó thay vì nhận qua tham số hoặc sự kiện"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để cắt vòng: chuyển phần chung sang một đơn vị thấp hơn hoặc đảo phụ thuộc; không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+ARCH_OWNER_EXPORT_BYPASS:
+  title: "Owner public export bypassed"
+  title_vi: "Bỏ qua cổng xuất công khai của module"
+  meaning_vi: "Import vào module chủ sở hữu không đi qua cổng xuất công khai của nó."
+  causes_vi:
+    - "Import thẳng tệp bên trong module khác"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra; không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+ARCH_OWNER_EXPORT_STAR:
+  title: "Owner public export uses export star"
+  title_vi: "Cổng xuất công khai dùng export *"
+  meaning_vi: "Cổng xuất công khai của module dùng export * nên lộ mọi thứ bên trong."
+  causes_vi:
+    - "Viết export * from trong tệp index công khai"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra; không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+ARCH_PACKAGE_EXPORT_BYPASS:
+  title: "Package export bypassed"
+  title_vi: "Bỏ qua cổng xuất của gói"
+  meaning_vi: "Import giữa các gói không dùng tên gói và export đã khai báo."
+  causes_vi:
+    - "Import đường dẫn tương đối sang gói khác"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra; không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+ARCH_PACKAGE_IMPORTS_APP:
+  title: "Package depends on an app"
+  title_vi: "Gói dùng chung phụ thuộc vào ứng dụng"
+  meaning_vi: "Một gói dùng chung lại import mã của ứng dụng cụ thể."
+  causes_vi:
+    - "Đặt mã dùng chung nhưng lấy phụ thuộc từ app"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra; không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+ARCH_SYNTAX_INVALID:
+  title: "Source syntax invalid"
+  title_vi: "Cú pháp mã nguồn không hợp lệ"
+  meaning_vi: "Trình biên dịch báo mã nguồn sai cú pháp."
+  causes_vi:
+    - "Tệp dở dang hoặc gõ sai"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra; không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+ARCH_TSCONFIG_INVALID:
+  title: "tsconfig invalid"
+  title_vi: "tsconfig không hợp lệ"
+  meaning_vi: "Một tệp tsconfig không đọc được hoặc sai."
+  causes_vi:
+    - "Sai JSON hoặc tuỳ chọn không hợp lệ"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra; không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+ARCH_TSCONFIG_MISSING:
+  title: "tsconfig missing"
+  title_vi: "Thiếu tsconfig"
+  meaning_vi: "Dự án được chọn nhưng không có tsconfig."
+  causes_vi:
+    - "Tệp bị xoá hoặc đường dẫn sai"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra; không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+ARCH_TSCONFIG_REFERENCE_OUTSIDE:
+  title: "tsconfig reference leaves repo"
+  title_vi: "Tham chiếu tsconfig ra ngoài kho"
+  meaning_vi: "Một project reference trong tsconfig trỏ ra ngoài kho mã."
+  causes_vi:
+    - "Đường dẫn references dùng ../ vượt gốc"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra; không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+ARCH_TYPESCRIPT_INVALID:
+  title: "TypeScript package has no compiler API"
+  title_vi: "Gói TypeScript trong kho không có API trình biên dịch"
+  meaning_vi: "Gói `typescript` trong kho được kiểm không cung cấp API trình biên dịch mà bộ kiểm kiến trúc cần."
+  causes_vi:
+    - "Gói `typescript` bị cài hỏng hoặc bị thay bằng gói khác cùng tên."
+  nextStep_vi: "Cài lại `typescript` đúng phiên bản đã ghim trong `knowledge/hfs/canon-pins.yaml` rồi chạy lại `hfs check`."
+  owner: op-retry
+  kind: check-finding
+
+ARCH_TYPESCRIPT_MISSING:
+  title: "TypeScript is not installed in the checked repository"
+  title_vi: "Kho được kiểm chưa cài TypeScript"
+  meaning_vi: "Bộ kiểm kiến trúc chỉ dùng TypeScript cài trong chính kho được kiểm, không thay bằng bộ phân tích khác, nên không kiểm được."
+  causes_vi:
+    - "Kho thiếu `package.json` hoặc chưa chạy `npm ci` nên `node_modules/typescript` không có."
+  nextStep_vi: "Chạy `npm ci` trong kho rồi chạy lại `hfs check`."
+  owner: op-retry
+  kind: check-finding
+
+BE_APPLICATION_IMPORTS_TRANSPORT:
+  title: "Application imports transport layer"
+  title_vi: "Lớp ứng dụng import lớp giao vận"
+  meaning_vi: "Mã lớp application của feature backend phụ thuộc vào adapter hay DTO của lớp transport."
+  causes_vi:
+    - "Import DTO hoặc controller vào use case, kể cả qua barrel hoặc import kiểu"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra; không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+BE_APPLICATION_TRANSPORT_FRAMEWORK:
+  title: "Application uses transport framework types"
+  title_vi: "Lớp ứng dụng dùng kiểu khung giao vận"
+  meaning_vi: "Mã lớp application import decorator, kiểu request hay response của giao thức."
+  causes_vi:
+    - "Đặt validator hay decorator HTTP trong lớp application"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra; không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+BE_APP_BUSINESS_ROLE:
+  title: "Composition root holds business role"
+  title_vi: "Gốc ghép nối chứa vai trò nghiệp vụ"
+  meaning_vi: "Thư mục ứng dụng gốc chứa mã có vai trò nghiệp vụ hay nhà cung cấp."
+  causes_vi:
+    - "Đặt service hay repository trong src của ứng dụng gốc"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra; không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+BE_APP_COMPOSITION_ONLY:
+  title: "Composition root has stray source"
+  title_vi: "Gốc ghép nối có tệp lạc chỗ"
+  meaning_vi: "Mã trong ứng dụng gốc không phải tệp mà slot ứng dụng cho phép (main.ts, app.module.ts, <app>.options.ts)."
+  causes_vi:
+    - "Thêm tệp không đúng tên vào thư mục ứng dụng gốc"
+    - "Composition spec của app tự khai AppModule, import AppModule từ tệp khác app.module, hoặc không gọi AppModule.register( — module thật không bao giờ được khởi chạy"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra; không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+BE_BACKGROUND_UNOWNED:
+  title: "Every sweep, outbox or retry has a job or consumer run by a worker app"
+  title_vi: "Việc nền không có ai chạy"
+  meaning_vi: "`<method>` là việc nền nhưng không có job/consumer nào chạy nó — 'khôi phục bền' này không bao giờ chạy."
+  causes_vi:
+    - "Vi phạm luật R46: Công việc nền (outbox, sweep, reconcile, retry) là `transport/schedule/*.job.ts` hoặc `transport/message/*.consumer.ts`, được app `worker` compose; job/consumer không app `worker` nào compose, hoặc `@Cron`/`@Interval`/`setInterval` ngoài `platform/scheduling`, hoặc method `sweep*\\|deliver*\\|reconcile*\\|retry*` không có job/consumer đã compose chạm tới = đỏ."
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra và mục của luật trong tiêu chuẩn HFS; nợ cũ cần quyết định thiết kế nên op không thêm ngoại lệ, chỉ tách hoặc chuyển về đúng chủ."
+  owner: op-retry
+  kind: check-finding
+
+BE_CONNECTION_DUPLICATE:
+  title: "One database reached through more than one connection or injector"
+  title_vi: "Một cơ sở dữ liệu có hơn một kết nối hoặc injector"
+  meaning_vi: "Mỗi cơ sở dữ liệu vật lý chỉ có một kết nối và một injector Inject<Conn>EntityManager() khai báo một lần trong platform/database. Bộ kiểm tra thấy một injector thứ hai (ví dụ InjectCollabEntityManager bên cạnh InjectAgentOsEntityManager), một tên kết nối thứ hai trỏ vào cùng cơ sở dữ liệu, một lời gọi InjectEntityManager/getEntityManagerToken/InjectDataSource ngoài <conn>.decorators.ts, hoặc hfs.json, tệp kết nối và injector không khớp một-một."
+  causes_vi:
+    - "Một tính năng tự tạo injector hoặc kết nối riêng cho cùng cơ sở dữ liệu"
+    - "Hai tệp cùng export một tên injector nhưng trỏ tới hai kết nối"
+    - "Kết nối mới chưa được khai báo trong hfs.json connections"
+    - "Cấu hình kết nối đọc biến môi trường của kết nối khác"
+  nextStep_vi: "Giữ đúng một <conn>.connection.ts, <conn>.config.ts và <conn>.decorators.ts cho mỗi mục hfs.json connections trong src/modules/platform/database/, xóa injector hoặc kết nối thừa cùng mọi tham chiếu và đổi nơi dùng sang injector duy nhất. Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra và mục của luật trong BE-CONVENTION; không thêm ngoại lệ, không tắt luật."
+  owner: op-retry
+  kind: check-finding
+
+BE_CONTRACT_UNGUARDED:
+  title: "A fake serves payload fixtures that no sandbox contract spec compares with the real provider"
+  title_vi: "Fixture của fake chưa có contract spec bảo vệ"
+  meaning_vi: "Thư mục `src/tests/world/fakes/<provider>/` có fixture payload (`payloads/*.json`) nhưng không có `src/tests/contract/<provider>/*.contract-spec.ts` nào vừa tham chiếu fixture của nhà cung cấp đó vừa khẳng định `shapeOf(real)` bằng `shapeOf(fixture)`: `<detail>`."
+  causes_vi:
+    - "Fake có fixture payload nhưng chưa có thư mục contract/<provider>/ hay spec nào"
+    - "Contract spec có nhưng không so hình dạng (shapeOf) của payload thật với fixture, hoặc không đọc fixture của đúng nhà cung cấp, hoặc tự định nghĩa shapeOf thay vì import từ world"
+  nextStep_vi: "Thêm `src/tests/contract/<provider>/<provider>.contract-spec.ts` dùng contract helper của world (`sandbox.describe(...)`, tự bỏ qua khi thiếu cấu hình sandbox) và khẳng định `expect(shapeOf(thật)).toEqual(shapeOf(fixture))`. Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra."
+  owner: op-retry
+  kind: check-finding
+
+BE_DEFAULT_DENY:
+  title: "Open or untyped door"
+  title_vi: "Cửa mở hoặc nhận dữ liệu không kiểu"
+  meaning_vi: "Một operation nhận body không kiểu (unknown, any, GraphQLJSON, switch theo operation), công khai mà không có @Public({ reason: PublicReason.X }) lấy từ enum của domain/identity, tự chọn guard bằng @UseGuards, hoặc so sánh bí mật bằng toán tử bằng thay vì timingSafeEqual. Mặc định mọi route đi qua chuỗi APP_GUARD toàn cục và mọi đầu vào phải có kiểu."
+  causes_vi:
+    - "@Body() hoặc @Args() không khai kiểu, hoặc khai unknown, any, object"
+    - "GraphQLJSON được dùng để chui dữ liệu không kiểu qua schema"
+    - "@Public() thiếu reason, hoặc reason là chuỗi hay thuộc enum khác PublicReason"
+    - "@UseGuards(...) trên controller hay resolver thay vì chuỗi APP_GUARD toàn cục"
+    - "Token, mật khẩu hoặc chữ ký được so sánh bằng === hay !=="
+    - "Gốc app api không cung cấp APP_GUARD theo thứ tự throttler, CSRF origin guard của platform/http-security, AuthGuard của domain/identity, hoặc thiếu, lặp một guard"
+  nextStep_vi: "Khai DTO hoặc kiểu hợp đồng cho từng operation, dùng @Public({ reason: PublicReason.X }) khi cần mở cửa, bỏ @UseGuards, và so sánh bí mật bằng crypto.timingSafeEqual; op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra."
+  owner: op-retry
+  kind: check-finding
+
+BE_ENTRYPOINT_ONLY_IN_APPS:
+  title: "Entrypoints only in `apps/*/src`"
+  title_vi: "Entrypoint nằm ngoài apps"
+  meaning_vi: "`<file>` là một entrypoint tiến trình nằm ngoài `apps/`."
+  causes_vi:
+    - "Vi phạm luật R33: Không `main.ts`/`bootstrap()`/top-level `void x()` ngoài `apps/*/src`; migrate là `apps/migrate`."
+    - "NestFactory.create* hoặc lời gọi bootstrap() cấp cao nhất nằm ngoài apps/<app>/src/main.ts"
+    - "Chỉ `src/tests/world/` (gốc ghép của test, slot be.tests.world) được gọi NestFactory ngoài main.ts; một spec (integration, contract, e2e) không được ghép: nó chỉ gọi useTestWorld(...)."
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra (nợ hàng loạt có codemod của HFS); không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+BE_ERROR_HOME:
+  title: "Error declared outside its capability"
+  title_vi: "Lỗi không nằm ở capability sở hữu"
+  meaning_vi: "Một lớp lỗi nằm ngoài errors/<capability>.error.ts của capability sở hữu nó, kế thừa Error trần hay base đã bỏ thay vì DomainError, hoặc tệp errors/<capability>.error.ts không đúng hình dạng (một enum <C>ErrorCode, một bảng <C>_ERROR_KINDS kiểu Record<<C>ErrorCode, ErrorKind>, một lớp <C>Error rỗng); hoặc code ném giá trị không phải DomainError (new Error, exception của framework, chuỗi), hoặc domain ném lỗi của platform."
+  causes_vi:
+    - "Lớp lỗi đặt ở tệp service hay tệp khác thay vì <capability>/errors/<capability>.error.ts"
+    - "Lớp lỗi kế thừa Error hoặc AbstractException thay vì DomainError"
+    - "throw new Error(...), throw new NotFoundException(...) hoặc throw một chuỗi thoát ra khỏi capability"
+    - "Giá trị enum không theo <CAPABILITY>_<WHAT>, bảng kind thiếu kiểu Record hoặc lớp lỗi có thân"
+    - "Domain ném ConfigError hay lỗi khác của platform"
+    - "Giá trị của enum <C>ErrorCode không phải chuỗi literal dạng <CAPABILITY>_<WHAT>, có hậu tố _ERROR hay _EXCEPTION, hoặc trùng với một mã ở nơi khác trong repo"
+  nextStep_vi: "Chuyển lỗi về errors/<capability>.error.ts với đúng ba thành phần, kế thừa DomainError, dịch lỗi platform thành lỗi của capability; op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra."
+  owner: op-retry
+  kind: check-finding
+
+BE_ERROR_MASKED:
+  title: "One filter per app; undeclared errors are masked"
+  title_vi: "Lỗi nội bộ lộ ra client"
+  meaning_vi: "App `<a>` trả thông điệp lỗi nội bộ ra client (`<where>`). Lỗi lạ phải bị che."
+  causes_vi:
+    - "Vi phạm luật R39: Mỗi app đăng ký đúng một filter/formatError của `platform/errors`; lỗi không khai báo → 500 + thông điệp chung, chi tiết chỉ vào log."
+    - "Gốc app api không cung cấp đúng một APP_FILTER dùng lớp khai báo trong platform/errors"
+    - "GraphQLModule.forRoot không truyền formatError của platform/errors"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra (nợ hàng loạt có codemod của HFS); không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+BE_FEATURE_IMPORTS_FEATURE:
+  title: "A feature never imports a feature"
+  title_vi: "Feature import feature khác"
+  meaning_vi: "Feature `<a>` import feature `<b>`. Logic dùng chung phải là một capability domain."
+  causes_vi:
+    - "Vi phạm luật R28: Feature không import feature khác (kể cả qua `index.ts`); dùng chung thì đưa xuống domain."
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra và mục của luật trong tiêu chuẩn HFS; nợ cũ cần quyết định thiết kế nên op không thêm ngoại lệ, chỉ tách hoặc chuyển về đúng chủ."
+  owner: op-retry
+  kind: check-finding
+
+BE_FEATURE_LAYOUT_INVALID:
+  title: "Feature folder layout invalid"
+  title_vi: "Bố cục thư mục feature sai"
+  meaning_vi: "Tệp của feature đặt sai thư mục application hoặc transport so với vai trò của nó."
+  causes_vi:
+    - "Đặt vai trò giao vận trong application/ hoặc ngược lại"
+    - "Thiếu tên giao thức dưới transport/"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra; không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+BE_FEATURE_NOT_COMPOSED:
+  title: "Feature or capability module not composed into any app"
+  title_vi: "Feature hoặc module năng lực không được lắp vào ứng dụng nào"
+  meaning_vi: "Một feature backend, hoặc một module domain, integrations hay platform, không có đường import chạy thật (không tính import chỉ-kiểu) từ tệp gốc của bất kỳ ứng dụng nào (app.module.ts hoặc main.ts), kể cả qua các module khác đã được lắp. Không tiến trình nào nạp nó nên code này không bao giờ được phục vụ."
+  causes_vi:
+    - "Quên thêm module của feature vào app.module.ts của ứng dụng"
+    - "Chỉ import kiểu (import type) từ ứng dụng, nên feature không thật sự được lắp vào"
+    - "Feature đã bị bỏ dở hoặc thay bằng feature khác nhưng thư mục cũ vẫn còn"
+    - "Module năng lực được viết sẵn nhưng chưa feature nào import nó, hoặc feature từng dùng nó đã bị xoá"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để lắp module của feature vào ứng dụng phù hợp hoặc xoá feature không dùng; không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+BE_FEATURE_SHAPE:
+  title: "Feature root is `index.ts`, module, `application/`, `transport/<protocol>/`"
+  title_vi: "Feature sai hình dạng"
+  meaning_vi: "Feature `<f>` có `<dir>` ngoài hình dạng chuẩn (application/ + transport/<protocol>/)."
+  causes_vi:
+    - "Vi phạm luật R29: Feature gốc chỉ có `index.ts`, `<feature>.module.ts`, `application/`, `transport/<protocol>/` với protocol có slot; không `application/graphql\\|http`, không `infrastructure/`, `composition/`, cây transport-first."
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra (nợ hàng loạt có codemod của HFS); không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+BE_MODULE_HANDLER_REGISTRATION:
+  title: "Handler not registered exactly once"
+  title_vi: "Handler chưa đăng ký đúng một lần"
+  meaning_vi: "Một handler không được đăng ký trực tiếp đúng một lần trong module Nest."
+  causes_vi:
+    - "Quên đăng ký vào providers"
+    - "Đăng ký ở nhiều module"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra; không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+BE_MODULE_PROVIDER_REREGISTRATION:
+  title: "Provider re-registered"
+  title_vi: "Provider bị đăng ký lại"
+  meaning_vi: "Một provider đã có nơi đăng ký lại bị đăng ký thêm ở module khác."
+  causes_vi:
+    - "Khai báo cùng provider ở hai module"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra; không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+BE_MODULE_SHAPE:
+  title: "Nest module shape invalid"
+  title_vi: "Hình dạng module Nest sai"
+  meaning_vi: "Một module vi phạm hình dạng chuẩn: @Global() ở bất kỳ đâu, isGlobal: true ngoài apps/<app>/src/app.module.ts, import module của owner khác vào @Module({ imports }), ConfigurableModuleBuilder không khai kiểu options, có forRoot, forFeature hay registerAsync thay vì chỉ static register, nhiều module trong một tệp, new một provider, hoặc biến let ở cấp module."
+  causes_vi:
+    - "@Global() trên bất kỳ module nào (kể cả trong spec)"
+    - "isGlobal: true ở ngoài app.module.ts của app"
+    - "Module của một capability khác bị import vào imports thay vì dùng qua Inject<Thing>()"
+    - "new ConfigurableModuleBuilder() không có kiểu options"
+    - "register không static, hoặc có forRoot, forFeature, registerAsync"
+    - "new XService() hoặc let ở cấp module tạo trạng thái toàn cục"
+    - "Feature có hai module trong một thư mục transport (một module cho mỗi thao tác), có module-definition, hoặc @Module ngoài `<f>.module.ts` và `<f>-<protocol>.module.ts`; app import module ứng dụng của feature hoặc module transport không thuộc loại app cho phép (api: graphql/http/websocket; worker: schedule/message; cli: cli)"
+    - "Bộ máy đồ thị module: module đại diện của capability được đăng ký hai lần trong một app, thiếu isGlobal: true ở gốc app, hoặc bị module khác import"
+    - "Module con có hơn một nơi import, hoặc vừa nằm ở gốc app vừa được module khác import"
+    - "isGlobal: true xuất hiện ngoài gốc app apps/<app>/src/app.module.ts"
+  nextStep_vi: "Bỏ @Global, để app đăng ký capability đúng một lần với isGlobal: true, dùng capability khác qua Inject<Thing>(), khai kiểu options, chỉ dùng static register, tách module, để container dựng provider; op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra."
+  owner: op-retry
+  kind: check-finding
+
+BE_PUBLIC_CONTRACT_FORM:
+  title: "Public contract form invalid"
+  title_vi: "Dạng hợp đồng công khai sai"
+  meaning_vi: "Hợp đồng công khai của backend không được khai báo theo dạng được yêu cầu (ví dụ kiểu inline)."
+  causes_vi:
+    - "Viết kiểu ngay tại tham số thay vì khai báo tên riêng"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra; không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+BE_RAW_INJECT:
+  title: "Infrastructure dependency injected without its Inject*() decorator"
+  title_vi: "Phụ thuộc hạ tầng không được tiêm qua Inject*()"
+  meaning_vi: "Mọi tham số constructor có kiểu thuộc hạ tầng (EntityManager, CommandBus, Clock, Logger, Cache, HttpClient, options của module, client SDK) phải mang một decorator Inject<Thing>() không tham số, export từ <owner>.decorators.ts và dựng bằng injector<T>(token) trên token unique symbol. Bộ kiểm tra thấy @Inject( thô ngoài *.decorators.ts, token chuỗi, forwardRef, ModuleRef, tiêm qua thuộc tính, injector sai hình hoặc kiểu T khác kiểu tham số. Token của Inject<Thing>() mà một service dùng cũng phải được export (từ <cap>.decorators.ts hoặc index.ts của năng lực) để spec có thể cung cấp nó."
+  causes_vi:
+    - "Token của Inject<Thing>() là const riêng tư, không export"
+    - "@Inject(TOKEN) viết thẳng ở nơi dùng"
+    - "Token là chuỗi thay vì unique symbol"
+    - "Tiêm lớp hạ tầng (CacheService, AppLogger) không qua injector"
+    - "Dùng ModuleRef.get hoặc forwardRef để né vòng phụ thuộc"
+  nextStep_vi: "Khai báo token `export const THING: unique symbol = Symbol(\"<owner>.<thing>\")` và `export const InjectThing = (): TypedParameterDecorator<Thing> => injector<Thing>(THING)` trong <owner>.decorators.ts rồi dùng @InjectThing() ở mọi nơi; vòng phụ thuộc là lỗi kiến trúc cần gỡ, không dùng forwardRef. Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra và mục của luật trong BE-CONVENTION; không thêm ngoại lệ, không tắt luật."
+  owner: op-retry
+  kind: check-finding
+
+BE_READONLY_BOUNDARY:
+  title: "Readonly boundary violated"
+  title_vi: "Vi phạm ranh giới chỉ-đọc"
+  meaning_vi: "Thông điệp hoặc phụ thuộc được tiêm không được đánh dấu readonly hoặc có setter."
+  causes_vi:
+    - "Thiếu readonly trên trường"
+    - "Có setter hay index signature"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra; không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+BE_REQUIRED_MODULE_MISSING:
+  title: "Required backend module, app or feature file is missing"
+  title_vi: "Thiếu tệp hoặc thư mục bắt buộc của một phần backend"
+  meaning_vi: "Bảng kê HFS bắt buộc mỗi ứng dụng, tính năng, module miền, tích hợp và module nền tảng (cấu hình, ghi nhật ký, lỗi, kiểu nguyên thuỷ) phải có một số tệp hoặc thư mục cố định, ví dụ index.ts, tệp .module.ts hay thư mục application/. Ở đây một mục như vậy không tồn tại, nên phần đó chưa đúng khuôn và các bộ kiểm tra khác không thể tin vào nó."
+  causes_vi:
+    - "Tạo module hoặc tính năng mới nhưng quên tệp cửa vào index.ts hoặc tệp .module.ts"
+    - "Module nền tảng bắt buộc (config, logging, errors, primitives) chưa được tạo hoặc đặt tên khác"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để tạo tệp hoặc thư mục còn thiếu đúng theo bảng kê; nếu tên hiện có là do thiết kế khác thì đó là việc đổi bảng kê, do người giám sát quyết định."
+  owner: op-retry
+  kind: check-finding
+
+BE_SCHEMA_OWNER:
+  title: "Entities and migrations live in the owning capability's `persistence/`"
+  title_vi: "Entity hoặc migration sai chủ"
+  meaning_vi: "Entity/migration `<file>` không nằm dưới `persistence/` của capability sở hữu (hoặc sai tên)."
+  causes_vi:
+    - "Vi phạm luật R35: Entity + migration nằm trong `<capability>/persistence/` của capability sở hữu bảng, có `connection.ts` khai báo hai mảng `<c>Entities` và `<c>Migrations` (không có `CONNECTION`); connection của capability là connection mà app đăng ký hai mảng đó vào `DatabaseModule.register`: đúng một connection khai trong `hfs.json` ở mọi app, và mọi `Inject<Conn>EntityManager` trong capability phải là connection ấy; tên migration `<epochMs13>-<kebab>.ts`, class `<Pascal><epochMs13>`, thuộc tính `name` bằng tên class; `index.ts` của owner export `<c>Entities` và `<c>Migrations`, app compose."
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra (nợ hàng loạt có codemod của HFS); không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+BE_SOURCE_FORM:
+  title: "Back-end source file breaks the naming or form canon"
+  title_vi: "Tệp nguồn BE sai quy ước tên hoặc hình thức"
+  meaning_vi: "Tên tệp phải là kebab-case với hậu tố vai trò trong danh sách đóng của slots.yaml; chỉ export có tên (không export default); mọi export và thành viên công khai có JSDoc tiếng Anh; không emoji, và không có chữ tiếng Việt trong định danh, chuỗi ký tự, chú thích hay tên test ngoài catalog messages/ và slot fixture i18n."
+  causes_vi:
+    - "Tệp dùng hậu tố bị cấm (use-case, repository, store, util, helper, types, constants)"
+    - "Lớp export không kết thúc bằng hậu tố vai trò của tệp và cũng không kết thúc bằng tên port (interface trong *.port.ts hoặc *.contracts.ts) mà nó implements"
+    - "Interface trong tệp *.input.ts, *.request.ts, *.response.ts, *.type.ts, *.args.ts hoặc *.rows.ts không kết thúc bằng Input, Request, Response, Type, Args hoặc Row"
+    - "@Args dùng tên khác \"input\""
+    - "Export default"
+    - "Thiếu JSDoc trên export"
+    - "Chú thích tiếng Việt trong mã"
+  nextStep_vi: "Đổi tên tệp theo vai trò trong danh sách đóng, chuyển kiểu vào <tên>.contracts.ts, thêm JSDoc tiếng Anh và bỏ export default. Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra và mục của luật trong BE-CONVENTION; không thêm ngoại lệ, không tắt luật."
+  owner: op-retry
+  kind: check-finding
+
+BE_SPEC_PLACEMENT:
+  title: "A back-end spec lives in one of the four test layers"
+  title_vi: "Spec đặt ngoài bốn tầng test"
+  meaning_vi: "Tệp spec hoặc test `<f>` nằm ngoài bốn tầng test của back end (kể cả trong `scripts/` hoặc `tools/`)."
+  causes_vi:
+    - "Vi phạm luật R102: spec đơn vị là `<name>.service.spec.ts` cạnh service của nó; spec tích hợp, e2e và contract nằm dưới `src/tests/{integration,e2e,contract}`. Mọi `*.spec.*`, `*.test.*`, `*-spec.*` khác là vi phạm; script vận hành và công cụ không mang spec."
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra: chuyển spec vào tầng đúng hoặc xóa nó; không thêm ngoại lệ, không tắt luật."
+  owner: op-retry
+  kind: check-finding
+
+BE_SPEC_QUALITY:
+  title: "Spec reads source, or an e2e breaks its flow shape"
+  title_vi: "Spec đọc mã nguồn hoặc e2e phá dạng luồng"
+  meaning_vi: "Một spec đọc mã nguồn của repo bằng fs để kiểm tra chữ, một spec chỉ khẳng định lời gọi thay vì kết quả, hoặc một e2e đi vòng qua transport, ngủ theo thời lượng, rẽ nhánh trong bước, tự dựng module, gọi nhà cung cấp mô hình hay không đọc lại trạng thái đã lưu. Ép kiểu (as, x!) trong spec do các luật mượn của typescript-eslint chặn, cùng mã BE_TYPE_ESCAPE. Một spec của bất kỳ tầng nào bỏ qua hoặc đánh dấu test (skip, skipIf, runIf, todo, only, xit, xdescribe, xtest) hay chọn runner theo điều kiện cũng bị chặn; việc bỏ qua duy nhất là của contract helper trong world khi thiếu cấu hình sandbox."
+  causes_vi:
+    - "readFileSync hay readdirSync trên mã nguồn hoặc __dirname trong spec"
+    - "Spec chỉ có toHaveBeenCalled*, không khẳng định kết quả hay trạng thái"
+    - "`it.skip`, `describe.skip`, `xit`, `it.todo`, `.skipIf`/`.runIf` hoặc `(cond ? describe : describe.skip)` trong spec; hãy viết test thật hoặc xóa nó, còn việc bỏ qua khi thiếu sandbox nằm trong contract helper của world (`sandbox.describe(...)`)"
+    - "e2e gọi CommandBus, QueryBus hay handler trực tiếp; dùng sleep thay cho waitFor; tự gọi Test.createTestingModule; import SDK của nhà cung cấp mô hình; không đọc lại dòng đã lưu qua EntityManager"
+    - "Spec đơn vị của service có providers khác với phụ thuộc constructor: thừa nhà cung cấp, thiếu nhà cung cấp, service không đứng đầu, token không suy ra được hoặc nhà cung cấp không phải lớp hay { provide, useValue }"
+  nextStep_vi: "Chuyển luật kiến trúc sang lint hoặc bộ kiểm tra; khẳng định kết quả hoặc trạng thái; e2e vào bằng transport thật, chờ bằng waitFor và dựng thế giới ở src/tests/e2e/setup. Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra."
+  owner: op-retry
+  kind: check-finding
+
+BE_SQL_TABLE_OWNER:
+  title: "SQL touches another capability's table or reads unbounded"
+  title_vi: "SQL ghi bảng của năng lực khác hoặc đọc không giới hạn"
+  meaning_vi: "Bộ kiểm tra phân tích từng hằng SqlText: câu lệnh ghi (INSERT, UPDATE, DELETE) chỉ được chạm bảng của entity thuộc chính năng lực đó; câu đọc chỉ được chạm bảng của năng lực mà chủ sở hữu được phép import; SELECT nhiều dòng phải có LIMIT trừ khi lọc theo khóa chính hoặc khóa duy nhất hoặc chỉ tính tổng."
+  causes_vi:
+    - "Service của năng lực A cập nhật bảng của năng lực B"
+    - "Truy vấn danh sách quên LIMIT"
+    - "Bảng chưa có entity khai báo ở năng lực sở hữu"
+  nextStep_vi: "Chuyển câu ghi về năng lực sở hữu bảng và gọi qua API công khai của năng lực đó; thêm LIMIT theo PAGE_SIZE_MAX, LIST_ROWS_MAX hoặc BATCH_ROWS của platform/database. Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra và mục của luật trong BE-CONVENTION; không thêm ngoại lệ, không tắt luật."
+  owner: op-retry
+  kind: check-finding
+
+BE_TEST_TOPOLOGY:
+  title: "One jest config, four projects live by folder; the world is the only test infrastructure and runs the repository's own stack for real"
+  title_vi: "Cấu hình test lệch chuẩn"
+  meaning_vi: "Cấu hình test lệch chuẩn: `<detail>`."
+  causes_vi:
+    - "Vi phạm luật R47: một `jest.config.js` (preset `@starci/jest-preset`) với bốn project `unit`, `integration`, `e2e`, `contract`; thư mục và hậu tố spec luôn khớp nhau; `diagnostics: false` + `isolatedModules: true`; `test:integration`, `test:e2e`, `test:contract` = `typecheck:tests && jest --selectProjects <tên>`; `src/tests/world/` là nơi duy nhất dựng hạ tầng test và chỉ chứa `global-setup.ts`, `global-teardown.ts`, `use-test-world.ts`, `fakes/` và file gốc có hậu tố vai trò (kể cả `test-world.config.ts`)."
+    - "Vi phạm luật R47 về stack thật: mọi dịch vụ khai trong `.starcistacks/<env>` (Postgres, Redis, Keycloak, mail host, k3s...) chạy THẬT trong world qua toxiproxy, world đọc dịch vụ và phiên bản image từ stack lúc chạy; `fakes/<provider>/` chỉ giả SaaS bên ngoài mà đội không vận hành. Ngoại lệ duy nhất: dịch vụ stateless cần phần cứng đặc biệt hoặc model bên ngoài (GPU inference, embedding tự host) được giả khi `test-world.config.ts` khai trong `fakedBy` với `reason` không rỗng; dịch vụ có trạng thái (database, cache, identity, storage, mail, queue, search hoặc có volume bền) không bao giờ được giả, và mục `fakedBy` trỏ tới dịch vụ hoặc thư mục fake không tồn tại bị coi là cũ."
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra (nợ hàng loạt có codemod của HFS); không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+BE_TIER_DIRECTION:
+  title: "Backend import against the tier direction"
+  title_vi: "Backend import ngược chiều tầng"
+  meaning_vi: "Một tệp backend import từ tầng mà bảng kê HFS không cho phép tầng của nó phụ thuộc vào. Mỗi tầng (app, feature, domain, integrations, platform) chỉ được nhìn xuống các tầng liệt kê trong bảng; hai feature import nhau là mã riêng BE_FEATURE_IMPORTS_FEATURE, và import chỉ kiểu (type-only) cũng tính như import thật."
+  causes_vi:
+    - "Một module domain, integrations hoặc platform import ngược lên feature hoặc app"
+    - "Một module platform import domain hoặc integrations"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để đưa phần dùng chung xuống đúng tầng (domain hoặc platform) rồi cho cả hai bên import từ đó; không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+FE_APP_ISOLATION:
+  title: "App imports another app"
+  title_vi: "Một app import app khác"
+  meaning_vi: "Một app trong apps/ import mã nguồn của app khác. Các app độc lập, build và triển khai riêng; mã dùng chung phải nằm trong một gói packages/<pkg>."
+  causes_vi:
+    - "Import đường dẫn tương đối hoặc bí danh trỏ sang apps/<app-khác>/src"
+    - "Sao chép cách dùng chung bằng import thay vì tạo gói dùng chung"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để chuyển phần dùng chung vào một gói packages/<pkg> hoặc nhân bản có chủ đích; nếu cần ô gói mới thì người giám sát thêm ô vào bảng kê."
+  owner: op-retry
+  kind: check-finding
+
+FE_BLOCK_PRODUCT_HOOK_DEFINITION:
+  title: "Block defines a product hook"
+  title_vi: "Khối giao diện tự định nghĩa hook sản phẩm"
+  meaning_vi: "Một block định nghĩa luôn vòng đời dữ liệu của sản phẩm, trong khi block chỉ được gọi hook có sẵn từ thư mục hooks."
+  causes_vi:
+    - "Viết hook dữ liệu ngay trong file block"
+    - "Trộn logic thế giới sản phẩm vào block"
+  nextStep_vi: "Op interface.implement chuyển hook sang thư mục hooks và để block chỉ gọi nó."
+  owner: other-op:interface.implement
+  kind: check-finding
+
+FE_CLIENT_REACHES_SERVER:
+  title: "Client module reaches a server-only import"
+  title_vi: "Mô-đun client với tới import chỉ dành cho máy chủ"
+  meaning_vi: "Một mô-đun có chỉ thị `\"use client\"` với tới, qua chuỗi import chạy thật (nhiều bước, không tính import chỉ-kiểu), một mô-đun import `server-only`, `next/headers`, `next/server`, `next-intl/server`, `node:*` hoặc `fs`. Lời nhắn nêu client đầu vào và cả chuỗi import."
+  causes_vi:
+    - "Hook hoặc module dùng chung được client component import gián tiếp lại đọc request ở máy chủ"
+    - "Reader máy chủ bị import từ đường đi của một client component thay vì chỉ từ server component"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để đọc dữ liệu ở server component và truyền xuống bằng props, hoặc đưa import ra khỏi đồ thị client theo lời nhắn; không thêm ngoại lệ."
+  owner: op-retry
+  kind: check-finding
+
+FE_COMPONENT_DEEP_HOOK_IMPORT:
+  title: "Component imports a hook too deeply"
+  title_vi: "Thành phần nhập hook quá sâu"
+  meaning_vi: "Thành phần giao diện nhập hook dữ liệu không qua cửa (barrel) của thư mục hooks."
+  causes_vi:
+    - "Nhập thẳng tệp hook thay vì qua barrel"
+    - "Đường nhập đi vòng qua nhiều tầng"
+  nextStep_vi: "Op interface.implement đổi sang nhập qua barrel hooks của nơi sở hữu."
+  owner: other-op:interface.implement
+  kind: check-finding
+
+FE_COMPONENT_WORLD_OWNERSHIP:
+  title: "Component owns product-world state"
+  title_vi: "Thành phần nắm trạng thái của thế giới sản phẩm"
+  meaning_vi: "Một thành phần cấp thấp tự giữ dữ liệu, điều hướng, ngôn ngữ hoặc phiên, trong khi chỉ được xử lý tương tác trình duyệt đơn giản."
+  causes_vi:
+    - "Gọi hook điều hướng hoặc ngôn ngữ trong thành phần thuần"
+    - "Đặt vòng đời dữ liệu ở tầng sai"
+  nextStep_vi: "Op interface.implement chuyển phần này lên thành phần kết nối (index.tsx) của tầng sở hữu."
+  owner: other-op:interface.implement
+  kind: check-finding
+
+FE_CONNECTED_BLOCK_RENDER_PAIR:
+  title: "Connected block lacks pure render twin"
+  title_vi: "Khối kết nối thiếu bản render thuần đi kèm"
+  meaning_vi: "Block kết nối (index.tsx) không giao mọi đường render cho hàm thuần trong component.tsx cùng cấp."
+  causes_vi:
+    - "Viết JSX trực tiếp trong index.tsx"
+    - "Chưa có bản thuần trong component.tsx"
+  nextStep_vi: "Op interface.implement tách phần hiển thị sang component.tsx và để index.tsx chỉ nối dữ liệu."
+  owner: other-op:interface.implement
+  kind: check-finding
+
+FE_CROSS_APP_DUPLICATE:
+  title: "File copied between apps"
+  title_vi: "Tệp chép nguyên giữa các app"
+  meaning_vi: "Hai tệp TypeScript của hai app khác nhau có nội dung token giống hệt (bỏ qua chú thích và khoảng trắng, giữ tên định danh), kể cả tệp trong cây route. Mã dùng chung là slot `packages/<pkg>`; tệp chỉ gồm import hoặc export lại một ký hiệu của gói thì được phép."
+  causes_vi:
+    - "Tệp route hoặc helper được chép từ app này sang app khác thay vì đưa vào gói dùng chung"
+    - "Mỗi app tự giữ một bản `error.tsx`, `not-found.tsx`, `i18n/request.ts` hay helper kiểm thử giống hệt nhau"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để chuyển mã vào một gói `packages/<pkg>` và để mỗi app chỉ re-export ký hiệu của gói theo lời nhắn; không thêm ngoại lệ."
+  owner: op-retry
+  kind: check-finding
+
+FE_CUSTOM_HOOK_LOCATION:
+  title: "Custom hook declared outside hooks root"
+  title_vi: "Hook tự viết nằm ngoài thư mục hooks"
+  meaning_vi: "Một hook useX do dự án tự viết được khai báo ngoài thư mục hooks đã cấu hình."
+  causes_vi:
+    - "Viết hook ngay trong file thành phần"
+    - "Đặt hook ở thư mục khác"
+  nextStep_vi: "Op interface.implement chuyển hook vào thư mục hooks."
+  owner: other-op:interface.implement
+  kind: check-finding
+
+FE_ERROR_BOUNDARY_MISSING:
+  title: "Next app lacks a required error or loading boundary"
+  title_vi: "Ứng dụng Next thiếu trang lỗi hoặc trang đang tải bắt buộc"
+  meaning_vi: "Mỗi ứng dụng Next phải có global-error.tsx, error.tsx, not-found.tsx và loading.tsx trong src/app theo bảng kê HFS. Thiếu chúng thì khi trang gặp lỗi, không tìm thấy hoặc đang tải, người dùng sẽ thấy màn hình mặc định của khung phần mềm hoặc màn hình trắng thay vì giao diện của sản phẩm."
+  causes_vi:
+    - "Ứng dụng mới được dựng mà chưa thêm các trang biên lỗi"
+    - "Trang lỗi được đặt sai thư mục, ví dụ ngoài src/app/[locale]/"
+    - "Tệp bị xoá hoặc đổi tên trong lúc dọn dẹp"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để thêm tệp còn thiếu vào đúng src/app hoặc src/app/[locale]; giao diện của các trang này do người thiết kế duyệt."
+  owner: op-retry
+  kind: check-finding
+
+FE_HOOKS_ARE_HOOKS:
+  title: "`hooks/` hold hooks and one shared file per domain"
+  title_vi: "hooks/ chứa thứ không phải hook"
+  meaning_vi: "`<file>` trong `hooks/` không phải React hook, hoặc một domain có nhiều hơn một tệp `.shared.ts` (hay tệp shared không mang tên domain), hoặc một helper được khai báo ở nhiều tệp của domain. Reader server về `modules/api`, helper về `<domain>.shared.ts`."
+  causes_vi:
+    - "Vi phạm luật R56: `hooks/<domain>/` chỉ chứa `use*.ts` và một `<domain>.shared.ts` cho helper dùng chung; reader server nằm ở `modules/api/<domain>/read-*.ts` (bọc `cache()`)."
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra (nợ hàng loạt có codemod của HFS); không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+FE_HREF_RESOLVES:
+  title: "Link points to a route that does not exist"
+  title_vi: "Liên kết trỏ tới đường dẫn không tồn tại"
+  meaning_vi: "Một liên kết viết thẳng trong code (href, redirect hoặc router.push) trỏ tới đường dẫn mà không tệp page.tsx hay route.ts nào của ứng dụng phục vụ. Người dùng bấm vào sẽ gặp trang 404."
+  causes_vi:
+    - "Gõ sai đường dẫn hoặc đổi tên route mà quên sửa liên kết"
+    - "Route đã bị xoá hoặc chưa được tạo"
+    - "Thiếu một tham số động trong đường dẫn so với cấu trúc thư mục route"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa liên kết cho khớp route thật hoặc tạo route còn thiếu; không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+FE_I18N_CATALOG:
+  title: "Same keys in every catalog, real catalog in specs, `pick` for clients"
+  title_vi: "Catalog ngôn ngữ lệch key"
+  meaning_vi: "Catalog `<locale>` thiếu/thừa key `<k>`."
+  causes_vi:
+    - "Vi phạm luật R60: Catalog các locale cùng tập key; không key thừa/thiếu; spec dùng catalog thật (không mock `useTranslations` trả key); catalog tách namespace, client chỉ nhận `pick`."
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra; không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+FE_I18N_KEYS:
+  title: "Catalog keys and the source that reads them agree"
+  title_vi: "Khóa catalog và mã nguồn đọc chúng không khớp"
+  meaning_vi: "Mã nguồn đọc khóa `<key>` mà một locale không có, hoặc catalog `<f>` giữ khóa `<key>` mà không đoạn mã nào của app hay của package dùng chung đọc tới."
+  causes_vi:
+    - "Vi phạm luật R106: khóa đọc bằng literal qua `next-intl` (`t`, `t.rich`, `t.raw`, `t.markup`) phải có trong mọi locale; khóa của catalog mà không chuỗi nào trong mã nguồn có thể đang đọc thì phải xóa."
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra: thêm khóa vào mọi catalog của app hoặc đọc khóa có thật; xóa khóa chết khỏi mọi catalog; không thêm ngoại lệ."
+  owner: op-retry
+  kind: check-finding
+
+FE_I18N_PLACEMENT:
+  title: "`next-intl`, `[locale]`, `modules/i18n/`"
+  title_vi: "i18n sai chuẩn next-intl"
+  meaning_vi: "i18n của app `<a>` không theo chuẩn (`<detail>`)."
+  causes_vi:
+    - "Vi phạm luật R59: `next-intl`, segment `[locale]`, `modules/i18n/{config,routing,navigation,request}.ts` + `modules/i18n/messages/<locale>.json`; app một ngôn ngữ vẫn dùng next-intl với một locale."
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra (nợ hàng loạt có codemod của HFS); không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+FE_NO_TESTS:
+  title: "Front end holds a test file, test tooling or a test dependency"
+  title_vi: "Front end có tệp test, công cụ test hoặc thư viện test"
+  meaning_vi: "Chuẩn của front end là không có test: repository có spec, e2e, cấu hình vitest, Playwright hay jest, script test, hoặc khai báo thư viện chạy test, dựng môi trường test, testing-library, axe trong package.json."
+  causes_vi:
+    - "Viết spec hoặc e2e cho component, hook hay trang"
+    - "Thêm vitest, Playwright, jest, testing-library hoặc axe vào package.json"
+    - "Thêm script test hoặc cấu hình test vào repository front end"
+  nextStep_vi: "Xóa tệp, cấu hình, script và thư viện test đó; front end không có ngoại lệ, kể cả thư mục scripts/. Kiểm tra giao diện bằng lint, typecheck và hfs check."
+  owner: op-retry
+  kind: check-finding
+
+FE_OWNER_REACHABLE:
+  title: "Page feature not mounted by a route"
+  title_vi: "Feature trang chưa được route nào gắn vào"
+  meaning_vi: "Một feature trang, layout hoặc overlay của frontend không có đường import chạy thật từ bất kỳ tệp nào trong cây route của ứng dụng (thư mục src/app). Người dùng sẽ không bao giờ thấy nó vì không route nào hiển thị."
+  causes_vi:
+    - "Quên import feature vào page.tsx hoặc layout.tsx tương ứng"
+    - "Route chỉ import kiểu của feature chứ không render nó"
+    - "Feature đã bị thay thế nhưng thư mục cũ vẫn còn"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để gắn feature vào route đúng hoặc xoá feature không dùng; không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+FE_PACKAGE_SHAPE:
+  title: "Packages build to `dist` with explicit exports and no dead unit"
+  title_vi: "Gói dùng chung sai hình dạng"
+  meaning_vi: "Package `<p>` export source chưa build (hoặc `export *`, hoặc unit không ai dùng)."
+  causes_vi:
+    - "Vi phạm luật R63: `packages/*` build ra `dist`, `exports` tường minh, không `export *`, không unit chết; package UI chỉ chứa composites/branches/leaves + CSS token của family."
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra và mục của luật trong tiêu chuẩn HFS; nợ cũ cần quyết định thiết kế nên op không thêm ngoại lệ, chỉ tách hoặc chuyển về đúng chủ."
+  owner: op-retry
+  kind: check-finding
+
+FE_PURE_REACHES_DATA:
+  title: "Pure component reaches hooks or API"
+  title_vi: "Thành phần thuần chạm tới hook hoặc API"
+  meaning_vi: "Tệp component.tsx thuần lại nhập được hook hoặc lớp truyền tải API, kể cả qua alias hay barrel."
+  causes_vi:
+    - "Nhập hook dữ liệu vào thành phần thuần"
+    - "Đường nhập gián tiếp đưa hook vào"
+  nextStep_vi: "Op interface.implement đưa phần dữ liệu lên index.tsx kết nối và giữ component.tsx thuần."
+  owner: other-op:interface.implement
+  kind: check-finding
+
+FE_PURE_WORLD_HOOK:
+  title: "Pure component uses a world hook"
+  title_vi: "Thành phần thuần dùng hook của thế giới sản phẩm"
+  meaning_vi: "Tệp component.tsx thuần dùng hook về trạng thái thế giới, thứ mà index.tsx kết nối mới được giữ."
+  causes_vi:
+    - "Gọi hook điều hướng, ngôn ngữ hay phiên trong thành phần thuần"
+    - "Chưa tách bản thuần khỏi bản kết nối"
+  nextStep_vi: "Op interface.implement chuyển hook sang index.tsx và truyền dữ liệu xuống qua props."
+  owner: other-op:interface.implement
+  kind: check-finding
+
+FE_PURE_WORLD_IMPORT:
+  title: "Pure component imports router or locale"
+  title_vi: "Thành phần thuần nhập bộ định tuyến hoặc ngôn ngữ"
+  meaning_vi: "Tệp component.tsx thuần nhập module về định tuyến hoặc ngôn ngữ, việc chỉ index.tsx kết nối được làm."
+  causes_vi:
+    - "Nhập next/navigation hoặc thư viện dịch trong thành phần thuần"
+    - "Bản thuần và bản kết nối chưa được tách"
+  nextStep_vi: "Op interface.implement bỏ nhập này khỏi component.tsx và để index.tsx truyền vào."
+  owner: other-op:interface.implement
+  kind: check-finding
+
+FE_ROUTE_CLIENT_BOUNDARY:
+  title: "Route page owns client boundary"
+  title_vi: "Trang route tự khai báo phía client"
+  meaning_vi: "Tệp page.tsx mang chỉ thị client, việc này route adapter phía máy chủ không được làm."
+  causes_vi:
+    - "Thêm use client vào page.tsx"
+    - "Gộp giao diện tương tác vào route"
+  nextStep_vi: "Op interface.implement bỏ chỉ thị client khỏi page.tsx và đặt nó ở thành phần được mount."
+  owner: other-op:interface.implement
+  kind: check-finding
+
+FE_ROUTE_CLIENT_HOOK:
+  title: "Server route imports a client hook"
+  title_vi: "Route máy chủ nhập hook phía client"
+  meaning_vi: "Tệp page.tsx phía máy chủ nhập hook chỉ dùng được ở phía client."
+  causes_vi:
+    - "Dùng useX ngay trong page.tsx"
+    - "Nhập hook vào route thay vì thành phần"
+  nextStep_vi: "Op interface.implement chuyển hook sang thành phần được page.tsx mount."
+  owner: other-op:interface.implement
+  kind: check-finding
+
+FE_ROUTE_DEFAULT_EXPORT:
+  title: "Page has no single default export"
+  title_vi: "Trang route thiếu một export mặc định duy nhất"
+  meaning_vi: "Tệp page.tsx phải mặc định export đúng một hàm route cục bộ nhưng không làm vậy."
+  causes_vi:
+    - "Thiếu export default"
+    - "Export mặc định là thứ khác hàm route"
+  nextStep_vi: "Op interface.implement khai báo const Page và kết thúc bằng export default Page."
+  owner: other-op:interface.implement
+  kind: check-finding
+
+FE_ROUTE_DRAWING_DECISION:
+  title: "Route makes a visual composition choice"
+  title_vi: "Route tự quyết định bố cục hiển thị"
+  meaning_vi: "Tệp route chọn hoặc bỏ phần bố cục hình ảnh, việc chỉ redirect hoặc notFound mới được làm."
+  causes_vi:
+    - "Có điều kiện chọn giao diện ngay trong page.tsx"
+    - "Trộn logic hiển thị vào route"
+  nextStep_vi: "Op interface.implement đưa quyết định bố cục vào thành phần trang, route chỉ còn redirect hoặc notFound."
+  owner: other-op:interface.implement
+  kind: check-finding
+
+FE_ROUTE_FILES_THIN:
+  title: "Route files mount one owner; Next conventions (`proxy.ts`, metadata)"
+  title_vi: "Tệp route không mỏng"
+  meaning_vi: "Tệp route `<file>` `<what>`. Route chỉ nhận input framework rồi mount một owner."
+  causes_vi:
+    - "Vi phạm luật R54: Luật route áp cho mọi tệp route (`page/layout/template/loading/not-found`): không component inline, không vẽ, không hook; `force-dynamic` cấm trên page client; redirect cũ nằm ở `next.config` `redirects()`."
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra; không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+FE_ROUTE_ONE_PAGE:
+  title: "Route must mount exactly one page"
+  title_vi: "Route phải mount đúng một thành phần trang"
+  meaning_vi: "Tệp page.tsx phải mount đúng một thành phần cấp trang, hoặc chỉ redirect và notFound không có JSX."
+  causes_vi:
+    - "Mount nhiều thành phần hoặc thành phần sai tầng"
+    - "Vừa có JSX vừa redirect"
+  nextStep_vi: "Op interface.implement sửa route để chỉ mount một thành phần trang."
+  owner: other-op:interface.implement
+  kind: check-finding
+
+FE_SLOT_FILE_ROLE:
+  title: "A front-end file is owned by a slot and named by it"
+  title_vi: "Tệp không đúng vai trò trong slot"
+  meaning_vi: "Tệp `<f>` nằm trong slot `<s>` nhưng tên của nó không thuộc danh sách `allows` của slot (ví dụ `page.tsx` trong hooks, đoạn `[lang]` dưới `app/`, `*.test.tsx` cạnh component), hoặc là tệp đặt ở chỗ slot cần một thư mục."
+  causes_vi:
+    - "Vi phạm luật R94: mỗi slot thư mục của front end (route, feature, components, hooks, modules/api) chỉ chứa các tệp mà `allows` của nó gọi tên, và chứa chúng trong thư mục riêng; tệp không slot nào sở hữu là HFS_PATH_NO_SLOT."
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra: đổi tên tệp về vai trò được phép hoặc chuyển nó về slot đúng; không thêm ngoại lệ."
+  owner: op-retry
+  kind: check-finding
+
+FE_SOURCE_LAYOUT_INVALID:
+  title: "Frontend source in wrong folder"
+  title_vi: "Mã giao diện nằm sai thư mục"
+  meaning_vi: "Mã sản phẩm frontend không thuộc app, features, components, hooks hoặc modules, cũng không phải tệp gốc framework yêu cầu."
+  causes_vi:
+    - "Đặt tệp ở thư mục không có chủ sở hữu"
+    - "Tính năng chứa thứ không phải trang, layout hay overlay"
+  nextStep_vi: "Op interface.implement chuyển tệp về đúng thư mục theo cấu trúc chuẩn."
+  owner: other-op:interface.implement
+  kind: check-finding
+
+FE_SWR_KEY_IDENTITY:
+  title: "SWR key misses an identity"
+  title_vi: "Khóa SWR thiếu thông tin định danh"
+  meaning_vi: "Hook SWR không dùng null khi thiếu đầu vào hoặc khóa chưa chứa đủ định danh của kết quả."
+  causes_vi:
+    - "Khóa thiếu định danh người xem hoặc tham số"
+    - "Không trả null khi thiếu đầu vào"
+  nextStep_vi: "Op interface.implement sửa khóa để chứa đủ định danh và dùng null khi thiếu đầu vào."
+  owner: other-op:interface.implement
+  kind: check-finding
+
+FE_SWR_MUTATION_RESOURCE_IDENTITY:
+  title: "SWR mutation not tied to resource"
+  title_vi: "Thao tác ghi SWR chưa gắn với tài nguyên"
+  meaning_vi: "Thao tác thay đổi dữ liệu của hook SWR không giữ định danh tài nguyên mà nó tác động."
+  causes_vi:
+    - "Mutation dùng khóa chung không chỉ tài nguyên"
+    - "Thiếu định danh tài nguyên khi làm mới"
+  nextStep_vi: "Op interface.implement gắn định danh tài nguyên vào khóa của thao tác ghi."
+  owner: other-op:interface.implement
+  kind: check-finding
+
+FE_TIER_DIRECTION:
+  title: "Frontend import against the tier direction"
+  title_vi: "Frontend import ngược chiều tầng"
+  meaning_vi: "Một tệp frontend import từ tầng mà bảng kê HFS không cho phép: route chỉ nhìn xuống feature, feature chỉ nhìn xuống components, hooks và modules, hai feature không bao giờ import nhau, và một lớp component chỉ import các lớp đứng sau nó (blocks, composites, branches, leaves)."
+  causes_vi:
+    - "Một feature import một feature khác thay vì đưa phần dùng chung xuống components, hooks hoặc modules"
+    - "Một component import ngược lên lớp cao hơn hoặc lên feature"
+    - "Một module import hooks hoặc components"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để chuyển phần dùng chung xuống tầng thấp hơn rồi cho cả hai bên import từ đó; không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+FE_TRANSPORT_OWNER:
+  title: "One `fetch`, in the repository's one transport client, with timeout and abort"
+  title_vi: "fetch ngoài client duy nhất"
+  meaning_vi: "`fetch` ở `<file>` ngoài client truyền tải duy nhất của repository (gọi, gán lại hoặc truyền như giá trị), thư viện HTTP khác được import, reader `read-*.ts` không đi qua client, repository có nhiều hơn một client hoặc nhiều hơn một union `Outcome` (mỗi app giữ một bản, hoặc gói api cộng thêm một bản của app), hoặc state dùng chung dạng `let`."
+  causes_vi:
+    - "Vi phạm luật R50: Mỗi repository đúng một client `fetch`, có timeout + `AbortSignal`: `packages/<family>-api/src/client.ts` khi các app dùng chung, hoặc `modules/api/client.ts` của app duy nhất; không singleton `let` giữ token/locale; credential truyền bằng tham số/context."
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra và mục của luật trong tiêu chuẩn HFS; nợ cũ cần quyết định thiết kế nên op không thêm ngoại lệ, chỉ tách hoặc chuyển về đúng chủ."
+  owner: op-retry
+  kind: check-finding
+
+FE_WIRE_GENERATED:
+  title: "Wire types generated from the contract copy"
+  title_vi: "Kiểu wire gõ tay"
+  meaning_vi: "`<file>` tự gõ kiểu wire/ép kiểu phản hồi. Dùng kiểu sinh từ `contract/`."
+  causes_vi:
+    - "Vi phạm luật R52: Kiểu wire sinh từ bản hợp đồng (`codegen`); tài liệu GraphQL trong `.graphql`; cấm `as GraphqlResult<T>`; enum wire không phải `string`."
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra và mục của luật trong tiêu chuẩn HFS; nợ cũ cần quyết định thiết kế nên op không thêm ngoại lệ, chỉ tách hoặc chuyển về đúng chủ."
+  owner: op-retry
+  kind: check-finding
+
+FE_WORLD_OWNER_RENDER_BOUNDARY:
+  title: "World-state owner renders inline"
+  title_vi: "Nơi giữ trạng thái sản phẩm tự render trực tiếp"
+  meaning_vi: "Thành phần đọc trạng thái sản phẩm không giao mọi đường render cho hàm hoặc thành phần thuần đã xác định."
+  causes_vi:
+    - "Viết JSX trực tiếp trong thành phần đọc dữ liệu"
+    - "Chưa có thành phần thuần tương ứng"
+  nextStep_vi: "Op interface.implement tách phần hiển thị sang thành phần thuần và giao cho nó."
+  owner: other-op:interface.implement
+  kind: check-finding
+
+HFS_ALIAS_REEXPORT:
+  title: "A declaration re-exported under a second name"
+  title_vi: "Xuất lại một khai báo dưới tên thứ hai"
+  meaning_vi: "Mã sản xuất dùng `export { X as Y }`, `export { default as Y }`, `export * as ns`, hoặc khai báo xuất `const Y = X`, `type Y = X`, `interface Y extends X {}` chỉ để đặt tên thứ hai cho một khai báo khác của repo: một khai báo có hai tên, nên người đọc và công cụ tìm kiếm phải đoán hai tên là một. Luật áp cho cả backend lẫn frontend."
+  causes_vi:
+    - "Cửa vào của owner đổi tên một khai báo để tránh trùng tên với khai báo cùng tên ở owner khác"
+    - "Đổi tên tạm để giữ tên cũ cho nơi dùng cũ"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để đổi tên chính khai báo cho đúng nghĩa, hoặc import và xuất nó bằng tên của nó; không giữ tên cũ song song."
+  owner: op-retry
+  kind: check-finding
+
+HFS_APPS_REQUIRED:
+  title: "Repository has no apps directory"
+  title_vi: "Kho mã không có thư mục apps"
+  meaning_vi: "Kho HFS phải là monorepo apps/<app>/ và có ít nhất một ứng dụng nhưng chưa có."
+  causes_vi:
+    - "Chưa tạo thư mục apps"
+    - "Mã còn nằm ở gốc kho"
+  nextStep_vi: "Op dựng khung (backend.scaffold hoặc interface.scaffold) tạo apps/<app> theo bố cục HFS."
+  owner: other-op:backend.scaffold
+  kind: check-finding
+
+HFS_APP_LAYOUT_INVALID:
+  title: "App directory layout invalid"
+  title_vi: "Bố cục thư mục ứng dụng chưa đúng"
+  meaning_vi: "Mục dưới apps/ không phải thư mục, hoặc thiếu các tệp mà slot của loại ứng dụng đó yêu cầu (requires; ví dụ ứng dụng migrate không cần app.module.ts)."
+  causes_vi:
+    - "Có tệp lẻ trong apps/"
+    - "Ứng dụng thiếu tệp bắt buộc"
+  nextStep_vi: "Op dựng khung sửa bố cục ứng dụng theo HFS rồi kiểm tra lại."
+  owner: other-op:backend.scaffold
+  kind: check-finding
+
+HFS_ARCH_CONFIG_UNREAD:
+  title: "The machine reads `hfs.json`; zero files analysed is red"
+  title_vi: "Máy kiến trúc không đọc được hfs.json"
+  meaning_vi: "Kiểm tra kiến trúc không đọc được `hfs.json` phân tích 0 tệp, hoặc repo còn một tệp cấu hình mà máy không đọc nữa (`architecture.json`) — đây là đỏ, không phải 'chưa có dữ liệu'."
+  causes_vi:
+    - "Vi phạm luật R24: Máy kiến trúc tự đọc `hfs.json`; phân tích 0 tệp hay `unavailable` cho một profile đã khai = thất bại."
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra; không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
 HFS_CANON_PIN_DRIFT:
   title: "Dependency version differs from the canon pin"
   title_vi: "Phiên bản phụ thuộc lệch khỏi bản đã ghim"
@@ -10,6 +980,26 @@ HFS_CANON_PIN_DRIFT:
   owner: op-retry
   kind: check-finding
 
+HFS_CI_MISSING_CANON:
+  title: "CI runs the pinned `@starci/hfs check`; pre-push runs typecheck and lint"
+  title_vi: "CI thiếu bước canon"
+  meaning_vi: "Workflow/husky thiếu bước `<step>`. Cấu trúc chỉ được kiểm khi agent chạy — CI phải tự kiểm."
+  causes_vi:
+    - "Vi phạm luật R13: CI phải chạy `npx @starci/hfs check` (bản pin); pre-push phải có `typecheck` + `lint:check`."
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra (nợ hàng loạt có codemod của HFS); không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+HFS_CONTRACT_SNAPSHOT_DRIFT:
+  title: "Contract snapshot equals the emit, the FE copy equals the BE"
+  title_vi: "Bản hợp đồng lệch bản thật"
+  meaning_vi: "Hợp đồng `<file>` lệch bản thật (`<sha>` ≠ `<sha>`). Chạy `npm run contract:emit` (BE) / `contract:pull` (FE) rồi commit kết quả. Nếu emit không chạy được thì finding nêu nguyên văn lỗi của emit; không bao giờ bỏ qua âm thầm."
+  causes_vi:
+    - "Vi phạm luật R23: BE: `contracts/<app>/schema.graphql` và `contracts/<app>/openapi.json` (sinh từ bảng thao tác có kiểu `apps/<app>/src/operations.ts`) phải bằng bản `hfs emit-contracts` phát ra ngay lúc kiểm tra (đồ thị module đọc từ mã nguồn, không cần env, DB hay mạng); chỉ chạy ở lượt kiểm tra đầy đủ, `--fast` bỏ qua và nói rõ trong phần coverage. FE: `modules/api/contract/*` bằng bản BE (so hash)."
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra; không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
 HFS_DECLARATION_INVALID:
   title: "hfs.json missing or invalid"
   title_vi: "hfs.json thiếu hoặc sai định dạng"
@@ -23,6 +1013,71 @@ HFS_DECLARATION_INVALID:
   owner: op-retry
   kind: check-finding
 
+HFS_DEP_VERSION_SKEW:
+  title: "One version per dependency in the workspace"
+  title_vi: "Một gói nhiều phiên bản"
+  meaning_vi: "`<pkg>` có `<n>` version trong workspace (`<list>`). Chỉ được một."
+  causes_vi:
+    - "Vi phạm luật R14: Mỗi dependency một version trong workspace; cấm bản sao lồng thứ hai (`apps/*/node_modules/@starci/grammar`)."
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra (nợ hàng loạt có codemod của HFS); không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+HFS_DOC_NOT_ENGLISH:
+  title: "Document is not English"
+  title_vi: "Tài liệu không viết bằng tiếng Anh"
+  meaning_vi: "Tệp Markdown hoặc YAML trong knowledge/, docs/, src/ hoặc apps/ có chữ cái tiếng Việt (kể cả trong khối mã của Markdown); tài liệu, mẫu và ví dụ phải viết bằng tiếng Anh."
+  causes_vi:
+    - "Viết hoặc dán đoạn tiếng Việt vào tài liệu, mẫu, ví dụ hay lời trích của chủ dự án"
+    - "Đặt dữ liệu YAML có tiếng Việt ngoài slot danh mục thông điệp hoặc slot fixture i18n"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra: dịch dòng được nêu sang tiếng Anh. Chỉ dữ liệu YAML trong slot danh mục thông điệp hoặc slot fixture i18n được giữ tiếng khác; không thêm ngoại lệ."
+  owner: op-retry
+  kind: check-finding
+
+HFS_DUPLICATE_CODE:
+  title: "Duplicated code block"
+  title_vi: "Mã trùng lặp"
+  meaning_vi: "Một đoạn mã (bỏ qua khác biệt về tên biến và giá trị chữ hoặc số) xuất hiện hai lần trong mã sản phẩm: ở hai chủ sở hữu, ở hai tệp của một chủ sở hữu, hoặc hai lần trong một tệp. Ngưỡng số dòng và số token là một định nghĩa duy nhất trong ruleParams.<profile>.duplicateBlock của knowledge/hfs/slots.yaml; lời nhắn của bộ kiểm tra ghi rõ ngưỡng và hai vị trí."
+  causes_vi:
+    - "Op cần một hàm hỗ trợ đã có ở nơi khác nhưng chép lại thay vì dùng chung"
+    - "Hai nơi cùng tự viết một logic giống nhau vì chưa ai đưa nó vào chỗ dùng chung"
+    - "Đoạn mã được chép nguyên rồi chỉ đổi tên biến hoặc hằng số"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để đưa đoạn mã về một chỗ duy nhất theo lời nhắn (trong cùng chủ sở hữu, hoặc src/modules/platform/primitives, module miền của năng lực đó, hay packages/* với FE) rồi gọi từ cả hai nơi; không thêm ngoại lệ."
+  owner: op-retry
+  kind: check-finding
+
+HFS_DUPLICATE_SYMBOL:
+  title: "One exported name declared in two files"
+  title_vi: "Một tên xuất được khai báo ở hai tệp"
+  meaning_vi: "Một tên mà cửa vào công khai (index.ts) của một chủ sở hữu xuất ra, truy về tệp khai báo nó, cũng được một tệp sản xuất khác của repo khai báo và xuất ra (hàm, lớp, hằng, enum, kiểu, interface). Hai bản khai báo cùng tên khiến import nhầm một bản mà trình biên dịch không báo, ví dụ hai decorator cùng tên InjectPrimaryEntityManager cho hai kết nối khác nhau. Việc xuất lại (re-export) một khai báo duy nhất không phải là bản thứ hai. Không có danh sách tên được miễn."
+  causes_vi:
+    - "Hai module cùng tự viết một helper, decorator hoặc kiểu với cùng một tên thay vì dùng chung một bản"
+    - "Mỗi kết nối hoặc mỗi ứng dụng chép nguyên một tệp rồi giữ nguyên tên xuất"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để giữ đúng một khai báo (dùng chung qua cửa vào của chủ sở hữu thích hợp) hoặc đổi tên bản còn lại cho đúng nghĩa của nó; không thêm ngoại lệ."
+  owner: op-retry
+  kind: check-finding
+
+HFS_E2E_IN_AUTOMATIC_GATE:
+  title: "E2E runs in automatic gate"
+  title_vi: "Kiểm thử e2e nằm trong cổng tự động"
+  meaning_vi: "Hook husky hoặc script tự động gọi cả kiểm thử e2e, trong khi e2e không được nằm trong cổng tự động."
+  causes_vi:
+    - "Pre-commit hoặc pre-push chạy e2e"
+    - "Script lint:check kéo e2e vào"
+  nextStep_vi: "Op backend.scaffold gỡ e2e khỏi hook và script tự động."
+  owner: other-op:backend.scaffold
+  kind: check-finding
+
+HFS_EMPTY_DIR:
+  title: "No empty directory outside an `ignored` slot"
+  title_vi: "Thư mục rỗng còn sót lại"
+  meaning_vi: "Có thư mục không có tệp nào bên dưới (kể cả các thư mục con cũng rỗng). Git không theo dõi thư mục rỗng nên nó chỉ là dấu vết của cấu trúc đã đổi tên hoặc đã xóa. Xóa thư mục."
+  causes_vi:
+    - "Vi phạm luật R03: cấu trúc bị đổi tên hoặc tệp bị xóa mà thư mục cũ không được dọn (vd `src/modules/business/*` còn trống bên cạnh `domain/*`)."
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra (nợ hàng loạt có codemod của HFS); không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
 HFS_FORBIDDEN_PRESENT:
   title: "Tracked path in a forbidden slot"
   title_vi: "Có tệp bị cấm trong cây mã nguồn"
@@ -35,6 +1090,57 @@ HFS_FORBIDDEN_PRESENT:
   owner: op-retry
   kind: check-finding
 
+HFS_FORMAT:
+  title: "Prettier is the only formatter"
+  title_vi: "Chưa format bằng Prettier"
+  meaning_vi: "`<file>` chưa được format. Chạy `npm run format`."
+  causes_vi:
+    - "Vi phạm luật R19: Prettier (config `@starci/prettier-config`) là formatter duy nhất; ESLint không còn luật định dạng."
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra (nợ hàng loạt có codemod của HFS); không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+HFS_FORMAT_TOOL_MISSING:
+  title: "The repository's own prettier is not installed"
+  title_vi: "Kho chưa cài prettier của chính nó"
+  meaning_vi: "Kiểm tra định dạng (R19) chạy prettier của chính kho. Kho chưa cài prettier nên không thể xác nhận định dạng, và trạng thái đó không bao giờ được tính là đạt."
+  causes_vi:
+    - "Chưa chạy `npm ci` trong kho"
+    - "prettier không nằm trong devDependencies của kho"
+  nextStep_vi: "Cài đúng phiên bản prettier ghi trong canon-pins.yaml (`npm ci`) rồi chạy lại `hfs check`."
+  owner: op-retry
+  kind: input-invalid
+
+HFS_GHOST_TREE:
+  title: "No empty directory beside a near-identical sibling"
+  title_vi: "Cây thư mục ma cạnh thư mục gần trùng tên"
+  meaning_vi: "Có thư mục rỗng mà tên chỉ khác vài ký tự so với thư mục anh em cùng cấp (thông báo nêu cả hai), tức là bản đổi tên hoặc gõ sai của cùng một cấu trúc chưa được dọn. Giữ bản có tệp, xóa bản rỗng."
+  causes_vi:
+    - "Vi phạm luật R03: đổi tên cấu trúc để lại bản cũ hoặc bản gõ sai (vd `business` và `bussiness`)."
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra (nợ hàng loạt có codemod của HFS); không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+HFS_GITIGNORE_BLOCK_DRIFT:
+  title: "The managed `.gitignore` block equals its render"
+  title_vi: "Khối .gitignore lệch bản render"
+  meaning_vi: "Khối .gitignore chuẩn đã bị sửa tay hoặc thiếu dòng `<rule>`. Chạy `hfs sync`."
+  causes_vi:
+    - "Vi phạm luật R04: Khối `.gitignore` do `.claude` quản lý phải trùng bản render (never-tracked list, deny `.env*`, cache)."
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra (nợ hàng loạt có codemod của HFS); không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+HFS_HOOKS_PATH_REDIRECTED:
+  title: "A clone redirects core.hooksPath away from husky"
+  title_vi: "core.hooksPath bị đổi hướng khỏi husky"
+  meaning_vi: "Cấu hình Git cục bộ của bản clone đặt `core.hooksPath` trỏ ra ngoài `.husky`, nên hook pre-commit và pre-push không chạy và cổng mà mọi clone khác phải qua đã bị bỏ qua. Chỉ xét khi thư mục được kiểm tra chính là gốc work tree Git của nó; một thư mục nằm trong clone khác (một ví dụ trong clone runtime) không có hook riêng nên không bị xét."
+  causes_vi:
+    - "Vi phạm luật R13: pre-push chạy typecheck và lint, và không clone nào được đổi `core.hooksPath` để né husky; giá trị duy nhất được phép là `.husky` hoặc `.husky/_` do chính husky đặt."
+  nextStep_vi: "Gỡ cấu hình bằng `git config --local --unset core.hooksPath` rồi commit lại qua hook; không dùng `--no-verify` và không đổi đường dẫn hook để né kiểm tra."
+  owner: op-retry
+  kind: check-finding
+
 HFS_INIT_EXISTS:
   title: "hfs.json already exists"
   title_vi: "hfs.json đã có sẵn"
@@ -56,6 +1162,26 @@ HFS_INIT_UNDETECTED:
   owner: op-retry
   kind: verb-refusal
 
+HFS_LINT_SUPPRESSION_FILE:
+  title: "A repository keeps no lint-suppression file, script or option"
+  title_vi: "Kho có tệp hoặc script ghi nhận bỏ qua lỗi lint"
+  meaning_vi: "Kho có tệp, script hoặc tùy chọn ghi nhận lỗi lint để bỏ qua ở `<f>`: `eslint.suppressions*`, script `lint:suppressions`, cờ `--suppress-all`/`--suppressions-location`, hoặc cấu hình eslint có `suppressions`."
+  causes_vi:
+    - "Vi phạm luật R104: lỗi lint được sửa trong mã (hoặc luật được đổi trong canon); không ghi nhận để lỗi nằm lại trong tệp suppressions."
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra: xóa tệp, script hoặc cờ, và sửa các lỗi lint trong mã."
+  owner: op-retry
+  kind: check-finding
+
+HFS_MANAGED_FILE_DRIFT:
+  title: "A managed file equals its template render"
+  title_vi: "Tệp do .claude quản lý bị lệch"
+  meaning_vi: "`<file>` do `.claude` quản lý nhưng nội dung lệch bản render từ template. Chạy `hfs sync --write`, không sửa tay."
+  causes_vi:
+    - "Vi phạm luật R05: Tệp trong slot có `managedBy` của slots.yaml (tsconfig, jest.config.js, .prettierrc, .prettierignore, husky, workflows, sonar, khối `scripts` của package.json) phải bằng bản render từ template; danh sách tệp nằm trong slots.yaml, không nằm trong mã."
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra (nợ hàng loạt có codemod của HFS); không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
 HFS_MANIFEST_INVALID:
   title: "HFS slot manifest invalid"
   title_vi: "Bảng kê ô HFS sai định dạng"
@@ -90,15 +1216,143 @@ HFS_MIN_INSTANCES:
   owner: op-retry
   kind: check-finding
 
-HFS_PATH_NO_SLOT:
-  title: "Path matches no HFS slot"
-  title_vi: "Đường dẫn không khớp ô nào của HFS"
-  meaning_vi: "Một tệp hoặc thư mục trong kho không thuộc ô nào trong bảng kê; mọi đường dẫn được theo dõi phải khớp đúng một ô. Bộ kiểm tra báo kèm ô gần nhất để biết tệp lẽ ra thuộc đâu."
+HFS_MODULE_TIER_INVALID:
+  title: "Module tier name is not allowed"
+  title_vi: "Tên tầng module không hợp lệ"
+  meaning_vi: "Trong src/modules có thư mục tầng không thuộc domain, platform hoặc integrations."
   causes_vi:
-    - "Tệp đặt sai chỗ, ví dụ một tệp không phải *.e2e-spec.ts nằm trong thư mục kiểm thử e2e"
-    - "Thư mục do kho tự đặt ở gốc hoặc trong src mà HFS không có ô cho nó"
-    - "Tên tệp hoặc thư mục viết sai so với mẫu của ô gần nhất"
-  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để chuyển tệp vào ô gần nhất được báo hoặc xoá nó; nếu thực sự cần một loại nội dung mới thì đó là việc thêm ô vào bảng kê, do người giám sát làm, không phải kho tự thêm."
+    - "Đặt tên tầng tự do"
+    - "Sai chính tả tên tầng"
+  nextStep_vi: "Op backend.implement chuyển module về một trong ba tầng hợp lệ."
+  owner: other-op:backend.implement
+  kind: check-finding
+
+HFS_PACKAGE_MANAGER_MIXED:
+  title: "Package manager mixed with npm"
+  title_vi: "Trộn trình quản lý gói khác với npm"
+  meaning_vi: "Trường packageManager trong package.json mâu thuẫn với hợp đồng dùng npm và package-lock.json."
+  causes_vi:
+    - "Khai pnpm hoặc yarn trong package.json"
+    - "Còn tệp khóa của trình khác"
+  nextStep_vi: "Op dựng khung đưa packageManager về npm rồi kiểm tra lại."
+  owner: other-op:backend.scaffold
+  kind: check-finding
+
+HFS_PLAINTEXT_SECRET:
+  title: "Secrets exist only as `.starcistacks/<env>/secrets/<slug>.enc`"
+  title_vi: "Bí mật dạng rõ trong kho"
+  meaning_vi: "Tìm thấy bí mật dạng rõ ở `<path>`. Bí mật chỉ được nằm ở `.starcistacks/<env>/secrets/<slug>.enc` (sops). Không đọc, không in giá trị."
+  causes_vi:
+    - "Vi phạm luật R06: Bí mật chỉ tồn tại ở `.starcistacks/<env>/secrets/<slug>.enc`. Mọi `.env*`, `.secrets/`, `*.key\\|*.pem` plaintext, `runtime/files/*` đều bị từ chối, kể cả khi ignore."
+  nextStep_vi: "Không đọc và không in giá trị. Chủ kho mã hoá bí mật bằng sops vào .starcistacks/<môi-trường>/secrets/<slug>.enc, sau đó xoá tệp rõ; agent không tạo hay xoay khoá."
+  owner: owner
+  kind: check-finding
+
+HFS_PROOF_COMMAND_FILE_MISSING:
+  title: "A proof command names only files the repository holds"
+  title_vi: "Lệnh chứng minh trỏ tới tệp không tồn tại"
+  meaning_vi: "Lệnh `requiresProof.<kind>.command` của hồ sơ `.starciwork` `<f>` chạy tệp `<path>` mà kho không có, nên không thể chạy đúng như đã viết."
+  causes_vi:
+    - "Vi phạm luật R105: lệnh chứng minh phải chạy được nguyên văn; tệp spec, script hay cấu hình mà nó nêu tên phải có trong kho (script đã xóa thì kế hoạch chứng minh phải được viết lại)."
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra: tạo tệp được nêu hoặc viết lại kế hoạch chứng minh (ví dụ thành một spec e2e trên world); không thêm ngoại lệ."
+  owner: op-retry
+  kind: check-finding
+
+HFS_README_BADGE_NOT_LIVE:
+  title: "README badge is not a live service"
+  title_vi: "Huy hiệu README không phải dịch vụ ngoài đang chạy"
+  meaning_vi: "Một huy hiệu trong README không trỏ tới dịch vụ ngoài HTTPS đang hoạt động."
+  causes_vi:
+    - "Dùng huy hiệu tĩnh hoặc địa chỉ nội bộ"
+    - "Địa chỉ huy hiệu không hợp lệ"
+  nextStep_vi: "Op docs.author thay bằng huy hiệu từ dịch vụ ngoài HTTPS thật."
+  owner: other-op:docs.author
+  kind: check-finding
+
+HFS_README_DESCRIPTION_INVALID:
+  title: "README description line invalid"
+  title_vi: "Dòng mô tả trong README chưa đúng"
+  meaning_vi: "README thiếu một dòng mô tả ngắn ngay dưới tên kho."
+  causes_vi:
+    - "Không có dòng mô tả dưới tiêu đề"
+    - "Mô tả dài nhiều dòng"
+  nextStep_vi: "Op docs.author thêm một dòng mô tả ngắn ngay dưới tiêu đề."
+  owner: other-op:docs.author
+  kind: check-finding
+
+HFS_README_DEVELOPMENT_INCOMPLETE:
+  title: "README Development section incomplete"
+  title_vi: "Mục Development trong README chưa đủ lệnh"
+  meaning_vi: "Mục Development chưa nêu đủ các lệnh cài đặt, typecheck, lint:check, build và test (các script do hfs sync quản lý; test chạy bằng npm test)."
+  causes_vi:
+    - "Quên một hoặc vài lệnh"
+    - "Viết bằng lệnh của trình quản lý khác"
+  nextStep_vi: "Op docs.author bổ sung đủ các lệnh npm còn thiếu."
+  owner: other-op:docs.author
+  kind: check-finding
+
+HFS_README_PRIVATE_URL:
+  title: "README links a private host"
+  title_vi: "README chứa địa chỉ nội bộ hoặc cục bộ"
+  meaning_vi: "README có địa chỉ trỏ tới máy cục bộ hoặc mạng riêng."
+  causes_vi:
+    - "Để nguyên địa chỉ localhost hoặc IP riêng"
+    - "Dán nhầm liên kết nội bộ"
+  nextStep_vi: "Op docs.author xóa hoặc thay bằng địa chỉ công khai."
+  owner: other-op:docs.author
+  kind: check-finding
+
+HFS_README_SECTION_MISSING:
+  title: "README lacks a standard section"
+  title_vi: "README thiếu một mục chuẩn"
+  meaning_vi: "README thiếu một trong các mục chuẩn: Overview, Stack, Repository layout, Development."
+  causes_vi:
+    - "Chưa viết mục đó"
+    - "Đặt sai cấp tiêu đề (không phải ##)"
+  nextStep_vi: "Op docs.author thêm mục còn thiếu bằng tiêu đề ## đúng tên."
+  owner: other-op:docs.author
+  kind: check-finding
+
+HFS_README_SECTION_ORDER:
+  title: "README sections out of order"
+  title_vi: "Các mục README sai thứ tự"
+  meaning_vi: "Các mục chuẩn của README không theo đúng thứ tự quy định."
+  causes_vi:
+    - "Đặt mục sau trước mục trước"
+    - "Chèn mục thêm làm xáo trộn thứ tự"
+  nextStep_vi: "Op docs.author sắp lại các mục theo thứ tự chuẩn."
+  owner: other-op:docs.author
+  kind: check-finding
+
+HFS_README_TITLE_INVALID:
+  title: "README title does not match repo name"
+  title_vi: "Tiêu đề README không khớp tên kho"
+  meaning_vi: "Dòng đầu README phải là # kèm tên kho nhưng đang khác."
+  causes_vi:
+    - "Tiêu đề đặt tên khác"
+    - "Kho đổi tên mà README chưa đổi"
+  nextStep_vi: "Op docs.author sửa dòng đầu thành # <tên kho>."
+  owner: other-op:docs.author
+  kind: check-finding
+
+HFS_README_WORK_POINTER_MISSING:
+  title: "README lacks Work pointer"
+  title_vi: "README thiếu chỉ dẫn tới cây Work"
+  meaning_vi: "README chưa chỉ tới cây .starciwork của kho backend."
+  causes_vi:
+    - "Chưa viết dòng trỏ tới .starciwork"
+    - "Chỉ dẫn viết sai nơi"
+  nextStep_vi: "Op docs.author thêm chỉ dẫn tới cây .starciwork của backend."
+  owner: other-op:docs.author
+  kind: check-finding
+
+HFS_REPO_LOCAL_CHECK:
+  title: "A repository keeps no check or lint rule of its own"
+  title_vi: "Kho tự giữ bộ kiểm tra riêng"
+  meaning_vi: "Kho có nguồn kiểm tra hoặc luật lint cục bộ ở `<f>`: tệp `check-*` trong `scripts/` hay `tools/`, tệp `eslint-local-rules*`, plugin eslint cục bộ, hoặc script npm chạy một tệp `check-*`."
+  causes_vi:
+    - "Vi phạm luật R103: mọi bộ kiểm tra sống trong runtime `.claude` (hfs check, các canon eslint); kho sản phẩm không giữ bộ kiểm tra hay luật riêng. `scripts/` chỉ chứa script vận hành."
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra: xóa tệp và script trỏ tới nó; nếu luật còn cần thì đề xuất vào canon trong runtime `.claude`, không giữ bản sao trong kho."
   owner: op-retry
   kind: check-finding
 
@@ -113,15 +1367,81 @@ HFS_REPO_UNREADABLE:
   owner: op-retry
   kind: input-invalid
 
-HFS_REQUIRED_MISSING:
-  title: "Required file or directory missing"
-  title_vi: "Thiếu tệp hoặc thư mục bắt buộc"
-  meaning_vi: "Một ô bắt buộc (hoặc một thực thể của ô, như một ứng dụng hay một tính năng) đòi có tệp hoặc thư mục này nhưng nó không nằm trong những gì Git theo dõi."
+HFS_REQUIRED_FILE_MISSING:
+  title: "Required file, directory or minimum instance is missing"
+  title_vi: "Thiếu tệp, thư mục hoặc số lượng tối thiểu bắt buộc theo bảng kê"
+  meaning_vi: "Bảng kê HFS đòi một tệp hoặc thư mục phải có trong mỗi phần của kho (gói dùng chung, module frontend, api, i18n, tuyến, layout...), hoặc đòi kho có ít nhất một ứng dụng hay tính năng thuộc loại bắt buộc. Mục đó không tồn tại; khi là số lượng tối thiểu thì báo tại hfs.json. Thiếu nó thì phần liên quan chưa hoạt động đầy đủ hoặc kho chưa phải một sản phẩm hoàn chỉnh."
   causes_vi:
-    - "Tính năng thiếu index.ts, tệp module hoặc thư mục application"
-    - "Ứng dụng thiếu main.ts, app.module.ts hoặc spec ghép ứng dụng"
-    - "Kho thiếu tệp gốc bắt buộc như README.md, hfs.json, .starciwork, .starcistacks"
-  nextStep_vi: "Tạo tệp hoặc thư mục theo mẫu của ô rồi commit; tệp chưa git add vẫn tính là thiếu. Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra; không cần ai can thiệp thêm."
+    - "Tạo thư mục mới nhưng chưa thêm tệp bắt buộc như index.ts, client.ts, outcome.ts hoặc package.json"
+    - "Tệp có nhưng tên hoặc chỗ đặt khác với bảng kê"
+    - "Kho chưa có tính năng hoặc ứng dụng nào của loại bắt buộc"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để tạo tệp còn thiếu đúng chỗ bảng kê chỉ định; nếu cấu trúc hiện có là chủ ý thì đó là việc sửa bảng kê, do người giám sát làm, không phải kho tự đổi."
+  owner: op-retry
+  kind: check-finding
+
+HFS_ROOT_ENTRY_FORBIDDEN:
+  title: "Root entry not on HFS allowlist"
+  title_vi: "Mục ở thư mục gốc không được phép"
+  meaning_vi: "Ở thư mục gốc của repo có một tệp hoặc thư mục không nằm trong các gốc mà slot của repo khai báo (ví dụ contracts/ cho ảnh chụp hợp đồng)."
+  causes_vi:
+    - "Worker tạo thêm tệp hoặc thư mục ngay ở gốc repo"
+    - "Tệp cũ chưa được dời vào đúng chỗ của nó"
+  nextStep_vi: "Bộ kiểm kiến trúc từ chối; op vừa tạo ra mục đó phải dời nó vào thư mục sở hữu rồi chạy lại kiểm tra."
+  owner: op-retry
+  kind: check-finding
+
+HFS_ROOT_ENTRY_MISSING:
+  title: "Required root entry is missing"
+  title_vi: "Thiếu mục bắt buộc ở thư mục gốc"
+  meaning_vi: "Repo thiếu một tệp hoặc thư mục mà cấu trúc chuẩn bắt buộc phải có ở gốc, hoặc README.md không đọc được."
+  causes_vi:
+    - "Repo mới chưa được dựng khung đầy đủ"
+    - "Tệp gốc bị xóa hoặc chưa được commit"
+  nextStep_vi: "Bộ kiểm kiến trúc từ chối; op đang làm việc phải tạo mục còn thiếu rồi chạy lại kiểm tra."
+  owner: op-retry
+  kind: check-finding
+
+HFS_ROOT_MARKDOWN_FORBIDDEN:
+  title: "Markdown file at repository root"
+  title_vi: "Tệp Markdown đặt ở thư mục gốc"
+  meaning_vi: "Có một tệp Markdown nằm ngay ở gốc repo, trong khi tài liệu phải nằm trong thư mục docs hoặc hồ sơ Work của nó."
+  causes_vi:
+    - "Worker ghi ghi chú hoặc báo cáo thẳng ra gốc repo"
+    - "Tài liệu cũ chưa được dời đi"
+  nextStep_vi: "Bộ kiểm kiến trúc từ chối; op phải chuyển tệp vào docs/ hoặc hồ sơ Work rồi chạy lại."
+  owner: op-retry
+  kind: check-finding
+
+HFS_ROOT_SRC_FORBIDDEN_FE:
+  title: "Root src folder in frontend repo"
+  title_vi: "Repo giao diện có thư mục src ở gốc"
+  meaning_vi: "Repo giao diện có thư mục src ngay ở gốc, trong khi mã nguồn chỉ được đặt trong apps/<tên app>/src."
+  causes_vi:
+    - "Dự án giao diện được dựng theo kiểu một app đơn"
+    - "Worker tạo mã ngoài thư mục app"
+  nextStep_vi: "Bộ kiểm kiến trúc từ chối; op phải chuyển toàn bộ src vào apps/<app>/src rồi chạy lại."
+  owner: op-retry
+  kind: check-finding
+
+HFS_RULE_OFF_WITHOUT_REPLACEMENT:
+  title: "The ESLint configuration (and a front end's stylelint configuration) is the rendered one-liner, so no rule is off, warned or redefined in a repository"
+  title_vi: "Cấu hình ESLint hoặc stylelint lệch bản render"
+  meaning_vi: "`eslint.config.mjs` (hoặc `stylelint.config.mjs` của front end) khác bản render (một dòng gọi `starciBeConfig`, `starciFeConfig` hoặc `starciStylelintConfig`). Factory không nhận tham số ghi đè, nên một luật chỉ có thể bị tắt, hạ mức hoặc định nghĩa lại trong repo khi tệp này khác bản render. Chạy `hfs sync --write`, không sửa tay."
+  causes_vi:
+    - "Vi phạm luật R17: `eslint.config.mjs` phải đúng bằng bản render; luật thay thế nằm trong plugin của `.claude`, không bao giờ tắt trong repo."
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra; không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+HFS_SIZE_GROWTH:
+  title: "Source file over the size budget grew"
+  title_vi: "Tệp mã nguồn vượt hạn mức dòng vẫn tiếp tục dài thêm"
+  meaning_vi: "Một tệp mã nguồn đã dài hơn hạn mức mềm của ruleParams.fileLines nhưng lại dài thêm so với phiên bản gốc của nhánh, hoặc một tệp mới tạo đã vượt hạn mức ngay từ đầu. Tệp quá dài khó đọc, khó sửa và là nơi lỗi dễ ẩn; quy tắc này cho phép tệp cũ đang quá dài được giữ nguyên hoặc thu nhỏ dần, nhưng không cho phép nó phình thêm."
+  causes_vi:
+    - "Op thêm mã mới vào một tệp vốn đã quá hạn mức thay vì tách phần mới sang tệp khác"
+    - "Một tệp đang dưới hạn mức được thêm mã cho đến khi vượt hạn mức"
+    - "Một tệp mới tạo dài hơn hạn mức, hoặc một tệp bị di chuyển sang đường dẫn mới nên bị coi là tệp mới"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để tách phần mã mới (hoặc bớt phần cũ) sang tệp riêng đúng ô của nó, sao cho tệp không dài hơn phiên bản gốc và tệp mới nằm trong hạn mức."
   owner: op-retry
   kind: check-finding
 
@@ -157,6 +1477,95 @@ HFS_SLOT_NOT_ENABLED:
   owner: op-retry
   kind: check-finding
 
+HFS_SLOT_REQUIRED_MISSING:
+  title: "A slot is missing a required file (feature `index.ts`, app composition spec, FE `global-error.tsx`)"
+  title_vi: "Ô thiếu tệp bắt buộc"
+  meaning_vi: "Một ô bắt buộc (hoặc một thực thể của ô, như một ứng dụng hay một tính năng) đòi có tệp hoặc thư mục này nhưng nó không nằm trong những gì Git theo dõi."
+  causes_vi:
+    - "Vi phạm luật R02: slot bắt buộc thiếu tệp `requires` (vd feature thiếu `index.ts`, app thiếu composition spec, FE thiếu `global-error.tsx`)."
+    - "Ứng dụng thiếu main.ts, app.module.ts hoặc spec ghép ứng dụng"
+    - "Kho thiếu tệp gốc bắt buộc như README.md, hfs.json, .starciwork, .starcistacks"
+  nextStep_vi: "Tạo tệp hoặc thư mục theo mẫu của ô rồi commit; tệp chưa git add vẫn tính là thiếu. Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra; không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+HFS_SLOT_UNDECLARED:
+  title: "Every tracked path matches exactly one slot"
+  title_vi: "Đường dẫn không thuộc ô nào"
+  meaning_vi: "Một tệp hoặc thư mục trong kho không thuộc ô nào trong bảng kê; mọi đường dẫn được theo dõi phải khớp đúng một ô. Bộ kiểm tra báo kèm ô gần nhất để biết tệp lẽ ra thuộc đâu."
+  causes_vi:
+    - "Vi phạm luật R01: mọi path được track phải khớp đúng một slot trong `knowledge/hfs/slots.yaml` (thay allowlist gốc)."
+    - "Tệp đặt sai chỗ, ví dụ một tệp không phải *.e2e-spec.ts nằm trong thư mục kiểm thử e2e"
+    - "Thư mục do kho tự đặt ở gốc hoặc trong src mà HFS không có ô cho nó"
+    - "Tên tệp hoặc thư mục viết sai so với mẫu của ô gần nhất"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để chuyển tệp vào ô gần nhất được báo hoặc xoá nó; nếu thực sự cần một loại nội dung mới thì đó là việc thêm ô vào bảng kê, do người giám sát làm, không phải kho tự thêm."
+  owner: op-retry
+  kind: check-finding
+
+HFS_SONAR_CONFIG:
+  title: "Sonar config is generated, with no host URL and no coverage import"
+  title_vi: "Cấu hình Sonar lệch"
+  meaning_vi: "Cấu hình Sonar lệch: `<detail>`. Sonar phải đọc đúng cấu hình sinh ra, không nhập báo cáo độ phủ."
+  causes_vi:
+    - "Vi phạm luật R11: `sonar-project.properties` do template sinh: không `sonar.host.url`, `sources`/`tests` không chồng, `sonar.exclusions` = đúng danh sách loại trừ của jest, không nhập lcov hay `sonar.coverage.*`, không nhắc kiểu spec đã bỏ, và nhận báo cáo ESLint cùng tệp nhập lỗi HFS (`sonar.eslint.reportPaths`, `sonar.externalIssuesReportPaths`) để mọi lỗi canon hiện trong Sonar."
+    - "Khối `services.sonar.qualityGate` của khai báo stack phải gọi đúng cổng chất lượng duy nhất của `knowledge/sonar-gate.yaml`; repo không tự ghi ngưỡng."
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra (nợ hàng loạt có codemod của HFS); không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+HFS_SRC_LAYOUT_INVALID:
+  title: "Backend src holds unexpected folders"
+  title_vi: "Thư mục src của backend có mục lạ"
+  meaning_vi: "Trong src của repo backend có thư mục nằm ngoài ba nơi cho phép là features, modules và tests, hoặc trong src/tests có thư mục ngoài các slot be.tests.* (world, fixtures, integration, e2e, contract)."
+  causes_vi:
+    - "Worker tạo thư mục mới ngay dưới src"
+    - "Mã cũ chưa được dời về đúng feature hoặc module"
+  nextStep_vi: "Bộ kiểm kiến trúc từ chối; op phải dời thư mục đó về nơi sở hữu nó rồi chạy lại."
+  owner: op-retry
+  kind: check-finding
+
+HFS_STACKS_IN_FE:
+  title: "Stack declarations in frontend repo"
+  title_vi: "Khai báo stack nằm trong repo giao diện"
+  meaning_vi: "Repo giao diện đang chứa thư mục .starcistacks, trong khi khai báo stack chỉ được đặt ở repo backend."
+  causes_vi:
+    - "Sao chép nhầm thư mục stack từ backend sang"
+    - "Worker tạo stack ở sai repo"
+  nextStep_vi: "Bộ kiểm kiến trúc từ chối; op phải xóa thư mục khỏi repo giao diện và đặt khai báo ở backend."
+  owner: op-retry
+  kind: check-finding
+
+HFS_STACKS_SHAPE:
+  title: "`.starcistacks` has the standard shape and the host Sonar owner"
+  title_vi: "Hình dạng .starcistacks sai"
+  meaning_vi: "`.starcistacks` có `<path>` ngoài hình dạng chuẩn (danh sách allows của slot be.starcistacks, gồm cả infra/metadata.json) (hoặc còn trỏ `.stacks`)."
+  causes_vi:
+    - "Vi phạm luật R10: `.starcistacks/<env>/` chỉ có `README.md`, `environment.json`, `infra/{compose,k8s,terraform}`, `runtime/{config,env}`, `secrets/`, `seeds/`; khối sonar là `owner: host` trỏ `.claude/ext/sonar`; không còn gốc `.stacks`."
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra (nợ hàng loạt có codemod của HFS); không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+HFS_TEST_KIND_RETIRED:
+  title: "Retired test kind or extra test config"
+  title_vi: "Dùng loại test đã bỏ hoặc cấu hình test thừa"
+  meaning_vi: "Có tệp test thuộc loại đã bị loại bỏ, hoặc một cấu hình jest hay Playwright riêng thay vì một cấu hình chung ở gốc."
+  causes_vi:
+    - "Viết spec tích hợp hoặc harness theo kiểu cũ"
+    - "Tạo thêm tệp cấu hình test cho riêng từng nhóm"
+  nextStep_vi: "Bộ kiểm kiến trúc từ chối; op phải đổi tệp thành unit hoặc e2e và bỏ cấu hình thừa rồi chạy lại."
+  owner: op-retry
+  kind: check-finding
+
+HFS_TOOL_CONFIG_LOCAL:
+  title: "Configs only call the factories; no local rules"
+  title_vi: "Kho tự đặt luật cục bộ"
+  meaning_vi: "Repo có cấu hình công cụ cục bộ ở `<file>`: tệp cấu hình ngoài bộ được quản lý (`.eslintrc*`, `.eslintignore`, `eslint.config.*` hay `stylelint.config.*` thứ hai, cấu hình prettier/lint-staged khác), tệp tự định nghĩa luật ESLint hoặc plugin stylelint, khóa cấu hình công cụ trong `package.json` (`eslintConfig`, `stylelint`, `prettier`, `lint-staged`, `jest`), hoặc lệnh chạy eslint/stylelint/prettier với cờ đổi cấu hình (`--rule`, `--no-inline-config`, `--no-eslintrc`, `--config`, `--ignore-pattern`). Luật chung nằm trong `.claude`; đề xuất thay đổi ở đó."
+  causes_vi:
+    - "Vi phạm luật R16: Cấu hình của repo chỉ gọi factory của `.claude`; cấm tệp cấu hình công cụ khác, tệp luật cục bộ (vd một tệp eslint-local trong thư mục scripts) và cờ dòng lệnh đổi hoặc tắt cấu hình trong hook, workflow, script."
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra (nợ hàng loạt có codemod của HFS); không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
 HFS_TRACKED_MUST_BE_IGNORED:
   title: "Tracked path that must be gitignored"
   title_vi: "Tệp bị theo dõi nhưng lẽ ra phải bị bỏ qua"
@@ -167,3 +1576,58 @@ HFS_TRACKED_MUST_BE_IGNORED:
   nextStep_vi: "Gỡ tệp khỏi Git bằng git rm --cached và thêm vào khối .gitignore chuẩn; không xoá thư mục trên đĩa. Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra; không cần ai can thiệp thêm."
   owner: op-retry
   kind: check-finding
+
+HFS_TS_STRICT:
+  title: "tsconfig extends `@starci/tsconfig` and lowers no flag"
+  title_vi: "tsconfig hạ cờ strict"
+  meaning_vi: "`tsconfig.json` đặt hoặc hạ cờ `<flag>`. `tsconfig.json` chỉ extends `@starci/tsconfig/be.json` và khai báo `paths` của ba alias; mọi cờ do preset quy định."
+  causes_vi:
+    - "Vi phạm luật R22: `tsconfig.json` chỉ có `extends` và `paths`; các cờ `strict`, `noUncheckedIndexedAccess`, `noImplicitOverride`, `noImplicitReturns`, `noFallthroughCasesInSwitch`, `noUnusedLocals`, `noUnusedParameters`, `allowJs: false` nằm trong preset và repo không đặt, không hạ cờ nào."
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra (nợ hàng loạt có codemod của HFS); không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+HFS_UNTRACKED_ROOT_ENTRY:
+  title: "No untracked or ignored entry outside an `ignored` slot"
+  title_vi: "Mục lạ ở gốc kho"
+  meaning_vi: "Có mục chưa được git theo dõi, cũng không nằm trong `.gitignore` hay slot `ignored`, nên HFS không cho phép nó tồn tại trong cây làm việc. Theo dõi nó vào đúng slot, hoặc lưu trữ ra `D:/starci-archive/` rồi xóa."
+  causes_vi:
+    - "Vi phạm luật R03: Thư mục làm việc không được có mục untracked/ignored ngoài slot `ignored` (vd `nul`, `.qwen/`, `.worktrees/`, `design-plans/`, `express`)."
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để sửa theo lời nhắn của bộ kiểm tra (nợ hàng loạt có codemod của HFS); không cần ai can thiệp thêm."
+  owner: op-retry
+  kind: check-finding
+
+HFS_UNUSED_EXPORT:
+  title: "Public export that nothing outside the module uses"
+  title_vi: "Tên xuất công khai mà không nơi nào bên ngoài dùng"
+  meaning_vi: "Cửa vào công khai (index.ts) của một module, tính năng hoặc gói đang xuất ra một tên mà không tệp sản xuất nào nằm ngoài module đó import. Tệp kiểm thử không được tính là nơi dùng. Tên thừa ở cửa vào làm bề mặt công khai phình to, khiến người sau tưởng có thể dựa vào nó và làm việc thay đổi module khó hơn."
+  causes_vi:
+    - "Xuất thêm kiểu, hằng số hoặc hàm 'phòng khi cần' nhưng chưa có nơi nào dùng"
+    - "Nơi từng dùng tên này đã bị xoá hoặc chuyển vào cùng module, còn dòng xuất ở cửa vào bị bỏ sót"
+    - "Tên chỉ được dùng trong tệp kiểm thử, nên với bộ kiểm tra nó vẫn là thừa"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để xoá tên khỏi cửa vào (hoặc bỏ luôn phần khai báo nếu không còn ai dùng); nếu tên thực sự cần cho một nơi ngoài module thì nơi đó phải import nó qua cửa vào."
+  owner: op-retry
+  kind: check-finding
+
+HFS_UNUSED_FILE:
+  title: "Production file that nothing reaches"
+  title_vi: "Tệp mã sản xuất không ai chạm tới"
+  meaning_vi: "Một tệp mã sản xuất không được nối tới từ bất kỳ gốc nào: không phải main.ts hay app.module.ts của một ứng dụng, không phải tệp route, không phải cửa vào của một gói, và không tệp sản xuất nào import nó (kể cả import chỉ kiểu). Tệp kiểm thử không được tính; tệp chỉ có spec dùng vẫn là chết. Không tiến trình nào chạy tệp này."
+  causes_vi:
+    - "Nơi từng import tệp đã bị xoá hoặc chuyển đi, còn tệp bị bỏ sót"
+    - "Tệp được thêm nhưng chưa nối vào module hay cửa vào nào"
+    - "Tệp chỉ được spec dùng"
+  nextStep_vi: "Op vừa tạo ra bản này sẽ được chạy lại để xoá tệp, hoặc nối nó vào nơi thật sự dùng; không thêm ngoại lệ."
+  owner: op-retry
+  kind: check-finding
+
+HFS_WORK_IN_FE:
+  title: "Work tree inside frontend repo"
+  title_vi: "Hồ sơ Work nằm trong repo giao diện"
+  meaning_vi: "Repo giao diện chứa thư mục .starciwork, trong khi hồ sơ Work chỉ được lưu ở repo backend."
+  causes_vi:
+    - "Tạo hồ sơ Work nhầm repo"
+    - "Sao chép nguyên cây Work sang repo giao diện"
+  nextStep_vi: "Bộ kiểm kiến trúc từ chối; op phải chuyển hồ sơ sang repo backend rồi chạy lại."
+  owner: op-retry
+  kind: check-finding