docs: JOSS paper for PyAutoLens-Assistant#71
Merged
Conversation
Add paper/ holding the JOSS manuscript, hosted with the software it describes and mirroring the PyAutoLens-JAX sibling in PyAutoLens/paper_jax/. Consolidates the author's drafted Summary, Statement of need, software design and benchmark sections into a single manuscript, adds the JOSS front-matter, and stubs the State of the field and Research impact sections that require author judgement. Bibliography entries are copied verbatim from the assistant literature bibliography so the paper and the wiki cannot drift apart. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds
paper/— the JOSS manuscript for PyAutoLens-Assistant: Using Natural Language and AI to Analyse Gravitational Lenses — hosted with the software it describes, mirroring the PyAutoLens-JAX sibling inPyAutoLens/paper_jax/.The drafted prose previously lived only in the PyAutoMind prompt file. This consolidates it into a real manuscript:
paper/paper.md— JOSS front-matter + Summary, Statement of need, Software design, Benchmark examples, AI usage disclosure.State of the fieldandResearch impact statementare left as commented stubs; both require author judgement and neither can be evidenced by the repo today.paper/paper.bib— 6 entries, copied verbatim fromwiki/literature/bibliography/autolens_literature.bibso the paper and the literature wiki cannot drift apart.paper/README.md— drafting checklist + Inara build command.paper/.gitignore— excludes the localpaper.pdfbuild output.Decisions
hard_group_multi.md) is intentionally not described. This resolves the drafting note in the original prompt (author chose reframing over adding a fourth paragraph) and is recorded in the README so the two stay consistent.benchmarks/RESULTS.mdcurrently records zero runs for all four benchmarks. The paper does not claim results the repository cannot evidence. Flagged on the README checklist.SLACS0946+1006→SDSSJ0946+1006to match the cited papers (Vegetti2010,Minor2021) and the literature wiki.Scripts Changed
None — documentation only. This PR adds four files under
paper/and touches no scripts, notebooks, configs, or library source.Test Plan
make validate-literature-citations— passes (Citation metadata is valid.)python autoassistant/audit_skill_apis.py— passes (58 files, 120 symbols, 0 missing/broken)paper.mdresolves againstpaper.bib(6 cited, 6 defined, 0 missing, 0 unused)paper/README.md).Notes
No
pending-releaselabel: that label does not exist on this repo, is not covered byensure_workspace_labels.sh, and recent merged PRs (#70, #68, #66) carry no labels. It guards the library-first merge gate, which does not apply to a docs-only change with no upstream library PR.Heart at ship time: YELLOW (score 55, no RED), acknowledged by the author. Reasons are pre-existing and unrelated to this docs-only change:
workspace validation not passing (3 failed, 2026-07-09T09-48-30Z),58 stale parked script(s).Closes #69
Generated by the PyAutoLabs agent workflow.