Commit Diff


commit - 9ce0b9cb39a3c98b9bf3332da7ce5c81be292fc6
commit + 6af67de2a51af9ab7228fe46255345a17cead54e
blob - /dev/null
blob + 26700d7dadabaab82605883aa8c9f4f216a1644c (mode 644)
--- /dev/null
+++ .github/workflows/CI.yml
@@ -0,0 +1,20 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: julia-actions/setup-julia@v3
+        with:
+          version: '1'
+      - uses: julia-actions/cache@v3
+      - uses: julia-actions/julia-buildpkg@v1
+      - uses: julia-actions/julia-runtest@v1
blob - 79ee32b83c44adccc6c4718593d9a249be84ba60
blob + a8a1df41d600e2b0f78567ecf6988a7247cdcac1
--- .gitignore
+++ .gitignore
@@ -26,3 +26,8 @@ docs/src/.vitepress/dist/
 # hand-authored logo.png/favicon.ico is ever added there.
 docs/src/assets/systematic-error-floor-sweep.png
 docs/src/assets/iasc-match-radius-retuning.png
+
+# Local-only notes about the GitHub mirror's own CI/Pages plumbing — not
+# part of the project (the wiki documents the pipeline, not its own
+# deploy infrastructure).
+PAGES_NOTES.md
blob - 43b3f4c30fb5b831d967b1d11b9da5fca7e5b604
blob + 480a0945a5130ce934bfbb14f885432aac6b4853
--- README.md
+++ README.md
@@ -1,6 +1,6 @@
 # AsteroidPipeline.jl
 
-[![Documenter](https://github.com/Richard7987/AsteroidPipeline.jl/actions/workflows/Documenter.yml/badge.svg)](https://github.com/Richard7987/AsteroidPipeline.jl/actions/workflows/Documenter.yml)
+[![CI](https://github.com/Richard7987/AsteroidPipeline.jl/actions/workflows/CI.yml/badge.svg)](https://github.com/Richard7987/AsteroidPipeline.jl/actions/workflows/CI.yml)
 [![docs](https://img.shields.io/badge/docs-dev-blue.svg)](https://richard7987.github.io/AsteroidPipeline.jl/dev/)
 
 An open-source Julia pipeline for asteroid search campaigns, developed for
@@ -41,7 +41,7 @@ julia --project=docs docs/make.jl
 ```
 
 `.github/workflows/Documenter.yml` builds and deploys it to GitHub Pages
-on every push to `main` and on tags.
+on every push to `main`.
 
 ## License
 
blob - 94f982af48c65fd43a71f7b22f2d6e59d0aed721
blob + 3b9e544a3ad109b2f710e0aa7f9988819d4aa26c
--- docs/src/design-refinements.md
+++ docs/src/design-refinements.md
@@ -1,14 +1,12 @@
-# Revisiting the two intentional-design "limitations"
+# Design refinements
 
 Part of this project's [Investigation Log](investigation-log.md) —
-split onto its own page since it's a design review, not a bug found on a
-specific real dataset the way the other pages here are.
+split onto its own page since these aren't bugs found on one specific
+real dataset the way the other pages here are: two are design decisions
+revisited to see if they could be improved without abandoning the choice
+behind them, and two are validation/performance investigations that
+don't belong to any single dataset-specific page.
 
-Two items in `docs/src/index.md`'s Known Limitations were design
-decisions, not bugs — but "intentional" isn't the same as "as good as it
-can be." Asked directly whether either could be genuinely improved
-without abandoning the design choice behind it.
-
 ## `estimate_psf`'s empirical-vs-fallback split was a hard binary
 
 A field either had stars passing the isolation/saturation filter at
@@ -51,44 +49,6 @@ missing was visibility: added a `@warn` (once per sess
 choice) when both are left `nothing`. Regression test confirms it fires
 when omitted and stays silent when both are supplied.
 
-## GitHub Pages was never actually serving the wiki, despite a working deploy pipeline
-
-The GitHub mirror's docs site returned 404 even though
-`.github/workflows/Documenter.yml` reported `success` on every run, and
-`deploydocs` printed a clean `Deploying: ✔` with all five criteria
-checked. Diagnosed with `gh` (installed and authenticated specifically
-for this, not guessed from log snippets) rather than assumed from the
-green checkmark: `gh api repos/.../pages` returned a plain 404
-("Not Found") — GitHub Pages itself was disabled at the repository
-level, Source stuck on "None". The workflow's own job log, read in
-full, confirmed the deploy step really had pushed a working site:
-`fatal: 'upstream/gh-pages' is not a commit` (the expected first-deploy
-message), followed by a clean orphan-branch creation and a real push —
-git's own "Create a pull request for 'gh-pages'" hint, which only
-appears when a *new* branch is actually accepted by the remote. So the
-branch existed with real content; nothing was being served from it
-because Pages was off, a setting independent of whether gh-pages exists.
-Fixed directly: `gh api repos/.../pages -X POST` with
-`source.branch=gh-pages`, confirmed via the API's own `status: "built"`
-and a live `curl` returning 200 on multiple pages.
-
-A related, real mistake made and caught in the same investigation: a
-first attempt at adding a `.nojekyll` file (see above) touched it into
-`docs/build/<n>/` before `deploydocs` ran, reasoning that this local
-directory was "the site root." It isn't — `deploydocs` copies that
-directory's contents into a nested `dev/` subfolder of the actual
-gh-pages branch, generating `versions.js` and a redirect `index.html`
-separately at the *real* root, which no local directory corresponds to.
-Confirmed by listing the live branch's root contents via `gh api`
-(`dev/`, `index.html`, `versions.js` — no `.nojekyll` anywhere) after
-the first attempt had already been deployed. Corrected by adding
-`.nojekyll` directly to the gh-pages root via the API instead, a
-one-time fix rather than build-time logic: `deploydocs`'s own push
-mechanism checks out the *existing* branch and only touches specific
-known paths (each version's subfolder, `versions.js`, the root
-`index.html`) rather than wiping it, so a root file added once persists
-across every future automated deploy.
-
 ## `photometric_outlier_threshold` was untested, but not for lack of a real anomaly to test it against
 
 `run_pipeline`'s raw-path `photometric_outlier_threshold` docstring used
blob - e6f5a8a6c1241d9ba058bc1eb1378404ce5ba18d
blob + e99478d48914a35114bb56bb42f86591a35d5a0f
--- docs/src/investigation-log.md
+++ docs/src/investigation-log.md
@@ -12,7 +12,7 @@ to split onto their own pages:
 
 - [Validating `search_field` against a real, independently-confirmed variable star](variable-star-validation.md)
 - [Validating against real IASC (Pan-STARRS1) campaign data](iasc-campaign-validation.md)
-- [Revisiting the two intentional-design "limitations"](design-refinements.md)
+- [Design refinements](design-refinements.md)
 
 ## Real ZTF data surfaced four bugs no synthetic test or code review caught
 
@@ -344,4 +344,4 @@ detections, not the smallest false-positive rate achie
 
 - [Validating `search_field` against a real, independently-confirmed variable star](variable-star-validation.md)
 - [Validating against real IASC (Pan-STARRS1) campaign data](iasc-campaign-validation.md)
-- [Revisiting the two intentional-design "limitations"](design-refinements.md)
+- [Design refinements](design-refinements.md)