astro-burr 0.3.1__tar.gz

astro_burr-0.3.1/.gitignore

@@ -0,0 +1,52 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+*$py.class
+*.so
+
+# Distribution / packaging
+build/
+dist/
+wheels/
+*.egg-info/
+*.egg
+.eggs/
+
+# Virtual environments
+.venv
+env/
+venv/
+ENV/
+
+# uv (libraries do not pin a lockfile)
+uv.lock
+
+# Environment / secrets
+.env
+*.env
+
+# Test / coverage reports
+.pytest_cache/
+.ruff_cache/
+.coverage
+.coverage.*
+coverage.xml
+coverage-*.xml
+junit-*.xml
+htmlcov/
+reports/
+
+# Editor / tooling
+.claude/
+.vscode/
+.idea/
+
+# Runtime artifacts
+src/burr/resources/cache/
+*.log
+*.tle
+*.bsp
+*.all
+
+# OS files
+.DS_Store

astro_burr-0.3.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 J. Zachary Gazak
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

astro_burr-0.3.1/PKG-INFO

@@ -0,0 +1,217 @@
+Metadata-Version: 2.4
+Name: astro-burr
+Version: 0.3.1
+Summary: Autonomous calibration and observation scheduling for rapid-deploy SDA telescopes
+Project-URL: Homepage, https://github.com/zgazak/burr
+Project-URL: Repository, https://github.com/zgazak/burr
+Project-URL: Issues, https://github.com/zgazak/burr/issues
+Author-email: Zach Gazak <jzg@alum.mit.edu>
+License-File: LICENSE
+Keywords: ascom,astronomy,automation,calibration,observatory,scheduling,sda,space domain awareness,telescope
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Astronomy
+Requires-Python: >=3.13
+Requires-Dist: alpyca>=3.1.0
+Requires-Dist: astropy>=7.1.0
+Requires-Dist: deepdiff>=6.7.1
+Requires-Dist: dotenv>=0.9.9
+Requires-Dist: loguru>=0.7.3
+Requires-Dist: matplotlib>=3.10.3
+Requires-Dist: nats-py>=2.7.0
+Requires-Dist: numpy
+Requires-Dist: pydantic>=2.11.5
+Requires-Dist: requests>=2.32.4
+Requires-Dist: scipy>=1.15.3
+Requires-Dist: skyfield>=1.53
+Requires-Dist: timezonefinder>=6.5.9
+Requires-Dist: tqdm>=4.67.1
+Requires-Dist: tzdata
+Requires-Dist: watchdog>=6.0.0
+Provides-Extra: direct
+Requires-Dist: alpyca>=3.1.0; extra == 'direct'
+Provides-Extra: notify
+Requires-Dist: slack-sdk>=3.35.0; extra == 'notify'
+Provides-Extra: senpai
+Requires-Dist: astro-senpai; extra == 'senpai'
+Provides-Extra: sk
+Requires-Dist: aiofile>=3.9.0; extra == 'sk'
+Requires-Dist: sensorkit[alpaca,filesys,pwi4,webapi]>=0.1.3; extra == 'sk'
+Description-Content-Type: text/markdown
+
+# Burr
+
+[![CI](https://github.com/zgazak/burr/actions/workflows/ci.yml/badge.svg)](https://github.com/zgazak/burr/actions/workflows/ci.yml)
+
+Taking the grind out of calibration.
+
+Autonomous calibration and observation scheduling for rapid-deploy SDA telescopes.
+
+Burr converts an observatory into a space domain awareness asset within days of deployment. It autonomously collects twilight flats, photometric standards, calibration satellite passes, sky coverage maps, and lunar background measurements -- all scheduled by lighting condition and time-share priority.
+
+Burr is built off of the descriptions in [Gazak et al. 2025, "Rapid Deployment, Calibration, and Training of Optical Observatories for Space Domain Awareness", AMOS Conference](https://amostech.space/year/2025/rapid-deployment-calibration-and-training-of-optical-observatories-for-space-domain-awareness/) -- see [Citation](#citation) below if you use this software.
+
+## Requirements
+
+- Python 3.13+
+- [uv](https://docs.astral.sh/uv/) package manager (for development installs)
+
+## Install
+
+Install from PyPI (package name `astro-burr`, imports as `burr`):
+
+```sh
+pip install astro-burr
+```
+
+Optional extras:
+
+```sh
+pip install "astro-burr[sk]"      # SensorKit (NATS-based) control
+pip install "astro-burr[direct]"  # direct ASCOM hardware control
+pip install "astro-burr[senpai]"  # SENPAI image-processing integration
+pip install "astro-burr[notify]"  # Slack notifications
+```
+
+### Development install
+
+This repo uses [uv](https://docs.astral.sh/uv/). First install uv, then:
+
+```sh
+make sync
+source .venv/bin/activate
+```
+
+## Configuration
+
+Burr separates **where** you observe from **how** you observe:
+
+- A **site file** (`deploy/<site>/site.yaml`) describes the observatory: coordinates, ASCOM/PWI4 hardware addresses, SensorKit entity names, notifications.
+- A **mode preset** (`deploy/presets/*.yaml`) describes the observing strategy: which task sources run, exposure ranges, and scheduling balance.
+
+You compose them at run time with `--site` + `--preset`. See [`deploy/example/`](deploy/example/) for a worked example and [`deploy/presets/`](deploy/presets/) for the bundled modes (`sda`, `science`, `survey`).
+
+| Site section   | Purpose                                                    |
+| -------------- | --------------------------------------------------------- |
+| `site`         | Coordinates and name (timezone auto-detected)             |
+| `hardware`     | ASCOM device addresses, ports, active flags               |
+| `sk`           | SensorKit entity names (for `burr-sk`)                     |
+| `weather`      | Rain/humidity thresholds and recovery timers              |
+| `notifications`| Slack channel for status updates                          |
+| `runtime`      | Output directory                                          |
+
+### Scheduling strategies
+
+Each task source has a scheduling strategy:
+
+- **`time_share`** -- target percentage of observing time (e.g. photometry 50%, coverage 30%)
+- **`interval`** -- minimum minutes between runs (e.g. calsats every 10 min)
+- **`one_shot`** -- run once per lighting condition (e.g. twilight flats)
+
+### Task sources
+
+| Source                  | What it collects                                         | Typical window    |
+| ----------------------- | -------------------------------------------------------- | ----------------- |
+| `twilight_flats`        | Flat field frames with auto-exposure adjustment          | Nautical twilight |
+| `calsats`               | Calibration satellite TLE tracking passes                | Twilight + night  |
+| `photometric_standards` | Landolt standard star observations with streaks          | Night             |
+| `coverage`              | Sparse sky maps (Fibonacci sphere sampling)              | Night             |
+| `lunar_background`      | Background measurements at angular separations from moon | Night             |
+
+## Quick Start
+
+### Direct mode (ASCOM hardware control)
+
+```sh
+burr-direct --site deploy/example/site.yaml --preset deploy/presets/sda.yaml
+```
+
+Connects to mount, camera, dome, and weather sensor via ASCOM Alpaca / PWI4. Runs all night autonomously -- opens dome at twilight, schedules observations by priority, closes dome at dawn or if weather deteriorates.
+
+### Simulation mode
+
+Set hardware devices to `active: false` in your site file (or point them at the bundled ASCOM/PWI4 simulators under [`deploy/`](deploy/)):
+
+```sh
+burr-direct --site deploy/example/site.yaml --preset deploy/presets/survey.yaml
+```
+
+### SensorKit mode (NATS-based control)
+
+```sh
+burr-sk --site deploy/example/site.yaml --preset deploy/presets/sda.yaml
+```
+
+Runs as a SensorKit program/controller pair, integrating with the [SensorKit](https://github.com/sensorkit/sensorkit) agent framework for multi-system orchestration. Requires the `sk` extra. `burr-sk --bootstrap --host <agent>` discovers SK entities + site position from a running agent and emits a `site.yaml` fragment.
+
+### Safe shutdown
+
+```sh
+burr-shutdown --site deploy/example/site.yaml --preset deploy/presets/sda.yaml
+```
+
+Closes dome, slews to a bright star for verification, parks mount, disconnects.
+
+## Project Structure
+
+```
+src/burr/
+    bootstrap.py              # Explicit engine init (no import-time side effects)
+    cli/                      # CLI entrypoints (direct, shutdown, sk)
+    core/                     # Config, constants, logging, notifications
+    models/                   # Pydantic models (tracking, observation, site, run, hardware)
+    task_source/              # Observation generators implementing the TaskSource protocol
+    scheduler/                # Shared scheduler (strategies, slots, factory)
+    hardware/
+        factory.py            # Device creation from config
+        direct/               # ASCOM control (runner, executor, weather monitor)
+        sk/                   # SensorKit integration (program, controller, tasks)
+    run/                      # Run state management and persistence
+    utils/                    # Astronomy, ephemeris, SpaceTrack utilities
+```
+
+## Credentials
+
+Burr reads credentials from the environment (or a `.env` file), never from config:
+
+- `SPACETRACK_USERNAME` / `SPACETRACK_PASSWORD` -- for SpaceTrack TLE downloads (calsats)
+- `SLACK_BOT_TOKEN` -- for the optional Slack notifications (`notify` extra)
+
+## Output
+
+Each night produces a run directory at `{output_dir}/{site}_{YYYYMMDD}/`:
+
+```
+example_20251201/
+    data/           # FITS files (flats, science frames, darks)
+    plots/          # Coverage maps, lighting schedules
+    metadata/       # run_state.json (resumable)
+    logs/           # Application logs
+    catalogs/       # TLE catalogs
+```
+
+Runs auto-resume if interrupted. Starting again on the same night picks up where it left off.
+
+## Citation
+
+Burr implements the system described in:
+
+> Gazak, J. Z., Swindle, R., Morales, S., Phelps, M., Iott, K., Blackhurst, E., & Fletcher, J. 2025, "Rapid Deployment, Calibration, and Training of Optical Observatories for Space Domain Awareness", Proceedings of the Advanced Maui Optical and Space Surveillance Technologies (AMOS) Conference. [doi:10.64861/XGPY2184](https://doi.org/10.64861/XGPY2184)
+
+If you use Burr in your research, please cite this paper:
+
+```bibtex
+@inproceedings{Gazak2025Burr,
+  title     = {Rapid Deployment, Calibration, and Training of Optical Observatories for Space Domain Awareness},
+  author    = {Gazak, J. Zachary and Swindle, Ryan and Morales, Sierra and Phelps, Matthew and Iott, Kevin and Blackhurst, Eric and Fletcher, Justin},
+  booktitle = {Proceedings of the Advanced Maui Optical and Space Surveillance Technologies (AMOS) Conference},
+  year      = {2025},
+  doi       = {10.64861/XGPY2184}
+}
+```
+
+## License
+
+[MIT](LICENSE)

astro_burr-0.3.1/README.md

@@ -0,0 +1,174 @@
+# Burr
+
+[![CI](https://github.com/zgazak/burr/actions/workflows/ci.yml/badge.svg)](https://github.com/zgazak/burr/actions/workflows/ci.yml)
+
+Taking the grind out of calibration.
+
+Autonomous calibration and observation scheduling for rapid-deploy SDA telescopes.
+
+Burr converts an observatory into a space domain awareness asset within days of deployment. It autonomously collects twilight flats, photometric standards, calibration satellite passes, sky coverage maps, and lunar background measurements -- all scheduled by lighting condition and time-share priority.
+
+Burr is built off of the descriptions in [Gazak et al. 2025, "Rapid Deployment, Calibration, and Training of Optical Observatories for Space Domain Awareness", AMOS Conference](https://amostech.space/year/2025/rapid-deployment-calibration-and-training-of-optical-observatories-for-space-domain-awareness/) -- see [Citation](#citation) below if you use this software.
+
+## Requirements
+
+- Python 3.13+
+- [uv](https://docs.astral.sh/uv/) package manager (for development installs)
+
+## Install
+
+Install from PyPI (package name `astro-burr`, imports as `burr`):
+
+```sh
+pip install astro-burr
+```
+
+Optional extras:
+
+```sh
+pip install "astro-burr[sk]"      # SensorKit (NATS-based) control
+pip install "astro-burr[direct]"  # direct ASCOM hardware control
+pip install "astro-burr[senpai]"  # SENPAI image-processing integration
+pip install "astro-burr[notify]"  # Slack notifications
+```
+
+### Development install
+
+This repo uses [uv](https://docs.astral.sh/uv/). First install uv, then:
+
+```sh
+make sync
+source .venv/bin/activate
+```
+
+## Configuration
+
+Burr separates **where** you observe from **how** you observe:
+
+- A **site file** (`deploy/<site>/site.yaml`) describes the observatory: coordinates, ASCOM/PWI4 hardware addresses, SensorKit entity names, notifications.
+- A **mode preset** (`deploy/presets/*.yaml`) describes the observing strategy: which task sources run, exposure ranges, and scheduling balance.
+
+You compose them at run time with `--site` + `--preset`. See [`deploy/example/`](deploy/example/) for a worked example and [`deploy/presets/`](deploy/presets/) for the bundled modes (`sda`, `science`, `survey`).
+
+| Site section   | Purpose                                                    |
+| -------------- | --------------------------------------------------------- |
+| `site`         | Coordinates and name (timezone auto-detected)             |
+| `hardware`     | ASCOM device addresses, ports, active flags               |
+| `sk`           | SensorKit entity names (for `burr-sk`)                     |
+| `weather`      | Rain/humidity thresholds and recovery timers              |
+| `notifications`| Slack channel for status updates                          |
+| `runtime`      | Output directory                                          |
+
+### Scheduling strategies
+
+Each task source has a scheduling strategy:
+
+- **`time_share`** -- target percentage of observing time (e.g. photometry 50%, coverage 30%)
+- **`interval`** -- minimum minutes between runs (e.g. calsats every 10 min)
+- **`one_shot`** -- run once per lighting condition (e.g. twilight flats)
+
+### Task sources
+
+| Source                  | What it collects                                         | Typical window    |
+| ----------------------- | -------------------------------------------------------- | ----------------- |
+| `twilight_flats`        | Flat field frames with auto-exposure adjustment          | Nautical twilight |
+| `calsats`               | Calibration satellite TLE tracking passes                | Twilight + night  |
+| `photometric_standards` | Landolt standard star observations with streaks          | Night             |
+| `coverage`              | Sparse sky maps (Fibonacci sphere sampling)              | Night             |
+| `lunar_background`      | Background measurements at angular separations from moon | Night             |
+
+## Quick Start
+
+### Direct mode (ASCOM hardware control)
+
+```sh
+burr-direct --site deploy/example/site.yaml --preset deploy/presets/sda.yaml
+```
+
+Connects to mount, camera, dome, and weather sensor via ASCOM Alpaca / PWI4. Runs all night autonomously -- opens dome at twilight, schedules observations by priority, closes dome at dawn or if weather deteriorates.
+
+### Simulation mode
+
+Set hardware devices to `active: false` in your site file (or point them at the bundled ASCOM/PWI4 simulators under [`deploy/`](deploy/)):
+
+```sh
+burr-direct --site deploy/example/site.yaml --preset deploy/presets/survey.yaml
+```
+
+### SensorKit mode (NATS-based control)
+
+```sh
+burr-sk --site deploy/example/site.yaml --preset deploy/presets/sda.yaml
+```
+
+Runs as a SensorKit program/controller pair, integrating with the [SensorKit](https://github.com/sensorkit/sensorkit) agent framework for multi-system orchestration. Requires the `sk` extra. `burr-sk --bootstrap --host <agent>` discovers SK entities + site position from a running agent and emits a `site.yaml` fragment.
+
+### Safe shutdown
+
+```sh
+burr-shutdown --site deploy/example/site.yaml --preset deploy/presets/sda.yaml
+```
+
+Closes dome, slews to a bright star for verification, parks mount, disconnects.
+
+## Project Structure
+
+```
+src/burr/
+    bootstrap.py              # Explicit engine init (no import-time side effects)
+    cli/                      # CLI entrypoints (direct, shutdown, sk)
+    core/                     # Config, constants, logging, notifications
+    models/                   # Pydantic models (tracking, observation, site, run, hardware)
+    task_source/              # Observation generators implementing the TaskSource protocol
+    scheduler/                # Shared scheduler (strategies, slots, factory)
+    hardware/
+        factory.py            # Device creation from config
+        direct/               # ASCOM control (runner, executor, weather monitor)
+        sk/                   # SensorKit integration (program, controller, tasks)
+    run/                      # Run state management and persistence
+    utils/                    # Astronomy, ephemeris, SpaceTrack utilities
+```
+
+## Credentials
+
+Burr reads credentials from the environment (or a `.env` file), never from config:
+
+- `SPACETRACK_USERNAME` / `SPACETRACK_PASSWORD` -- for SpaceTrack TLE downloads (calsats)
+- `SLACK_BOT_TOKEN` -- for the optional Slack notifications (`notify` extra)
+
+## Output
+
+Each night produces a run directory at `{output_dir}/{site}_{YYYYMMDD}/`:
+
+```
+example_20251201/
+    data/           # FITS files (flats, science frames, darks)
+    plots/          # Coverage maps, lighting schedules
+    metadata/       # run_state.json (resumable)
+    logs/           # Application logs
+    catalogs/       # TLE catalogs
+```
+
+Runs auto-resume if interrupted. Starting again on the same night picks up where it left off.
+
+## Citation
+
+Burr implements the system described in:
+
+> Gazak, J. Z., Swindle, R., Morales, S., Phelps, M., Iott, K., Blackhurst, E., & Fletcher, J. 2025, "Rapid Deployment, Calibration, and Training of Optical Observatories for Space Domain Awareness", Proceedings of the Advanced Maui Optical and Space Surveillance Technologies (AMOS) Conference. [doi:10.64861/XGPY2184](https://doi.org/10.64861/XGPY2184)
+
+If you use Burr in your research, please cite this paper:
+
+```bibtex
+@inproceedings{Gazak2025Burr,
+  title     = {Rapid Deployment, Calibration, and Training of Optical Observatories for Space Domain Awareness},
+  author    = {Gazak, J. Zachary and Swindle, Ryan and Morales, Sierra and Phelps, Matthew and Iott, Kevin and Blackhurst, Eric and Fletcher, Justin},
+  booktitle = {Proceedings of the Advanced Maui Optical and Space Surveillance Technologies (AMOS) Conference},
+  year      = {2025},
+  doi       = {10.64861/XGPY2184}
+}
+```
+
+## License
+
+[MIT](LICENSE)

astro_burr-0.3.1/deploy/example/README.md

@@ -0,0 +1,44 @@
+# Example deployment
+
+A worked example of a Burr site, meant to be copied and edited for a real
+observatory.
+
+Burr splits configuration into two pieces:
+
+- **`site.yaml`** (here) — *where* and *what*: coordinates, ASCOM/PWI4 hardware
+  addresses, SensorKit entity names, weather thresholds, notifications.
+- **a mode preset** (`../presets/*.yaml`) — *how*: which task sources run,
+  exposure ranges, and the scheduling balance between them.
+
+They are combined at run time, with the preset deep-merged on top of the site
+file.
+
+## Run it
+
+```sh
+# SensorKit (NATS-based) control — requires the `sk` extra
+burr-sk     --site deploy/example/site.yaml --preset deploy/presets/sda.yaml
+
+# Direct ASCOM hardware control
+burr-direct --site deploy/example/site.yaml --preset deploy/presets/survey.yaml
+
+# Safe shutdown
+burr-shutdown --site deploy/example/site.yaml --preset deploy/presets/sda.yaml
+```
+
+## Make your own
+
+1. Copy this directory: `cp -r deploy/example deploy/<your-site>`.
+2. Edit `site.yaml`:
+   - set `site.name`, `latitude`, `longitude`, `altitude_km`;
+   - set the `hardware` addresses (or `active: false` to simulate a device);
+   - for `burr-sk`, fill in the `sk` entity names — discover them with
+     `burr-sk --bootstrap --host <agent-host>`;
+   - enable `notifications` and set `SLACK_BOT_TOKEN` if you want Slack updates.
+3. Pick (or write) a preset in `../presets/` and run with `--site` + `--preset`.
+
+## Simulators
+
+The bundled `deploy/ASCOM.Alpaca.Simulators` and `deploy/PWI4` Docker setups let
+you exercise the full pipeline without real hardware — point the `hardware`
+addresses in `site.yaml` at them.

astro_burr-0.3.1/pyproject.toml

@@ -0,0 +1,106 @@
+[project]
+name = "astro-burr"
+version = "0.3.1"
+description = "Autonomous calibration and observation scheduling for rapid-deploy SDA telescopes"
+readme = "README.md"
+requires-python = ">=3.13"
+authors = [
+    { name = "Zach Gazak", email = "jzg@alum.mit.edu" },
+]
+keywords = [
+    "astronomy",
+    "telescope",
+    "observatory",
+    "space domain awareness",
+    "sda",
+    "scheduling",
+    "calibration",
+    "ascom",
+    "automation",
+]
+classifiers = [
+    "Programming Language :: Python :: 3.13",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Intended Audience :: Science/Research",
+    "Topic :: Scientific/Engineering :: Astronomy",
+]
+dependencies = [
+    "numpy",
+    "astropy>=7.1.0",
+    "deepdiff>=6.7.1",
+    "dotenv>=0.9.9",
+    "loguru>=0.7.3",
+    "matplotlib>=3.10.3",
+    "pydantic>=2.11.5",
+    "requests>=2.32.4",
+    "scipy>=1.15.3",
+    "skyfield>=1.53",
+    "timezonefinder>=6.5.9",
+    "tqdm>=4.67.1",
+    "watchdog>=6.0.0",
+    "nats-py>=2.7.0",
+    "alpyca>=3.1.0",
+    "tzdata",  # Required for Windows timezone support
+]
+
+[project.urls]
+Homepage = "https://github.com/zgazak/burr"
+Repository = "https://github.com/zgazak/burr"
+Issues = "https://github.com/zgazak/burr/issues"
+
+[project.scripts]
+burr-direct = "burr.cli.direct:main"
+burr-shutdown = "burr.cli.shutdown:main"
+burr-sk = "burr.cli.sk:main"
+
+[project.optional-dependencies]
+# SensorKit (NATS-based) control. sensorkit is published on PyPI.
+sk = [
+    "sensorkit[alpaca,pwi4,filesys,webapi]>=0.1.3",
+    "aiofile>=3.9.0",
+]
+# Direct ASCOM hardware control (alpyca is already a core dependency; this
+# extra exists for symmetry and explicit intent).
+direct = [
+    "alpyca>=3.1.0",
+]
+# SENPAI image-processing integration.
+senpai = [
+    "astro-senpai",
+]
+# Slack notifications.
+notify = [
+    "slack-sdk>=3.35.0",
+]
+
+# uv keeps pydantic on the 2.x line shared with downstream integrations.
+[tool.uv]
+override-dependencies = ["pydantic~=2.10"]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/burr"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "src/burr",
+    "README.md",
+    "LICENSE",
+    "pyproject.toml",
+]
+
+[tool.pytest.ini_options]
+addopts = "-ra -q"
+testpaths = ["tests"]
+
+[dependency-groups]
+dev = [
+    "ruff>=0.3.0",
+    "pytest>=8.3.0",
+    "pytest-cov>=5.0.0",
+    "genbadge[coverage,tests]>=1.1.3",
+]

astro_burr-0.3.1/src/burr/__init__.py

@@ -0,0 +1,10 @@
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("astro-burr")
+except PackageNotFoundError:
+    __version__ = "unknown"
+
+# Re-export for backward compatibility - code that calls burr.initialize_engine()
+# or burr.load_environment() will still work.
+from burr.bootstrap import initialize_engine, load_environment  # noqa: F401