Wakeplane

beta · v0.2.0-beta.1

Wakeplane is a durable scheduling control plane for long-running systems. These docs cover the current public beta release, v0.2.0-beta.1.

Beta: public release discipline and downloadable artifacts are in place. Security posture is unchanged: no auth, no RBAC, SQLite-first, single-process, trusted-network-only. See Security and Status.

Start Here

• Getting Started for install paths, checksum verification, and a five-minute quickstart
• GitHub for the canonical public repository

Use It When

• You need an internal scheduling control plane with durable run recording.
• You want to embed scheduling into a Go service and register workflow handlers explicitly.
• You need an operator-visible replacement for ad hoc cron in a system where retries, overlap policy, and audit history matter.

Do Not Use It When

• You need a public multi-tenant SaaS scheduler.
• You need an auth-heavy enterprise control plane today.
• You need a distributed workflow engine or DAG orchestrator.

Understanding Wakeplane

• Concepts: Overview for planner, dispatcher, occurrence keys, leases, receipts, and dead letters
• Schedules for YAML manifest shape, cadence types, and timezone behavior
• Policies for overlap, misfire, timeout, and retry
• Executors for HTTP, shell, and workflow targets
• Run Ledger for the full run state model and crash recovery semantics

Reference

• Reference: CLI generated from the real Cobra command tree
• Reference: API Contract aligned to the real HTTP routes
• Reference: Embedding for in-process use
• Reference: Storage for SQLite-first rationale and portability seam
• Operations: Runbook for startup, health checks, metrics, and failure handling
• Operations: Release Notes for release pages and release discipline
• Security for trusted-network requirements
• Status for beta and 1.0 gates

Current Scope

Wakeplane v0.2.0-beta.1 ships as:

• Single-process Go daemon and CLI
• SQLite-first storage with embedded migrations
• HTTP, shell, and in-process workflow executors
• HTTP JSON API and Cobra CLI
• Planner and dispatcher loops with durable run ledger
• Metrics, health, readiness, and status endpoints
• Structured shutdown and drain logging

Beta Constraints

Wakeplane is beta because the release discipline is now real:

• docs must match code exactly
• release artifacts and checksums must be published from tags
• security posture must remain explicit
• example code must be copied from tested source or validated in CI

Not yet shipped:

• Authentication, RBAC, or multi-tenancy
• Postgres backend
• UI
• Distributed coordination
• Dynamic plugin loading