api-driven notion operations

.dockerignore

@@ -0,0 +1,152 @@
+# ============================================
+# .dockerignore for Comapeo Docs API Server
+# Minimizes Docker context size by excluding unnecessary files
+# ============================================
+
+# Dependencies (installed in container via package.json)
+node_modules
+npm-debug.log*
+yarn-error.log*
+package-lock.json
+yarn.lock
+pnpm-lock.yaml
+
+# Build outputs and caches
+build/
+dist/
+.out/
+.docusaurus/
+.cache-loader/
+*.tsbuildinfo
+
+# ============================================
+# Content Generation (not needed for API server)
+# ============================================
+# Generated content from Notion (synced from content branch)
+docs/
+i18n/
+static/images/
+
+# ============================================
+# Development & Testing (not needed in production)
+# ============================================
+# Test files and coverage
+coverage/
+test-results*.json
+test-results*.html
+*.test.ts
+*.test.tsx
+*.spec.ts
+vitest.config.ts
+__tests__/
+
+# Development configuration
+.eslintrc*
+.prettierrc*
+.prettierignore
+lefthook.yml
+
+# CI/CD
+.github/
+.gitlab-ci.yml
+.azure-pipelines.yml
+.circleci/
+
+# ============================================
+# Documentation & Assets (not needed for API)
+# ============================================
+# Project documentation
+README.md
+CONTRIBUTING.md
+CHANGELOG.md
+LICENSE
+context/
+NOTION_FETCH_ARCHITECTURE.md
+
+# Assets not needed for API server
+assets/
+favicon.*
+robots.txt
+
+# ============================================
+# Development Directories (not needed in container)
+# ============================================
+# Git
+.git/
+.gitignore
+.gitattributes
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.marscode/
+.eclipse/
+
+# Worktrees and development directories
+worktrees/
+.dev-docs/
+
+# ============================================
+# Environment & Secrets (use env vars or mounted secrets)
+# ============================================
+.env
+.env.*
+!.env.example
+
+# ============================================
+# Temporary & Generated Files
+# ============================================
+# Temporary files
+*.tmp
+*.temp
+*-preview-*.md
+.cache/
+screenshots/
+
+# Notion exports and emoji files (not needed for API)
+notion_*.json
+
+# Runtime metrics and cache files
+retry-metrics.json
+image-cache.json
+image-failures.json
+
+# Job persistence data (mounted as volume)
+.jobs-data/
+
+# Audit data (development only)
+.audit-data/
+
+# Development planning
+TASK.md
+NEXT_STEPS.md
+PRD.md
+TODO.md
+
+# ============================================
+# Docker Files (don't include Docker files in image)
+# ============================================
+Dockerfile*
+docker-compose*
+.dockerignore
+
+# ============================================
+# Misc (OS files, logs)
+# ============================================
+.DS_Store
+Thumbs.db
+*.log
+
+# ============================================
+# Test Directories under scripts/ (explicit)
+# ============================================
+scripts/test-docker/
+scripts/test-scaffold/
+scripts/test-utils/
+scripts/**/__tests__/
+scripts/**/*.test.ts
+api-server/**/__tests__/
+api-server/**/*.test.ts

.env.example

@@ -49,3 +49,32 @@ MAX_IMAGE_RETRIES=3
 # Example:
 # TEST_DATA_SOURCE_ID=test-database-id-here
 # TEST_MODE=true
+
+# OpenAI Configuration (Required for translation jobs)
+OPENAI_API_KEY=your_openai_api_key_here
+OPENAI_MODEL=gpt-4o-mini
+
+# API Server Configuration (for Docker deployment)
+NODE_ENV=production
+API_HOST=0.0.0.0
+API_PORT=3001
+
+# Content Repository Configuration (required for mutating jobs in API server)
+# Required for: notion:fetch, notion:fetch-all, notion:translate
+# GitHub repository URL must be HTTPS (no embedded credentials)
+GITHUB_REPO_URL=https://github.com/digidem/comapeo-docs.git
+# GitHub token with permissions to push to the content branch
+GITHUB_TOKEN=your_github_token_here
+# Git author identity used for content commits created by jobs
+GIT_AUTHOR_NAME=CoMapeo Content Bot
+GIT_AUTHOR_EMAIL=content-bot@example.com
+
+# Content repository behavior (optional)
+GITHUB_CONTENT_BRANCH=content
+WORKDIR=/workspace/repo
+COMMIT_MESSAGE_PREFIX=content-bot:
+ALLOW_EMPTY_COMMITS=false
+
+# API Authentication (Optional - generate secure keys with: openssl rand -base64 32)
+# API_KEY_DEPLOYMENT=your_secure_api_key_here
+# API_KEY_GITHUB_ACTIONS=your_github_actions_key_here