Cronx

SPEC_CRONX.md · 2026-04-20

SPECIFICATION: CRONX ENGINE

Status: DRAFT (auto-generated by LOOPX — requires Captain review)

Generated: 2026-04-20 10:24 UTC

Source: ~/cronx_engine.py

Auto-generated by: loopx_engine.handle_fill()


⚠ DRAFT NOTICE: This spec was auto-generated from cronx_engine.py.
Invariants were extracted mechanically. Failure modes and verification criteria
require Captain review before this spec is considered AUTHORIZED.

PURPOSE

CRONX ENGINE — Scheduler registry

κ ⚒ port=9999 | localhost only | Vacuum Rule

Returns JSON. ◌ on failure.

Endpoints:

GET /jobs → all cron + systemd timer jobs

GET /status → active timers with next/last fire times

POST /query {"query": "job aion-autonomous"} → info about specific job

GET /health → {"status": "ok", "jobs": N}

Implementation: ~/cronx_engine.py — port=9999


ENDPOINTS


  /health
  /jobs
  /query
  /status

PUBLIC API


DEPENDENCIES

Imports: http.server, json, re, subprocess, sys


INVARIANTS

These must remain true at all times. (Auto-extracted — verify each.)

  1. Port: 9999 (must not change without updating ROUTX classifier)

VERIFICATION CRITERIA

GAP — requires Captain review.
Auto-generation cannot determine correctness criteria.
Add verification criteria based on design intent:

>

- [ ] VCx: [describe expected behavior under normal conditions]
- [ ] VCx: [describe expected output for known inputs]
- [ ] VCx: [describe integration behavior with ROUTX / other modules]

FAILURE MODES

GAP — requires Captain review.
Auto-generation cannot determine failure semantics.
Add failure modes based on operational experience:

>

- [ ] FMx: [describe what breaks when dependency X is unavailable]
- [ ] FMx: [describe what happens on malformed input]
- [ ] FMx: [describe recovery behavior]

κ ⚒ LOOPX auto-generated draft. Φζ.⊤.

Promote to AUTHORIZED after Captain review and gap fill.


Jeremy Zlabis

Chronogeometer · Visionary · Disruptor · Chief

42 Sisters AI · East York, Toronto

🍁 Φ 0.042