Roadmap
What's built, what's coming, what's deferred. Kept current as the project evolves (reflects the v23.0.0 build). Nothing under Coming next carries a date.
Built
Core
- Safety supervisor with a five-state verdict (
SAFE/WARNING/UNSAFE/
UNKNOWN / DISABLED); UNKNOWN is treated as UNSAFE, WARNING is the slow recovery dwell, and DISABLED is Manual Mode (backyard / no weather sensor)
- Manual Mode — run with no observatory or weather sensor; the verdict never reads
as unsafe and nothing is gated (you're the weather sensor)
- Pub/sub bus with ~15 topic channels in active use
- Hash-chained audit log (SQLite)
- Response engine for SAFE→UNSAFE transitions
- Two equipment transports running side-by-side: ASCOM and Alpaca
- Self-healing health monitor (memory, disk, threads, devices) with a COM-free
liveness watchdog and a Solo driver-death heartbeat
- Three isolated ASCOM worker lanes (mount / roof / everything else) with
fail-fast dispatch to a wedged lane, honest connect on both transports, and DeviceState (Platform 7) with a kill switch
- Guardian self-heal ladder: detect -> reconnect -> USB port reset -> reset all ->
escalate, "shoot what's left" by default
- A memory floor that must persist before it is an emergency, never counted during a
frame download, and an escalation that stops the running sequence first
Equipment control (Console)
- Camera capture with FITS write (live progress, abort), AIRMASS/site headers
- Camera cooling: setpoint, settle detection, manual on/off, warm-up, slow ramp
- Mount slew/sync (RA/Dec or named target), park/unpark, tracking, abort
- Focuser absolute/relative move, halt, travel limits, backlash measurement
- Filter wheel position changes by name, with per-filter focuser offsets
- Field rotator: move, halt, plate-solved sky position angle; mechanical travel limits that every move obeys, rotate-to-angle included (v23)
- "Halt all" emergency stop
- Equipment dashboard: live device tiles with trends and per-device control
Autofocus
- Star detection + HFR/HFD (NumPy-only, no external astronomy deps)
- First Light once, Refocus forever (v22.2.15): First Light is a set-up step run once from the Console; it measures the focuser's refocus formula (the V's slope and the backlash) with no numbers to enter
- Refocus by that formula, from the Console and in every plan, sized from the stars of the night; the formula is kept in
focus_recipe.jsonper rig - Optional slew-to-focus-star selection (RoboStar-equivalent: pick a bright, isolated catalog star; opt-in, moves the mount)
- The measured focuser backlash is stored with the equipment profile; using it for manual moves is a choice you approve
- New in v23: sweeps planned inside the focuser's travel limits, First Light for a follower focuser, and two opt-in extras between refocuses - a refocus when the stars grow (HFR drift) and temperature compensation
Sequencer
- Multi-target plans, rotate-per-frame and finish-each-filter modes, five policy phases (on_start, on_error, on_suspend, on_resume, on_end) + TOML escape hatch
- Category-grouped, colour-coded action catalog (roof & cover, mount & pointing, dome, power, camera & focus, utility)
- On-start gates: wait-for-safe, wait-for-darkness (Sun below −18°), wait-until-time, altitude, max-wait
- Actions incl. precise-point, plate-solve & sync, blind-solve & sync (whole-sky recovery), home mount, connect/disconnect a power device, cool-camera with an optional over-X-minutes ramp
- Pause / resume / stop / abort, per-step error policy (abort / skip / retry) and per-action on-fail policy (cancel / pass / retry / go-to-end)
- Plan library (TOML save / load / backup / soft-delete / delete), "Save as scheduler template"
- Autofocus, cooling, constraint (altitude/HA/end-by) integration, and a meridian flip that asks the driver (DestinationSideOfPier), writes SideOfPier where the mount allows it, verifies the pier side, recenters by plate solve and resumes the interrupted exposure step
- A park wait that reads AtPark and Slewing live and says what it saw when a park does not happen
- Full PHD2 guiding: start/stop, dither cadence, settle gate, guiding-enforcement hold, optional guiding watchdog
- Per-frame quality acceptance (HFR/stars/eccentricity/background, per-filter overrides, reshoot, live tally)
- Live autofocus V-curve in the run view while a refocus runs
- Checkpoint / resume — a stand-alone run leaves a checkpoint, and Resume picks an interrupted run up where it stopped without re-shooting the frames already taken. You start the resume yourself, or (v23, opt-in, stand-alone sequences only) Starship resumes a run that a restart cut short - see the Windows restarts and crashes topic
- New in v23: pause takes effect between subs, a resume unparks a parked mount, a rising target can be waited for (
wait_for_rise), a failed start-up step can ask before it cancels, andrun_scripttakestimeout,fail_okand$filtereverywhere
Scheduler & unattended automation
- Multi-night dispatch Scheduler: projects + multi-filter per-target goals, persistent ledger, scoring/eligibility/hysteresis
- Two strategies (dispatch / finish-target) + per-project completion modes
- Per-target recipes (the templated "variable target"), and a "Scheduler Target" magic-name placeholder in a saved sequence
- Meridian preference (score boost near transit, optional hard gate) and a "don't waste a clear night" soft-constraint relaxation
- Per-filter Moon avoidance (phase-scaled separation, narrowband relaxed)
- Glass-box Schedule page — a step-by-step readiness bar, a "now imaging" panel, plain-words per-target status ("Moon too close", "still rising", "sets in 22 min"), per-filter progress bars and integration-time totals
- Save / recall / replace named schedules
- Roof management (open when dark+safe, close at dawn/unsafe/complete) with CloudWatcher as the hardwired backstop
- Blockscript state-machine night automation (startup→running→shutdown, WARNING/UNSAFE/RESUME/EMERGENCY) with device-loss recovery, a clickable lifecycle map, and typical-action one-click fills
- Blockscript Wait modes (duration / until-safe / until-time / until-dark / until-safe-dark) and a Run scheduler / Run sequence action with a saved-schedule / saved-sequence dropdown
run_schedulerblockscript action — an unattended campaign that runs every clear night until all goals complete[blockscript] auto_start— a named blockscript is started when Starship starts (it begins from its startup state; it does not continue a half-finished sequence), and the scheduler's ledger keeps the goals and the frames already counted across nights- "Simulate tonight" visual-timeline dry-run with per-target skip reasons
- Ask Pete pre-flight checker (sequences / blockscripts / scheduler)
- Auto Flat planner (per-filter table: shots, target ADU, tolerance, binning, exposure; one-folder or per-filter layout) + flat-cover / warm-camera epilogue actions
- Sky flats at dusk or dawn (v22.2.7)
- Calibration frames utility (v22.2.13): flats, bias and darks in one run with the observatory closed, cooled to a set temperature
- Dome control + ASDM adaptive slit slaving (roll-off roof or dome), with an editable geometry diagram; clamshell enclosures that close on their own weather vote are handled (v22.2.11, v22.2.18)
- Nights that run themselves (v22.2.16 to v22.2.18): the weather response belongs to the blockscript, the roof never opens inside the safety dwell, and a dawn teardown ends the night
- Blockscript dome and find-home actions, a Dry run button and the per-action on-fail policy in the editor (v23)
Sources, targets & displays
- AAG CloudWatcher (Solo) safety driver with stale detection
- ASCOM / Alpaca SafetyMonitor and ObservingConditions devices as weather sources, beside the Solo or instead of it (v23)
- All-sky + CCTV displays, STF auto-stretched last-frame preview (the single image surface)
- Cartes du Ciel target lookup; ASTAP plate solver (CLI + WCS); precise/blind slew-solve-sync and blind-solve recovery; J2000 targets precessed to the mount's frame
- Polar alignment rebuilt (v22.1): a plate-solved two-position method with an optional third position, southern-hemisphere aware, the mount is never moved by Starship
- PHD2 guider — read-only status and commanding (set exposure, start/stop guiding, dither, settle-gate) when you allow control; auto-launch (path-resolved), profile-connect, and guiding enforcement
- Skyhunter — offline catalog (OpenNGC), tonight's visibility, planets/asteroids/comets, satellite passes, Moon×filter (BB/NB) awareness, and one-click → sequencer or scheduler; an in-app refresh of the asteroid, comet and satellite catalogues (v23)
- Sky Atlas — Aladin sky view, camera FOV framing (from optics or a connected camera), mosaic planner → one-click sequence (appends, never replaces)
- Filter library — name each filter, per-filter refocus exposure, OSC support
- Alerts — outbound email + Pushover on safety and sequence events (including sequence stop/halt with reason)
- Images filed by target, filter and night (
[fits] layout = "target", v22.2.12), each frame labelled with the filter's library name (v22.2.5) - Alpaca Find devices (v22.2.14): a network search with a pick list in Settings
Platform
- Web UI with WebSocket live updates; in-app help with Markdown topics + search
- Four themes (Original / Light / Red-night / High-contrast), saved per browser, applied instantly
- Settings (live save vs. save+restart), background job system with progress streaming
- Startup splash + Acknowledgements page crediting the standards and projects Starship builds on
- The public edition is free (v22.3.0): no licence, no activation, no licence server
- External scripts + plugin loader (opt-in extension points)
- A dashboard left open in a hidden tab can no longer stall Starship (v22.2.13)
- In the v22.3.1 test build: a safe-state that reads the park and the close back and re-sends them, a start-up that stops on a bad read-back, restart and shutdown that ask first while a run is going, and a much faster preview of every sub
- In v23: protection against Windows restarts and crashes - a fast make-safe when Windows ends the session, a warning and a refused unattended start while a restart is pending, a death watch that parks the mount and closes the cover if Starship stops unexpectedly, an alert at the next start, and alerts that are tried again when they cannot be sent
- A COM camera's image array read straight into numpy (one frame of memory, not forty bytes per pixel)
- The full HTTP API documented in-app for scripts and AI agents (the HTTP API topic), with an operator playbook
- Ships as two editions from one codebase — Astroworx Starship (public) and Astroworx Starship Professional — the build self-identifies and the UI hides whatever isn't present
Coming next
Designed or recorded as owed, but not yet built. No dates are promised.
- Automatic resume for supervised runs — since v23 a stand-alone sequence can be
resumed automatically after a restart (opt-in). A blockscript's sequence and a scheduler chunk are not: the blockscript starts again from its startup list.
- OS-level boot auto-launch — on a remote rig something still has to start the
Starship process after a power cut (a Windows startup task/service).
- Out-of-process ASCOM driver host — isolate COM drivers so a wedged driver can't
stall the loop (the COM-free watchdog mitigates this today).
- A Settings page for the ASCOM / Alpaca weather sources — they are set in the
config file today.
- A horizon profile by azimuth — only a single minimum altitude exists today.
- A sensor characterisation utility (gain, read noise, full well).
- Token access and a packaged interface for scripts and AI agents — the HTTP API is
documented today; the access layer around it is not built.
- Dome calibration solver — the ASDM sync-point solver that recovers the physical offsets automatically (the engine + live slaving are built; you set offsets by measurement today).
- In-app bug report / feedback + community links.
Designed, deferred
Scoped but waiting on dependencies or priority.
- Research module — blink, photometry, astrometry workflows (the Research page names the directions today; nothing runs yet)
- GCN / TNS / MPC transient alerts (the alerts module today covers safety/sequence email + Pushover)
- Astroworx Native Bus + WAN Relay — multi-instance / off-site dashboards
- Stellarium as a second planetarium backend
- Linux / Raspberry Pi packaging — the core already imports clean on Linux/ARM (Alpaca-only); a supported install path + on-target test is the remaining work
Won't do
What we explicitly don't plan to build, and why.
- CCTV-based safety automation — fuzzy signals don't belong in the safety verdict. See Display vs. control.
- Built-in autoguiding — PHD2 is the standard; peer-process integration is correct.
- A bundled FITS calibration / stacking pipeline — Siril, PixInsight, APP exist and are better.
- Recording / motion detection on CCTV — existing CCTV systems do this better.