JayXiao718/fullstack-starter
1
0
Fork 0
forked from imbytecat/fullstack-starter
Code Pull Requests Activity

docs(agents): 同步 embed-migrations 与 sql.d.ts，修陈旧描述

Browse Source 
- CLI 帮助块与 Layout migrate.ts 注释从 "from ./drizzle" 改为 "embedded migrations"
- 补 src/sql.d.ts（with { type: 'text' } SQL 导入的载体）到 Layout
- 补 patches/（patchedDependencies 用途）到 Layout
This commit is contained in:
imbytecat
2026-04-25 14:11:21 +08:00
parent 7e27640a26
commit f520b54ca5
1 changed files with 4 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files
AGENTS.md
+4 -2
View File
@@ -56,7 +56,7 @@ Before committing: `bun run fix && bun run typecheck && bun run test`. No CI, no
``` ```
./server [serve] # default — start the HTTP server ./server [serve] # default — start the HTTP server
./server migrate # apply migrations from ./drizzle ./server migrate # apply embedded migrations
./server --help ./server --help
``` ```
@@ -137,7 +137,7 @@ src/
│ └── queries/ # per-feature query hooks: keys, options, `useInvalidate<Feature>` helpers │ └── queries/ # per-feature query hooks: keys, options, `useInvalidate<Feature>` helpers
├── cli/ # CLI subcommands (loaded lazily by bin.ts via citty) ├── cli/ # CLI subcommands (loaded lazily by bin.ts via citty)
│ ├── serve.ts # `./server serve` — imports the Nitro bridge on demand │ ├── serve.ts # `./server serve` — imports the Nitro bridge on demand
│ ├── migrate.ts # `./server migrate` — drizzle migrate against ./drizzle │ ├── migrate.ts # `./server migrate` — applies embedded migrations via public `db.execute(sql)` + `db.transaction()`
│ ├── _serve-nitro.mjs # bridge: `import('../../.output/server/index.mjs')` │ ├── _serve-nitro.mjs # bridge: `import('../../.output/server/index.mjs')`
│ └── _serve-nitro.d.mts # types for the bridge (build output has no .d.ts) │ └── _serve-nitro.d.mts # types for the bridge (build output has no .d.ts)
├── routes/ ├── routes/
@@ -166,12 +166,14 @@ src/
├── components/ # non-route UI primitives (PascalCase, arrow const) ├── components/ # non-route UI primitives (PascalCase, arrow const)
├── env.ts # t3-oss env validation ├── env.ts # t3-oss env validation
├── router.tsx # QueryClient + setupRouterSsrQueryIntegration ├── router.tsx # QueryClient + setupRouterSsrQueryIntegration
├── sql.d.ts # ambient `declare module '*.sql'` — load-bearing for `with { type: 'text' }` imports in migrations.gen.ts
├── styles.css # Tailwind v4 entry ├── styles.css # Tailwind v4 entry
└── routeTree.gen.ts # auto-generated, do not edit └── routeTree.gen.ts # auto-generated, do not edit
bin.ts # citty entry (root) — keep imports minimal (see "CLI" section) bin.ts # citty entry (root) — keep imports minimal (see "CLI" section)
compile.ts # `bun build --compile` driver; resolves --target; sets minify/bytecode/sourcemap compile.ts # `bun build --compile` driver; resolves --target; sets minify/bytecode/sourcemap
embed-migrations.ts # codegen: scans ./drizzle/meta/_journal.json → src/server/db/migrations.gen.ts embed-migrations.ts # codegen: scans ./drizzle/meta/_journal.json → src/server/db/migrations.gen.ts
drizzle/ # SQL migrations (source of truth for `db:generate`; not shipped in binary) drizzle/ # SQL migrations (source of truth for `db:generate`; not shipped in binary)
patches/ # Bun `patchedDependencies` — patches `@tanstack/start-plugin-core` to drop the `@rsbuild/core` mis-import (see `package.json`)
``` ```
Nitro plugins are wired in `vite.config.ts` (`nitro({ plugins: [...] })`), not via a Nitro config file. Nitro plugins are wired in `vite.config.ts` (`nitro({ plugins: [...] })`), not via a Nitro config file.