chore: remove per-file SPDX headers (#2135)

Author: koistya

.claude/commands/migrate-to-d1.md

@@ -6,15 +6,8 @@ Migrate the project from Neon to Cloudflare D1 database following these steps:
 
 ```typescript
 /**
- * Drizzle ORM configuration supporting dual-mode database connections.
- *
- * Local: Uses Wrangler-generated SQLite file from .wrangler/state/v3/d1/ directory.
- * Remote: Connects to Cloudflare D1 production database via HTTPS using account credentials.
- *
- * Environment detection based on npm lifecycle events or DB environment variable.
- *
- * SPDX-FileCopyrightText: 2014-present Kriasoft
- * SPDX-License-Identifier: MIT
+ * Drizzle ORM configuration for dual-mode (local/remote) D1 connections.
+ * Local: Wrangler SQLite file. Remote: D1 via HTTPS with account credentials.
  */
 
 import { defineConfig } from "drizzle-kit";

.gitignore

@@ -76,6 +76,7 @@ docs/.vitepress/dist
 *.local.md
 *.local.json
 *.local.jsonc
+*.local.ts
 
 # macOS
 # https://github.com/github/gitignore/blob/master/Global/macOS.gitignore

.vscode/settings.json

@@ -100,7 +100,6 @@
     "relyingparty",
     "signup",
     "sourcemap",
-    "spdx",
     "swapi",
     "tarkus",
     "trpc",

CLAUDE.md

@@ -83,3 +83,4 @@ bun app:deploy                 # Deploy main React app
 2. **Modern TypeScript:** Leverage latest features (e.g., const assertions, template literals); avoid legacy patterns like `_` prefixes for private variables.
 3. **Imports:** Use named imports (e.g., `import { foo } from "bar";`) for tree-shaking, readability, and modern standards; avoid namespace imports (e.g., `import * as baz from "bar";`).
 4. **Bun/Hono Idioms:** Incorporate Bun-specific features (e.g., native APIs) and Hono middleware patterns for performance and simplicity.
+5. **Comments:** Use brief `//` rationale comments for non-obvious logic; reserve `@file` JSDoc blocks for core architectural files only.

apps/api/dev.ts

@@ -1,17 +1,7 @@
 /**
- * Local development server that emulates Cloudflare Workers runtime with Neon database.
+ * @file Local development server emulating Cloudflare Workers runtime.
  *
- * WARNING: This file uses getPlatformProxy which requires wrangler.jsonc configuration.
- * Hyperdrive bindings must be configured for both HYPERDRIVE_CACHED and HYPERDRIVE_DIRECT.
- *
- * @example
- * ```bash
- * bun --filter @repo/api dev
- * bun --filter @repo/api dev --env=staging  # Use staging environment config
- * ```
- *
- * SPDX-FileCopyrightText: 2014-present Kriasoft
- * SPDX-License-Identifier: MIT
+ * Requires wrangler.jsonc with HYPERDRIVE_CACHED and HYPERDRIVE_DIRECT bindings.
  */
 
 import { Hono } from "hono";
@@ -35,27 +25,23 @@ type CloudflareEnv = {
   HYPERDRIVE_DIRECT: Hyperdrive;
 } & Env;
 
-// [INITIALIZATION]
 const app = new Hono<AppContext>();
 
-// NOTE: persist:true maintains D1 state across restarts (.wrangler directory)
-// Environment defaults to 'dev' unless --env flag is provided
+// persist:true maintains state across restarts in .wrangler directory
 const cf = await getPlatformProxy<CloudflareEnv>({
   configPath: "./wrangler.jsonc",
   environment: args.env ?? "dev",
   persist: true,
 });
 
-// [CONTEXT INJECTION]
-// Creates two database connections per request:
-// - db: Uses Hyperdrive caching (read-heavy queries)
-// - dbDirect: Bypasses cache (write operations, transactions)
+// Inject context with two database connections:
+// - db: Hyperdrive caching for read-heavy queries
+// - dbDirect: No cache for writes and transactions
 app.use("*", async (c, next) => {
   const db = createDb(cf.env.HYPERDRIVE_CACHED);
   const dbDirect = createDb(cf.env.HYPERDRIVE_DIRECT);
 
-  // Priority: Cloudflare bindings > process.env > empty string
-  // Required for local dev where secrets aren't in wrangler.jsonc
+  // Merge secrets from process.env (local dev) with Cloudflare bindings
   const secretKeys = [
     "BETTER_AUTH_SECRET",
     "GOOGLE_CLIENT_ID",
@@ -72,7 +58,6 @@ app.use("*", async (c, next) => {
     ),
     APP_NAME: process.env.APP_NAME || cf.env.APP_NAME || "Example",
     APP_ORIGIN:
-      // Prefer origin set by `apps/app` at runtime
       c.req.header("x-forwarded-origin") ||
       process.env.APP_ORIGIN ||
       c.env.APP_ORIGIN ||
@@ -85,7 +70,6 @@ app.use("*", async (c, next) => {
   await next();
 });
 
-// Routes from ./index.js mounted at root
 app.route("/", api);
 
 export default app;

apps/api/index.ts

@@ -1,11 +1,7 @@
 /**
- * Main exports for the API package.
+ * @file Public API surface for the backend package.
  *
- * This file serves as the public interface for the API package, exporting
- * utilities, routers, types, and the core application for library usage.
- *
- * SPDX-FileCopyrightText: 2014-present Kriasoft
- * SPDX-License-Identifier: MIT
+ * Re-exports the Hono app, tRPC router, and core utilities.
  */
 
 // Core utilities and services

apps/api/lib/ai.ts

@@ -1,6 +1,3 @@
-/* SPDX-FileCopyrightText: 2014-present Kriasoft */
-/* SPDX-License-Identifier: MIT */
-
 import type { OpenAIProvider } from "@ai-sdk/openai";
 import { createOpenAI } from "@ai-sdk/openai";
 import type { Env } from "./env";

apps/api/lib/app.ts

@@ -1,12 +1,7 @@
 /**
- * Core Hono application for the API.
+ * @file Hono app construction and tRPC router initialization.
  *
- * This module contains the pure API routing logic that can be used across
- * different deployment environments (local development, Cloudflare Workers, etc.).
- * The app expects database and auth to be initialized upstream via middleware.
- *
- * SPDX-FileCopyrightText: 2014-present Kriasoft
- * SPDX-License-Identifier: MIT
+ * Combines authentication, tRPC, and health check endpoints into a single HTTP router.
  */
 
 import { fetchRequestHandler } from "@trpc/server/adapters/fetch";

apps/api/lib/auth.ts

@@ -1,6 +1,3 @@
-/* SPDX-FileCopyrightText: 2014-present Kriasoft */
-/* SPDX-License-Identifier: MIT */
-
 import { schema as Db } from "@repo/db";
 import { betterAuth } from "better-auth";
 import type { DB } from "better-auth/adapters/drizzle";

apps/api/lib/context.ts

@@ -1,6 +1,3 @@
-/* SPDX-FileCopyrightText: 2014-present Kriasoft */
-/* SPDX-License-Identifier: MIT */
-
 import type { DatabaseSchema } from "@repo/db";
 import type { CreateHTTPContextOptions } from "@trpc/server/adapters/standalone";
 import type { Session, User } from "better-auth/types";