@starci/eslint-canon-fe 4.0.0 → 5.1.2

package/docs/env-owner.md

@@ -0,0 +1,52 @@
+# Environment owner
+
+Law module: `env-owner.mjs`. Catalogue: R49 FE_ENV_OWNER.
+
+The environment is read in exactly one place, `modules/config`, and nothing there has a literal default that stands in for a real deployment value. A missing production variable must fail when the config module loads, not point production at a developer's machine.
+
+Every rule below is an error in `starciFeConfig`; none can be switched off or suppressed inline.
+
+## `starci-fe/no-env-outside-config`
+
+`process.env` and `import.meta.env` are read only in `modules/config`.
+
+**Invalid** (`src/hooks/session/useSession.ts`)
+
+```ts
+const url = process.env.API_URL
+```
+
+**Valid** (`src/hooks/session/useSession.ts`)
+
+```ts
+import { config } from "@/modules/config"
+const url = config.apiUrl
+```
+
+**Finding code:** `FE_ENV_OWNER`
+
+**Vì sao (why):** `<file>` đọc biến môi trường. Chỉ `modules/config` được đọc env.
+
+**Cách sửa:** Đọc giá trị từ export có kiểu của `modules/config` thay vì `process.env`.
+
+## `starci-fe/no-hardcoded-endpoint-fallback`
+
+No URL literal as a fallback, and no literal default for an address or secret variable.
+
+**Invalid** (`src/modules/config/env.ts`)
+
+```ts
+const url = process.env.API_URL ?? "http://localhost:3068"
+```
+
+**Valid** (`src/modules/config/env.ts`)
+
+```ts
+const url = process.env.API_URL
+```
+
+**Finding code:** `FE_ENV_OWNER`
+
+**Vì sao (why):** `<file>` có giá trị dự phòng cứng cho địa chỉ hoặc bí mật (`?? "http://localhost…"`). Thiếu biến ở production phải ném lỗi khi nạp cấu hình, không được lặng lẽ trỏ về máy dev.
+
+**Cách sửa:** Xóa giá trị dự phòng; để `modules/config` ném lỗi khi thiếu biến ở production.

package/docs/formatting.md

@@ -0,0 +1,30 @@
+# Formatting numbers, money and dates
+
+Law module: `formatting.mjs`. Catalogue: R59 FE_I18N_PLACEMENT, sub-check `FE_I18N_FORMATTER`.
+
+`next-intl` owns the reader's locale and time zone and hands them to `useFormatter()` / `getFormatter()`. `toLocale*String`, `new Intl.*`, displayed `toFixed`, a currency symbol glued to a template substitution and the date libraries either guess the locale (server and browser disagree, so a price flickers on hydration) or hard-code one. `modules/i18n/**` is exempt: it is where formats are configured.
+
+Every rule below is an error in `starciFeConfig`; none can be switched off or suppressed inline.
+
+## `starci-fe/use-intl-formatter`
+
+Format numbers, money and dates with `useFormatter` / `getFormatter` from `next-intl`.
+
+**Invalid** (`src/components/blocks/Feed/component.tsx`)
+
+```tsx
+<p>{new Date(at).toLocaleString()}</p>
+```
+
+**Valid** (`src/components/blocks/Feed/component.tsx`)
+
+```tsx
+const format = useFormatter()
+<p>{format.dateTime(new Date(at), { dateStyle: "medium" })}</p>
+```
+
+**Finding code:** `FE_I18N_FORMATTER`
+
+**Vì sao (why):** `<file>` định dạng số, tiền hoặc ngày bằng `toLocale*String`, `new Intl.*`, `toFixed`, ký hiệu tiền dán vào template hoặc thư viện ngày, thay vì formatter của next-intl.
+
+**Cách sửa:** Dùng `useFormatter()` (hoặc `getFormatter()` ở server): `number(...)`, `dateTime(...)`, `relativeTime(...)`.

package/docs/hooks-folder.md

@@ -0,0 +1,29 @@
+# hooks/ holds hooks
+
+Law module: `hooks-folder.mjs`. Catalogue: R56 FE_HOOKS_ARE_HOOKS (lint half).
+
+`hooks/<domain>/use<Name>.ts` holds one hook per file; `hooks/<domain>/<domain>.shared.ts` holds the domain's non-hook helpers; server readers live in `modules/api/<domain>/read-*.ts`. Whether a folder has exactly one shared file and whether a helper name repeats across files belongs to the architecture machine.
+
+Every rule below is an error in `starciFeConfig`; none can be switched off or suppressed inline.
+
+## `starci-fe/hooks-folder-holds-hooks-only`
+
+`hooks/<domain>/` holds `use*.ts` hooks and one `<domain>.shared.ts`; nothing else.
+
+**Invalid** (`src/hooks/course/readCourse.ts`)
+
+```ts
+export const readCourse = () => 1
+```
+
+**Valid** (`src/hooks/course/useCourse.ts`)
+
+```ts
+export const useCourse = () => 1
+```
+
+**Finding code:** `FE_HOOKS_ARE_HOOKS`
+
+**Vì sao (why):** `<file>` trong `hooks/` không phải React hook. Reader server về `modules/api`, helper về `<domain>.shared.ts`.
+
+**Cách sửa:** Mỗi tệp `use*.ts` một hook; helper dùng chung vào `<domain>.shared.ts`; reader server vào `modules/api/<domain>/read-*.ts`.

package/docs/hygiene.md

@@ -0,0 +1,111 @@
+# Runtime hygiene
+
+Law module: `hygiene.mjs`. Catalogue: R65 FE_SIZE_AND_STATE_BUDGET (sub-checks `FE_EFFECT_CLEANUP`, `FE_SWALLOWED_ERROR`, `FE_CONSOLE_CALL`) and R50 FE_TRANSPORT_OWNER (sub-check `FE_EFFECT_FETCH`).
+
+Work started by a component that nobody owns the end of: a timer that outlives the component, a fetch in an effect with no cache or cancel, an empty `catch` that hides the failure, a `console` call no pipeline reads. `modules/**` is exempt from the timer rule only (the API client owns its timeout timer and clears it in `finally`).
+
+Every rule below is an error in `starciFeConfig`; none can be switched off or suppressed inline.
+
+## `starci-fe/timer-needs-effect-cleanup`
+
+`setTimeout` and `setInterval` live in an effect whose cleanup clears them.
+
+**Invalid** (`src/components/blocks/Feed/component.tsx`)
+
+```tsx
+const onClick = () => { setTimeout(() => setOpen(false), 300) }
+```
+
+**Valid** (`src/components/blocks/Feed/component.tsx`)
+
+```tsx
+useEffect(() => {
+  const id = setTimeout(() => setOpen(false), 300)
+  return () => clearTimeout(id)
+}, [])
+```
+
+**Valid** also: a function that starts the timer and directly returns a cleanup clearing the same handle (the `subscribe` of `useSyncExternalStore`)
+
+```tsx
+const subscribe = (listener: () => void) => {
+  listeners.add(listener)
+  if (timer === undefined) timer = setInterval(tick, 60_000)
+  return () => {
+    listeners.delete(listener)
+    if (listeners.size === 0) { clearInterval(timer); timer = undefined }
+  }
+}
+```
+
+**Finding code:** `FE_EFFECT_CLEANUP`
+
+**Vì sao (why):** `<timer>` ở `<file>` chạy ngoài effect hoặc trong effect không có cleanup gọi `clearTimeout`/`clearInterval`.
+
+**Cách sửa:** Đặt timer trong `useEffect` và trả `() => clearTimeout(id)`; hoặc chuyển vào một hook làm việc đó.
+
+## `starci-fe/no-data-fetch-in-effect`
+
+No `await`, `fetch` or `.then` inside a `useEffect`; read through SWR or a server reader.
+
+**Invalid** (`src/components/blocks/Feed/component.tsx`)
+
+```tsx
+useEffect(() => { fetch(url).then(setData) }, [url])
+```
+
+**Valid** (`src/components/blocks/Feed/component.tsx`)
+
+```tsx
+const { data } = useSWR(key, fetcher)
+```
+
+**Finding code:** `FE_EFFECT_FETCH`
+
+**Vì sao (why):** `useEffect` ở `<file>` tải dữ liệu (`await`, `fetch`, `.then`): không cache, không gộp request, không trạng thái loading/lỗi, không huỷ.
+
+**Cách sửa:** Đọc phía client bằng SWR gọi client của app (`hooks/`), phía route bằng server reader `modules/api/<domain>/read-*.ts`.
+
+## `starci-fe/no-empty-catch`
+
+A `catch` that does nothing hides the failure; handle it or return a typed outcome.
+
+**Invalid** (`src/components/blocks/Feed/component.tsx`)
+
+```tsx
+try { await save() } catch {}
+```
+
+**Valid** (`src/components/blocks/Feed/component.tsx`)
+
+```tsx
+try { await save() } catch (error) { return { kind: "unavailable", cause: error } }
+```
+
+**Finding code:** `FE_SWALLOWED_ERROR`
+
+**Vì sao (why):** `catch` hoặc `.catch` ở `<file>` không làm gì: lỗi biến mất, không thông báo, không dấu vết.
+
+**Cách sửa:** Trả một outcome có kiểu mang nguyên nhân, hiển thị trạng thái lỗi, hoặc ném lại.
+
+## `starci-fe/no-console`
+
+No `console.*` call in product source.
+
+**Invalid** (`src/components/blocks/Feed/component.tsx`)
+
+```tsx
+console.error(error)
+```
+
+**Valid** (`src/components/blocks/Feed/component.tsx`)
+
+```tsx
+return { kind: "unavailable", cause: error }
+```
+
+**Finding code:** `FE_CONSOLE_CALL`
+
+**Vì sao (why):** `console.<method>` ở `<file>`: không vào pipeline log nào và lộ chi tiết nội bộ cho người dùng.
+
+**Cách sửa:** Trả outcome có kiểu, hiển thị trạng thái lỗi, hoặc để lỗi tới `error.tsx`.

package/docs/lint-escape-hatch.md

@@ -0,0 +1,32 @@
+# No inline suppression of any spelling
+
+Law module: `lint-escape-hatch.mjs`. Catalogue: R18 HFS_INLINE_SUPPRESSION.
+
+No `eslint-disable` (line, next-line, block), `eslint-enable`, `eslint-env`, inline `eslint rule: ...` config, `@ts-ignore`, `@ts-expect-error`, `@ts-nocheck`, and no retired `vn-ok:` pragma. `noInlineConfig` makes a directive ineffective, this rule makes it a finding, and `reportUnusedDisableDirectives` reports a leftover that suppresses nothing. The rule covers `src/**`, specs and the e2e tree.
+
+Every rule below is an error in `starciFeConfig`; none can be switched off or suppressed inline.
+
+## `starci-fe/no-inline-lint-config`
+
+Source cannot change its own lint or type-check policy, and the vn-ok pragma is retired.
+
+**Invalid** (`src/components/blocks/Feed/index.tsx`)
+
+```ts
+// eslint-disable-next-line no-console
+// @ts-ignore
+const s = "x" // vn-ok: reason
+```
+
+**Valid** (`src/components/blocks/Feed/index.tsx`)
+
+```ts
+// the rule is fixed centrally; fix the code instead
+const s = 1
+```
+
+**Finding code:** `HFS_INLINE_SUPPRESSION`
+
+**Vì sao (why):** Có chú thích tắt luật ở `<file>:<line>`. HFS không cho tắt tại chỗ — sửa code, hoặc đề xuất đổi luật.
+
+**Cách sửa:** Xóa `eslint-disable`, `@ts-ignore`, `@ts-expect-error` hoặc `vn-ok` và sửa nguyên nhân.

package/docs/lists.md

@@ -0,0 +1,74 @@
+# Lists
+
+Law module: `lists.mjs`. Catalogue: R65 FE_SIZE_AND_STATE_BUDGET, sub-check `FE_LIST_KEY`.
+
+A list is items with identity. React reconciles a rendered list by `key`; a missing, positional or random key hands a deleted row's state to its neighbour or remounts every row. A component prop written as an object or array literal inside `.map` is a new value per row per render, so a memoised row never hits.
+
+Every rule below is an error in `starciFeConfig`; none can be switched off or suppressed inline.
+
+## `starci-fe/list-item-has-key`
+
+Every element a `.map` callback returns carries a `key`.
+
+**Invalid** (`src/components/blocks/Feed/component.tsx`)
+
+```tsx
+rows.map((row) => <Row row={row} />)
+```
+
+**Valid** (`src/components/blocks/Feed/component.tsx`)
+
+```tsx
+rows.map((row) => <Row key={row.id} row={row} />)
+```
+
+**Finding code:** `FE_LIST_KEY`
+
+**Vì sao (why):** Phần tử trả từ `.map` ở `<file>` không có `key`, nên React nhận diện hàng theo vị trí và hàng bị đổi state khi xoá hoặc sắp xếp lại.
+
+**Cách sửa:** Thêm `key` lấy từ id của dữ liệu; với fragment dùng `<Fragment key={...}>`.
+
+## `starci-fe/no-index-key`
+
+A list key is stable data identity, never the map index or a random value. A static array written in place, or a callback that ignores its item (`(_, index) =>`), is exempt.
+
+**Invalid** (`src/components/blocks/Feed/component.tsx`)
+
+```tsx
+rows.map((row, index) => <Row key={index} row={row} />)
+```
+
+**Valid** (`src/components/blocks/Feed/component.tsx`)
+
+```tsx
+rows.map((row) => <Row key={row.id} row={row} />)
+```
+
+**Finding code:** `FE_LIST_KEY`
+
+**Vì sao (why):** `key` ở `<file>` lấy từ chỉ số của `.map` hoặc giá trị sinh ngẫu nhiên; chỉ số là vị trí, không phải danh tính.
+
+**Cách sửa:** Dùng id mà dữ liệu mang (`key={row.id}`); không dùng index, `Math.random`, `Date.now`.
+
+## `starci-fe/no-inline-literal-prop-in-list`
+
+No object or array literal as a prop of a component rendered inside `.map`.
+
+**Invalid** (`src/components/blocks/Feed/component.tsx`)
+
+```tsx
+rows.map((row) => <Avatar key={row.id} props={{ size: "sm" }} />)
+```
+
+**Valid** (`src/components/blocks/Feed/component.tsx`)
+
+```tsx
+const AVATAR_PROPS = { size: "sm" } as const
+rows.map((row) => <Avatar key={row.id} props={AVATAR_PROPS} />)
+```
+
+**Finding code:** `FE_LIST_KEY`
+
+**Vì sao (why):** Component trong `.map` ở `<file>` nhận object hoặc array literal làm prop: mỗi hàng mỗi lần render một giá trị mới, memo không bao giờ trúng.
+
+**Cách sửa:** Nâng hằng số ra ngoài component hoặc dựng một lần trước `.map`.

package/docs/native-controls.md

@@ -0,0 +1,73 @@
+# No native form controls
+
+Law module: `native-controls.mjs`. Catalogue: R62 FE_NATIVE_FORM_CONTROL.
+
+`<select>`, `<input>`, `<textarea>` and `<button>` are rendered by the grammar in product source, at every tier. If the grammar lacks the control, add it to the grammar.
+
+Every rule below is an error in `starciFeConfig`; none can be switched off or suppressed inline.
+
+## `starci-fe/no-native-form-control`
+
+Use the grammar's renderers; never a bare select, input, textarea or button.
+
+**Invalid** (`src/components/blocks/Feed/index.tsx`)
+
+```ts
+<button onClick={go} />
+```
+
+**Valid** (`src/components/blocks/Feed/index.tsx`)
+
+```ts
+<Button onPress={go}>{t("go")}</Button>
+```
+
+**Finding code:** `FE_NATIVE_FORM_CONTROL`
+
+**Vì sao (why):** `<tag>` thô ở `<file>`. Dùng renderer của grammar.
+
+**Cách sửa:** Thay bằng thành phần của grammar; nếu chưa có, thêm vào grammar thay vì vẽ tại chỗ.
+
+## `starci-fe/no-native-img`
+
+Use `next/image`, never a bare `<img>` (catalogue R62, sub-check `FE_NATIVE_IMAGE`).
+
+**Invalid** (`src/components/blocks/Feed/component.tsx`)
+
+```tsx
+<img src={src} alt={t("cover")} />
+```
+
+**Valid** (`src/components/blocks/Feed/component.tsx`)
+
+```tsx
+<Image src={src} alt={t("cover")} width={40} height={40} />
+```
+
+**Finding code:** `FE_NATIVE_IMAGE`
+
+**Vì sao (why):** `<img>` thô ở `<file>`: tải ảnh gốc, không giữ chỗ nên trang nhảy khi ảnh tải xong.
+
+**Cách sửa:** Dùng `Image` của `next/image` với `width` và `height` (hoặc `fill` và `sizes`) và `alt` từ catalog.
+
+## `starci-fe/image-has-size`
+
+`next/image` carries `width` and `height`, or `fill` with `sizes` (sub-check `FE_NATIVE_IMAGE`).
+
+**Invalid** (`src/components/blocks/Feed/component.tsx`)
+
+```tsx
+<Image src={src} alt={t("cover")} />
+```
+
+**Valid** (`src/components/blocks/Feed/component.tsx`)
+
+```tsx
+<Image src={src} alt={t("cover")} width={40} height={40} />
+```
+
+**Finding code:** `FE_NATIVE_IMAGE`
+
+**Vì sao (why):** `Image` ở `<file>` thiếu `width` và `height` (hoặc `fill` mà thiếu `sizes`): trình duyệt không giữ chỗ được.
+
+**Cách sửa:** Cho đủ `width` và `height`, hoặc `fill` trong khung có kích thước kèm `sizes`.

package/docs/next-conventions.md

@@ -0,0 +1,206 @@
+# Next conventions and the one locale pattern
+
+Law module: `next-conventions.mjs`. Catalogue: FE_NEXT_CONVENTIONS, R58 (html lang), R59 (i18n placement, single-file half).
+
+One locale pattern everywhere: `next-intl`, a `[locale]` segment, default `vi`, `localePrefix: "as-needed"`, and `proxy.ts` (Next 16) instead of `middleware.ts`.
+
+Every rule below is an error in `starciFeConfig`; none can be switched off or suppressed inline.
+
+## `starci-fe/no-middleware-file`
+
+`middleware.ts` is forbidden: the request interceptor is `proxy.ts` and exports `proxy`.
+
+**Invalid** (`src/middleware.ts`)
+
+```ts
+export function middleware() {}
+```
+
+**Valid** (`src/proxy.ts`)
+
+```ts
+export function proxy(request) { return request }
+```
+
+**Finding code:** `FE_NEXT_CONVENTIONS`
+
+**Vì sao (why):** `<file>` dùng tên `middleware`. Từ Next 16 bộ chặn request là `proxy.ts` và xuất `proxy`.
+
+**Cách sửa:** Đổi tên tệp thành `proxy.ts` và đổi export thành `proxy`.
+
+## `starci-fe/locale-segment-is-locale`
+
+The locale route segment is `[locale]`, never `[lang]`.
+
+**Invalid** (`src/app/[lang]/page.tsx`)
+
+```ts
+export default function Page() {}
+```
+
+**Valid** (`src/app/[locale]/page.tsx`)
+
+```ts
+export default function Page() {}
+```
+
+**Finding code:** `FE_I18N_PLACEMENT`
+
+**Vì sao (why):** Tệp `<file>` nằm dưới segment ngôn ngữ không phải `[locale]`. Chỉ có một mẫu: `next-intl`, `[locale]`, mặc định `vi`.
+
+**Cách sửa:** Đổi tên thư mục segment thành `[locale]`.
+
+## `starci-fe/no-second-i18n-stack`
+
+`next-intl` is the only i18n library.
+
+**Invalid** (`any file`)
+
+```ts
+import { useTranslation } from "react-i18next"
+```
+
+**Valid** (`any file`)
+
+```ts
+import { useTranslations } from "next-intl"
+```
+
+**Finding code:** `FE_I18N_PLACEMENT`
+
+**Vì sao (why):** `<file>` nhập một thư viện i18n thứ hai. App chỉ dùng `next-intl` qua `modules/i18n`.
+
+**Cách sửa:** Chuyển sang `next-intl`; xóa thư viện còn lại.
+
+## `starci-fe/html-lang-from-locale`
+
+`<html lang>` is taken from the `[locale]` segment, never a literal.
+
+**Invalid** (`src/app/[locale]/layout.tsx`)
+
+```ts
+<html lang="en">
+```
+
+**Valid** (`src/app/[locale]/layout.tsx`)
+
+```ts
+<html lang={locale}>
+```
+
+**Finding code:** `FE_I18N_LITERAL`
+
+**Vì sao (why):** `<html lang>` ở `<file>` là chữ cứng. Thuộc tính `lang` phải lấy từ segment `[locale]`.
+
+**Cách sửa:** Dùng `lang={locale}` từ tham số của layout `[locale]`.
+
+## `starci-fe/page-exports-metadata`
+
+Every `page.tsx` exports `metadata` or `generateMetadata` (catalogue R54, sub-check `FE_PAGE_METADATA_MISSING`).
+
+**Invalid** (`src/app/[locale]/courses/page.tsx`)
+
+```tsx
+export default function Page() { return <CoursesPage /> }
+```
+
+**Valid** (`src/app/[locale]/courses/page.tsx`)
+
+```tsx
+export async function generateMetadata() { return { title: t("courses.title") } }
+export default function Page() { return <CoursesPage /> }
+```
+
+**Finding code:** `FE_PAGE_METADATA_MISSING`
+
+**Vì sao (why):** `<file>` là `page.tsx` nhưng không export `metadata` hoặc `generateMetadata`; mọi trang trong nhánh mang cùng một tiêu đề.
+
+**Cách sửa:** Export `metadata` (hoặc `generateMetadata` khi tiêu đề lấy từ dữ liệu) với tiêu đề và mô tả lấy từ catalog thông điệp.
+
+## `starci-fe/no-null-suspense-fallback`
+
+`<Suspense>` has a fallback that renders something; `fallback={null}` is forbidden (catalogue R53, sub-check `FE_SUSPENSE_NULL_FALLBACK`).
+
+**Invalid** (`src/components/blocks/Feed/component.tsx`)
+
+```tsx
+<Suspense fallback={null}><Feed /></Suspense>
+```
+
+**Valid** (`src/components/blocks/Feed/component.tsx`)
+
+```tsx
+<Suspense fallback={<FeedSkeleton />}><Feed /></Suspense>
+```
+
+**Finding code:** `FE_SUSPENSE_NULL_FALLBACK`
+
+**Vì sao (why):** `<Suspense>` ở `<file>` có `fallback` rỗng: người dùng thấy khoảng trống thay vì trạng thái đang tải.
+
+**Cách sửa:** Truyền skeleton (trạng thái loading) của đúng thứ đang tải làm `fallback`.
+
+## `starci-fe/navigation-from-intl`
+
+`Link`, `useRouter`, `usePathname` and `redirect` come from `modules/i18n/navigation`, not from Next (catalogue R59, sub-check `FE_I18N_NAVIGATION`).
+
+**Invalid** (`src/components/blocks/Feed/component.tsx`)
+
+```tsx
+import { useRouter } from "next/navigation"
+```
+
+**Valid** (`src/components/blocks/Feed/component.tsx`)
+
+```tsx
+import { useRouter } from "@/modules/i18n/navigation"
+```
+
+**Finding code:** `FE_I18N_NAVIGATION`
+
+**Vì sao (why):** `<file>` nhập `Link`, `useRouter`, `usePathname` hoặc `redirect` từ Next, không biết locale: đường dẫn mất tiền tố `[locale]`.
+
+**Cách sửa:** Nhập từ `modules/i18n/navigation`, được next-intl dựng từ `routing.ts`.
+
+## `starci-fe/no-native-anchor`
+
+An internal link is `Link` from `modules/i18n/navigation`; an external `_blank` link carries `rel` (catalogue R59, sub-check `FE_I18N_NAVIGATION`).
+
+**Invalid** (`src/components/blocks/Feed/component.tsx`)
+
+```tsx
+<a href="/courses">{t("courses")}</a>
+```
+
+**Valid** (`src/components/blocks/Feed/component.tsx`)
+
+```tsx
+<Link href={routes.courses()}>{t("courses")}</Link>
+```
+
+**Finding code:** `FE_I18N_NAVIGATION`
+
+**Vì sao (why):** `<a>` ở `<file>` trỏ route nội bộ (tải lại cả trang, mất locale, mất prefetch) hoặc mở tab mới mà không có `rel`.
+
+**Cách sửa:** Dùng `Link` từ `modules/i18n/navigation` với href dựng bởi `modules/routes`; liên kết `_blank` thêm `rel="noopener noreferrer"`.
+
+## `starci-fe/no-hardcoded-route`
+
+A route path is built by `modules/routes`, never written as a literal at a link or a navigation call (catalogue R57, sub-check `FE_ROUTE_HARDCODED`).
+
+**Invalid** (`src/components/blocks/Feed/component.tsx`)
+
+```tsx
+router.push("/agentos/workspaces/new")
+```
+
+**Valid** (`src/components/blocks/Feed/component.tsx`)
+
+```tsx
+router.push(routes.newWorkspace())
+```
+
+**Finding code:** `FE_ROUTE_HARDCODED`
+
+**Vì sao (why):** `<file>` viết thẳng đường dẫn route ở nơi gọi; route đổi chỗ thì bản sao trỏ vào 404.
+
+**Cách sửa:** Dựng href bằng hàm của `modules/routes` và dùng đúng hàm đó ở mọi nơi.

package/docs/size-and-state-budget.md

@@ -0,0 +1,73 @@
+# Size and state budget
+
+Law module: `size-and-state-budget.mjs`. Catalogue: R65 FE_SIZE_AND_STATE_BUDGET.
+
+A component file is at most 300 lines; a connected unit holds at most 6 `useState` and reads at most 6 data hooks; there is no hand-written polling loop. `HFS_SIZE_GROWTH` (no growth against the parent commit) is the architecture machine's; these are the absolute file-local limits.
+
+Every rule below is an error in `starciFeConfig`; none can be switched off or suppressed inline.
+
+## `starci-fe/component-line-budget`
+
+A component file has at most 300 lines.
+
+**Invalid** (`src/components/blocks/Feed/index.tsx`)
+
+```ts
+// a 301-line component file
+```
+
+**Valid** (`src/components/blocks/Feed/index.tsx`)
+
+```ts
+// 300 lines or fewer
+```
+
+**Finding code:** `FE_SIZE_AND_STATE_BUDGET`
+
+**Vì sao (why):** `<file>` dài `<n>` dòng, vượt ngưỡng 300 dòng của một component.
+
+**Cách sửa:** Tách phần vẽ khỏi phần dữ liệu và tách từng khu vực thành đơn vị riêng.
+
+## `starci-fe/unit-hook-budget`
+
+A unit has at most 6 state hooks and 6 data hooks.
+
+**Invalid** (`src/components/blocks/Feed/index.tsx`)
+
+```ts
+const Feed = () => { /* 7 x useState */ }
+```
+
+**Valid** (`src/components/blocks/Feed/index.tsx`)
+
+```ts
+const Feed = () => { /* up to 6 x useState and 6 data hooks */ }
+```
+
+**Finding code:** `FE_SIZE_AND_STATE_BUDGET`
+
+**Vì sao (why):** `<unit>` có `<n>` hook dữ liệu / `<m>` useState, vượt ngưỡng 6.
+
+**Cách sửa:** Gom trạng thái đổi cùng nhau vào reducer hoặc hook riêng; tách mỗi vùng dữ liệu thành block kết nối riêng.
+
+## `starci-fe/no-hand-rolled-polling`
+
+No `setInterval` and no self-scheduling `setTimeout`: one refresh mechanism per resource.
+
+**Invalid** (`src/components/blocks/Feed/index.tsx`)
+
+```ts
+useEffect(() => { const t = setInterval(load, 5000) }, [])
+```
+
+**Valid** (`src/components/blocks/Feed/index.tsx`)
+
+```ts
+const d = useQueryFeedSwr({ refreshInterval: 5000 })
+```
+
+**Finding code:** `FE_SIZE_AND_STATE_BUDGET`
+
+**Vì sao (why):** `<unit>` tự viết vòng poll (`setInterval` hoặc `setTimeout` tự gọi lại).
+
+**Cách sửa:** Làm tươi qua hook dữ liệu (`refreshInterval`) hoặc socket, mỗi resource đúng một cơ chế.