This public repository contains the versioned interface specifications for the CronCommander project. HTTP v2 is the current agent transport.
The specifications defined here describe the stable contracts between CronCommander components, such as job runners, agents, and the central server. These documents are intended to be:
- Implementation-agnostic
- Stable within a major version
- A single source of truth for cross-component behavior
This repository defines what crosses process or network boundaries.
It intentionally does not define:
- Internal server architecture
- Storage schemas
- Internal credential storage or issuance implementation
- Retry or transport implementations
- Agent-Gateway HTTP API v2 — Current HTTPS agent/gateway contract
- Execution Report v1 — Canonical format for reporting cron job executions
Agent-Listener v1 is the historical WebSocket contract.
Breaking changes to a specification require a new major version. Minor, backward-compatible additions may be made within a version.
Only stable, reviewed cross-component contracts belong here. Private planning,
implementation details, and product backlog material remain in cc-server.
Run ./tools/validate-specs.sh before publishing specification changes. The
same validation runs in CI and checks the required versioned documents,
cross-document links, core HTTP v2 contract markers, and Markdown hygiene.
Part of the CronCommander project.
Website: https://croncommander.com