Project Bootstrap — Monorepo, CI, Dev Environment

.env.example

@@ -0,0 +1,51 @@
+# =============================================================================
+# OpenThreads — Environment Variables
+# Copy this file to .env and fill in your values.
+# =============================================================================
+
+# Server
+PORT=3000
+NODE_ENV=development
+
+# MongoDB
+# When using Docker Compose: mongodb://openthreads:openthreads@localhost:27017/openthreads
+MONGODB_URI=mongodb://openthreads:openthreads@localhost:27017/openthreads
+
+# Security
+# IMPORTANT: Change this in production! Use a long, random string.
+JWT_SECRET=change-me-in-production
+
+# Reply Token TTL (in seconds)
+# Default: 86400 (24 hours)
+REPLY_TOKEN_TTL=86400
+
+# Base URL for OpenThreads (used to build replyTo URLs and form links)
+OPENTHREADS_BASE_URL=http://localhost:3000
+
+# =============================================================================
+# Channel Credentials
+# Add credentials for each channel you want to enable.
+# =============================================================================
+
+# Slack
+# SLACK_BOT_TOKEN=xoxb-your-slack-bot-token
+# SLACK_SIGNING_SECRET=your-slack-signing-secret
+# SLACK_APP_TOKEN=xapp-your-slack-app-token
+
+# Telegram
+# TELEGRAM_BOT_TOKEN=your-telegram-bot-token
+
+# Discord
+# DISCORD_BOT_TOKEN=your-discord-bot-token
+# DISCORD_CLIENT_ID=your-discord-client-id
+
+# =============================================================================
+# Trust Layer (optional)
+# Enable for production deployments requiring strong authentication and
+# cryptographic evidence (JWS signing, WebAuthn, audit logging).
+# =============================================================================
+
+# TRUST_LAYER_ENABLED=false
+# TRUST_JWS_ALGORITHM=RS256
+# TRUST_PRIVATE_KEY_PATH=./keys/private.pem
+# TRUST_PUBLIC_KEY_PATH=./keys/public.pem

.github/workflows/claude-task.yml

@@ -25,3 +25,4 @@ jobs:
         with:
           claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
           claude_args: "--model claude-sonnet-4-6"
+          allowed_bots: "claude[bot]"

.gitignore

@@ -0,0 +1,32 @@
+# Dependencies
+node_modules/
+
+# Build outputs
+dist/
+.next/
+*.tsbuildinfo
+
+# Environment files
+.env
+.env.local
+.env.*.local
+!.env.example
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+npm-debug.log*
+bun-debug.log*
+
+# Test coverage
+coverage/
+
+# OS
+.DS_Store

.prettierignore

@@ -0,0 +1,6 @@
+node_modules/
+dist/
+.next/
+coverage/
+*.lockb
+bun.lockb

.prettierrc

@@ -0,0 +1,9 @@
+{
+  "semi": false,
+  "singleQuote": true,
+  "tabWidth": 2,
+  "trailingComma": "es5",
+  "printWidth": 100,
+  "arrowParens": "always",
+  "endOfLine": "lf"
+}

docker-compose.yml

@@ -0,0 +1,25 @@
+version: '3.8'
+
+services:
+  mongodb:
+    image: mongo:7.0
+    container_name: openthreads-mongodb
+    ports:
+      - '27017:27017'
+    environment:
+      MONGO_INITDB_ROOT_USERNAME: openthreads
+      MONGO_INITDB_ROOT_PASSWORD: openthreads
+      MONGO_INITDB_DATABASE: openthreads
+    volumes:
+      - mongodb_data:/data/db
+    healthcheck:
+      test: ['CMD', 'mongosh', '--eval', "db.adminCommand('ping')"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+      start_period: 10s
+    restart: unless-stopped
+
+volumes:
+  mongodb_data:
+    driver: local

eslint.config.mjs

@@ -0,0 +1,38 @@
+import js from '@eslint/js'
+import tsPlugin from '@typescript-eslint/eslint-plugin'
+import tsParser from '@typescript-eslint/parser'
+import prettierConfig from 'eslint-config-prettier'
+
+export default [
+  js.configs.recommended,
+  {
+    files: ['**/*.{ts,tsx}'],
+    languageOptions: {
+      parser: tsParser,
+      parserOptions: {
+        ecmaVersion: 'latest',
+        sourceType: 'module',
+      },
+    },
+    plugins: {
+      '@typescript-eslint': tsPlugin,
+    },
+    rules: {
+      ...tsPlugin.configs.recommended.rules,
+      '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
+      '@typescript-eslint/no-explicit-any': 'warn',
+    },
+  },
+  prettierConfig,
+  {
+    ignores: [
+      '**/dist/**',
+      '**/node_modules/**',
+      '**/.next/**',
+      '**/coverage/**',
+      '*.config.js',
+      '*.config.mjs',
+      '*.config.ts',
+    ],
+  },
+]

package.json

@@ -0,0 +1,45 @@
+{
+  "name": "openthreads",
+  "version": "0.0.1",
+  "private": true,
+  "workspaces": [
+    "packages/core",
+    "packages/storage/mongodb",
+    "packages/channels",
+    "packages/server",
+    "packages/trust"
+  ],
+  "scripts": {
+    "dev": "bun run --filter '*' dev",
+    "build": "bun run --filter '*' build",
+    "test": "bun test",
+    "lint": "eslint 'packages/**/*.{ts,tsx}'",
+    "lint:fix": "eslint 'packages/**/*.{ts,tsx}' --fix",
+    "format": "prettier --write 'packages/**/*.{ts,tsx,json,md}'",
+    "typecheck": "tsc --build",
+    "prepare": "husky"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.0.0",
+    "@types/node": "^22.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "eslint": "^9.0.0",
+    "eslint-config-prettier": "^9.0.0",
+    "husky": "^9.0.0",
+    "lint-staged": "^15.0.0",
+    "prettier": "^3.0.0",
+    "typescript": "^5.0.0",
+    "vite": "^5.0.0",
+    "vite-plugin-dts": "^4.0.0"
+  },
+  "lint-staged": {
+    "*.{ts,tsx}": [
+      "eslint --fix",
+      "prettier --write"
+    ],
+    "*.{json,md}": [
+      "prettier --write"
+    ]
+  }
+}

packages/channels/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@openthreads/channels",
+  "version": "0.0.1",
+  "private": false,
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "vite build",
+    "dev": "vite build --watch",
+    "test": "bun test"
+  },
+  "devDependencies": {
+    "vite": "*",
+    "vite-plugin-dts": "*",
+    "typescript": "*"
+  },
+  "dependencies": {
+    "@openthreads/core": "workspace:*"
+  }
+}

packages/channels/src/index.test.ts

@@ -0,0 +1,8 @@
+import { describe, it, expect } from 'bun:test'
+
+describe('@openthreads/channels', () => {
+  it('exports channel types', async () => {
+    const mod = await import('./index')
+    expect(mod).toBeDefined()
+  })
+})

packages/channels/src/index.ts

@@ -0,0 +1,5 @@
+// @openthreads/channels
+// Custom channel adapters (Baileys/WhatsApp, etc.)
+// Native Chat SDK adapters live in @openthreads/core
+
+export * from './types'

packages/channels/src/types.ts

@@ -0,0 +1,8 @@
+import type { Channel } from '@openthreads/core'
+
+export interface ChannelAdapter {
+  channel: Channel
+  connect(): Promise<void>
+  disconnect(): Promise<void>
+  send(target: string, message: unknown): Promise<void>
+}

packages/channels/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": "./src",
+    "outDir": "./dist"
+  },
+  "references": [
+    { "path": "../core" }
+  ],
+  "include": ["src"]
+}

packages/channels/vite.config.ts

@@ -0,0 +1,18 @@
+import { defineConfig } from 'vite'
+import dts from 'vite-plugin-dts'
+import { resolve } from 'path'
+
+export default defineConfig({
+  build: {
+    lib: {
+      entry: resolve(__dirname, 'src/index.ts'),
+      name: 'OpenThreadsChannels',
+      formats: ['es', 'cjs'],
+      fileName: (format) => `index.${format === 'es' ? 'js' : 'cjs'}`,
+    },
+    rollupOptions: {
+      external: ['@openthreads/core'],
+    },
+  },
+  plugins: [dts({ rollupTypes: true })],
+})

packages/core/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@openthreads/core",
+  "version": "0.0.1",
+  "private": false,
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "vite build",
+    "dev": "vite build --watch",
+    "test": "bun test"
+  },
+  "devDependencies": {
+    "vite": "*",
+    "vite-plugin-dts": "*",
+    "typescript": "*"
+  }
+}

packages/core/src/index.test.ts

@@ -0,0 +1,8 @@
+import { describe, it, expect } from 'bun:test'
+
+describe('@openthreads/core', () => {
+  it('exports types', async () => {
+    const mod = await import('./index')
+    expect(mod).toBeDefined()
+  })
+})

packages/core/src/index.ts

@@ -0,0 +1,5 @@
+// @openthreads/core
+// Router, reply engine, envelope, thread/turn management,
+// abstract storage interface
+
+export * from './types'