profclaw 0.0.1-beta.1

package/.env.example

@@ -0,0 +1,215 @@
+# profClaw Environment Configuration
+# Copy this file to .env and fill in your values
+# Only the variables you need are required - most have sensible defaults
+
+# ════════════════════════════════════════════════════════════════════════════════
+# SERVER
+# ════════════════════════════════════════════════════════════════════════════════
+
+PORT=3000
+NODE_ENV=development
+# Allowed CORS origins (comma-separated for multiple)
+# CORS_ORIGIN=http://localhost:3000,http://localhost:5173
+
+# ════════════════════════════════════════════════════════════════════════════════
+# STORAGE
+# ════════════════════════════════════════════════════════════════════════════════
+
+# Storage backend: memory, local (persistent SQLite), libsql (Turso)
+STORAGE_TIER=local
+# Path for file-based storage
+DATA_PATH=./data
+
+# LibSQL (for production - use Turso or local libsql-server)
+# LIBSQL_URL=libsql://your-db.turso.io
+# LIBSQL_AUTH_TOKEN=your_token_here
+
+# ════════════════════════════════════════════════════════════════════════════════
+# DEPLOYMENT MODE (pico | mini | pro)
+# pico: agent + tools + chat only (~50MB RAM, no UI, no Redis)
+# mini: + dashboard, basic cron, integrations (~150MB RAM) [default]
+# pro:  + all channels, Redis queues, plugins, sandbox (~300MB RAM)
+# ════════════════════════════════════════════════════════════════════════════════
+
+# PROFCLAW_MODE=mini
+
+# QUEUE (Optional - enables background jobs)
+# ════════════════════════════════════════════════════════════════════════════════
+
+# REDIS_URL=redis://localhost:6379
+# PROFCLAW_REQUIRE_REDIS=false
+
+# ════════════════════════════════════════════════════════════════════════════════
+# FEATURES
+# ════════════════════════════════════════════════════════════════════════════════
+
+# Enable scheduled job execution
+ENABLE_CRON=true
+
+# Task processing concurrency
+TASK_CONCURRENCY=2
+
+# ════════════════════════════════════════════════════════════════════════════════
+# AI PROVIDERS (at least one required for chat features)
+# ════════════════════════════════════════════════════════════════════════════════
+
+# Anthropic (Claude) - Recommended for agentic tasks
+# ANTHROPIC_API_KEY=sk-ant-xxx
+
+# OpenAI (GPT-4, GPT-4o, o1, etc.)
+# OPENAI_API_KEY=sk-xxx
+
+# Google (Gemini)
+# GOOGLE_GENERATIVE_AI_API_KEY=xxx
+
+# Azure OpenAI (alternative to OpenAI)
+# AZURE_OPENAI_API_KEY=xxx
+# AZURE_OPENAI_ENDPOINT=https://your-resource.openai.azure.com
+
+# Groq (fast inference for open models)
+# GROQ_API_KEY=gsk_xxx
+
+# Ollama (local models - free)
+OLLAMA_BASE_URL=http://localhost:11434
+# OLLAMA_PORT=11434
+
+# ════════════════════════════════════════════════════════════════════════════════
+# TOOL EXECUTION
+# ════════════════════════════════════════════════════════════════════════════════
+
+# OpenClaw Configuration (AI coding agent)
+# OPENCLAW_BASE_URL=http://localhost:18789
+# OPENCLAW_GATEWAY_TOKEN=your-openclaw-gateway-token
+# OPENCLAW_WORKING_DIR=~/openclaw-workdir
+
+# Claude Code (optional - auto-detected if installed)
+# CLAUDE_WORKING_DIR=
+
+# Tool pool settings
+POOL_MAX_CONCURRENT=50
+POOL_MAX_QUEUE_SIZE=200
+POOL_TIMEOUT_MS=300000
+POOL_QUEUE_TIMEOUT_MS=30000
+
+# ════════════════════════════════════════════════════════════════════════════════
+# GITHUB INTEGRATION
+# ════════════════════════════════════════════════════════════════════════════════
+
+# GitHub personal access token or GitHub App token
+# GITHUB_TOKEN=ghp_xxx
+# GITHUB_WEBHOOK_SECRET=your-webhook-secret
+
+# OAuth App (for user authentication)
+# GITHUB_CLIENT_ID=xxx
+# GITHUB_CLIENT_SECRET=xxx
+
+# Issue polling
+# GITHUB_AI_TASK_LABEL=ai-task
+# GITHUB_AI_REVIEW_LABEL=ai-review
+# GITHUB_REPOS_TO_POLL=your-org/your-repo
+
+# ════════════════════════════════════════════════════════════════════════════════
+# JIRA INTEGRATION
+# ════════════════════════════════════════════════════════════════════════════════
+
+# JIRA_BASE_URL=https://your-org.atlassian.net
+# JIRA_EMAIL=your-email@example.com
+# JIRA_API_TOKEN=your-jira-api-token
+# JIRA_WEBHOOK_SECRET=your-jira-webhook-secret
+# JIRA_AI_TASK_LABEL=ai-task
+# JIRA_CLIENT_ID=xxx
+# JIRA_CLIENT_SECRET=xxx
+# JIRA_CLOUD_ID=xxx
+
+# ════════════════════════════════════════════════════════════════════════════════
+# LINEAR INTEGRATION
+# ════════════════════════════════════════════════════════════════════════════════
+
+# LINEAR_API_KEY=lin_api_xxx
+# LINEAR_WEBHOOK_SECRET=xxx
+
+# ════════════════════════════════════════════════════════════════════════════════
+# SLACK INTEGRATION
+# ════════════════════════════════════════════════════════════════════════════════
+
+# Bot token (OAuth)
+# SLACK_BOT_TOKEN=xoxb-xxx
+# SLACK_SIGNING_SECRET=xxx
+# SLACK_APP_TOKEN=xapp-xxx
+
+# Webhook notifications
+# SLACK_WEBHOOK_URL=https://hooks.slack.com/services/xxx/yyy/zzz
+# SLACK_CHANNEL=#ai-tasks
+# SLACK_NOTIFY_ON_START=false
+# SLACK_NOTIFY_ON_SUCCESS=true
+# SLACK_NOTIFY_ON_FAILURE=true
+
+# ════════════════════════════════════════════════════════════════════════════════
+# DISCORD INTEGRATION
+# ════════════════════════════════════════════════════════════════════════════════
+
+# DISCORD_BOT_TOKEN=xxx
+# DISCORD_APPLICATION_ID=xxx
+# DISCORD_PUBLIC_KEY=xxx
+# DISCORD_CLIENT_SECRET=xxx
+
+# ════════════════════════════════════════════════════════════════════════════════
+# TELEGRAM INTEGRATION
+# ════════════════════════════════════════════════════════════════════════════════
+
+# TELEGRAM_BOT_TOKEN=xxx
+
+# ════════════════════════════════════════════════════════════════════════════════
+# WHATSAPP INTEGRATION
+# ════════════════════════════════════════════════════════════════════════════════
+
+# WHATSAPP_ACCESS_TOKEN=xxx
+# WHATSAPP_PHONE_NUMBER_ID=xxx
+# WHATSAPP_VERIFY_TOKEN=xxx
+
+# ════════════════════════════════════════════════════════════════════════════════
+# MATRIX INTEGRATION
+# ════════════════════════════════════════════════════════════════════════════════
+
+# MATRIX_HOMESERVER_URL=https://matrix.org
+# MATRIX_ACCESS_TOKEN=xxx
+# MATRIX_USER_ID=@profclaw:matrix.org
+
+# ════════════════════════════════════════════════════════════════════════════════
+# GOOGLE CHAT INTEGRATION
+# ════════════════════════════════════════════════════════════════════════════════
+
+# Webhook (simpler, outbound only)
+# GOOGLE_CHAT_WEBHOOK_URL=https://chat.googleapis.com/v1/spaces/xxx/messages?key=yyy&token=zzz
+# Service account (full API access)
+# GOOGLE_CHAT_SERVICE_ACCOUNT_KEY={"type":"service_account",...}
+# GOOGLE_CHAT_PROJECT_ID=your-project-id
+
+# ════════════════════════════════════════════════════════════════════════════════
+# MICROSOFT TEAMS INTEGRATION
+# ════════════════════════════════════════════════════════════════════════════════
+
+# MSTEAMS_APP_ID=xxx
+# MSTEAMS_APP_PASSWORD=xxx
+# MSTEAMS_TENANT_ID=xxx
+
+# ════════════════════════════════════════════════════════════════════════════════
+# SEARCH & EMBEDDINGS
+# ════════════════════════════════════════════════════════════════════════════════
+
+# Web search via SearXNG
+SEARXNG_URL=https://searx.tiekoetter.com
+
+# Embedding provider: local, openai, voyage
+EMBEDDING_PROVIDER=local
+# VOYAGE_API_KEY=xxx
+
+# ════════════════════════════════════════════════════════════════════════════════
+# DOCKER / MONITORING (docker-compose only)
+# ════════════════════════════════════════════════════════════════════════════════
+
+# REDIS_PORT=6379
+# REDIS_COMMANDER_PORT=8081
+# PROMETHEUS_PORT=9090
+# GRAFANA_PORT=3001
+# GRAFANA_PASSWORD=admin

package/CHANGELOG.md

@@ -0,0 +1,49 @@
+# Changelog
+
+## [2.0.0](https://github.com/profclaw/profclaw/compare/v1.0.0...v2.0.0) (2026-03-11)
+
+### Breaking Changes
+
+* Renamed from "GLINR Task Manager" to "profClaw" — all env vars, CLI commands, and API paths updated
+* `GLINR_REQUIRE_REDIS` renamed to `PROFCLAW_REQUIRE_REDIS`
+* `glinr.mjs` renamed to `profclaw.mjs`
+* All `glinr-*` skill names renamed to `profclaw-*`
+
+### Features
+
+* **Deployment Modes**: Run as `pico`, `mini`, or `pro` via `PROFCLAW_MODE` env var
+* **In-Memory Queue**: BullMQ-compatible task queue without Redis for pico/mini modes
+* **Unified Queue Facade**: Auto-selects Redis or memory backend based on mode
+* **WebChat Provider**: Browser-based chat via SSE with session management
+* **Matrix Provider**: Matrix homeserver integration via Client-Server API
+* **Google Chat Provider**: Google Workspace integration via webhook or service account
+* **MS Teams Provider**: Microsoft Teams integration via Bot Framework
+* **Plugin SDK**: Third-party plugin system with `definePlugin()` helper, npm/local loader
+* **Onboarding CLI**: `npx profclaw onboard` wizard for zero-to-running setup
+* **Skills Expansion**: 15 built-in skills (code-review, code-generation, debug-helper, git-workflow, web-research, cron-manager, memory-manager, system-admin, file-manager, api-tester, docker-ops)
+* **Sandbox Hardening**: Security presets per deployment mode
+* **Static UI Serving**: Hono middleware serves `ui/dist/` with SPA fallback
+* **Pico Docker Image**: Minimal image without Chromium (`Dockerfile.pico`)
+
+### Chat Channels (4 → 8)
+
+* Slack, Discord, Telegram, WhatsApp (existing)
+* WebChat, Matrix, Google Chat, Microsoft Teams (new)
+
+### Infrastructure
+
+* CI/CD: GitHub Actions with build+test+lint, release-please, Docker multi-arch, npm publish
+* OSS files: CONTRIBUTING.md, SECURITY.md, CODE_OF_CONDUCT.md, LICENSE (AGPL-3.0)
+
+## [1.0.0](https://github.com/profclaw/profclaw/releases/tag/v1.0.0) (2026-03-10)
+
+### Features
+
+* Initial release as GLINR Task Manager v1.0.0
+* AI agent task orchestration with 51+ built-in tools
+* 15+ AI provider support (Anthropic, OpenAI, Google, Azure, Ollama, etc.)
+* 4 chat channels (Slack, Discord, Telegram, WhatsApp)
+* GitHub, Jira, Linear integrations
+* MCP server for Model Context Protocol
+* Redis-backed BullMQ task queue
+* React 19 dashboard UI

package/CONTRIBUTING.md

@@ -0,0 +1,119 @@
+# Contributing to profClaw
+
+Thanks for your interest in contributing to profClaw! This guide will help you get started.
+
+## Getting Started
+
+### Prerequisites
+
+- Node.js 22+
+- pnpm 9+
+- Redis (optional, only needed for pro mode)
+
+### Setup
+
+```bash
+git clone https://github.com/profclaw/profclaw.git
+cd profclaw
+pnpm install
+cp .env.example .env
+# Add your AI provider API key to .env
+pnpm dev
+```
+
+### Development Commands
+
+```bash
+pnpm dev          # Start dev server (API + UI)
+pnpm build        # Compile TypeScript + Vite
+pnpm test         # Run tests
+pnpm lint         # Lint check
+```
+
+## How to Contribute
+
+### Reporting Bugs
+
+Open an issue with:
+- Steps to reproduce
+- Expected vs actual behavior
+- Environment (OS, Node version, deployment mode)
+
+### Suggesting Features
+
+Open a discussion or issue describing:
+- The problem you're solving
+- Your proposed solution
+- Alternatives you considered
+
+### Submitting Code
+
+1. Fork the repo and create a branch from `main`
+2. Follow the naming convention: `feat/description`, `fix/description`, `refactor/description`
+3. Write code following existing patterns (see `CLAUDE.md`)
+4. Add tests for new features
+5. Ensure `pnpm build && pnpm test && pnpm lint` pass
+6. Submit a pull request
+
+### Commit Messages
+
+We use conventional commits:
+
+```
+<type>: <description>
+
+Co-Authored-By: Your Name <your@email.com>
+```
+
+Types: `feat`, `fix`, `perf`, `refactor`, `docs`, `test`
+
+### Code Style
+
+- TypeScript strict mode, no `any` types
+- `import type` for type-only imports
+- `.js` extension on all relative imports
+- Tailwind v4 for UI styling (no inline styles)
+- Lucide icons only
+- Zod validation at system boundaries
+- See `CLAUDE.md` for full conventions
+
+## Architecture
+
+```
+src/
+  adapters/      - AI agent adapters
+  chat/          - Chat engine + providers (Slack, Discord, Telegram, WhatsApp)
+  core/          - Deployment modes, feature flags
+  integrations/  - GitHub, Jira, Linear webhooks
+  queue/         - BullMQ + in-memory task queue
+  providers/     - AI SDK providers (15+)
+  skills/        - Skill loader and registry
+  types/         - Shared TypeScript types
+
+ui/src/          - React 19 + Vite frontend
+skills/          - Built-in skill definitions
+```
+
+## Adding a Chat Channel
+
+1. Create `src/chat/providers/<name>/index.ts`
+2. Implement the `ChatProvider` interface from `src/chat/providers/types.ts`
+3. Add the provider ID to `ChatProviderId` type
+4. Register in the provider registry
+5. Add tests
+
+## Adding a Skill
+
+1. Create `skills/<name>/SKILL.md` following existing skill format
+2. The skill loader auto-discovers skills from this directory
+3. Test via the chat interface
+
+## Adding a Tool
+
+1. Add tool definition in `src/chat/execution/tools/`
+2. Register in `src/chat/execution/tools/index.ts`
+3. Add tests
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the AGPL-3.0 license.

package/Dockerfile

@@ -0,0 +1,107 @@
+# ====================
+# Stage 1: Base
+# ====================
+FROM node:22-alpine AS base
+
+# Install pnpm
+RUN corepack enable && corepack prepare pnpm@latest --activate
+
+WORKDIR /app
+
+# ====================
+# Stage 2: Dependencies (Backend)
+# ====================
+FROM base AS deps
+COPY package.json pnpm-lock.yaml* ./
+RUN pnpm install --frozen-lockfile
+
+# ====================
+# Stage 3: Dependencies (UI)
+# ====================
+FROM base AS ui-deps
+WORKDIR /app/ui
+COPY ui/package.json ui/pnpm-lock.yaml* ./
+RUN pnpm install --frozen-lockfile
+
+# ====================
+# Stage 4: Build Backend (tsc only — UI is built in stage 5)
+# ====================
+FROM base AS build-backend
+COPY --from=deps /app/node_modules ./node_modules
+COPY . .
+RUN ./node_modules/.bin/tsc --project tsconfig.json
+
+# ====================
+# Stage 5: Build UI
+# ====================
+FROM base AS build-ui
+WORKDIR /app/ui
+COPY --from=ui-deps /app/ui/node_modules ./node_modules
+COPY ui/ ./
+RUN pnpm build
+
+# ====================
+# Stage 6: Production
+# ====================
+FROM node:22-alpine AS production
+
+# Install Chromium for Playwright, git for agent sandbox, dev tools
+RUN apk add --no-cache \
+    chromium \
+    nss \
+    freetype \
+    harfbuzz \
+    ca-certificates \
+    ttf-freefont \
+    curl \
+    git \
+    && rm -rf /var/cache/apk/*
+
+# Enable pnpm via corepack (for agent sandbox: clone, build, lint)
+RUN corepack enable && corepack prepare pnpm@latest --activate
+
+# Set Playwright to use system Chromium
+ENV PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=1
+ENV PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH=/usr/bin/chromium-browser
+
+# Create non-root user for security
+RUN addgroup -g 1001 -S profclaw && \
+    adduser -S profclaw -u 1001 -G profclaw
+
+WORKDIR /app
+
+# Copy backend artifacts
+COPY --from=build-backend /app/dist ./dist
+COPY --from=build-backend /app/node_modules ./node_modules
+COPY --from=build-backend /app/package.json ./
+
+# Copy runtime config (settings.yml for storage tier, queue, etc.)
+COPY --from=build-backend /app/config ./config
+
+# Copy skills
+COPY --from=build-backend /app/skills ./skills
+
+# Copy UI build artifacts
+COPY --from=build-ui /app/ui/dist ./ui/dist
+
+# Create data directory for SQLite and link CLI binary
+RUN mkdir -p /app/data && \
+    ln -sf /app/dist/cli/index.js /usr/local/bin/profclaw && \
+    chmod +x /app/dist/cli/index.js 2>/dev/null || true && \
+    chown -R profclaw:profclaw /app
+
+# Production environment
+ENV NODE_ENV=production
+ENV PORT=3000
+ENV PROFCLAW_MODE=pro
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
+    CMD curl -f http://localhost:${PORT}/health || exit 1
+
+# Switch to non-root user
+USER profclaw
+
+EXPOSE 3000
+
+CMD ["node", "dist/server.js"]