//localhost:1313/internal/index.html Purpose Define quality gates and release-readiness checks for DSAMbayes v1.2.2. Audience Maintainers preparing and validating releases. Reviewers checking evidence before sign-off. Pages Page Topic Testing and Validation Quality-gate execution commands, expected outcomes, and evidence capture Quality Gates Gate definitions and pass/fail criteria Runner Smoke Tests Minimal runner validation runs CI Workflows Automated check and docs-build workflows Release Readiness Checklist Gate checklist and sign-off fields Release Evidence Pack Artefact collection for stakeholder review Release Playbook Step-by-step release process Sign-off Template Release sign-off record template Hugo en-gb //localhost:1313/internal/quality-gates/index.html Mon, 01 Jan 0001 00:00:00 +0000 //localhost:1313/internal/quality-gates/index.html Purpose Define the canonical release-quality gates for DSAMbayes v1.2.2, including commands, pass/fail criteria, and evidence requirements. Audience Maintainers preparing a release candidate Reviewers signing off release readiness Engineers running local pre-merge quality checks Gate Matrix Gate ID Gate Command Pass Criteria Evidence QG-1 Lint R_LIBS_USER="$PWD/.Rlib" Rscript scripts/check.R --lint Exit code 0, no lint failures, no SKIP: output Terminal log and exit code QG-2 Style R_LIBS_USER="$PWD/.Rlib" Rscript scripts/check.R --style Exit code 0, no style failures, no SKIP: output Terminal log and exit code QG-3 Unit tests R_LIBS_USER="$PWD/.Rlib" R -q -e 'testthat::test_dir("tests/testthat")' Exit code 0, no test failures Terminal log and exit code QG-4 Package check R_LIBS_USER="$PWD/.Rlib" R -q -e 'rcmdcheck::rcmdcheck(args = c("--no-manual","--compact-vignettes=gs+qpdf"))' No ERROR. No WARNING for release sign-off. Any NOTE requires explicit reviewer acceptance rcmdcheck summary and reviewer decision on NOTEs QG-5 Runner smoke: validate R_LIBS_USER="$PWD/.Rlib" Rscript scripts/dsambayes.R validate --config config/blm_synthetic_mcmc.yaml --run-dir results/quality_gate_validate Exit code 0 CLI log and results/quality_gate_validate/00_run_metadata/config.resolved.yaml QG-6 Runner smoke: run R_LIBS_USER="$PWD/.Rlib" Rscript scripts/dsambayes.R run --config config/blm_synthetic_mcmc.yaml --run-dir results/quality_gate_run Exit code 0 and core artefacts exist CLI log and selected artefacts under results/quality_gate_run/ QG-7 Docs build check R_LIBS_USER="$PWD/.Rlib" Rscript -e 'pkgdown::build_site_github_pages(new_process = FALSE, install = FALSE)' Exit code 0 Build log and generated site output under docs/ Gate Definitions QG-1 Lint Command: //localhost:1313/internal/testing-and-validation/index.html Mon, 01 Jan 0001 00:00:00 +0000 //localhost:1313/internal/testing-and-validation/index.html Purpose Define the canonical testing and validation workflow for DSAMbayes v1.2.2, from local pre-merge checks through release-quality gates. Audience Engineers running local checks before merge Maintainers preparing release candidates Reviewers validating release evidence Validation layers Layer Objective Primary command(s) Output proof Lint Catch style and static issues early Rscript scripts/check.R --lint Exit code 0, no lint failures Style Enforce formatting compliance on changed files Rscript scripts/check.R --style Exit code 0, no reformat-required files Unit tests Catch behavioural regressions in package logic R -q -e 'testthat::test_dir("tests/testthat")' Exit code 0, no test failures Package check Validate package-level install and check behaviour R -q -e 'rcmdcheck::rcmdcheck(...)' No ERROR; no unresolved WARNING Runner validate Validate config and data contracts without fitting Rscript scripts/dsambayes.R validate ... Exit code 0, metadata artefacts Runner run Validate end-to-end runner execution and artefacts Rscript scripts/dsambayes.R run ... Exit code 0, core run artefacts Docs build Validate pkgdown documentation buildability Rscript -e 'pkgdown::build_site_github_pages(...)' Exit code 0, successful site build CI workflows Cross-platform and publish-path verification GitHub Actions workflow runs Green workflow status on candidate commit Environment setup Run all commands from repository root: //localhost:1313/internal/runner-smoke-tests/index.html Mon, 01 Jan 0001 00:00:00 +0000 //localhost:1313/internal/runner-smoke-tests/index.html Purpose Define the minimal reproducible smoke-test matrix for the YAML runner validate and run commands, including exact commands and expected artefacts. Audience Maintainers preparing release evidence Engineers triaging runner regressions Reviewers confirming gate QG-5 and QG-6 Test scope This smoke suite is intentionally small. It proves: //localhost:1313/internal/ci-workflows/index.html Mon, 01 Jan 0001 00:00:00 +0000 //localhost:1313/internal/ci-workflows/index.html Purpose Define what the repository CI workflows execute, what each workflow is expected to prove, and where each workflow fits in release evidence. Audience Maintainers who triage CI failures and approve merges Reviewers validating release evidence Engineers who need to map local checks to CI outcomes Workflow inventory Workflow file Job Triggers Primary proof .github/workflows/R-CMD-check.yaml R-CMD-check push and pull_request to main or master DSAMbayes passes R CMD check across the configured OS and R-version matrix. .github/workflows/pkgdown.yaml pkgdown push and pull_request to main or master, release (published), and manual workflow_dispatch Documentation site builds successfully, and non-PR events can deploy to gh-pages. R-CMD-check.yaml Trigger conditions R-CMD-check.yaml runs on: //localhost:1313/internal/release-evidence-pack/index.html Mon, 01 Jan 0001 00:00:00 +0000 //localhost:1313/internal/release-evidence-pack/index.html Purpose Define the exact evidence bundle required before release sign-off for DSAMbayes v1.2.2. Audience Release owner preparing sign-off materials Reviewers validating release readiness Maintainers reproducing release gate outcomes Evidence root and naming Use one evidence root per candidate release. //localhost:1313/internal/release-readiness-checklist/index.html Mon, 01 Jan 0001 00:00:00 +0000 //localhost:1313/internal/release-readiness-checklist/index.html Purpose Provide the mandatory go or no-go checklist before creating a DSAMbayes release tag. How to use this checklist Complete this checklist after running all release-quality gates. Record evidence paths for each item. If any mandatory item fails, decision is NO-GO. Copy final decision details into Release Sign-off Template. Mandatory checklist ID Check Pass criteria Evidence required RL-01 Candidate commit fixed Single candidate commit hash selected and recorded 00_release_identity/release_identity.txt RL-02 Version metadata aligned DESCRIPTION version equals intended release version 00_release_identity/release_identity.txt RL-03 Changelog aligned Top CHANGELOG.md section matches candidate scope 00_release_identity/changelog_top.md RL-04 QG-1 lint passed Exit code 0, no lint failures 10_quality_gates/qg1_lint.log, 10_quality_gates/qg1_lint.exit RL-05 QG-2 style passed Exit code 0, no style failures 10_quality_gates/qg2_style.log, 10_quality_gates/qg2_style.exit RL-06 QG-3 tests passed Exit code 0, no test failures 10_quality_gates/qg3_tests.log, 10_quality_gates/qg3_tests.exit RL-07 QG-4 package check passed No ERROR; no unresolved WARNING 10_quality_gates/qg4_rcmdcheck.log, 10_quality_gates/qg4_rcmdcheck.exit RL-08 QG-5 validate passed Exit code 0; required validate artefacts present 10_quality_gates/qg5_validate.*, 20_runner_artifacts/quality_gate_validate/ RL-09 QG-6 run passed Exit code 0; required run artefacts present 10_quality_gates/qg6_run.*, 20_runner_artifacts/quality_gate_run/ RL-10 QG-7 docs build passed Exit code 0; pkgdown build completed 10_quality_gates/qg7_pkgdown.* RL-11 CI package workflow green .github/workflows/R-CMD-check.yaml passed on candidate commit 30_ci/ci_run_summary.md RL-12 CI docs workflow green .github/workflows/pkgdown.yaml build passed on candidate commit 30_ci/ci_run_summary.md RL-13 Evidence bundle complete All mandatory evidence items EVD-01 to EVD-13 present Evidence root directory RL-14 Exceptions resolved or accepted All exceptions documented with owner and approval 40_signoff/sign_off_record.md RL-15 Final sign-off recorded Decision, approver, and timestamp completed 40_signoff/sign_off_record.md Required runner artefact checks Validate artefacts that must exist: //localhost:1313/internal/release-playbook/index.html Mon, 01 Jan 0001 00:00:00 +0000 //localhost:1313/internal/release-playbook/index.html Purpose Define the operational release flow from freeze to tag for DSAMbayes v1.2.2, including rollback and hotfix handling. Audience and roles Release owner (cshaw): drives the checklist, evidence pack, and final go or no-go call. Maintainers: execute gates, review failures, and approve release PRs. Reviewers: verify evidence and sign off risk acceptance. Release inputs Release work starts only when these inputs are ready: //localhost:1313/internal/sign-off-template/index.html Mon, 01 Jan 0001 00:00:00 +0000 //localhost:1313/internal/sign-off-template/index.html Purpose Provide the final approval record for a DSAMbayes release candidate after all mandatory evidence has been reviewed. Instructions Copy this template into the candidate evidence bundle as 40_signoff/sign_off_record.md. Complete every field. Use GO, NO-GO, or HOLD for the decision. If any exception is accepted, record explicit rationale and owner. Release identification Field Value Release version v1.2.2 Package version (DESCRIPTION) <fill> Candidate commit hash <fill> Candidate branch <fill> Intended tag <fill> Changelog section verified <yes/no> Evidence root path <fill> Decision summary Field Value Decision <GO/NO-GO/HOLD> Decision date (UTC) <YYYY-MM-DD> Decision timestamp (UTC) <YYYY-MM-DDTHH:MM:SSZ> Release owner <name> Primary approver <name> Secondary reviewer (if used) <name or n/a> Decision rationale: