diff --git a/index.md b/index.md index d7aa83a..bb95eef 100644 --- a/index.md +++ b/index.md @@ -28,12 +28,14 @@ the schema in [`wiki/CLAUDE.md`](wiki/CLAUDE.md). ## Reading queue -- [`reading-queue.md`](reading-queue.md) — paper queue (moved from - `admin_jammy/papers.md` on 2026-05-22). Section headers (Strong - Lensing, SMBHs, Galaxy Formation, Dark Matter, Stats, SETI, Cancer) - match the sub-wiki domains. When a queued paper is read, stub it in - the appropriate sub-wiki `sources/*.md` and add its canonical entry - to `bibliography/` — the PDF itself stays off-repo, never committed. +- [`reading-queue.md`](reading-queue.md) — the paper queue AND the reading + history: `## ` section headers group papers by domain, one title per line, + and a read paper is never deleted — its line gains a `DONE — ` + prefix. When a queued paper is read, add its canonical entry to + `bibliography/`, stub it in the matching sub-wiki `sources/*.md`, mark the + line DONE, and run `make validate` — the PDF itself stays off-repo, never + committed. Per-section waiting/read counts live on the + [knowledge board](https://pyautolabs.github.io/PyAutoMemory/). ## Schema diff --git a/reading-queue.md b/reading-queue.md index a824e7c..2e273d2 100644 --- a/reading-queue.md +++ b/reading-queue.md @@ -1,349 +1,346 @@ -# Reading queue - -This file used to live at `admin_jammy/papers.md`. It moved here on -2026-05-22 when this repo (then named PyAutoPaper, now PyAutoMemory) -became the unified knowledge repo. Section headers below match topic folders -in this repo (Strong Lensing, SMBHs, Galaxy Formation, Dark Matter, -Stats, …) — when a paper here is acquired as a PDF, it should be -filed under the matching folder and stubbed in the relevant -the matching `wiki//sources/*.md` page. - ---- - -Imagining the Alien: Human Projections and Cognitive Limitations - -Strong Lensing: - -The X-Ray Continuum Emission Region in the Lensed Quasar SDSS J133907.23+131038.6 is Much Smaller than the Accretion Disk -Confirmation of the Finch Flatter-Fainter Relation for the Quadruple Images of Lensed Point Sources -The Koi Pond: A Strongly Lensed Protocluster Core hosting a Diverse Population of DSFGs -Addressing position anomalies in the Strong Gravitational Lensing System HS~0810+2554 through Dark Matter Subhalos -The Fornax Cluster VLT Spectroscopic Survey - V. Mass modelling of the BCG NGC 1399 out to 150 kpc -Galaxy-LRD Strong Lenses: A Missing Population? -Cosmic CORALS: Timing the Universe with high-z star clusters -Polar coordinate transformations for machine learning based dark matter subhalo detection in strong gravitational lenses -XShooter DESI Lens Program: Sample characterization -Strong-lensing effects in high-redshift massive black-hole binary population inference - -LEGGOS III: Mapping Star Formation and Dust in Gravitationally Lensed Galaxies with SUMAC, a UMAP and Clustering Framework -LEGGOS II: A Strong Lens Model and Source-Plane Projection of the Clumpy Star-Forming Galaxy SGASJ111020.0+645950.8 at z=2.48 - -Dynamical models of cluster members to probe the total mass properties of cluster subhalos. I. A comparison with parametric strong lensing models -COOL-LAMPS IX: A Rare Duo of Quasars Each Lensed by a Single Massive Galaxy Cluster -Beyond collective fluctuations: probing micro-image swarms in lensed quasars with intensity interferometry -Constraining Axion-like Particles through Multi-epoch Monitoring of Strong Gravitational Lenses -Mapping dark matter in the Bullet Cluster using JWST imaging and spectroscopy -Detecting Strongly-Lensed Supernovae in Wide-field Space Telescope Imaging via Deep Learning -Microlensing Black Hole Shadows-II: Constraining Primordial Black Hole Dark Matter using the photon rings of M87 and Sgr A* -SLICE -- Combining Strong Lensing and X-ray in AC\,114. Insights into the Merger Scenario -Tracing Structure: Shape and Centroid Deviations in 39 Strong Lensing Clusters as a Test of Cluster Formation Predictions -A Super-Eddington, Lensing-Magnified Quasar at observed with JWST -Caustic crossings in giant arcs with extended dark matter objects -Kinematic Mapping of Giant Arcs: A New Method to Locate Lensing Critical Curves -VENUS: A Strongly Lensed Clumpy Galaxy at behind the Galaxy Cluster MACS J0257.1-2325 -Investigating the Dark Energy Constraint from Strongly Lensed AGN at LSST-Scale -The Chandra Strong Lens Sample: Measuring the Dynamical States and Relaxation Fraction of a Sample of 28 Strong Lensing Selected Galaxy Clusters -The Impact of Orbital Anisotropy Assumptions in Lensing-Dynamics Modeling -SourceREACH (Source REconstruction of Arcs behind Cluster Halos): A New Source Reconstruction Algorithm Optimized for Giant Arcs and Galaxy Cluster Lenses -JWST Lensed Quasar Dark Matter Survey III: Dark Matter Sensitive Flux Ratios and Warm Dark Matter Constraint from the Full Sample. -A Strong Gravitational Lensing Model of PSZ2 G118.46+39.32 -CSST Strong Lensing Preparation: Cosmological Constraints Forecast from CSST Galaxy-Scale Strong Lensing -The complicated nature of the X-ray emission from the field of the strongly lensed hyperluminous infrared galaxy PJ1053+60 at z=3.54 -A cosmographic analysis using DESI-DR2 and strong lensing: I. Time-Delay measurements -A cosmographic analysis using DESI-DR2 and strong lensing: II. Distance Ratio measurements -Detecting dark matter substructure with lensed quasars in optical bands -CURLING -- II. Improvement on the Inference from Pixelized Cluster Strong Lens Modeling -iPTF16geu through the lens of thermonuclear explosion models -Forecasting the Observable Rates of Gravitationally Lensed Supernovae for the PASSAGES Dusty Starbursts -The Case for Space: Estimating Precise Time Delays from Ground- and Space-Based Observations of Lensed Supernovae with Glimpse -JWST Discovery of Strong Lensing from a Galaxy Cluster at Cosmic Noon: Giant Arcs and a Highly Concentrated Core of XLSSC 122 -HOLISMOKES XVIII: Detecting strongly lensed SNe Ia from time series of multi-band LSST-like imaging data -The collar of early-type galaxies -- probing evolution by focusing on the inner stellar density profile -High-Dimensional Bayesian Model Comparison in Cosmology with GPU-accelerated Nested Sampling and Neural Emulators -THE STELLAR AND DARK MATTER DISTRIBUTIONS IN ELLIPTICAL GALAXIES MEASURED BY STACKED WEAK GRAVITATIONAL LENSING - - -SMBHs: - -Overmassive and Undermassive Massive Black Holes: The Role of Environment and Gravitational-Wave Recoils -Core Scouring Dynamics and Gravitational Wave Consequences: Constraints on Supermassive Black Hole Binary Hardening -Stellar cores live long and prosper in cuspy dark matter halos -Recoiling Black Hole Candidates from Spatially Offset Broad Emission Lines in MaNGA -Accretion, Jets, and Recoil in Merging Supermassive Binary Black Holes -Off-center black hole seed formation? Implications for high and low redshift massive black holes -Understanding the Evolution of Black Hole Accretion and Dust out to z=4 with a Deep Imaging Extragalactic Survey with PRIMA -Identifying massive black hole binaries via light curve variability in optical time-domain surveys -A Large Systematic Search for Close Supermassive Binary and Rapidly Recoiling Black Holes -- IV. Ultraviolet spectroscopy -Elliptical (E) and ellicular (ES) galaxies in the M_bh-M_*,sph diagram, and a merger-driven explanation for the origin of ES galaxies, anti-truncated stellar discs in lenticular galaxies, and the Sersicification of E galaxy light profiles -HST Observations within the Sphere of Influence of the Powerful Supermassive Black Hole in PKS0745-191 -Primordial Black Hole stellar microlensing constraints: understanding their dependence on the density and velocity distributions -Probing the Merger Rates of Supermassive Black Holes and Galaxies with Gravitational Waves -Two radio cores in GPS J1543-0757: a new dual supermassive black hole system? -Can quasars, triggered by mergers, account for NANOGrav's stochastic gravitational wave background? -Is your stochastic signal really detectable? -Beyond the Goldilocks Zone: Identifying Critical Features in Massive Black Hole Formation -Massive black holes or stars first: the key is the residual cosmic electron fraction -Wandering and escaping: recoiling massive black holes in cosmological simulations -Large-scale dual AGN in large-scale cosmological hydrodynamical simulations -Super-Size Me: The Big Multi-AGN Catalog (The Big MAC), Data Release 1: The Source Catalog -A Recent Supermassive Black Hole Binary in the Galactic Center Unveiled by the Hypervelocity Stars -Primordial black holes as supermassive black holes seeds -Connecting Inflation to the NANOGrav 15-year Data Set via Massive Gravity -Active Galactic Nuclei and Host Galaxies in COSMOS-Web. II. First Look at the Kpc-scale Dual and Offset AGN Population -Signatures of Massive Black Hole Merger Host Galaxies from Cosmological Simulations II: Unique Stellar Kinematics in Integral Field Unit Spectroscopy -The formation of supermassive black holes from Population III.1 seeds. III. Galaxy evolution and black hole growth from semi-analytic modelling -PKS 2131-021 -- Discovery of Strong Coherent Sinusoidal Variations from Radio to Optical Frequencies: Compelling Evidence for a Blazar Supermassive Black Hole Binary -Dynamics around supermassive black holes: Extreme mass-ratio inspirals as gravitational-wave sources -Supermassive black hole mass measurement in the spiral galaxy NGC 4736 Using JWST/NIRSpec stellar kinematics - -The Host Galaxies of PTA Sources: Converting Supermassive BH Binary Parameters into EM Observables -First Light And Reionization Epoch Simulations (FLARES) -- XIX: Supermassive black hole mergers in the early Universe and their environmental dependence -Accretion onto supermassive black hole binaries -Astrometric Jitter as a Detection Diagnostic for Recoiling and Slingshot Supermassive Black Hole Candidates -Detection and Prediction of Future Massive Black Hole Mergers with Machine Learning and Truncated Waveforms -How do Primordial Black Holes change the Halo Mass Function and Structure? -Tip of the iceberg: overmassive black holes at 4 10^7MSun SMBHB's. - -Premature supermassive black hole mergers in cosmological simulations of structure formation - - Brilliant example of how numerical effects in simulations can lead to delays on SMBH mergers which impact SWGB PTA results. - -KetJU: - -https://arxiv.org/pdf/2211.11788.pdf - -Big Galaxies and Big Black Holes: The Massive Ends of the Local Stellar and Black Hole Mass Functions and the Implications for Nanohertz Gravitational Waves - - Examples of how to make and plot SMBH mass functions and relating them to GWB. - - -Varstrometry for Off-nucleus and Dual sub-Kpc AGN (VODKA): A Mix of Singles, Lenses, and True Duals at Cosmic Noon - - Good overview of dual AGN and looking for them - -Identifying supermassive black hole recoil in elliptical galaxies - - All the stuff SMBH binary recoils do to the Sersic core and galaxy around them. - - -__SMBH Scouring__ - -The supermassive black hole merger driven evolution of high-redshift red nuggets into present-day cored early-type galaxies - - Great KetJU simulation study of how scouring SMBHs can create cored galaxies and impact the galaxies around them. - -__Analysis__ - -Characterization of JWST NIRCam PSFs and Implications for AGN+Host Image Decomposition: - - Detailed discussion of the JWST PSF and how to model it, reference for PyAutoGalaxy. - - -__Dark Matter__ - -THESAN-HR: Galaxies in the Epoch of Reionization in warm dark matter, fuzzy dark matter and interacting dark matter: - - Good description of how alternative DM models (Warm, Fuzzy, Interacting) impact high-z galaxy formation / reionization. - - -The shape of dark matter halos: a new fundamental cosmological invariance - - Could be a Cosmology motivation for COMSOSO SL+WL study - - -__Galaxies__ - -Stellar feedback-regulated black hole growth: driving factors from nuclear to halo scales - - Description of how a mass threshold surpresses stellar feedback to make BH's efficient and quency galaxie,s similar to Bower 2017 - - - -__Software__ - -Setting SAIL: Leveraging Scientist-AI-Loops for Rigorous Visualization Tools - -https://github.com/patrick-kidger/optimistix?tab=readme-ov-file: - - LOADS of JAX githubs including lineaer solvers, BlackJAX - -Eryn: A multi-purpose sampler for Bayesian inference: https://arxiv.org/list/astro-ph/new - - Another cool sampler for autofit. - - - - - +# Reading queue + +Papers waiting to be read and filed. Format: + +- `##
` headers group papers by domain (matching `wiki//` + where one exists). +- One paper per line — a bare title, optionally followed by ` — `. +- A read/consumed paper is never deleted: prefix its line with + `DONE — ` and leave it in place (the reading history). +- Filing a read paper: add its canonical entry to `bibliography/`, stub it in + the matching `wiki//sources/*.md` page per `wiki/CLAUDE.md`, then + mark the line DONE and run `make validate`. + +(Moved from `admin_jammy/papers.md` on 2026-05-22, when this repo — then +PyAutoPaper, now PyAutoMemory — became the unified knowledge repo.) + +--- + +## Strong Lensing +The X-Ray Continuum Emission Region in the Lensed Quasar SDSS J133907.23+131038.6 is Much Smaller than the Accretion Disk +Confirmation of the Finch Flatter-Fainter Relation for the Quadruple Images of Lensed Point Sources +The Koi Pond: A Strongly Lensed Protocluster Core hosting a Diverse Population of DSFGs +Addressing position anomalies in the Strong Gravitational Lensing System HS~0810+2554 through Dark Matter Subhalos +The Fornax Cluster VLT Spectroscopic Survey - V. Mass modelling of the BCG NGC 1399 out to 150 kpc +Galaxy-LRD Strong Lenses: A Missing Population? +Cosmic CORALS: Timing the Universe with high-z star clusters +Polar coordinate transformations for machine learning based dark matter subhalo detection in strong gravitational lenses +XShooter DESI Lens Program: Sample characterization +Strong-lensing effects in high-redshift massive black-hole binary population inference + +LEGGOS III: Mapping Star Formation and Dust in Gravitationally Lensed Galaxies with SUMAC, a UMAP and Clustering Framework +LEGGOS II: A Strong Lens Model and Source-Plane Projection of the Clumpy Star-Forming Galaxy SGASJ111020.0+645950.8 at z=2.48 + +Dynamical models of cluster members to probe the total mass properties of cluster subhalos. I. A comparison with parametric strong lensing models +COOL-LAMPS IX: A Rare Duo of Quasars Each Lensed by a Single Massive Galaxy Cluster +Beyond collective fluctuations: probing micro-image swarms in lensed quasars with intensity interferometry +Constraining Axion-like Particles through Multi-epoch Monitoring of Strong Gravitational Lenses +Mapping dark matter in the Bullet Cluster using JWST imaging and spectroscopy +Detecting Strongly-Lensed Supernovae in Wide-field Space Telescope Imaging via Deep Learning +Microlensing Black Hole Shadows-II: Constraining Primordial Black Hole Dark Matter using the photon rings of M87 and Sgr A* +SLICE -- Combining Strong Lensing and X-ray in AC\,114. Insights into the Merger Scenario +Tracing Structure: Shape and Centroid Deviations in 39 Strong Lensing Clusters as a Test of Cluster Formation Predictions +A Super-Eddington, Lensing-Magnified Quasar at observed with JWST +Caustic crossings in giant arcs with extended dark matter objects +Kinematic Mapping of Giant Arcs: A New Method to Locate Lensing Critical Curves +VENUS: A Strongly Lensed Clumpy Galaxy at behind the Galaxy Cluster MACS J0257.1-2325 +Investigating the Dark Energy Constraint from Strongly Lensed AGN at LSST-Scale +The Chandra Strong Lens Sample: Measuring the Dynamical States and Relaxation Fraction of a Sample of 28 Strong Lensing Selected Galaxy Clusters +The Impact of Orbital Anisotropy Assumptions in Lensing-Dynamics Modeling +SourceREACH (Source REconstruction of Arcs behind Cluster Halos): A New Source Reconstruction Algorithm Optimized for Giant Arcs and Galaxy Cluster Lenses +JWST Lensed Quasar Dark Matter Survey III: Dark Matter Sensitive Flux Ratios and Warm Dark Matter Constraint from the Full Sample. +A Strong Gravitational Lensing Model of PSZ2 G118.46+39.32 +CSST Strong Lensing Preparation: Cosmological Constraints Forecast from CSST Galaxy-Scale Strong Lensing +The complicated nature of the X-ray emission from the field of the strongly lensed hyperluminous infrared galaxy PJ1053+60 at z=3.54 +A cosmographic analysis using DESI-DR2 and strong lensing: I. Time-Delay measurements +A cosmographic analysis using DESI-DR2 and strong lensing: II. Distance Ratio measurements +Detecting dark matter substructure with lensed quasars in optical bands +CURLING -- II. Improvement on the Inference from Pixelized Cluster Strong Lens Modeling +iPTF16geu through the lens of thermonuclear explosion models +Forecasting the Observable Rates of Gravitationally Lensed Supernovae for the PASSAGES Dusty Starbursts +The Case for Space: Estimating Precise Time Delays from Ground- and Space-Based Observations of Lensed Supernovae with Glimpse +JWST Discovery of Strong Lensing from a Galaxy Cluster at Cosmic Noon: Giant Arcs and a Highly Concentrated Core of XLSSC 122 +HOLISMOKES XVIII: Detecting strongly lensed SNe Ia from time series of multi-band LSST-like imaging data +The collar of early-type galaxies -- probing evolution by focusing on the inner stellar density profile +High-Dimensional Bayesian Model Comparison in Cosmology with GPU-accelerated Nested Sampling and Neural Emulators +THE STELLAR AND DARK MATTER DISTRIBUTIONS IN ELLIPTICAL GALAXIES MEASURED BY STACKED WEAK GRAVITATIONAL LENSING + + +## SMBHs +Overmassive and Undermassive Massive Black Holes: The Role of Environment and Gravitational-Wave Recoils +Core Scouring Dynamics and Gravitational Wave Consequences: Constraints on Supermassive Black Hole Binary Hardening +Stellar cores live long and prosper in cuspy dark matter halos +Recoiling Black Hole Candidates from Spatially Offset Broad Emission Lines in MaNGA +Accretion, Jets, and Recoil in Merging Supermassive Binary Black Holes +Off-center black hole seed formation? Implications for high and low redshift massive black holes +Understanding the Evolution of Black Hole Accretion and Dust out to z=4 with a Deep Imaging Extragalactic Survey with PRIMA +Identifying massive black hole binaries via light curve variability in optical time-domain surveys +A Large Systematic Search for Close Supermassive Binary and Rapidly Recoiling Black Holes -- IV. Ultraviolet spectroscopy +Elliptical (E) and ellicular (ES) galaxies in the M_bh-M_*,sph diagram, and a merger-driven explanation for the origin of ES galaxies, anti-truncated stellar discs in lenticular galaxies, and the Sersicification of E galaxy light profiles +HST Observations within the Sphere of Influence of the Powerful Supermassive Black Hole in PKS0745-191 +Primordial Black Hole stellar microlensing constraints: understanding their dependence on the density and velocity distributions +Probing the Merger Rates of Supermassive Black Holes and Galaxies with Gravitational Waves +Two radio cores in GPS J1543-0757: a new dual supermassive black hole system? +Can quasars, triggered by mergers, account for NANOGrav's stochastic gravitational wave background? +Is your stochastic signal really detectable? +Beyond the Goldilocks Zone: Identifying Critical Features in Massive Black Hole Formation +Massive black holes or stars first: the key is the residual cosmic electron fraction +Wandering and escaping: recoiling massive black holes in cosmological simulations +Large-scale dual AGN in large-scale cosmological hydrodynamical simulations +Super-Size Me: The Big Multi-AGN Catalog (The Big MAC), Data Release 1: The Source Catalog +A Recent Supermassive Black Hole Binary in the Galactic Center Unveiled by the Hypervelocity Stars +Primordial black holes as supermassive black holes seeds +Connecting Inflation to the NANOGrav 15-year Data Set via Massive Gravity +Active Galactic Nuclei and Host Galaxies in COSMOS-Web. II. First Look at the Kpc-scale Dual and Offset AGN Population +Signatures of Massive Black Hole Merger Host Galaxies from Cosmological Simulations II: Unique Stellar Kinematics in Integral Field Unit Spectroscopy +The formation of supermassive black holes from Population III.1 seeds. III. Galaxy evolution and black hole growth from semi-analytic modelling +PKS 2131-021 -- Discovery of Strong Coherent Sinusoidal Variations from Radio to Optical Frequencies: Compelling Evidence for a Blazar Supermassive Black Hole Binary +Dynamics around supermassive black holes: Extreme mass-ratio inspirals as gravitational-wave sources +Supermassive black hole mass measurement in the spiral galaxy NGC 4736 Using JWST/NIRSpec stellar kinematics + +The Host Galaxies of PTA Sources: Converting Supermassive BH Binary Parameters into EM Observables +First Light And Reionization Epoch Simulations (FLARES) -- XIX: Supermassive black hole mergers in the early Universe and their environmental dependence +Accretion onto supermassive black hole binaries +Astrometric Jitter as a Detection Diagnostic for Recoiling and Slingshot Supermassive Black Hole Candidates +Detection and Prediction of Future Massive Black Hole Mergers with Machine Learning and Truncated Waveforms +How do Primordial Black Holes change the Halo Mass Function and Structure? +Tip of the iceberg: overmassive black holes at 4 10^7MSun SMBHB's. + +Premature supermassive black hole mergers in cosmological simulations of structure formation + + Brilliant example of how numerical effects in simulations can lead to delays on SMBH mergers which impact SWGB PTA results. + +## KetJU +https://arxiv.org/pdf/2211.11788.pdf + +Big Galaxies and Big Black Holes: The Massive Ends of the Local Stellar and Black Hole Mass Functions and the Implications for Nanohertz Gravitational Waves + + Examples of how to make and plot SMBH mass functions and relating them to GWB. + + +Varstrometry for Off-nucleus and Dual sub-Kpc AGN (VODKA): A Mix of Singles, Lenses, and True Duals at Cosmic Noon + + Good overview of dual AGN and looking for them + +Identifying supermassive black hole recoil in elliptical galaxies + + All the stuff SMBH binary recoils do to the Sersic core and galaxy around them. + + +__SMBH Scouring__ + +The supermassive black hole merger driven evolution of high-redshift red nuggets into present-day cored early-type galaxies + + Great KetJU simulation study of how scouring SMBHs can create cored galaxies and impact the galaxies around them. + +__Analysis__ + +Characterization of JWST NIRCam PSFs and Implications for AGN+Host Image Decomposition: + + Detailed discussion of the JWST PSF and how to model it, reference for PyAutoGalaxy. + + +__Dark Matter__ + +THESAN-HR: Galaxies in the Epoch of Reionization in warm dark matter, fuzzy dark matter and interacting dark matter: + + Good description of how alternative DM models (Warm, Fuzzy, Interacting) impact high-z galaxy formation / reionization. + + +The shape of dark matter halos: a new fundamental cosmological invariance + + Could be a Cosmology motivation for COMSOSO SL+WL study + + +__Galaxies__ + +Stellar feedback-regulated black hole growth: driving factors from nuclear to halo scales + + Description of how a mass threshold surpresses stellar feedback to make BH's efficient and quency galaxie,s similar to Bower 2017 + + + +__Software__ + +Setting SAIL: Leveraging Scientist-AI-Loops for Rigorous Visualization Tools + +https://github.com/patrick-kidger/optimistix?tab=readme-ov-file: + + LOADS of JAX githubs including lineaer solvers, BlackJAX + +Eryn: A multi-purpose sampler for Bayesian inference: https://arxiv.org/list/astro-ph/new + + Another cool sampler for autofit. + + + + + diff --git a/scripts/board.py b/scripts/board.py index ad73090..924554d 100644 --- a/scripts/board.py +++ b/scripts/board.py @@ -43,7 +43,11 @@ WIKILINK_RE = re.compile(r"\[\[([^\]]+)\]\]") BIB_ENTRY_RE = re.compile(r"^@\w+\{", re.MULTILINE) RESOLVED_KEY_RE = re.compile(r"\*\*Canonical BibTeX key:\*\* `([^`]+)`") -QUEUE_SECTION_RE = re.compile(r"^([A-Za-z][A-Za-z /&'\-]+):\s*$") +# Queue sections are real `## ` headers (the 2026-08 restructure, #35); a +# consumed paper stays in place as a `DONE — ` line, so the +# queue is also the reading history. +QUEUE_SECTION_RE = re.compile(r"^##\s+(.+?)\s*$") +QUEUE_DONE_RE = re.compile(r"^DONE\b") def _owner_repo() -> tuple[str, str]: @@ -109,17 +113,22 @@ def collect(root: Path | None = None) -> dict: queue = root / "reading-queue.md" if queue.exists(): - section, count = None, 0 + section, count, done = None, 0, 0 + def _flush(): + if section is not None: + snapshot["queue"].append({"section": section, "count": count, + "done": done}) for line in queue.read_text(errors="replace").splitlines(): - m = QUEUE_SECTION_RE.match(line.strip()) - if m: - if section is not None: - snapshot["queue"].append({"section": section, "count": count}) - section, count = m.group(1), 0 + m = QUEUE_SECTION_RE.match(line) + if m and not m.group(1).startswith("#"): + _flush() + section, count, done = m.group(1), 0, 0 elif section is not None and line.strip(): - count += 1 - if section is not None: - snapshot["queue"].append({"section": section, "count": count}) + if QUEUE_DONE_RE.match(line.strip()): + done += 1 + else: + count += 1 + _flush() slugs = [s.split("|")[0].strip() for s in all_slugs] uniq = set(slugs) @@ -163,11 +172,12 @@ def _repo_url(snapshot: dict) -> str: def _read_prompt(snapshot: dict, section: str) -> str: repo = snapshot.get("repo") or "the memory repo" - return (f"Work through the next paper in the '{section}' section of " + return (f"Work through the next paper in the '## {section}' section of " f"{repo}/reading-queue.md: verify it against an authoritative " f"record, add its canonical entry to the bibliography/ BibTeX " f"file, stub it in the matching wiki/<domain>/sources/ page per " - f"wiki/CLAUDE.md, remove it from the queue, and run make validate.") + f"wiki/CLAUDE.md, mark its queue line 'DONE <date> — <title>', " + f"and run make validate.") def _todo_prompt(snapshot: dict, wiki: str) -> str: @@ -205,7 +215,8 @@ def _render_md(snapshot: dict) -> str: f"{w.get('todo', 0)} |") lines += ["", "## Reading queue", ""] for q in snapshot.get("queue") or []: - lines.append(f"- {q['section']}: {q['count']}") + done = f", {q['done']} read" if q.get("done") else "" + lines.append(f"- {q['section']}: {q['count']} waiting{done}") if not snapshot.get("queue"): lines.append("- _(queue empty or unavailable)_") url = pages_url(snapshot) @@ -250,9 +261,11 @@ def _render_html(snapshot: dict) -> str: queue_rows = [] for q in snapshot.get("queue") or []: + done = (f" <span class='meta'>· {q['done']} read</span>" + if q.get("done") else "") queue_rows.append( f"<tr><td class='name'>{_html.escape(q['section'])}</td>" - f"<td>{q['count']} waiting " + f"<td>{q['count']} waiting{done} " f"{_copy_btn(_read_prompt(snapshot, q['section']), 'copy: file the next paper')}" f"</td></tr>") if not queue_rows: diff --git a/tests/test_board.py b/tests/test_board.py index 7801920..1071e9c 100644 --- a/tests/test_board.py +++ b/tests/test_board.py @@ -39,7 +39,8 @@ def _tree(tmp_path: Path) -> Path: "@book{Other2021,\n title={U}\n}\n") (tmp_path / "reading-queue.md").write_text( "# Reading queue\n\nintro prose\n\n---\n\n" - "Demo Papers:\n\nTitle One\nTitle Two\n\nOther Things:\n\nTitle Three\n") + "## Demo Papers\n\nTitle One\nTitle Two\n" + "DONE 2026-06-01 — Old Title\n\n## Other Things\n\nTitle Three\n") return tmp_path @@ -51,8 +52,8 @@ def test_counts_from_a_synthetic_tree(tmp_path): assert w["statuses"] == {"drafted": 1, "stub": 1} assert w["sections"] == 2 and w["todo"] == 1 and w["resolved_keys"] == 1 assert snap["bib_entries"] == 2 - assert snap["queue"] == [{"section": "Demo Papers", "count": 2}, - {"section": "Other Things", "count": 1}] + assert snap["queue"] == [{"section": "Demo Papers", "count": 2, "done": 1}, + {"section": "Other Things", "count": 1, "done": 0}] # alpha exists; beta/gamma are wanted assert snap["links"]["wanted"] == 2