feat(packaging): ship wrapper-first Next.js npm integration (#20)

Make Junior deployable as an npm dependency using standard Next.js
wrappers.

The previous package approach depended on CLI-generated shim files and
custom build commands. This change moves to a wrapper-first integration
so consumers keep normal Next.js dev/build/start scripts while importing
Junior runtime surfaces directly.

Key changes:

- Add importable runtime surfaces for app layout, catch-all API routing,
instrumentation, and Next.js config composition
- Introduce `withJunior()` to merge required `serverExternalPackages`
and `outputFileTracingIncludes` for `/api/**`, with optional Sentry
wrapping
- Keep runtime handlers centralized under `src/handlers/*` and reuse
them from app routes and package exports
- Update packaging/build outputs (`tsup`, exports map, `files`, peer
dependency layout) so published artifacts are consumable from external
Next.js apps
- Move default bot content to root-level `data/`, `skills/`, and
`plugins/` conventions for scaffolded and consuming repos
- Update README/setup guidance to the wrapper model
(`app/api/[...path]/route.js`, `next.config.mjs`, `instrumentation.js`,
optional `app/layout.js`)
- Preserve existing `outputFileTracingIncludes["/api/**"]` entries when
applying Junior config instead of overwriting consumer-defined values
- Restore webhook route parity by matching only single-segment platforms
(e.g. `/api/webhooks/slack`) and returning 404 for multi-segment paths

This keeps deployment ergonomics aligned with normal Next.js behavior
while preserving the runtime/data loading guarantees Junior needs in
production.

Refs GH-9

---------

Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: GPT-5 <noreply@openai.com>
Co-authored-by: GPT-5 Codex <codex@openai.com>

Author: 3 people

.env.example

@@ -1,90 +1,15 @@
-# junior
+# junior monorepo
 
-Slack bot built with Next.js + Chat SDK.
+This repository is organized as a workspace:
 
-Junior responds when mentioned in Slack and can continue replying in subscribed threads. It also supports slash-invoked local skills (`/skill-name ...`) and built-in tools (web search/fetch, image generation, Slack canvases/lists).
+- `packages/junior`: publishable `junior` package and source
+- `packages/jr-sentry`: smoke-test consumer app that uses `junior` via `workspace:*`
 
-## Requirements
-
-- Node.js 20+
-- pnpm
-- Vercel CLI
-- Slack app credentials already configured in Vercel
-- Redis configured in Vercel (`REDIS_URL`)
-
-## Local setup
-
-1. Install dependencies.
+Common commands from repo root:
 
 ```bash
 pnpm install
+pnpm build:pkg
+pnpm test
+pnpm --filter jr-sentry build
 ```
-
-2. Link this repo to the Sentry Vercel project and pull dev env.
-
-```bash
-pnpm dlx vercel@latest login
-pnpm dlx vercel@latest switch
-pnpm dlx vercel@latest link --yes --scope sentry
-pnpm dlx vercel@latest env pull .env --environment=development --scope sentry
-```
-
-3. Start the app.
-
-```bash
-pnpm dev
-```
-
-## Slack tunnel (Cloudflare)
-
-Install `cloudflared` if you don't have it (`brew install cloudflared` on macOS).
-
-### Quick (random hostname each time)
-
-```bash
-cloudflared tunnel --url http://localhost:3000
-```
-
-### Stable hostname (one-time setup)
-
-Requires a free Cloudflare account and a domain managed through Cloudflare DNS.
-
-```bash
-cloudflared tunnel login
-cloudflared tunnel create junior-dev
-cloudflared tunnel route dns junior-dev junior-dev.yourdomain.com
-```
-
-Then each time you develop:
-
-```bash
-cloudflared tunnel run --url http://localhost:3000 junior-dev
-```
-
-### Configuring Slack
-
-Set Slack Event Subscriptions and Interactivity request URL to:
-
-```text
-https://<tunnel-host>/api/webhooks/slack
-```
-
-With a stable hostname you only need to do this once. Invite `@junior` to a channel and mention it.
-
-## Evals
-
-Use evals for end-to-end behavior testing of Junior's reply pipeline (prompting, tools, and expected outputs) with LLM-judged numeric scoring.
-
-Evals intentionally exclude live Slack integration concerns (Slack transport, app permissions, and webhook delivery).
-
-Authoring guidance lives in `evals/README.md` and `specs/testing/evals-spec.md`.
-
-```bash
-pnpm evals
-```
-
-## Test env isolation
-
-Vitest loads `.env`, `.env.local`, `.env.test`, then `.env.test.local` so test-specific values override development/prod values.
-
-Slack credentials are intentionally replaced with test values for tests/evals to prevent accidental use of real Slack tokens.

README.md

@@ -1,44 +1,18 @@
 {
-  "name": "junior",
-  "version": "0.1.0",
+  "name": "junior-monorepo",
   "private": true,
-  "type": "module",
   "packageManager": "pnpm@10.30.2",
   "scripts": {
-    "dev": "next dev",
-    "build": "next build",
-    "start": "next start",
-    "test": "pnpm run test:slack-boundary && vitest run",
-    "test:watch": "vitest",
-    "preevals": "pnpm run test:slack-boundary",
-    "evals": "pnpm exec vitest run -c vitest.evals.config.ts",
-    "test:slack-boundary": "node scripts/check-slack-test-boundary.mjs",
-    "typecheck": "tsc --noEmit",
-    "skills:check": "node scripts/check-skills.mjs"
-  },
-  "dependencies": {
-    "@ai-sdk/gateway": "^3.0.57",
-    "@chat-adapter/slack": "^4.15.0",
-    "@chat-adapter/state-memory": "^4.15.0",
-    "@chat-adapter/state-redis": "^4.15.0",
-    "@mariozechner/pi-agent-core": "^0.55.0",
-    "@mariozechner/pi-ai": "^0.55.0",
-    "@sentry/nextjs": "^10.40.0",
-    "@sinclair/typebox": "^0.34.48",
-    "@slack/web-api": "^7.14.1",
-    "@vercel/sandbox": "^1.7.1",
-    "@workflow/serde": "4.1.0-beta.2",
-    "ai": "^6.0.103",
-    "bash-tool": "^1.3.15",
-    "chat": "^4.15.0",
-    "just-bash": "^2.10.6",
-    "next": "^16.1.6",
-    "node-html-markdown": "^2.0.0",
-    "react": "^19.2.4",
-    "react-dom": "^19.2.4",
-    "workflow": "4.1.0-beta.60",
-    "yaml": "^2.8.2",
-    "zod": "^4.3.6"
+    "dev": "pnpm --filter junior dev",
+    "build": "pnpm --filter junior build",
+    "build:pkg": "pnpm --filter junior build:pkg",
+    "start": "pnpm --filter junior start",
+    "test": "pnpm --filter junior test",
+    "test:watch": "pnpm --filter junior test:watch",
+    "preevals": "pnpm --filter junior preevals",
+    "evals": "pnpm --filter junior evals",
+    "typecheck": "pnpm --filter junior typecheck",
+    "skills:check": "pnpm --filter junior skills:check"
   },
   "pnpm": {
     "peerDependencyRules": {
@@ -48,17 +22,7 @@
       }
     },
     "patchedDependencies": {
-      "@chat-adapter/slack": "patches/@chat-adapter__slack.patch"
+      "@chat-adapter/slack": "packages/junior/patches/@chat-adapter__slack.patch"
     }
-  },
-  "devDependencies": {
-    "@types/node": "^25.3.0",
-    "@types/react": "^19.2.14",
-    "@types/react-dom": "^19.2.3",
-    "msw": "^2.12.10",
-    "typescript": "^5.9.3",
-    "vercel": "^50.23.2",
-    "vitest": "^4.0.18",
-    "vitest-evals": "^0.6.0"
   }
 }

next.config.ts

@@ -0,0 +1,7 @@
+SLACK_BOT_TOKEN=
+SLACK_SIGNING_SECRET=
+JUNIOR_BOT_NAME=
+AI_MODEL=
+AI_FAST_MODEL=
+REDIS_URL=
+NEXT_PUBLIC_SENTRY_DSN=

package.json

@@ -0,0 +1,4 @@
+node_modules/
+.next/
+.env
+.env.local

packages/jr-sentry/.env.example

@@ -0,0 +1,2 @@
+export { GET, POST } from "junior/handler";
+export const runtime = "nodejs";

packages/jr-sentry/.gitignore

@@ -0,0 +1 @@
+export { default } from "junior/app/layout";

packages/jr-sentry/app/api/[...path]/route.js

@@ -0,0 +1,3 @@
+# jr-sentry
+
+You are jr-sentry, a helpful assistant.

packages/jr-sentry/app/layout.js

@@ -0,0 +1 @@
+export { register, onRequestError } from "junior/instrumentation";