added watchdog workflow for failed ci jobs

Author: maureeungaro

.github/workflows/binary_tarballs.yml

@@ -86,6 +86,7 @@ jobs:
     name: ${{ matrix.image }}:${{ matrix.image_tag }} ${{ matrix.arch }}
     needs: [ discover, release-tarballs ]
     runs-on: ${{ matrix.runner }}
+    timeout-minutes: 120
     strategy:
       fail-fast: false
       matrix: ${{ fromJSON(needs.discover.outputs.matrix_build) }}

.github/workflows/deploy.yml

@@ -68,6 +68,7 @@ jobs:
     name: ${{ matrix.image }}/${{ matrix.image_tag }} ${{ matrix.arch }}
     needs: [ overview, discover ]
     runs-on: ${{ matrix.runner }}
+    timeout-minutes: 360
     strategy:
       fail-fast: false
       matrix: ${{ fromJSON(needs.discover.outputs.matrix_build) }}
@@ -199,6 +200,7 @@ jobs:
     name: ${{ matrix.image }}/${{ matrix.image_tag }}
     needs: [ build_arch, discover ]
     runs-on: ubuntu-latest
+    timeout-minutes: 60
     # If arm64 was skipped (e.g., archlinux), still publish amd64-only manifest.
     strategy:
       fail-fast: false

.github/workflows/rerun_failed_matrix.yml

@@ -0,0 +1,117 @@
+name: Retry Failed Matrix Jobs
+
+permissions:
+  actions: write
+  contents: read
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+on:
+  workflow_run:
+    workflows: [ "Test", "Sanitize", "Deploy", "Binary Tarballs" ]
+    types: [ completed ]
+
+jobs:
+  rerun-failed:
+    name: Retry failed matrix jobs
+    if: >-
+      ${{
+        github.event.workflow_run.head_repository.full_name == github.repository &&
+        github.event.workflow_run.run_attempt == 1 &&
+        (
+          github.event.workflow_run.conclusion == 'failure' ||
+          github.event.workflow_run.conclusion == 'timed_out'
+        )
+      }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Re-run failed jobs when most matrix jobs passed
+        uses: actions/github-script@v8
+        with:
+          script: |
+            const run = context.payload.workflow_run;
+            const owner = context.repo.owner;
+            const repo = context.repo.repo;
+            const workflowName = run.name;
+
+            const excludedByWorkflow = {
+              "Test": [
+                "Create job matrix",
+                "Test - summary",
+              ],
+              "Sanitize": [
+                "Create job matrix",
+                "Sanitize - summary",
+              ],
+              "Deploy": [
+                "Workflow Overview",
+                "Create Job Matrices",
+                "Mirror images to Docker Hub",
+                "Update Docker Hub description",
+                "Deploy - summary",
+              ],
+              "Binary Tarballs": [
+                "Attach GEMC tarballs to dev release",
+                "Create Job Matrix",
+              ],
+            };
+
+            const excluded = new Set(
+              (excludedByWorkflow[workflowName] || []).map((name) => name.toLowerCase()),
+            );
+
+            const jobs = await github.paginate(github.rest.actions.listJobsForWorkflowRun, {
+              owner,
+              repo,
+              run_id: run.id,
+              per_page: 100,
+            });
+
+            const countedConclusions = new Set([
+              "success",
+              "failure",
+              "cancelled",
+              "timed_out",
+              "action_required",
+            ]);
+
+            const matrixJobs = jobs.filter((job) => {
+              const name = job.name.trim();
+              return job.status === "completed"
+                && countedConclusions.has(job.conclusion)
+                && !excluded.has(name.toLowerCase());
+            });
+
+            const successCount = matrixJobs.filter((job) => job.conclusion === "success").length;
+            const failedCount = matrixJobs.length - successCount;
+            const successRatio = matrixJobs.length === 0 ? 0 : successCount / matrixJobs.length;
+
+            core.info(`Workflow: ${workflowName}`);
+            core.info(`Run: ${run.html_url}`);
+            core.info(`Matrix jobs: ${matrixJobs.length}`);
+            core.info(`Matrix successes: ${successCount}`);
+            core.info(`Matrix failed/cancelled/timed out: ${failedCount}`);
+
+            if (matrixJobs.length === 0) {
+              core.notice("No matrix jobs were found for this workflow; not retrying.");
+              return;
+            }
+
+            if (failedCount === 0) {
+              core.notice("No failed matrix jobs were found; not retrying.");
+              return;
+            }
+
+            if (successRatio < 0.5) {
+              core.notice("Fewer than 50% of matrix jobs succeeded; not retrying failed jobs.");
+              return;
+            }
+
+            await github.rest.actions.reRunWorkflowFailedJobs({
+              owner,
+              repo,
+              run_id: run.id,
+            });
+
+            core.notice("Requested a re-run of failed jobs for this workflow run.");

.github/workflows/sanitize.yml

@@ -64,6 +64,7 @@ jobs:
       fail-fast: false
       matrix: ${{ fromJSON(needs.discover.outputs.matrix_sanitize) }}
     runs-on: ${{ matrix.runner }}
+    timeout-minutes: 180
     container: ${{ matrix.container }}
 
     steps:

.github/workflows/test.yml

@@ -68,6 +68,7 @@ jobs:
     name: ${{ matrix.image }}/${{ matrix.image_tag }} ${{ matrix.arch }}
     needs: [ discover ]
     runs-on: ${{ matrix.runner }}
+    timeout-minutes: 180
     strategy:
       fail-fast: false
       matrix: ${{ fromJSON(needs.discover.outputs.matrix_build) }}

CITATION.cff

@@ -17,6 +17,7 @@ preferred-citation:
   authors:
     - family-names: Ungaro
       given-names: Maurizio
+      orcid: "https://orcid.org/0000-0001-6982-3310"
   collection-title: "European Physical Journal Web of Conferences"
   volume: 295
   year: 2024

releases/0.4.md

@@ -6,6 +6,7 @@ This version includes:
 - A `-global_field=<name>` option to attach a configured field to the ROOT world volume.
 - A `-no_field=<volume|list|all>` option to remove field associations; unused field plugins and maps
   are no longer loaded.
+- A `-max_field_step=<length>` option to cap the largest Geant4 magnetic-field propagation step.
 - A new `asciimap` field plugin (`type: asciimap`) that loads ASCII field maps from data-only files
   with the grid defined in YAML — the GEMC3 successor of the clas12 `asciiField`.
 - Field-only runs now initialize against the default ROOT world when no detector system is selected.
@@ -35,6 +36,9 @@ This version includes:
   gvolume name, a whitespace- or comma-separated list of names, or the special value `all`, which
   resets every per-volume field and also clears `-global_field`. Fields left unused after the reset
   are skipped: their plugins and field maps are no longer loaded.
+- Added `-max_field_step=<length>` to set Geant4's largest acceptable magnetic-field propagation
+  step through `G4PropagatorInField::SetLargestAcceptableStep()`. The default `0*mm` leaves the
+  Geant4 propagator default unchanged.
 - Field-line visualization now applies `/vis/set/extentForField` from the configured ROOT `G4Box`
   half-lengths before issuing `/vis/scene/add/magneticField`, avoiding misleading field-line
   sampling when the scene extent is dominated by detector geometry.
@@ -98,6 +102,8 @@ This version includes:
 - Added gfield tests for `-fieldAt` and `-fieldMapPoints` query workflows.
 - Added `asciimap` load and `-fieldAt` tests for the dipole, solenoid, and phi-segmented torus
   example maps.
+- Updated the `gemc_gfield_verbose` integration test to install a global field and exercise
+  `-max_field_step=5*mm`.
 
 <br/>
 
@@ -107,7 +113,7 @@ This version includes:
 - [Issue #28](https://github.com/gemc/src/issues/28): add buttons to g4display
 - [Issue #31](https://github.com/gemc/src/issues/31): improve field ASCII and add SQLITE factory and apply it to gemc3
 - [Issue #42](https://github.com/gemc/src/issues/42): output options for digitized and true infos
-- [Issue #57](https://github.com/gemc/src/issues/57): min and max field steps definitions
+- [Issue #57](https://github.com/gemc/src/issues/57): add max field steps definitions
 - [Issue #59](https://github.com/gemc/src/issues/59): TSGQt plotter see B5 example from presentation
 - [Issue #75](https://github.com/gemc/src/issues/75): add histo tab with g4histos
 - [Issue #76](https://github.com/gemc/src/issues/76): refined CAD interface, add SQLITE like gemc2
@@ -175,6 +181,10 @@ Both x86_64 and ARM64 platforms are supported.
   name and the fully-qualified Geant4 name, an unmatched name emits a warning, and `all` additionally
   suppresses the global field. `GMagneto`'s constructor gained an optional `required_fields` set
   (empty meaning "load everything", preserving the field-query path).
+- Added the `-max_field_step=<length>` option (defined in the gfields module, consumed in
+  `GMagneto`). Positive values are parsed with GEMC's Geant4-unit parser and passed to
+  `G4PropagatorInField::SetLargestAcceptableStep()`, while the default `0*mm` leaves Geant4's
+  propagation limit unchanged. Per-field `minimum_step` still controls the field integration driver.
 - The GUI field-line toggle now parses the configured ROOT `G4Box` dimensions and sends
   `/vis/set/extentForField -dx dx -dy dy -dz dz mm` before adding or refreshing the magnetic-field
   model. Non-`G4Box` roots keep Geant4's default scene-extent behavior.