Skip to content

Releases

v2.0.0 — LLM-assisted reproducibility and scientific-alignment update

Choose a tag to compare

@reblocke reblocke released this 27 Jul 23:09
88098c6

v2.0.0 — LLM-Assisted Reproducibility and Scientific-Alignment Update

This is the current citable release of the public repository.

What Changed

  • Applied human-adjudicated corrections to published case-definition
    boundaries, sensitivity-analysis exclusions, testing-strategy subgroups,
    selected upstream aggregate checks, and figure filenames.
  • Added a guarded restricted-data runner, adjacent input approval contract,
    provenance capture, complete artifact checks, and a value-suppressing
    comparison workflow.
  • Added a portable PNG-to-TIFF cohort-diagram workflow, locked public checks,
    structured metadata, and release-aware reader and machine documentation.
  • Reorganized the README around release selection, article identifiers, the
    data boundary, quick starts, and a paper-to-code map.

LLM Assistance and Scientific Authority

LLM tools assisted repository review, reproducibility hardening, testing, and
documentation. Scientific decisions were made and adjudicated by the repository
maintainer and study author.

Validation

  • Release commit: 88098c6e89f8084114d4bf72e787340b0422523b
  • GitHub Actions passed on both main and the v2.0.0 tag.
  • The public suite contains 100 tests, a public-surface audit, CFF validation,
    and an executed diagram/TIFF smoke test.
  • The exact scientific-alignment implementation
    9f8fecd2384edd3ae3fd4b0c8ecbc8536769bc19 was executed twice against the
    same approved restricted input. The candidates were artifact-for-artifact
    repeatable, and historical differences were recorded as correction impact.
  • The current scientific body remains separately test-locked.

Important Boundaries

  • This release is not equivalent to v1.0.0; it includes documented scientific
    corrections.
  • SA-002, SA-007, SA-008, and SA-009 remain unresolved.
  • Public checks do not reproduce the restricted Stata analysis or validate the
    article estimates.
  • The repository does not reproduce upstream TriNetX construction.
  • No restricted data, generated results, logs, workbooks, figures, or other
    release assets are attached.

See docs/SCIENTIFIC_ALIGNMENT.md, docs/VALIDATION.md, and
docs/REPRODUCIBILITY.md for the technical evidence and limitations.

v1.0.0 — paper-associated historical implementation

Choose a tag to compare

@reblocke reblocke released this 27 Jul 23:09

v1.0.0 — Paper-Associated Historical Implementation

This release provides a citable snapshot of the validated implementation before
the current scientific-alignment corrections.

Article

Snapshot

  • Release commit: e5671dc35a30ba433588f0793de48d0e97a6d3df
  • Existing historical tag at the same commit: hcd-000b-historical
  • Scientific role: paper-associated, pre-correction implementation

The historical scientific body was compared with a preserved legacy baseline,
and two independent guarded candidates were repeatable for the restricted input
available during validation. See docs/VALIDATION.md in the release.

Important Boundaries

  • This release is not proof that the available restricted file was the exact
    publication input.
  • It does not reproduce the upstream TriNetX query, export, code lists,
    laboratory windowing, or analytic-dataset assembly.
  • Publication-time versions of community Stata packages remain unresolved.
  • No restricted data, generated results, logs, workbooks, figures, or other
    release assets are attached.

Historical Diagram Portability

The repository tests pass at this tag. Its optional data-free diagram smoke test
does not run on the current Ubuntu Graphviz 2.43 package because the historical
notebook requests direct TIFF output, which that Graphviz build does not
support. This affects only rendering of the fixed-count cohort diagram, not the
Stata scientific analysis. The portable PNG-to-TIFF workflow is included in
v2.0.0.

When citing the code, cite this release together with the CHEST article.