Add missing bibtex and links

Author: tmigot

.claude/skills/find-bib/SKILL.md

@@ -0,0 +1,156 @@
+---
+name: find-bib
+description: Find or construct a BibTeX reference for an OptimizationProblems.jl meta file. Given a DOI, problem name, or free-form reference text, searches for the DOI online, fetches BibTeX from doi2bib.org, and formats the result as a Julia raw string ready to paste into src/Meta/<name>.jl.
+argument-hint: <problem-name | DOI | "free-form reference text">
+allowed-tools: [Read, Glob, Grep, WebSearch, WebFetch]
+---
+
+# find-bib
+
+Find or construct a BibTeX reference and format it as a Julia raw string for `src/Meta/<name>.jl`.
+
+## Arguments
+
+The user invoked this skill with: $ARGUMENTS
+
+This can be:
+- A **problem name** from `src/Meta/` (e.g. `zangwil3`, `hs1`) — skill will read the file and extract context
+- A **DOI** (e.g. `10.1145/355934.355936` or `https://doi.org/10.1145/355934.355356`)
+- **Free-form reference text** (title, authors, journal, year — quoted or unquoted)
+- **Empty** — if no argument is given, ask the user to specify a problem name or reference
+
+---
+
+## Instructions
+
+Follow these steps in order.
+
+### Step 1 — Gather source material
+
+If `$ARGUMENTS` looks like a problem name (no spaces, no slashes, exists as `src/Meta/<name>.jl`):
+- Read `src/Meta/$ARGUMENTS.jl`
+- Extract `:url`, `:notes`, `:origin_notes`, and the existing `:reference` field (may be empty)
+- Use this text as the source for Steps 2–4
+
+Otherwise, treat `$ARGUMENTS` directly as a DOI or free-form reference text.
+
+### Step 2 — Extract or find a DOI
+
+1. Regex-scan all gathered text for a DOI pattern: `10\.\d{4,}/\S+`
+   - DOIs appear in `:url`, `:notes`, `:origin_notes`, or in the argument itself
+2. If no DOI is found, run a **WebSearch** to locate one:
+   - Try: `"<title or key terms>" "<first author>" DOI`
+   - Try: `site:doi.org "<title or key terms>"`
+   - Try CrossRef: `site:search.crossref.org "<title or key terms>"`
+3. Extract the DOI string from any search result that contains one.
+
+### Step 3 — Fetch BibTeX
+
+If a DOI was found (say `10.1145/355934.355936`), try these endpoints in order:
+
+1. **CrossRef** (primary): `https://api.crossref.org/works/10.1145/355934.355936/transform/application/x-bibtex`
+2. **doi2bib.org** (fallback): `https://www.doi2bib.org/bib/10.1145/355934.355936`
+
+The response is plain-text BibTeX — use it as-is (clean up whitespace if needed).
+If both fail or return an error, fall through to Step 4.
+
+### Step 4 — Construct BibTeX manually (fallback)
+
+If no DOI was found or doi2bib.org failed, construct the best possible BibTeX from all available information.
+
+Choose the entry type:
+
+| Type | Use when |
+|---|---|
+| `@article` | journal or conference paper |
+| `@book` | book or edited volume |
+| `@techreport` | institutional or technical report |
+| `@misc` | dataset, software, website, or unclear |
+
+**Citation key format:** `Author1Author2YYYY` using last names only (e.g. `MoreGarbowHillstrom1981`, `HockSchittkowski1981`). For a single author: `AuthorYYYY`.
+
+**LaTeX encoding for special characters:** `Mor{\'e}`, `{\'E}`, etc.
+
+**Flag uncertain fields** with a trailing `% UNVERIFIED` comment on that line.
+
+### Step 5 — Present the result
+
+Show three things:
+
+**1. Status line** — one sentence: whether the DOI was found, and from where.
+
+**2. The BibTeX entry** in a code block:
+```bibtex
+@article{AuthorYear,
+  author  = {Last, First and Last2, First2},
+  title   = {Title of the Article},
+  journal = {Journal Name},
+  year    = {YYYY},
+  volume  = {V},
+  number  = {N},
+  pages   = {P1--P2},
+  doi     = {10.xxxx/xxxxx}
+}
+```
+
+**3. The Julia snippet** ready to paste into `src/Meta/<name>.jl`:
+```julia
+:reference => raw"""
+@article{AuthorYear,
+  author  = {Last, First and Last2, First2},
+  title   = {Title of the Article},
+  journal = {Journal Name},
+  year    = {YYYY},
+  volume  = {V},
+  number  = {N},
+  pages   = {P1--P2},
+  doi     = {10.xxxx/xxxxx}
+}
+""",
+```
+
+### Step 6 — Suggest next steps
+
+- List any fields marked `% UNVERIFIED` that the user should check manually.
+- If a DOI was found and the file's `:url` field does not already contain it, suggest adding `https://doi.org/<DOI>` to `:url`.
+- If the problem name was given, name the exact file to edit: `src/Meta/<name>.jl`.
+
+---
+
+## BibTeX type templates (reference)
+
+```bibtex
+@article{AuthorYear,
+  author  = {Last, First},
+  title   = {Title},
+  journal = {Journal},
+  year    = {YYYY},
+  volume  = {V},
+  number  = {N},
+  pages   = {P1--P2},
+  doi     = {10.xxxx/xxxxx}
+}
+
+@book{AuthorYear,
+  author    = {Last, First},
+  title     = {Book Title},
+  publisher = {Publisher},
+  address   = {City},
+  year      = {YYYY}
+}
+
+@techreport{AuthorYear,
+  author      = {Last, First},
+  title       = {Report Title},
+  institution = {Institution},
+  number      = {Report Number},
+  year        = {YYYY}
+}
+
+@misc{AuthorYear,
+  author       = {Last, First},
+  title        = {Title},
+  year         = {YYYY},
+  howpublished = {\url{https://...}}
+}
+```

src/Meta/Dus2_1.jl

@@ -27,7 +27,15 @@ Problem found in
 http://www.dmi.usherb.ca/~dussault/ROP630E17/
 Jean_pierre Dussault
 """,
-  :reference => raw"""""",
+  :reference => raw"""
+@misc{Dussault2017,
+  author       = {Dussault, Jean-Pierre},
+  title        = {Optimization Test Problems},
+  howpublished = {\url{http://www.dmi.usherb.ca/~dussault/ROP630E17/}},
+  year         = {2017},
+  note         = {Universit{\'e} de Sherbrooke}
+}
+""",
   :lib => "",
 )
 get_Dus2_1_nvar(; n::Integer = default_nvar, kwargs...) = 1

src/Meta/Dus2_3.jl

@@ -27,7 +27,15 @@ Problem found in
 http://www.dmi.usherb.ca/~dussault/ROP630E17/
 Jean_pierre Dussault
 """,
-  :reference => raw"""""",
+  :reference => raw"""
+@misc{Dussault2017,
+  author       = {Dussault, Jean-Pierre},
+  title        = {Optimization Test Problems},
+  howpublished = {\url{http://www.dmi.usherb.ca/~dussault/ROP630E17/}},
+  year         = {2017},
+  note         = {Universit{\'e} de Sherbrooke}
+}
+""",
   :lib => "",
 )
 get_Dus2_3_nvar(; n::Integer = default_nvar, kwargs...) = 1

src/Meta/Dus2_9.jl

@@ -27,7 +27,15 @@ Problem found in
 http://www.dmi.usherb.ca/~dussault/ROP630E17/
 Jean_pierre Dussault
 """,
-  :reference => raw"""""",
+  :reference => raw"""
+@misc{Dussault2017,
+  author       = {Dussault, Jean-Pierre},
+  title        = {Optimization Test Problems},
+  howpublished = {\url{http://www.dmi.usherb.ca/~dussault/ROP630E17/}},
+  year         = {2017},
+  note         = {Universit{\'e} de Sherbrooke}
+}
+""",
   :lib => "",
 )
 get_Dus2_9_nvar(; n::Integer = default_nvar, kwargs...) = 1

src/Meta/Duscube.jl

@@ -27,7 +27,15 @@ Problem found in
 http://www.dmi.usherb.ca/~dussault/ROP630E17/
 Jean_pierre Dussault
 """,
-  :reference => raw"""""",
+  :reference => raw"""
+@misc{Dussault2017,
+  author       = {Dussault, Jean-Pierre},
+  title        = {Optimization Test Problems},
+  howpublished = {\url{http://www.dmi.usherb.ca/~dussault/ROP630E17/}},
+  year         = {2017},
+  note         = {Universit{\'e} de Sherbrooke}
+}
+""",
   :lib => "",
 )
 get_Duscube_nvar(; n::Integer = default_nvar, kwargs...) = 1

src/Meta/NZF1.jl

@@ -16,7 +16,7 @@ NZF1_meta = Dict(
   :is_feasible => true,
   :defined_everywhere => missing,
   :origin => :unknown,
-  :url => "",
+  :url => "https://doi.org/10.1080/10556780500137116",
   :notes => raw"""
 "Philippe Toint (private communication)"
 
@@ -27,7 +27,22 @@ A. Montoison, Montreal, 05/2018.
   :origin_notes => raw"""
 
 """,
-  :reference => raw"""""",
+  :reference => raw"""
+@article{Price2006,
+  title = {Exploiting problem structure in pattern search methods for unconstrained optimization},
+  volume = {21},
+  ISSN = {1029-4937},
+  url = {http://dx.doi.org/10.1080/10556780500137116},
+  DOI = {10.1080/10556780500137116},
+  number = {3},
+  journal = {Optimization Methods and Software},
+  publisher = {Informa UK Limited},
+  author = {Price,  C. J. and Toint,  PH. L.},
+  year = {2006},
+  month = June,
+  pages = {479–491}
+}  
+  """,
   :lib => "",
 )
 get_NZF1_nvar(; n::Integer = default_nvar, kwargs...) = 13 * max(2, div(n, 13))

src/Meta/Shpak1.jl

@@ -16,7 +16,7 @@ Shpak1_meta = Dict(
   :is_feasible => true,
   :defined_everywhere => missing,
   :origin => :unknown,
-  :url => "",
+  :url => "http://www.math.md/publications/csjm/issues/v3-n2/7902/",
   :notes => raw"""
 first problem of
  Global optimization in one-dimensional case
@@ -30,7 +30,18 @@ Computer Science Journal of Moldova, vol.3, no.2(8), 1995
   :origin_notes => raw"""
 
 """,
-  :reference => raw"""""",
+  :reference => raw"""
+@article{Shpak1995,
+  author  = {Shpak, Alexander},
+  title   = {Global Optimization in One-Dimensional Case Using Analytically Defined Derivatives of Objective Function},
+  journal = {Computer Science Journal of Moldova},
+  year    = {1995},
+  volume  = {3},
+  number  = {2},
+  pages   = {168--184},
+  url     = {http://www.math.md/publications/csjm/issues/v3-n2/7902/}
+}
+""",
   :lib => "",
 )
 get_Shpak1_nvar(; n::Integer = default_nvar, kwargs...) = 1

src/Meta/Shpak2.jl

@@ -16,7 +16,7 @@ Shpak2_meta = Dict(
   :is_feasible => true,
   :defined_everywhere => missing,
   :origin => :unknown,
-  :url => "",
+  :url => "http://www.math.md/publications/csjm/issues/v3-n2/7902/",
   :notes => raw"""
 Second problem of
  Global optimization in one-dimensional case
@@ -31,7 +31,18 @@ Second problem of
   :origin_notes => raw"""
 
 """,
-  :reference => raw"""""",
+  :reference => raw"""
+@article{Shpak1995,
+  author  = {Shpak, Alexander},
+  title   = {Global Optimization in One-Dimensional Case Using Analytically Defined Derivatives of Objective Function},
+  journal = {Computer Science Journal of Moldova},
+  year    = {1995},
+  volume  = {3},
+  number  = {2},
+  pages   = {168--184},
+  url     = {http://www.math.md/publications/csjm/issues/v3-n2/7902/}
+}
+""",
   :lib => "",
 )
 get_Shpak2_nvar(; n::Integer = default_nvar, kwargs...) = 1

src/Meta/Shpak3.jl

@@ -16,7 +16,7 @@ Shpak3_meta = Dict(
   :is_feasible => true,
   :defined_everywhere => missing,
   :origin => :unknown,
-  :url => "",
+  :url => "http://www.math.md/publications/csjm/issues/v3-n2/7902/",
   :notes => raw"""
 third problem of
 Global optimization in one-dimensional case
@@ -31,7 +31,18 @@ Computer Science Journal of Moldova, vol.3, no.2(8), 1995
   :origin_notes => raw"""
 
 """,
-  :reference => raw"""""",
+  :reference => raw"""
+@article{Shpak1995,
+  author  = {Shpak, Alexander},
+  title   = {Global Optimization in One-Dimensional Case Using Analytically Defined Derivatives of Objective Function},
+  journal = {Computer Science Journal of Moldova},
+  year    = {1995},
+  volume  = {3},
+  number  = {2},
+  pages   = {168--184},
+  url     = {http://www.math.md/publications/csjm/issues/v3-n2/7902/}
+}
+""",
   :lib => "",
 )
 get_Shpak3_nvar(; n::Integer = default_nvar, kwargs...) = 1

src/Meta/Shpak4.jl

@@ -16,7 +16,7 @@ Shpak4_meta = Dict(
   :is_feasible => true,
   :defined_everywhere => missing,
   :origin => :unknown,
-  :url => "",
+  :url => "http://www.math.md/publications/csjm/issues/v3-n2/7902/",
   :notes => raw"""
 4th problem of
  Global optimization in one-dimensional case
@@ -32,7 +32,18 @@ Shpak4_meta = Dict(
   :origin_notes => raw"""
 
 """,
-  :reference => raw"""""",
+  :reference => raw"""
+@article{Shpak1995,
+  author  = {Shpak, Alexander},
+  title   = {Global Optimization in One-Dimensional Case Using Analytically Defined Derivatives of Objective Function},
+  journal = {Computer Science Journal of Moldova},
+  year    = {1995},
+  volume  = {3},
+  number  = {2},
+  pages   = {168--184},
+  url     = {http://www.math.md/publications/csjm/issues/v3-n2/7902/}
+}
+""",
   :lib => "",
 )
 get_Shpak4_nvar(; n::Integer = default_nvar, kwargs...) = 1