chore: KaTeX math support + project cleanup by one-ea · Pull Request #41 · one-ea/Monolith

one-ea · 2026-04-25T02:23:56Z

Summary

KaTeX math formula support: inline $...$ and block $$...$$ rendering with code block protection
Project cleanup: remove orphaned .wiki-tmp submodule, unused marked from server, stray test artifacts
Dependency hygiene: @types/dompurify and shadcn moved to devDependencies
gitignore: add .playwright-mcp/ and .wiki-tmp/

coderabbitai · 2026-04-25T02:24:16Z

Warning

Rate limit exceeded

@one-ea has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 45 minutes and 47 seconds before requesting another review.

Your organization is not enrolled in usage-based pricing. Contact your admin to enable usage-based pricing to continue reviews beyond the rate limit, or try again in 45 minutes and 47 seconds.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: b31af85a-ba1f-4a88-a1ed-d753a08b0ab5

📥 Commits

Reviewing files that changed from the base of the PR and between b673444 and da229d2.

⛔ Files ignored due to path filters (1)

package-lock.json is excluded by !**/package-lock.json, !**/package-lock.json

📒 Files selected for processing (7)

.gitignore
.wiki-tmp
client/package.json
client/src/globals.css
client/src/lib/markdown.ts
server/package.json
server/src/index.ts

📝 Walkthrough

总体概述

本 PR 重构前端导航系统为动态化，集成 KaTeX 数学表达式渲染，重新设计管理后台侧边栏布局，优化代码块样式，调整项目配置和依赖清单。涉及 15 个文件的变更，包含 UI 组件、样式、类型定义和配置文件。

变更概览

内聚组 / 文件(s)	变更摘要
导航系统动态化 `client/src/lib/api.ts`, `client/src/components/navbar.tsx`, `client/src/components/footer.tsx`	新增 `NavPage` 类型和 `fetchNavPages()` 函数（支持缓存和错误容错），取代硬编码导航链接，动态从 `/api/pages` 获取已发布导航页面，删除旧的延迟动画类。
后台布局重构 `client/src/components/admin-layout.tsx`, `client/src/pages/admin/dashboard.tsx`	提取 SidebarFooter 组件，桌面端侧边栏改为固定定位左侧导航栏，移动端抽屉补充 dialog 语义，添加外链按钮；标签栏支持展开/收起，侧边栏在大屏启用粘性定位。
KaTeX 数学支持 `client/src/lib/markdown.ts`, `client/src/globals.css`, `client/package.json`	集成 KaTeX 库进行 LaTeX 数学表达式渲染（`$$...$$` 和 $...$ ），临时保护代码块避免冲突，扩展 DOMPurify 白名单支持 KaTeX 生成的 DOM，添加样式化的数学错误提示；更新依赖管理。
代码块样式优化 `client/src/globals.css`	重构代码块横向滚动行为，行号改为弹性布局分离，添加代码头部粘性定位，iOS 惯性滚动支持，移动端调整边距和圆角。
后端依赖清理 `server/package.json`, `server/src/index.ts`	移除未使用的 `marked` 库依赖。
配置和文档 `.gitignore`, `opencode.json`, `AGENTS.md`, `.playwright-mcp/*`, `.wiki-tmp`	更新 gitignore 规则（支持单点环境变量、忽略临时工具目录），新增 MCP 集成配置（GitHub、Playwright、Upstash），补充中文架构文档，清理过期的测试数据。

代码审查工作量估计

🎯 3 (Moderate) | ⏱️ ~25 分钟

关键审查点：

类型安全：验证新增 NavPage 类型与 API 响应的契合度，fetchNavPages() 错误处理边界
响应式兼容：检查 lg:sticky、lg:self-start 等 Tailwind 响应式类在暗色主题下的可见性，移动端边距/圆角一致性
KaTeX 集成：LaTeX 表达式检测正确性，代码块保护机制完整性，DOMPurify 白名单扩展是否引入安全隐患
布局交互：标签展开/收起状态管理，固定侧边栏与主内容的间距对齐，移动端 dialog 语义正确性
性能：useMemo 在 Navbar 中的依赖数组完整性，fetchNavPages() 缓存策略合理性

可能关联的 PR

feat: 前端样式精修 + 后台主题切换 + 部署管道安全加固 #26: 修改相同前端文件（admin-layout.tsx、globals.css），涉及重叠的 UI/布局和代码块样式调整
chore: sync admin hardening and code scanning fixes into main #21: 同样修改 client/src/lib/markdown.ts，两者都涉及 Markdown 渲染管道的扩展
feat(admin): refactor settings module to categorized sidebar tabs #20: 共同修改后台 UI 组件（admin-layout.tsx 和 dashboard.tsx），代码级别直接相关

建议标签

frontend, styles, feature

🚥 Pre-merge checks | ✅ 4

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	PR 标题符合 Conventional Commits 格式 (chore: description)，清晰概括了核心改动：KaTeX 数学公式支持和项目清理，与变更集高度对应。
Description check	✅ Passed	PR 描述与变更集相关，列举了主要改动项（KaTeX 支持、清理孤立文件、依赖调整、gitignore 更新），与实际代码改动对应。
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

Create PR with unit tests
Commit unit tests in branch dev

✨ Simplify code

Create PR with simplified code
Commit simplified code in branch dev

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

coderabbitai

Actionable comments posted: 5

🧹 Nitpick comments (5)

client/src/pages/admin/dashboard.tsx (1)
340-348: 折叠阈值与高度限制不一致（可选优化）

按钮文案 +${allTags.length - 8} 暗示折叠时展示 8 个标签，但实际通过 max-h-[64px] 控制——当标签字符长度差异较大时，可见标签数可能多于或少于 8 个，按钮里的数字会与肉眼看到的不符。如果在意可以改用基于数量的截断（allTags.slice(0, 8)）或把阈值抽成常量并在两处共用。

非阻塞，按需调整即可。
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@client/src/pages/admin/dashboard.tsx` around lines 340 - 348, The collapse
behavior is inconsistent: the button text uses 8 as the threshold but the UI
limits height via max-h-[64px], which can show a different number of tags;
update the rendering to use a consistent count-based collapse (or a shared
constant). Specifically, introduce and use a TAG_COLLAPSE_COUNT (or directly use
allTags.slice(0, 8) when !tagExpanded) so the tag list rendering and the button
text both rely on the same logic (references: allTags, tagExpanded,
setTagExpanded) and remove or keep max-h styling only as a secondary visual
clamp.
client/src/components/admin-layout.tsx (1)
65-135: 避免在组件内部声明子组件

SidebarFooter 与 SidebarContent 在每次 AdminLayout 渲染时都会被重新创建为新的函数引用，导致 React 将其视为新的组件类型，整棵子树会被卸载/重建（丢失内部状态、破坏过渡动画、增加无谓 reconciliation 开销）。建议提到模块作用域、改为 useMemo 返回 JSX，或直接内联。
♻️ 建议改为返回 JSX 的常量（最小改动）
-  const SidebarFooter = () => (
+  const sidebarFooter = (
     <div className="border-t border-border/40 p-[12px] space-y-[2px]">
       ...
     </div>
-  );
+  );
@@
-  const SidebarContent = () => (
+  const sidebarContent = (
     <div className="flex flex-col h-full">
       ...
-      <SidebarFooter />
+      {sidebarFooter}
     </div>
   );
@@
-        <SidebarContent />
+        {sidebarContent}
@@
-            <SidebarContent />
+            {sidebarContent}
注意：若改为常量 JSX，记得把依赖（location、mobileMenuOpen 等闭包变量）的更新仍可正确触发重渲染——因为它们在父组件作用域内，正常工作。
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@client/src/components/admin-layout.tsx` around lines 65 - 135, SidebarFooter
and SidebarContent are declared as new functions inside AdminLayout on every
render causing remounts; move them out of the AdminLayout render path by
converting them into stable values: either hoist them to module scope as JSX
constants or compute them with useMemo inside AdminLayout so their references
are stable. Ensure the hoisted/ memoized JSX still reads up-to-date values
(location, setMobileMenuOpen, navGroups, mobileMenuOpen, handleLogout) by
passing those as dependencies to useMemo or by keeping only presentational
markup hoisted and wiring interactive props (onClick handlers, dynamic classes
using isActive calculation) from AdminLayout into the JSX via props/closures.
Specifically target SidebarFooter, SidebarContent and the isActive logic that
uses location and setMobileMenuOpen.
client/src/globals.css (1)
410-426: KaTeX 样式整体良好，建议为 .math-error 补上亮色主题覆盖。

.katex-display 的 overflow-x: auto + -webkit-overflow-scrolling: touch 很好地处理了长公式在窄屏下的横向滚动；.katex { font-size: 1.05em } 相对于正文 15px 约 15.75px，与代码/正文排版比例协调。

唯一的小隐患：.math-error 使用 oklch(0.65 0.2 25) 的橙红色，在暗色背景上可读性 OK，但在亮色主题的 --background: oklch(0.975 0.002 250) 上对比度偏低（约 3:1 左右）。按照该文件 [data-theme="light"] 覆写其他颜色的惯例，建议补一条亮色覆盖。

As per coding guidelines: 是否有遗漏的选择器未覆盖亮色模式。
🎨 建议补充
 .prose-monolith .math-error {
   color: oklch(0.65 0.2 25);
   font-size: 13px;
 }
+
+:root[data-theme="light"] .prose-monolith .math-error {
+  color: oklch(0.45 0.22 25);
+}
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@client/src/globals.css` around lines 410 - 426, Add a light-theme override
for the .prose-monolith .math-error rule so the error text has sufficient
contrast on the light background; locate the existing .prose-monolith
.math-error selector and add a corresponding [data-theme="light"] selector (e.g.
[data-theme="light"] .prose-monolith .math-error) that sets a darker/more
saturated color (or a theme variable like --text-danger) to meet contrast
requirements against --background: oklch(0.975 0.002 250).
client/package.json (1)
31-31: 移除 @types/dompurify，依赖 dompurify 的内置类型定义。

dompurify@^3.4.0 已内置官方 TypeScript 声明文件（dist/purify.cjs.d.ts 等），@types/dompurify@^3.0.5 现为纯 stub 包，无实际用途。保留两份类型定义可能导致冗余或不一致，建议移除该 devDependency。
♻️ 建议修改
     "@tailwindcss/vite": "^4",
-    "@types/dompurify": "^3.0.5",
     "@types/katex": "^0.16.8",
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@client/package.json` at line 31, Remove the redundant devDependency
"@types/dompurify" from package.json because dompurify@^3.4.0 already ships
TypeScript declarations; update the dependencies/devDependencies block by
deleting the "@types/dompurify": "^3.0.5" entry and run npm/yarn install to
ensure only the built-in dompurify types are used (verify no other code imports
the stub package name).
client/src/lib/markdown.ts (1)
309-336: 考虑迁移至 marked-katex-extension，提升数学公式处理的稳健性。

当前 renderMath 通过字符串替换在 marked.parse 之前注入 KaTeX HTML，存在以下风险：

代码保护不完整：仅覆盖 ``` 和 ` ` 语法，漏掉缩进代码块（4 空格/Tab）和 ~~~ 围栏，可能错误地处理其中的 $ 符号。

占位符恢复脆弱：依赖 marked 对零字节的保留，这是隐式依赖，未来版本变更可能导致失效。

块公式正则无边界：/$$([\s\S]+?)$$/ 未锚定行首行尾，可能跨越段落或列表边界。

marked-katex-extension (v5.1.8，兼容 marked v17.0.6) 将 $ / $$ 作为 marked 的 lexer token，由 marked 词法层统一处理冲突，在 DOMPurify 净化前生成纯净的 KaTeX HTML，无需担心代码块保护或占位符问题。现有的 DOMPurify 配置（含 iframe/video 白名单）与该方案完全兼容。
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@client/src/lib/markdown.ts` around lines 309 - 336, The current renderMath
function (and its preserved/ph placeholder logic using preserved and ph, plus
the regex replacements for $$...$$ and $...$) is fragile and should be replaced
by integrating the marked-katex-extension: install marked-katex-extension,
import and register its KaTeX extension with marked (instead of doing regex
replacements in renderMath), remove the placeholder handling (preserved, ph) and
the manual katex.renderToString calls, and ensure the extension is applied
before DOMPurify sanitization so KaTeX HTML is produced by the lexer/parser
rather than by brittle string surgery; keep existing DOMPurify settings
unchanged.

🤖 Prompt for all review comments with AI agents

Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@AGENTS.md`:
- Around line 59-63: The AGENTS.md "CI 与安全" section contains hard-coded secrets
("monolith2026" and explicit "GitHub PAT" mention); remove any plaintext
credentials from that section (delete the "monolith2026" literal and any PAT
references), rotate the exposed admin password immediately, and replace
doc-stored secrets with instructions to use environment variables or a secrets
manager (e.g., reference using .dev.vars or a proper secret store) in the "CI
与安全" text; then purge the secret from history using git filter-repo (or
equivalent) and update repository guidance to store secrets in ignored files
(e.g., .dev.vars) or secret management, plus ensure .gitignore excludes those
files.

In `@client/src/components/admin-layout.tsx`:
- Around line 149-184: The button that toggles mobile menu (onClick={() =>
setMobileMenuOpen(true)}) uses aria-controls="admin-mobile-navigation" but the
aside dialog (<aside role="dialog"> / SidebarContent) lacks that id and
aria-modal; add id="admin-mobile-navigation" to that aside and include
aria-modal="true" so the button correctly references the dialog and the dialog
exposes modal semantics to assistive tech.

In `@client/src/globals.css`:
- Around line 917-921: The mobile rule currently sets border-radius: 0 only for
:root[data-theme="light"] .prose-monolith .code-block-wrapper, leaving the
default/dark theme with 8px corners; make the behavior consistent by moving or
duplicating the mobile rule so that .prose-monolith .code-block-wrapper gets
border-radius: 0 for both themes (either remove the [data-theme="light"]
qualifier or add a matching selector for the default/dark theme such as
:root:not([data-theme="light"]) .prose-monolith .code-block-wrapper) and add a
short comment explaining the intentional cross-theme mobile styling change.

In `@client/src/lib/markdown.ts`:
- Around line 324-331: The inline math regex used in the md.replace call
(currently /(?<!\\)\$([^$\n]+?)\$/g) is too permissive and mis-parses currency
like " $100 "; update the pattern to enforce no leading/trailing spaces and
prevent a closing $ followed by a digit: replace the regex in the md.replace
invocation with /(?<!\\)\$(?!\s)([^$\n]+?)(?<!\s)\$(?!\d)/g while keeping the
existing katex.renderToString(tex.trim(), { displayMode: false, throwOnError:
false }) and the catch branch that returns `<code
class="math-error">${escapeHtml(tex)}</code>` unchanged.

In `@opencode.json`:
- Around line 4-11: The opencode.json GitHub MCP config uses Authorization:
"Bearer {env:GITHUB_TOKEN}" but the GITHUB_TOKEN env var isn't documented or
provisioned; add documentation and example files: create a .env.example showing
GITHUB_TOKEN, add a .dev.vars (or update existing local env guidance) with
instructions for local development, and update deployment/CI config (e.g.,
wrangler.toml and CI secrets) to pass GITHUB_TOKEN into the runtime so the
"github" -> "headers" -> "Authorization" entry works; reference the "github"
section and the Authorization header in opencode.json when updating docs and
deployment manifests.

---

Nitpick comments:
In `@client/package.json`:
- Line 31: Remove the redundant devDependency "@types/dompurify" from
package.json because dompurify@^3.4.0 already ships TypeScript declarations;
update the dependencies/devDependencies block by deleting the
"@types/dompurify": "^3.0.5" entry and run npm/yarn install to ensure only the
built-in dompurify types are used (verify no other code imports the stub package
name).

In `@client/src/components/admin-layout.tsx`:
- Around line 65-135: SidebarFooter and SidebarContent are declared as new
functions inside AdminLayout on every render causing remounts; move them out of
the AdminLayout render path by converting them into stable values: either hoist
them to module scope as JSX constants or compute them with useMemo inside
AdminLayout so their references are stable. Ensure the hoisted/ memoized JSX
still reads up-to-date values (location, setMobileMenuOpen, navGroups,
mobileMenuOpen, handleLogout) by passing those as dependencies to useMemo or by
keeping only presentational markup hoisted and wiring interactive props (onClick
handlers, dynamic classes using isActive calculation) from AdminLayout into the
JSX via props/closures. Specifically target SidebarFooter, SidebarContent and
the isActive logic that uses location and setMobileMenuOpen.

In `@client/src/globals.css`:
- Around line 410-426: Add a light-theme override for the .prose-monolith
.math-error rule so the error text has sufficient contrast on the light
background; locate the existing .prose-monolith .math-error selector and add a
corresponding [data-theme="light"] selector (e.g. [data-theme="light"]
.prose-monolith .math-error) that sets a darker/more saturated color (or a theme
variable like --text-danger) to meet contrast requirements against --background:
oklch(0.975 0.002 250).

In `@client/src/lib/markdown.ts`:
- Around line 309-336: The current renderMath function (and its preserved/ph
placeholder logic using preserved and ph, plus the regex replacements for
$$...$$ and $...$) is fragile and should be replaced by integrating the
marked-katex-extension: install marked-katex-extension, import and register its
KaTeX extension with marked (instead of doing regex replacements in renderMath),
remove the placeholder handling (preserved, ph) and the manual
katex.renderToString calls, and ensure the extension is applied before DOMPurify
sanitization so KaTeX HTML is produced by the lexer/parser rather than by
brittle string surgery; keep existing DOMPurify settings unchanged.

In `@client/src/pages/admin/dashboard.tsx`:
- Around line 340-348: The collapse behavior is inconsistent: the button text
uses 8 as the threshold but the UI limits height via max-h-[64px], which can
show a different number of tags; update the rendering to use a consistent
count-based collapse (or a shared constant). Specifically, introduce and use a
TAG_COLLAPSE_COUNT (or directly use allTags.slice(0, 8) when !tagExpanded) so
the tag list rendering and the button text both rely on the same logic
(references: allTags, tagExpanded, setTagExpanded) and remove or keep max-h
styling only as a secondary visual clamp.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

Push a commit to this branch (recommended)
Create a new PR with the fixes

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 3256d097-039c-4bb5-b3e5-ea22aff9e7e8

📥 Commits

Reviewing files that changed from the base of the PR and between f4ddfa3 and b673444.

⛔ Files ignored due to path filters (4)

.kilo/package-lock.json is excluded by !**/package-lock.json, !**/package-lock.json
.playwright-mcp/console-2026-04-19T04-35-34-885Z.log is excluded by !**/*.log
.playwright-mcp/page-2026-04-19T04-35-58-544Z.png is excluded by !**/*.png
package-lock.json is excluded by !**/package-lock.json, !**/package-lock.json

📒 Files selected for processing (16)

.gitignore
.playwright-mcp/page-2026-04-19T04-35-40-096Z.yml
.playwright-mcp/page-2026-04-19T04-35-49-532Z.yml
.wiki-tmp
AGENTS.md
client/package.json
client/src/components/admin-layout.tsx
client/src/components/footer.tsx
client/src/components/navbar.tsx
client/src/globals.css
client/src/lib/api.ts
client/src/lib/markdown.ts
client/src/pages/admin/dashboard.tsx
opencode.json
server/package.json
server/src/index.ts

💤 Files with no reviewable changes (5)

.playwright-mcp/page-2026-04-19T04-35-49-532Z.yml
server/package.json
.playwright-mcp/page-2026-04-19T04-35-40-096Z.yml
.wiki-tmp
server/src/index.ts

📜 Review details

🧰 Additional context used

📓 Path-based instructions (5)

client/src/**/*.{ts,tsx}

📄 CodeRabbit inference engine (AGENTS.md)

DOMPurify must sanitize Markdown rendered output with whitelist allowing iframe/video embeds

Files:

client/src/lib/api.ts
client/src/pages/admin/dashboard.tsx
client/src/lib/markdown.ts
client/src/components/navbar.tsx
client/src/components/footer.tsx
client/src/components/admin-layout.tsx

client/src/pages/**

⚙️ CodeRabbit configuration file

client/src/pages/**: 页面级组件。审查时请关注： 1. 数据加载和错误处理是否完善 2. SEO 相关（页面标题、meta 标签） 3. 导航和路由是否正确

Files:

client/src/pages/admin/dashboard.tsx

client/src/components/**

⚙️ CodeRabbit configuration file

client/src/components/**: 这是 React 前端组件目录。审查时请关注： 1. 是否同时兼容暗色和亮色主题（检查 CSS 变量和 data-theme） 2. 响应式布局是否完整（移动端/平板/桌面端） 3. 无障碍访问（aria 标签、键盘导航） 4. 组件是否保持单一职责

Files:

client/src/components/navbar.tsx
client/src/components/footer.tsx
client/src/components/admin-layout.tsx

.gitignore

📄 CodeRabbit inference engine (AGENTS.md)

package-lock.json must never be added to .gitignore

Files:

.gitignore

client/src/globals.css

⚙️ CodeRabbit configuration file

client/src/globals.css: 全局样式和 CSS 变量系统。审查时请关注： 1. [data-theme="light"] 和默认暗色主题的变量是否配对 2. OKLCH 色值的明度/色度是否合理 3. 是否有遗漏的选择器未覆盖亮色模式

Files:

client/src/globals.css

🧠 Learnings (6)

📓 Common learnings

Learnt from: CR
Repo: one-ea/Monolith

Timestamp: 2026-04-25T02:24:16.009Z
Learning: Use `npm run deploy:cloudflare` for one-command deployment, strictly forbidden to manually run `wrangler pages deploy`

Learnt from: CR
Repo: one-ea/Monolith

Timestamp: 2026-04-25T02:24:16.009Z
Learning: Must deploy `dist` directory from `client/` directory, otherwise Pages Functions will be omitted

Learnt from: CR
Repo: one-ea/Monolith

Timestamp: 2026-04-25T02:24:16.009Z
Learning: CI 'Sync Worker secrets' step must inject ADMIN_PASSWORD / JWT_SECRET via `wrangler secret put`

Learnt from: CR
Repo: one-ea/Monolith

Timestamp: 2026-04-25T02:24:16.009Z
Learning: When D1 migration markers are out of sync, manually `INSERT INTO d1_migrations` to resolve

Learnt from: CR
Repo: one-ea/Monolith

Timestamp: 2026-04-25T02:24:16.009Z
Learning: Use deployment unique URLs when validating Cloudflare CDN behavior due to short-lived caching

Learnt from: CR
Repo: one-ea/Monolith

Timestamp: 2026-04-25T02:24:16.009Z
Learning: Production branch is `main` (auto-deployed by Cloudflare Pages); development happens on `dev` branch; strictly forbidden to push directly to main

Learnt from: CR
Repo: one-ea/Monolith

Timestamp: 2026-04-25T02:24:16.009Z
Learning: Main branch requires 1 approval + linear history + status checks before merging

Learnt from: CR
Repo: one-ea/Monolith

Timestamp: 2026-04-25T02:24:16.009Z
Learning: Preferred workflow: dev development → commit → push → PR → squash merge to main → deploy