pen-stack 4.0.0__tar.gz → 4.0.1__tar.gz

{pen_stack-4.0.0 → pen_stack-4.0.1}/CHANGELOG.md

@@ -3,6 +3,18 @@
 All notable changes to PEN-STACK are documented here. This file follows
 [Keep a Changelog](https://keepachangelog.com/) and the program's phase structure.
 
+## [4.0.1] - 2026-06-09 - data-correctness patch: writer-verification panel verified against Perry 2025
+
+### Fixed
+- **WS-WV frozen panel is now verbatim from the measured Perry 2025 ISCro4 DMS.** The offline-fallback panel
+  in `atlas/writer_verify.py` previously used *illustrative* Z-scores (2.6/2.1/1.7) and invented control
+  variants (G15D/P88R/L120E), and `_CORE_RESIDUES` used illustrative arginines. Replaced with the REAL values
+  from `science.adz0276` Table S3: the top-3 enhancers **N322P (Z 0.754), H50K (0.742), R278M (0.709)**, real
+  near-neutral variants (V21R, S312Q, G286T), the most-deleterious variants (R132E −5.40, R137E −5.12,
+  R195D −4.98), and the documented catalytic residues **D11/E60/D102/D105/S241** ("Residue Groups" sheet). The
+  real-DMS path (on the VM/Drive) was already correct; only the offline fallback constants were illustrative.
+  Added `test_ws_wv.py::test_frozen_panel_matches_real_perry_dms_table_s3` to guard against drift.
+
 ## [4.0.0] - 2026-06-09 - v4.0 release: the Oracle Mesh (on top of the foundation models) + writer verification
 
 A major bump: the substrate now *composes* the biomolecular foundation models under one contract and verifies

{pen_stack-4.0.0 → pen_stack-4.0.1}/CITATION.cff

@@ -1,7 +1,7 @@
 cff-version: 1.2.0
 message: "If you use PEN-STACK, please cite it as below."
 title: "PEN-STACK: open infrastructure for genome writing"
-version: 4.0.0
+version: 4.0.1
 date-released: 2026-06-01
 authors:
   - family-names: "Mahaboob Ali"

{pen_stack-4.0.0 → pen_stack-4.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pen-stack
-Version: 4.0.0
+Version: 4.0.1
 Summary: Open infrastructure for genome writing: the Writable Genome atlas, the Writer Atlas, and the Write Planner.
 Author-email: Anees Ahmed Mahaboob Ali <ahmedaneesm@gmail.com>
 License: MIT
@@ -89,7 +89,7 @@ and durably write new DNA, **which enzyme** can write it there, and **how** to d
 [![codecov](https://codecov.io/gh/ahmedanees-m/pen-stack/branch/main/graph/badge.svg)](https://codecov.io/gh/ahmedanees-m/pen-stack)
 [![License: MIT](https://img.shields.io/badge/License-MIT-informational.svg)](LICENSE)
 [![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://www.python.org/)
-[![Version](https://img.shields.io/badge/version-4.0.0-blue.svg)](CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-4.0.1-blue.svg)](CHANGELOG.md)
 [![Tests](https://img.shields.io/badge/tests-208%20passing-success.svg)](tests/)
 [![Lint: ruff](https://img.shields.io/badge/lint-ruff-purple.svg)](https://github.com/astral-sh/ruff)
 [![Runtime: Docker](https://img.shields.io/badge/runtime-docker-2496ED.svg)](docker/)

{pen_stack-4.0.0 → pen_stack-4.0.1}/README.md

@@ -14,7 +14,7 @@ and durably write new DNA, **which enzyme** can write it there, and **how** to d
 [![codecov](https://codecov.io/gh/ahmedanees-m/pen-stack/branch/main/graph/badge.svg)](https://codecov.io/gh/ahmedanees-m/pen-stack)
 [![License: MIT](https://img.shields.io/badge/License-MIT-informational.svg)](LICENSE)
 [![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://www.python.org/)
-[![Version](https://img.shields.io/badge/version-4.0.0-blue.svg)](CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-4.0.1-blue.svg)](CHANGELOG.md)
 [![Tests](https://img.shields.io/badge/tests-208%20passing-success.svg)](tests/)
 [![Lint: ruff](https://img.shields.io/badge/lint-ruff-purple.svg)](https://github.com/astral-sh/ruff)
 [![Runtime: Docker](https://img.shields.io/badge/runtime-docker-2496ED.svg)](docker/)

{pen_stack-4.0.0 → pen_stack-4.0.1}/pen_stack/__init__.py

@@ -1,2 +1,2 @@
 """PEN-STACK v3.0 - open infrastructure for genome writing."""
-__version__ = "4.0.0"
+__version__ = "4.0.1"

{pen_stack-4.0.0 → pen_stack-4.0.1}/pen_stack/atlas/writer_verify.py

@@ -21,16 +21,20 @@ from __future__ import annotations
 import math
 from dataclasses import dataclass
 
-# Known ISCro4 enhancers (Perry 2025 DMS) + documented-neutral/worse controls — a FROZEN retrospective panel
-# (relative activity Z-score wrt WT; positive = enhancing). Used only when the full Perry DMS is absent.
+# A FROZEN retrospective panel of REAL values from the Perry 2025 ISCro4 deep mutational scan
+# (science.adz0276 Table S3, sheet "L2FC_Relative_Z-Scores", column Z_Score_wrt_WT) — the three top-ranked
+# enhancers, three near-neutral variants, and the three most-deleterious variants, copied verbatim from the
+# measured table. Used only when the full Perry DMS is absent (offline/CI); never fabricated.
 _FROZEN_DMS_Z = {
-    "N322P": 2.6, "H50K": 2.1, "R278M": 1.7,            # published enhancers
-    "K12A": 0.1, "S40T": -0.2, "V90I": 0.0,             # ~neutral
-    "G15D": -2.4, "P88R": -1.9, "L120E": -1.5,          # deleterious / worse
+    "N322P": 0.754, "H50K": 0.742, "R278M": 0.709,      # top-3 enhancers (measured Z, ranks 1-3)
+    "V21R": -0.000, "S312Q": -0.001, "G286T": -0.001,   # near-neutral (|Z| ~ 0)
+    "R132E": -5.400, "R137E": -5.115, "R195D": -4.984,  # most-deleterious (measured worst by Z)
 }
 KNOWN_ISCRO4_ENHANCERS = ["N322P", "H50K", "R278M"]
-# minimal conserved core residues a plausible ISCro4-family candidate should retain (active-site heuristic)
-_CORE_RESIDUES = {49: "R", 277: "R"}                     # 0-based; illustrative conserved arginines
+_WORSE_CONTROLS = ["R132E", "R137E", "R195D"]            # measured-worst variants (Perry Table S3)
+# the catalytic residues a plausible ISCro4-family candidate must retain (Perry Table S3, sheet
+# "Residue Groups", Catalytic_Residues == "Catalytic"): D11, E60, D102, D105, S241 (1-based) -> 0-based below
+_CORE_RESIDUES = {10: "D", 59: "E", 101: "D", 104: "D", 240: "S"}
 
 
 def _sigmoid(x: float) -> float:
@@ -91,9 +95,8 @@ def blind_recovery(top_k: int = 5) -> dict:
     ranked = sorted(scores, key=scores.get, reverse=True)
     top = ranked[:top_k]
     recovered = {e: (e in top) for e in KNOWN_ISCRO4_ENHANCERS}
-    worse = ["G15D", "P88R", "L120E"]
     enh_min = min(scores[e] for e in KNOWN_ISCRO4_ENHANCERS)
-    worse_max = max(scores[w] for w in worse)
+    worse_max = max(scores[w] for w in _WORSE_CONTROLS)
     return {"available": True, "model": "frozen_retrospective_panel", "n": len(_FROZEN_DMS_Z), "top_k": top_k,
             "top": top, "recovered": recovered, "all_enhancers_recovered": all(recovered.values()),
             "enhancers_outrank_worse": bool(enh_min > worse_max),

{pen_stack-4.0.0 → pen_stack-4.0.1}/pen_stack.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pen-stack
-Version: 4.0.0
+Version: 4.0.1
 Summary: Open infrastructure for genome writing: the Writable Genome atlas, the Writer Atlas, and the Write Planner.
 Author-email: Anees Ahmed Mahaboob Ali <ahmedaneesm@gmail.com>
 License: MIT
@@ -89,7 +89,7 @@ and durably write new DNA, **which enzyme** can write it there, and **how** to d
 [![codecov](https://codecov.io/gh/ahmedanees-m/pen-stack/branch/main/graph/badge.svg)](https://codecov.io/gh/ahmedanees-m/pen-stack)
 [![License: MIT](https://img.shields.io/badge/License-MIT-informational.svg)](LICENSE)
 [![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://www.python.org/)
-[![Version](https://img.shields.io/badge/version-4.0.0-blue.svg)](CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-4.0.1-blue.svg)](CHANGELOG.md)
 [![Tests](https://img.shields.io/badge/tests-208%20passing-success.svg)](tests/)
 [![Lint: ruff](https://img.shields.io/badge/lint-ruff-purple.svg)](https://github.com/astral-sh/ruff)
 [![Runtime: Docker](https://img.shields.io/badge/runtime-docker-2496ED.svg)](docker/)

{pen_stack-4.0.0 → pen_stack-4.0.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pen-stack"
-version = "4.0.0"
+version = "4.0.1"
 description = "Open infrastructure for genome writing: the Writable Genome atlas, the Writer Atlas, and the Write Planner."
 readme = "README.md"
 requires-python = ">=3.11"