MonoKernelAI-Powered Task Automation

Quick Links ​

For Developers ​

• Project Overview & Setup - Essential commands and architecture patterns
• Cloudflare Infrastructure - Workers, D1, R2, KV architecture
• Sandbox Integration - Isolated execution environments

For Operations ​

• Monitoring Quick Reference - Dashboard metrics and alerts
• Runbooks - Incident response procedures
• Recovery Playbooks - Disaster recovery guides

For Platform Engineers ​

• Database Migrations - Schema evolution and D1 optimization
• D1 Index Optimization - Performance tuning
• Event Sourcing Guide - Event-driven architecture

System Overview ​

MonoTask is a Bun-powered monorepo implementing an AI-driven task automation system with:

• Cloudflare Workers - Serverless execution across 6 specialized workers
• AI Agents - Claude-powered agents for task elicitation, testing, and implementation
• Sandbox Isolation - Secure execution environments with resource limits
• Real-time Monitoring - Comprehensive observability with dashboards and alerts
• D1 Database - Distributed SQLite with WAL mode and optimized indexes
• State Machine - Enforced task lifecycle with validation gates

Documentation Structure ​

📁 Architecture & Implementation
  ├── Cloudflare Infrastructure Overview
  ├── Monitoring Implementation Summary
  ├── Sandbox Integration Summary
  ├── Stage 3 Implementation Plan
  └── Backup & Recovery Implementation

📁 Monitoring & Operations
  ├── Quick Reference Guide
  ├── Dashboard Configuration
  ├── SLO Definitions
  └── Runbooks (5 detailed guides)

📁 Recovery Playbooks
  ├── Database Recovery
  ├── Worker Rollback
  ├── Partial Failure Recovery
  └── Data Corruption Handling

📁 Database & Migrations
  ├── Migration Guide
  ├── D1 Index Optimization
  ├── Materialized Views Guide
  └── SQLite to D1 Migration Analysis

📁 Cloudflare Infrastructure
  ├── Workers Research
  ├── Frontend Migration Guide
  └── Event Sourcing Guide

Search Tips ​

Use the search bar (⌘K or Ctrl+K) to quickly find:

• Specific topics: "sandbox timeout", "error alerting", "D1 indexes"
• Runbooks: "high error rate", "queue backup", "worker timeout"
• Configuration: "wrangler.toml", "analytics engine", "logpush"
• Implementation details: "state machine", "durable objects", "KV storage"

Contributing ​

This documentation is generated from markdown files in the MonoKernel_MonoTask repository. To update:

# Sync documentation from main project
bun run docs:sync

# Run local development server
bun run docs:dev

# Build for production
bun run docs:build

Support ​

For issues or questions:

• Review the relevant runbook in Monitoring & Operations
• Check Recovery Playbooks for incident procedures
• Consult the Development Guide for setup and architecture

Last Updated: October 26, 2025 Documentation Version: 1.0.0 Status: Production Ready