Repository navigation
Releases
v2.0.0 — LLM-assisted reproducibility and scientific-alignment update
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
mainand thev2.0.0tag. - The public suite contains 100 tests, a public-surface audit, CFF validation,
and an executed diagram/TIFF smoke test. - The exact scientific-alignment implementation
9f8fecd2384edd3ae3fd4b0c8ecbc8536769bc19was 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
v1.0.0 — Paper-Associated Historical Implementation
This release provides a citable snapshot of the validated implementation before
the current scientific-alignment corrections.
Article
- The Consistency of Hypercapnic Respiratory Failure Case Definitions in Electronic Health Record Data
- PMID: 40885535
- PMCID: PMC12739763
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.