@qwen-code/arena-agent 0.0.9-dev.2 → 0.0.9-dev.21

package/docs/BINARY_DISTRIBUTION.md

@@ -0,0 +1,231 @@
+# Arena 多平台单文件二进制
+
+Arena 可以使用 Node.js Single Executable Applications（SEA）构建为一个包含
+Node.js 运行时、应用代码和静态资源的可执行文件。目标机器不需要安装 Node.js。
+
+如果业务机只是受安装权限或 Node.js 版本管理限制，这种方式可以绕过安装步骤。
+Linux x64 glibc 包固定使用 Node.js unofficial-builds 的 glibc 2.17 Runtime，支持
+CentOS 7 / glibc 2.17 及更新的 glibc 系统；低于 glibc 2.17 的系统仍无法运行。
+
+## npm 安装（业务机有 Node.js 18）
+
+推荐业务方安装统一入口包：
+
+```bash
+npm install -g @qwen-code/arena-cli
+arena --version
+code-harness --version
+```
+
+`@qwen-code/arena-cli` 是一个兼容 Node.js 18 的小型启动器。npm 会通过
+`optionalDependencies` 安装当前系统对应的平台包，启动器检测操作系统、CPU 和
+Linux libc 后运行其中的同一个 SEA 文件。`arena` 默认选择 Arena 模式，
+`code-harness` 默认选择 React 模式；二者都可用 `--mode` 选择四种模式。
+Harness 本身使用 SEA 内嵌的 Node.js 运行时，
+业务机不需要 Node.js 20+。
+
+不要使用 `--omit=optional` 安装入口包；否则需要显式安装对应的平台包。
+
+现有的 `@qwen-code/arena-agent` 继续提供 JavaScript CLI 和 SDK，并同时暴露
+`arena`、`code-harness` 两个命令，仍要求 Node.js 20.16+。它与平台包是两种
+分发形式，不是两套模式实现。
+
+## 直接安装（业务机没有 Node.js）
+
+npm 命令本身需要 Node.js。如果业务机连 Node.js 18 也没有，macOS/Linux 可以
+直接安装最新稳定版：
+
+```bash
+curl -fsSL https://cdn.jsdelivr.net/npm/@qwen-code/arena-cli@latest/install.sh | sh
+```
+
+跟随滚动更新的 dev 渠道并指定安装目录：
+
+```bash
+curl -fsSL https://cdn.jsdelivr.net/npm/@qwen-code/arena-cli@dev/install.sh \
+  | sh -s -- --version dev --install-dir "$HOME/bin"
+```
+
+这里的两个 `dev` 都需要保留：前者选择安装脚本，后者选择对应平台二进制。
+
+安装脚本检测 macOS/Linux、x64/arm64 与 Linux glibc/musl，从 npm 下载对应平台包，
+校验 tarball checksum，并把 `arena` 安装到 `~/.local/bin`。如果该目录不在 PATH，
+脚本会幂等更新当前 shell 的 profile；设置 `ARENA_NO_MODIFY_PATH=1` 可以关闭。
+
+也可以从平台包中取出 `bin/arena`（Windows 为 `bin/arena.exe`），直接复制运行。
+
+macOS / Linux：
+
+```bash
+chmod +x arena
+./arena --version
+./arena -p "分析当前项目"
+./arena --mode full-stack -p "创建一个应用"
+```
+
+Windows：
+
+```powershell
+.\arena.exe --version
+.\arena.exe -p "分析当前项目"
+```
+
+模型地址、密钥和其他配置仍通过 `.env` 或环境变量提供。
+
+## npm 平台包矩阵
+
+所有包必须使用与仓库根 `package.json` 完全相同的版本号。
+
+| 目标 | npm 包 |
+| --- | --- |
+| macOS arm64 | `@qwen-code/arena-darwin-arm64` |
+| macOS x64 | `@qwen-code/arena-darwin-x64` |
+| Linux arm64 glibc | `@qwen-code/arena-linux-arm64` |
+| Linux arm64 musl | `@qwen-code/arena-linux-arm64-musl` |
+| Linux x64 glibc | `@qwen-code/arena-linux-x64` |
+| Linux x64 musl | `@qwen-code/arena-linux-x64-musl` |
+| Windows x64 | `@qwen-code/arena-win32-x64` |
+
+Node SEA 使用 Node 官方运行时，不需要像部分 Bun 二进制那样再拆 AVX2 与 baseline。
+如果以后引入有额外 CPU 指令要求的原生依赖，再扩展目标矩阵。
+
+## 在各平台构建
+
+构建机要求 Node.js 20.16+。面向旧业务系统的正式发布建议固定使用 Node.js 20.x，
+不要因为构建 runner 自动升级而无意中嵌入 Node.js 22/24：
+
+```bash
+npm ci
+npm run package:binary
+```
+
+默认命令构建当前 runner 的系统、CPU 和 libc。CI 还支持在 Linux x64 上按 Node
+SEA 跨平台流程生成三个关键目标：`linux-x64` 固定下载完全相同版本的 Node.js
+unofficial-builds glibc 2.17 Runtime，`linux-x64-musl` 下载 unofficial-builds
+musl Runtime，`darwin-x64` 下载官方 macOS x64 Runtime。三者都通过 Aone 可访问的
+npmmirror 二进制镜像下载，并校验对应的
+`SHASUMS256.txt`，关闭 code cache/snapshot 后注入 SEA blob。
+macOS 产物再使用固定版本和 checksum 的 `rcodesign` 做 ad-hoc 签名。Aone 从仓库的
+`toolchains/apple-codesign-0.29.0` 工具链分支拉取固定 commit，避免构建时依赖 GitHub
+Release 的网络可用性；本地构建未指定 `ARENA_RCODESIGN_ARCHIVE` 时仍会从官方
+Release 下载。产物包括：
+
+- SEA 文件：macOS / Linux 为 `build/sea/arena`，Windows 为
+  `build/sea/arena.exe`
+- 待发布包目录：`build/npm/packages/<target>` 与 `build/npm/packages/cli`
+- npm tarball：`build/npm/tarballs/*.tgz`
+
+`build/sea` 最终只保留需要交付的可执行文件。构建脚本会自动运行一次
+`arena --version` 冒烟检查。
+
+Code Arena 的 prompt/tool contract 会编译进 bundle；React 与 Full Stack
+scaffold 会作为 SEA assets 一起嵌入。四种模式只构建一次，不为每个模式重复平台
+矩阵。
+
+如果已经有另一个 runner 产生的二进制，也可以只组装指定平台包：
+
+```bash
+node scripts/package-binaries.mjs \
+  --target linux-x64 \
+  --binary artifacts/linux-x64/arena \
+  --skip-cli
+```
+
+CI 应构建并汇总 `build/npm/packages/<target>`。原生 Runtime 通常应在对应环境中
+构建；禁用 SEA snapshot/code cache 后，`linux-x64`、`linux-x64-musl` 和
+`darwin-x64` 都可以在 Linux x64 Runner 上使用经过校验的目标 Node Runtime
+组装。
+
+本仓库使用 Aone CI，流水线定义在
+[`/.aoneci/arena-binaries.yaml`](../.aoneci/arena-binaries.yaml)。当前项目没有关联
+自托管 Runner 组，因此流水线优先使用 Aone 托管的 Linux amd64 资源构建
+`linux-x64`，并交叉构建 `linux-x64-musl` 和 `darwin-x64`。推送与根
+`package.json` 版本完全一致的 `v<semver>` Tag 时会自动运行，并在同一批次
+发布这三个关键平台包、`@qwen-code/arena-agent` 和
+`@qwen-code/arena-cli`；后两个包都包含四种模式和两个命令入口。普通分支 push
+不触发，手动运行只构建、不发布。发布前
+需要在“设置 → 持续集成 → 变量管理”中添加名为 `NPM_TOKEN` 的 Secret。
+
+例如，预发布版自动使用 npm `dev` tag：
+
+```bash
+npm version 0.0.10-dev.1 --no-git-tag-version
+git add package.json package-lock.json
+git commit -m "chore: release 0.0.10-dev.1"
+git push origin master
+git tag v0.0.10-dev.1
+git push origin v0.0.10-dev.1
+```
+
+正式版同理，例如 `package.json` 为 `0.0.10` 时推送 `v0.0.10`，发布脚本会自动
+使用 npm `latest` tag。Tag 名与版本不一致时发布步骤会直接失败，避免把错误版本
+发布到 npm。首次稳定版发布前请显式使用 `@dev` 或完整版本号；首个正式版本发布后
+才把无版本安装渠道作为稳定入口。
+
+Aone 官方不提供 Windows/macOS 托管资源；`darwin-x64` 已通过上述交叉构建覆盖。
+Linux arm64 的两个平台包暂不参与自动发布，以免非关键 ARM64 Job 阻塞 x64
+发布。发布 `darwin-arm64` 和 Windows 包前，仍需要关联对应的 self-hosted Runner
+组。
+
+## 发布
+
+汇总全部 7 个平台包目录后，重新生成一次入口包并进行发布前检查：
+
+```bash
+npm run package:binary:cli
+npm run publish:binaries -- --dry-run --tag dev
+```
+
+确认后去掉 `--dry-run`，按需传入 registry：
+
+```bash
+npm run publish:binaries -- \
+  --tag dev \
+  --registry https://registry.example.com
+```
+
+发布脚本会校验 7 个平台包和入口包的名称、版本、依赖是否一致，并严格依次发布
+平台包、`@qwen-code/arena-agent`，最后发布 `@qwen-code/arena-cli`。失败后重跑会
+跳过 npm 上已经存在的同版本包。预发布版本默认使用 `dev` tag，稳定版本默认使用
+`latest` tag，也可以显式用 `--tag` 覆盖。
+
+入口包必须最后发布；否则用户可能在平台包尚未可用时安装到一个缺少二进制的版本。
+
+## 平台与兼容性
+
+SEA 产物内含目标平台的 Node.js 可执行文件，因此需要为每种目标分别构建：
+
+- macOS arm64 与 x64
+- Linux arm64/x64 的 glibc 与 musl
+- Windows x64
+
+除流水线已覆盖的三个关键 x64 目标外，其他目标应在对应操作系统和 CPU 架构的
+构建机或 CI runner 上执行。
+
+“业务机不需要 Node.js 20+”不等于“二进制不受 Node.js 20 的系统要求影响”。
+SEA 把 Node.js 可执行文件放进 Arena，运行时仍由操作系统加载这个内嵌运行时：
+
+- 当前 Linux x64 glibc 包的最低要求是 glibc 2.17；
+- musl 包用于 Alpine 等 musl 系统，不能代替 glibc 包；
+- 在较新的 Linux 上打包，不能自动获得对更老 glibc 的兼容性。
+
+因此，业务机只有 Node.js 18 通常不是问题；真正需要确认的是它的操作系统、CPU
+架构和 `ldd --version`。Linux x64 的 glibc 2.17 兼容性来自构建脚本选择的
+`linux-x64-glibc-217` Runtime，而不是构建 runner 的系统版本。如果业务机低于
+glibc 2.17，仍必须使用更老系统兼容的 Runtime 重新制作平台包，或升级业务系统。
+仅仅在“更老的 Docker 镜像”里复制同一个官方 Node.js 二进制并不能降低其 glibc
+下限。
+
+单文件只消除了目标机器安装 Node.js 的要求，并不会内嵌所有外部程序：
+
+- `bash` 工具仍要求 `/bin/bash`。
+- Git 仓库识别仍需要系统提供 `git`。
+- 旧版 `.doc`、`.ppt`、`.xls` 转换仍需要 LibreOffice；现代 Office 文档和 PDF
+  读取已包含在二进制中。
+
+macOS 构建会进行 ad-hoc 签名。对外分发时，建议在构建完成后使用正式开发者证书
+重新签名并按组织要求完成 notarization。Windows 也可以在构建后使用组织证书签名。
+
+实现基于 [Node.js SEA 官方文档](https://nodejs.org/api/single-executable-applications.html)、
+[Node.js unofficial-builds](https://github.com/nodejs/unofficial-builds) 和
+[rcodesign 文档](https://gregoryszorc.com/docs/apple-codesign/stable/)。

package/docs/MODES_AND_RELEASES.md

@@ -0,0 +1,123 @@
+# 四模式架构与发包方案
+
+## 结论
+
+本仓库采用“一个核心包、四种运行模式”，不改成 monorepo。
+
+- `arena`、`react`、`html`、`full-stack` 共用当前仓库的配置、provider、
+  agent loop、compaction、history、metrics、CLI/TUI/server 和 SDK。
+- 模式边界只包含 system prompt、工具 schema/实现以及可选 scaffold。
+- 四种模式使用同一个版本号一起演进，避免两份 agent loop 再次漂移。
+- JavaScript/SDK 包与 SEA 二进制包是两种分发形式，可以按需要分别发布；
+  它们不是两套产品源码，也不要求 npm workspaces。
+
+## 目录
+
+```text
+src/
+  agent.ts                 # 唯一 agent loop
+  config.ts                # 唯一配置入口
+  tools.ts                 # mode-aware facade + Arena tools
+  code-tools.ts            # 三种 Code Arena 工具语义
+  mode.ts                  # 四模式名称、别名与默认 step limit
+  workspace.ts             # React/Full Stack scaffold 初始化
+
+spec/                      # Arena 生产 fixtures（保持原路径）
+modes/code-arena/
+  model.json               # 三种 Code Arena 共用模型参数
+  react/
+    system-prompt.txt
+    tools.json
+    template/
+  html/
+    system-prompt.txt
+    tools.json
+  full-stack/
+    system-prompt.txt
+    tools.json
+    template/
+```
+
+`scripts/generate-canonical-data.mjs` 将 Arena fixtures 和三种 Code Arena
+contract 一起编译到 `src/canonical-data.ts`。正常 npm 运行不读取 prompt/schema
+源文件；scaffold 仍作为包资源保留，SEA 构建时则作为 assets 嵌入二进制。
+
+## 模式选择
+
+统一 CLI 使用显式参数：
+
+```bash
+arena --mode arena -p '...'
+arena --mode react -p '...'
+arena --mode html -p '...'
+arena --mode full-stack -p '...'
+```
+
+兼容命令 `code-harness` 进入同一 CLI，缺省模式为 `react`。环境变量优先级为：
+
+1. CLI `--mode`
+2. `ARENA_HARNESS_MODE`
+3. `CODE_HARNESS_MODE`（兼容）
+4. `ARENA_MODE`（兼容）
+5. `arena` 命令默认 `arena`；`code-harness` 命令默认 `react`
+
+历史记录会保存 `mode`，system prompt 的 canonical 校验会阻止用错误模式续跑
+同一轨迹。Code Arena 模式不启用 Arena 的自动 repo prompt；即使工作区位于 Git
+仓库中，也仍使用所选的 Code Arena prompt。
+
+## npm 与二进制
+
+### JavaScript/SDK 包
+
+`@qwen-code/arena-agent` 同时发布：
+
+- `arena -> dist/cli.js`
+- `code-harness -> dist/code-cli.js`
+- SDK 的 Arena 名称与 Code Harness 兼容别名
+- 四种模式所需的 scaffold
+
+这是日常源码安装和 SDK 消费的发布单元，要求 Node.js 20.16+。
+
+### 单文件二进制
+
+`@qwen-code/arena-cli` 是兼容 Node.js 18 的平台选择器，同时提供 `arena` 和
+`code-harness` 两个命令。它们启动同一个 SEA 文件；`code-harness` launcher
+只负责注入默认 `react` 模式。平台包继续使用 `@qwen-code/arena-<platform>`
+命名，无需为四种模式复制一套平台矩阵。
+
+因此一次平台构建包含全部四种模式，版本和校验和天然一致。
+
+## 发布节奏
+
+可以只发布 JavaScript/SDK 包，也可以在随后完成 7 个平台的 SEA 包和 launcher；
+但不建议单独发布某一个模式。推荐顺序：
+
+```bash
+npm run typecheck
+npm test
+npm pack --dry-run
+
+# 每个平台 runner
+npm run package:binary:platform
+
+# 汇总平台产物后
+npm run package:binary:cli
+npm run publish:binaries -- --dry-run
+```
+
+平台包必须先于 `@qwen-code/arena-cli` 发布。完整矩阵见
+[`BINARY_DISTRIBUTION.md`](BINARY_DISTRIBUTION.md)。
+
+## 原 Code Harness 的迁移边界
+
+迁入的是三种模式的运行时 contract、工具行为和 scaffold；没有迁入旧仓库中
+已经落后的 agent loop、配置、server、SDK 或 Web UI 副本。
+
+未完成的一致性实验已作为开发数据迁到 `tasks/code-harness/`：包含三个模式共
+150 个历史 case、行为配置、选定 baseline，以及直接调用本仓库统一 runtime 的
+输入重建、工具 replay、behavior 和 probe runner。重复的原始 JSONL、ignored
+中间报告和旧 runtime 没有复制。`package.json#files` 不包含 `tasks/` 或这些实验
+脚本，因此它们不会进入 npm/SEA 运行包，也不会形成第二套 runtime。
+
+只有在两组模式确实需要独立版本、独立依赖或不同发布权限时，才值得增加两个
+很薄的入口包；即便如此，共享核心仍应留在本仓库，而不是复制实现。

package/docs/SDK.md

@@ -289,6 +289,10 @@ if (
 | `start` | Turn 已开始 |
 | `reasoning-start/delta/end` | reasoning 流 |
 | `text-start/delta/end` | 最终文本流 |
+| `model.start` | 模型请求开始，包含 step 与实际 offered tools |
+| `model.retry` | 流式模型请求正在自动重试，包含 attempt 与 error；丢弃本次请求此前的 delta |
+| `model.complete` | 模型请求完成，包含 finish reason 与 usage |
+| `compaction` | 上下文压缩完成；其 usage 只通过此事件上报 |
 | `tool-input-start/delta/available` | 模型正在生成工具调用 |
 | `tool-output-available` | 工具执行结果 |
 | `data-agent-status` | 当前模型或工具阶段 |
@@ -337,6 +341,16 @@ return [
 ];
 ```
 
+如果调用方选择跳过，返回结构化响应。Agent 会收到标准 skipped tool result 并
+继续当前 Turn：
+
+```ts
+return {
+  answers: [],
+  skipped: true,
+};
+```
+
 ### UI 手动回答
 
 不传 `onInputRequired`，收到事件后渲染自己的 UI：
@@ -354,6 +368,15 @@ for await (const event of session.stream({
 }
 ```
 
+手动 UI 也可以跳过：
+
+```ts
+await session.respondToInput(request.requestId, {
+  answers: [],
+  skipped: true,
+});
+```
+
 答案格式：
 
 ```ts
@@ -545,7 +568,7 @@ session.retry(options?)
 session.upload(file)
 session.download(path)
 session.workspaceUrl(path)
-session.respondToInput(requestId, answers)
+session.respondToInput(requestId, answersOrResponse)
 session.cancel()
 session.undo()
 ```

package/modes/code-arena/full-stack/system-prompt.txt

@@ -0,0 +1,77 @@
+You are an expert fullstack developer building web applications with Next.js (App Router) and PostgreSQL via Drizzle ORM. You will use the provided tools to view, create, and edit files in the project.
+For any user prompt, always try to generate a working fullstack web application. Always just update the code instead of asking the user to confirm details.
+
+## Critical File Operations
+
+All file operations must be done exclusively through the provided tools. After using a tool, provide only a brief summary of what you did - DO NOT output the actual code content in your response text.
+You can use 'list_files', 'grep_files', 'glob_files', and 'bash' to explore the project, search file contents by regex, and discover files by name pattern.
+
+## Web Research
+
+You have access to 'web_search' and 'web_fetch' tools for researching information on the internet.
+- Use 'web_search' to find documentation, API references, examples, or any facts you need. This is especially useful when the user asks you to integrate a third-party API or library you're not fully familiar with.
+- Use 'web_fetch' to read the content of a specific web page, such as documentation or API reference pages found via search.
+- When the user's request involves a specific API, service, or library, proactively search for its documentation to ensure you use the correct endpoints, parameters, and authentication methods rather than guessing.
+
+## Task Planning
+
+You have a maximum of 50 sequential tool-calling steps to complete the task. Plan your approach carefully and prioritize the most critical changes first to work within this limit.
+
+For each file you create or edit, you must first explain what you are about to do, then call the tool, then confirm the result.
+
+Do not ask me for anything. Go with your recommendation.
+
+## Database
+
+The project connects to a local PostgreSQL instance via Drizzle ORM.
+- The database connection is configured in `src/db/index.ts` and reads `DATABASE_URL` from the `.env` file.
+- Use Drizzle ORM for all database interactions. Import the `db` client from `@/db`.
+- Tailwind CSS is already installed and wired through `src/app/globals.css`, so you can use Tailwind utility classes immediately.
+- When defining new tables, edit `src/db/schema.ts` and use `drizzle-orm/pg-core`.
+- If you need to apply schema changes in a fresh sandbox, call `build_and_start` first so the environment is bootstrapped and dependencies are installed.
+- After `build_and_start` has prepared the environment, you may use the `bash` tool to run `npx drizzle-kit push` to apply schema changes directly without migration files.
+- If you apply schema changes after a previously passing validation run, rerun the full validation sequence and end with `build_and_start` again.
+- You can also run raw SQL via the bash tool: `psql postgresql://postgres:postgres@127.0.0.1:5432/app_db -c "YOUR SQL"`
+
+## Requirements
+
+The platform builds and starts the preview after your tool calls complete.
+Do not assume there is a running app server while you edit files.
+Do not leave behind long-lived `next dev` or `next start` processes unless you are debugging a blocker.
+ALWAYS create complete, functional fullstack web applications.
+NEVER edit package.json directly. Use the 'install_npm_packages' tool to install new packages.
+
+## Final Validation
+
+Before you finish, you MUST use the `bash` tool to run all of these commands from the project root:
+- `bash -lc 'set -o pipefail; npx next typegen 2>&1 | tee /tmp/next-typegen.log'`
+- `bash -lc 'set -o pipefail; npm exec tsc -- --noEmit --pretty false 2>&1 | tee /tmp/tsc.log'`
+- `bash -lc 'set -o pipefail; npm run build 2>&1 | tee /tmp/build.log'`
+
+After those commands pass, you MUST call the `build_and_start` tool. This tool bootstraps the database, builds the app, starts the production server, and verifies `/api/health`.
+
+Do not run `npm run start` or `next start` directly via `bash` as your final validation step.
+Do not finish until type generation, TypeScript, production build, and `build_and_start` all pass.
+Do not treat `npm run typecheck` as sufficient final validation.
+If any validation command fails, immediately inspect the matching log before fixing the code:
+- `cat /tmp/next-typegen.log`
+- `cat /tmp/tsc.log`
+- `cat /tmp/build.log`
+If `build_and_start` fails, carefully inspect the returned `stage` and `logTail` before fixing the code.
+If any validation step fails, keep fixing the project and do not finish yet.
+If you make any code, package, or schema change after a passing validation run, rerun the full validation sequence before finishing.
+Do not rely on the platform's post-turn preview build as proof the task is done; you must confirm the build yourself during the turn.
+
+## Environment Variables
+
+The user may have configured environment variable secrets (API keys, tokens, etc.) for this sandbox.
+- Server-side code (API routes, server components, route handlers): access via `process.env.KEY_NAME`
+- Client-side code: only `NEXT_PUBLIC_*` prefixed vars are exposed to the browser bundle
+- For external API calls that require secrets, create an API route under `app/api/` that reads `process.env.KEY_NAME` and proxies the request — this keeps secrets server-side
+- Do NOT hardcode API keys or secrets — always read from `process.env`
+
+## Remember
+
+Use tools for all file creation and editing. Never output code directly in your response text.
+Feel free to use multiple files in your implementation.
+The preview is rebuilt and restarted after you finish your edits for the turn.

package/modes/code-arena/full-stack/template/.env

@@ -0,0 +1 @@
+DATABASE_URL=postgresql://postgres:postgres@127.0.0.1:5432/app_db

package/modes/code-arena/full-stack/template/drizzle.config.json

@@ -0,0 +1,7 @@
+{
+  "dialect": "postgresql",
+  "schema": "./src/db/schema.ts",
+  "dbCredentials": {
+    "url": "postgresql://postgres:postgres@127.0.0.1:5432/app_db"
+  }
+}

package/modes/code-arena/full-stack/template/eslint.config.mjs

@@ -0,0 +1,9 @@
+import { defineConfig, globalIgnores } from "eslint/config";
+import nextVitals from "eslint-config-next/core-web-vitals";
+import nextTs from "eslint-config-next/typescript";
+
+export default defineConfig([
+  ...nextVitals,
+  ...nextTs,
+  globalIgnores([".next/**", "out/**", "build/**", "next-env.d.ts"]),
+]);

package/modes/code-arena/full-stack/template/next.config.ts

@@ -0,0 +1,5 @@
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {};
+
+export default nextConfig;

package/modes/code-arena/full-stack/template/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "nextjs-postgresql-template",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "dotenv": "17.3.1",
+    "drizzle-orm": "0.45.2",
+    "next": "16.2.6",
+    "pg": "8.20.0",
+    "react": "19.2.6",
+    "react-dom": "19.2.6"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "4.1.17",
+    "@types/node": "22.19.15",
+    "@types/pg": "8.18.0",
+    "@types/react": "19.2.14",
+    "@types/react-dom": "19.2.3",
+    "drizzle-kit": "0.31.10",
+    "eslint": "9.39.4",
+    "eslint-config-next": "16.2.6",
+    "postcss": "8.5.8",
+    "tailwindcss": "4.1.17",
+    "typescript": "5.9.3"
+  }
+}

package/modes/code-arena/full-stack/template/postcss.config.mjs

@@ -0,0 +1,7 @@
+const config = {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};
+
+export default config;

package/modes/code-arena/full-stack/template/src/app/api/health/route.ts

@@ -0,0 +1,13 @@
+import { db } from "@/db";
+import { sql } from "drizzle-orm";
+
+export const dynamic = "force-dynamic";
+
+export async function GET() {
+  try {
+    await db.execute(sql`select 1`);
+    return Response.json({ ok: true });
+  } catch {
+    return Response.json({ ok: false }, { status: 500 });
+  }
+}

package/modes/code-arena/full-stack/template/src/app/globals.css

@@ -0,0 +1 @@
+@import "tailwindcss";

package/modes/code-arena/full-stack/template/src/app/layout.tsx

@@ -0,0 +1,16 @@
+import type { Metadata } from "next";
+import type { ReactNode } from "react";
+import "./globals.css";
+
+export const metadata: Metadata = {
+  title: "Arena Next.js PostgreSQL Starter",
+  description: "Starter template with Next.js, Drizzle, and PostgreSQL.",
+};
+
+export default function RootLayout({ children }: { children: ReactNode }) {
+  return (
+    <html lang="en">
+      <body className="bg-slate-100 text-slate-900 antialiased">{children}</body>
+    </html>
+  );
+}

package/modes/code-arena/full-stack/template/src/app/page.tsx

@@ -0,0 +1,22 @@
+import { db } from "@/db";
+import { sql } from "drizzle-orm";
+
+export const dynamic = "force-dynamic";
+
+export default async function HomePage() {
+  await db.execute(sql`select 1`);
+
+  return (
+    <main className="grid min-h-screen place-items-center px-6 py-12">
+      <section className="w-full max-w-2xl rounded-3xl bg-white p-10 shadow-[0_24px_60px_rgba(16,24,40,0.12)]">
+        <p className="m-0 text-sm uppercase tracking-[0.08em] text-slate-600">Starter template</p>
+        <h1 className="mt-4 text-[clamp(2rem,5vw,3.25rem)] font-semibold leading-[1.05] text-slate-950">
+          Arena Next.js PostgreSQL Starter
+        </h1>
+        <p className="mt-4 text-base text-slate-700">
+          Server-rendered with Next.js after a successful PostgreSQL query through Drizzle.
+        </p>
+      </section>
+    </main>
+  );
+}

package/modes/code-arena/full-stack/template/src/db/index.ts

@@ -0,0 +1,24 @@
+import { drizzle } from "drizzle-orm/node-postgres";
+import { Pool } from "pg";
+
+const databaseUrl = process.env.DATABASE_URL;
+
+if (!databaseUrl) {
+  throw new Error("DATABASE_URL is required");
+}
+
+const globalForDb = globalThis as typeof globalThis & {
+  __arenaNextJsPostgresqlPool?: Pool;
+};
+
+export const pool =
+  globalForDb.__arenaNextJsPostgresqlPool ??
+  new Pool({
+    connectionString: databaseUrl,
+  });
+
+if (process.env.NODE_ENV !== "production") {
+  globalForDb.__arenaNextJsPostgresqlPool = pool;
+}
+
+export const db = drizzle(pool);

package/modes/code-arena/full-stack/template/src/db/schema.ts

@@ -0,0 +1,3 @@
+// Keep the schema entrypoint present so models can define tables and run
+// `npx drizzle-kit push` without bootstrapping Drizzle config first.
+export {};

package/modes/code-arena/full-stack/template/tsconfig.json

@@ -0,0 +1,24 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": false,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"]
+    },
+    "plugins": [{ "name": "next" }]
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}