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

README.md

@@ -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.

package.json

@@ -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"
   }
 }

packages/jr-sentry/.env.example

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

packages/jr-sentry/.gitignore

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

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

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

packages/jr-sentry/app/layout.js

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

packages/jr-sentry/data/SOUL.md

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

packages/jr-sentry/instrumentation.js

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

packages/jr-sentry/next.config.mjs

@@ -0,0 +1,11 @@
+import { withJunior } from "junior/config";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+export default withJunior({
+  turbopack: {
+    root: path.resolve(__dirname, "../..")
+  }
+});

packages/jr-sentry/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "jr-sentry",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start"
+  },
+  "dependencies": {
+    "@sentry/nextjs": "^10.0.0",
+    "junior": "workspace:*",
+    "next": "^16.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  }
+}

packages/junior/.env.example

@@ -0,0 +1,11 @@
+SLACK_BOT_TOKEN=
+SLACK_SIGNING_SECRET=
+JUNIOR_BOT_NAME=            # Defaults to "junior"
+AI_MODEL=                   # Defaults to anthropic/claude-sonnet-4.6
+AI_FAST_MODEL=              # Defaults to anthropic/claude-haiku-4-5
+REDIS_URL=
+SKILL_DIRS=                 # Additional skill directories (colon-separated)
+GITHUB_APP_ID=
+GITHUB_APP_PRIVATE_KEY=
+GITHUB_INSTALLATION_ID=
+NEXT_PUBLIC_SENTRY_DSN=