chore: rewrite AGENT.md to AGENTS.md with updated guidelines, restruc…

AGENTS.md

@@ -0,0 +1,40 @@
+# Repository Guidelines
+
+## Project Structure & Module Organization
+- Monorepo managed by Turborepo. Workspaces: `apps/*`, `packages/*`, `tooling/*`, `scripts/`.
+- Web app and workers live in `apps/` (e.g., `apps/web`, `apps/opennext-cache`).
+- Reusable libraries live in `packages/` (e.g., `packages/api`, `packages/db`, `packages/ui`).
+- Environment examples in `.env.example`; copy and adapt to `.env.local`.
+
+## Build, Test, and Development Commands
+- Install deps: `bun install` (requires Node >= 24, Bun 1.2+).
+- Dev (all apps): `bun run dev`; Web-only: `bun run dev:web`.
+- Build all: `bun run build`; Type checks: `bun run typecheck`.
+- Format check/fix: `bun run format` / `bun run format:fix`.
+- Lint check/fix: `bun run lint` / `bun run lint:fix`.
+- DB workflows: `bun run migration:generate`, `bun run migration:local`, `bun run studio:dev`.
+- Preview/Deploy (Cloudflare): `bun run preview`, `bun run deploy`.
+- Tests across workspaces (if defined): `turbo test` (or run per package).
+
+## Coding Style & Naming Conventions
+- Formatter/Linter: Biome (see `biome.json`).
+- Indentation: 2 spaces; line width: 100; quotes: single; semicolons: as needed; trailing commas: ES5.
+- TypeScript-first; keep strict types and meaningful names.
+- Prefer feature-oriented folders; test files near code or under `__tests__/`.
+- Zod v4 only: `import { z } from 'zod/v4'`.
+
+## Testing Guidelines
+- Framework: Vitest. Typical locations: `__tests__/` or `*.test.ts` adjacent to source.
+- Run all: `turbo test`; per package: `bun test` (from that workspace) or package-specific scripts.
+- Name tests `*.test.ts`; add integration tests where behavior spans modules.
+- Aim for reliable, isolated tests; include minimal setup files when needed.
+
+## Commit & Pull Request Guidelines
+- Use Conventional Commits: `feat:`, `fix:`, `chore:`, `refactor:`; optional scope (e.g., `feat(web): ...`).
+- PRs must include: concise description, linked issues (`#123`), screenshots for UI, and passing checks (build, typecheck, lint, tests).
+- Keep changes scoped; update docs and `.env.example` when config changes.
+
+## Security & Configuration Tips
+- Never commit secrets; use `.env.local` for local-only settings.
+- Validate env at runtime (see `@t3-oss/env-nextjs` usage in the repo).
+- For DB changes, always generate migrations and run locally before PR.

apps/builder/CHANGELOG.md

@@ -1,5 +1,11 @@
 # vite-shadcn-builder-libra
 
+## 1.0.3
+
+### Patch Changes
+
+- mini update & fix
+
 ## 1.0.2
 
 ### Patch Changes

apps/builder/package.json

@@ -1,7 +1,7 @@
 {
   "name": "vite-shadcn-builder-libra",
   "private": true,
-  "version": "1.0.2",
+  "version": "1.0.3",
   "type": "module",
   "scripts": {
     "dev": "vite",
@@ -44,10 +44,10 @@
     "@splinetool/react-spline": "^4.1.0",
     "react-router-dom": "^7.8.0",
     "tailwind-merge": "^3.3.1",
-    "zod": "^4.0.15",
+    "zod": "^4.0.16",
     "@hookform/resolvers": "^5.2.1",
     "hono": "^4.9.0",
-    "@tanstack/react-query": "^5.84.1",
+    "@tanstack/react-query": "^5.84.2",
     "recharts": "^2.15.4",
     "vaul": "^1.1.2",
     "react": "^19.1.1",
@@ -56,7 +56,7 @@
     "motion": "^12.23.12"
   },
   "devDependencies": {
-    "@types/node": "^22.17.0",
+    "@types/node": "^22.17.1",
     "@types/react": "^19.1.9",
     "@types/react-dom": "^19.1.7",
     "@tailwindcss/vite": "^4.1.11",
@@ -71,6 +71,6 @@
     "vite": "^6.3.5",
     "@cloudflare/vite-plugin": "^1.11.2",
     "wrangler": "4.27.0",
-    "@cloudflare/workers-types": "^4.20250807.0"
+    "@cloudflare/workers-types": "^4.20250809.0"
   }
 }

apps/deploy/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @libra/deploy
 
+## 1.0.3
+
+### Patch Changes
+
+- mini update & fix
+
 ## 1.0.2
 
 ### Patch Changes

apps/deploy/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@libra/deploy",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Queue-based deployment service for Libra platform",
   "scripts": {
     "dev": "wrangler dev --port 3008 --persist-to=../web/.wrangler/state",
@@ -23,12 +23,12 @@
     "hono": "^4.9.0",
     "@scalar/hono-api-reference": "^0.9.13",
     "@hono/zod-openapi": "^0.19.10",
-    "zod": "^4.0.15",
+    "zod": "^4.0.16",
     "drizzle-orm": "^0.44.4"
   },
   "devDependencies": {
     "wrangler": "4.27.0",
-    "@types/node": "^24.2.0",
+    "@types/node": "^24.2.1",
     "typescript": "^5.9.2",
     "vitest": "^3.2.4",
     "@vitest/coverage-v8": "^3.2.4"

apps/dispatcher/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @libra/dispatcher
 
+## 1.0.3
+
+### Patch Changes
+
+- mini update & fix
+
 ## 1.0.2
 
 ### Patch Changes

apps/dispatcher/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@libra/dispatcher",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "type": "module",
   "scripts": {
     "dev": "wrangler dev --port 3007 --persist-to=../web/.wrangler/state",
@@ -17,13 +17,13 @@
     "@libra/middleware": "*",
     "hono": "^4.9.0",
     "pg": "^8.16.3",
-    "zod": "^4.0.15",
+    "zod": "^4.0.16",
     "@hono/zod-openapi": "^0.19.10",
     "@scalar/hono-api-reference": "^0.9.13"
   },
   "devDependencies": {
     "wrangler": "4.27.0",
-    "@cloudflare/workers-types": "^4.20250807.0",
+    "@cloudflare/workers-types": "^4.20250809.0",
     "typescript": "^5.9.2",
     "dotenv": "^17.2.1",
     "dotenv-cli": "^10.0.0",

apps/docs/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @libra/docs
 
+## 1.0.3
+
+### Patch Changes
+
+- mini update & fix
+
 ## 1.0.2
 
 ### Patch Changes

apps/docs/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@libra/docs",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "private": true,
   "scripts": {
     "build": "next build",
@@ -16,7 +16,7 @@
     "octokit": "^5.0.3",
     "@orama/tokenizers": "^3.1.11",
     "@orama/orama": "^3.1.11",
-    "zod": "^4.0.15"
+    "zod": "^4.0.16"
   },
   "devDependencies": {
     "@types/mdx": "^2.0.13"

apps/screenshot/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @libra/screenshot
 
+## 1.0.3
+
+### Patch Changes
+
+- mini update & fix
+
 ## 1.0.2
 
 ### Patch Changes

apps/screenshot/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@libra/screenshot",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Queue-based screenshot service for Libra platform",
   "scripts": {
     "dev": "wrangler dev --port 3009 --persist-to=../web/.wrangler/state",
@@ -24,12 +24,12 @@
     "hono": "^4.9.0",
     "@scalar/hono-api-reference": "^0.9.13",
     "@hono/zod-openapi": "^0.19.10",
-    "zod": "^4.0.15",
+    "zod": "^4.0.16",
     "drizzle-orm": "^0.44.4"
   },
   "devDependencies": {
     "wrangler": "4.27.0",
-    "@types/node": "^24.2.0",
+    "@types/node": "^24.2.1",
     "typescript": "^5.9.2",
     "vitest": "^3.2.4",
     "@vitest/coverage-v8": "^3.2.4"

apps/web/CHANGELOG.md

@@ -1,5 +1,14 @@
 # libra-core
 
+## 1.0.7
+
+### Patch Changes
+
+- mini update & fix
+- Updated dependencies
+  - @libra/better-auth-cloudflare@1.0.3
+  - @libra/email@1.0.2
+
 ## 1.0.6
 
 ### Patch Changes

apps/web/package.json

@@ -1,6 +1,6 @@
 {
   "name": "libra-core",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "private": true,
   "type": "module",
   "scripts": {
@@ -26,8 +26,8 @@
   },
   "dependencies": {
     "@ai-sdk/anthropic": "^2.0.1",
-    "@ai-sdk/azure": "^2.0.5",
-    "@ai-sdk/xai": "^2.0.2",
+    "@ai-sdk/azure": "^2.0.7",
+    "@ai-sdk/xai": "^2.0.3",
     "@git-diff-view/file": "^0.0.30",
     "@git-diff-view/react": "^0.0.30",
     "@hookform/resolvers": "^5.2.1",
@@ -46,7 +46,7 @@
     "@marsidev/react-turnstile": "^1.3.0",
     "@openrouter/ai-sdk-provider": "^1.1.0",
     "@shikijs/transformers": "^3.9.2",
-    "@tanstack/react-query": "^5.84.1",
+    "@tanstack/react-query": "^5.84.2",
     "@tanstack/react-table": "^8.21.3",
     "@tsparticles/engine": "^3.9.1",
     "@tsparticles/react": "^3.0.0",
@@ -60,7 +60,7 @@
     "motion": "^12.23.12",
     "next": "^15.4.6",
     "nextjs-toploader": "^3.8.16",
-    "posthog-js": "^1.258.6",
+    "posthog-js": "^1.259.0",
     "posthog-node": "^5.6.0",
     "react": "^19.1.1",
     "react-error-boundary": "^5.0.0",
@@ -75,7 +75,7 @@
   },
   "devDependencies": {
     "@types/diff": "^8.0.0",
-    "@tanstack/react-query-devtools": "^5.84.1",
+    "@tanstack/react-query-devtools": "^5.84.2",
     "@inlang/paraglide-js": "^2.2.0",
     "@inlang/cli": "^3.0.12",
     "@types/file-saver": "^2.0.7",