Skip to content

Interpretation framing lit review: rag-build + 4 papers + cite map (3/3)#64

Merged
NewGraphEnvironment merged 3 commits into
mainfrom
63-interpretation-framing-lit-review
May 5, 2026
Merged

Interpretation framing lit review: rag-build + 4 papers + cite map (3/3)#64
NewGraphEnvironment merged 3 commits into
mainfrom
63-interpretation-framing-lit-review

Conversation

@NewGraphEnvironment
Copy link
Copy Markdown
Owner

Summary

  • Issue 3 of 3 in the climate-departure 3-split lit reviews (interpretation framing). Snow Snowpack-departure methodology lit review: Zotero + ragnar + cited vignette #53 → v0.1.7, Temperature Lit-review temperature-departure methodology + interpretation backing #58 → v0.2.2, Precip+Drying Lit-review precipitation + drying methodology + interpretation backing (2/3) #61 → v0.2.3, and now Interpretation Framing → v0.2.4. After this lands, the citation backbone for the entire climate-departure narrative is complete; downstream vignette wire-up branch can pick up [@key] markers from all four findings.md files.
  • 4 new peer-reviewed papers added to the NewGraphEnvironment/climate Zotero collection with PDFs attached: Arguez & Vose 2011 (WMO climate-normal definition + alternatives), Livezey 2007 (estimating normals when trends exist), Hawkins & Sutton 2012 (time of emergence), Hansen 2012 (perception of climate change / loaded dice). Plus 6 reuse-relevant existing climate-collection items (Mora 2013, Pauly 1995, Rodrigues 2019, Alleway 2023, IPCC AR6 WGI + SYR) + 4 cross-rag references from snow + temp + precip+drying stores.
  • Local ragnar DuckDB at data/rag/interpretation_framing.duckdb (291 chunks, 4 sources, ~10 s ingest), built by the new scripts/rag_interpretation_framing_build.R. 16-query mining via scripts/rag_interpretation_framing_query.R produced planning/active/interpretation_framing_quotes.md (373 lines), synthesized into findings.md with methodology-quotes-by-topic, cross-cutting methodology, deviations, and an 11-row "cite this for that" menu (BBT-auto-derived keys ready for downstream [@key] insertion).
  • All Lit-review temperature-departure methodology + interpretation backing #58/Lit-review precipitation + drying methodology + interpretation backing (2/3) #61 lessons applied cleanly: no Citation Key: overrides in extra (BBT auto-derives per soul#43); all 4 papers had ≥2 individual creators per CrossRef (no Pepin-style PATCH); macOS auto-restart fired without user prompt and all 4 BBT keys captured first try.

Headline finding: Hansen 2012 uses the 1951–1980 base period — same as cd — providing the strongest direct precedent for cd's baseline window choice across all three lit reviews. Per Arguez & Vose 2011, cd's choice is an "alternative climate normal" (departure on the period-start attribute) — defensible if documented, and Hansen 2012 is the documentation.

Wraps the 3-split. BEC zone-shifts (#59 tracker) is the natural next pickup if reporting needs warrant it.

Relates to NewGraphEnvironment/sred-2025-2026#23.

Fixes #63.

Test plan

  • devtools::test() clean on 63-interpretation-framing-lit-review (verified: 166 PASS, 0 FAIL)
  • lintr::lint() on new scripts → 0 lints (verified)
  • Rscript scripts/rag_interpretation_framing_build.R reproduces the store (4 sources, ~291 chunks) given the local PDF cache populated from Zotero
  • Rscript scripts/rag_interpretation_framing_query.R regenerates planning/active/interpretation_framing_quotes.md
  • All 4 BBT citation keys in findings.md Phase 2 table resolve to items in NewGraphEnvironment/climate (verified via local sqlite)
  • PWF checkboxes in planning/active/task_plan.md match landed work
  • No vignette edits on this branch (lit review is decoupled from the downstream vignette wire-up)

🤖 Generated with Claude Code

…art)

Phase 2 — POSTed 4 candidates to NewGraphEnvironment/climate
(8MH9LCC9) via Web API with PDFs attached via S3. CrossRef-driven
metadata; tags interpretation-framing-methodology + cd-issue-63.
2 fresh PDF uploads (Arguez & Vose, Hawkins & Sutton), 2 md5-
deduped (Hansen 2012, Livezey 2007). Auto-restart fired and all 4
BBT keys captured cleanly:
  arguez_vose2011DefinitionStandard
  livezey_etal2007EstimationExtrapolation
  hawkins_sutton2012Timeemergence
  hansen_etal2012Perceptionclimate

Phase 3 — adds scripts/rag_interpretation_framing_build.R cloning
the precip+drying build script with a 4-paper pdf_specs map. Runs
in ~10 s on Ollama nomic-embed-text:
  Found 4 / 4 PDFs
  Chunks: 291
  Sources: 4

Phase 4 — adds scripts/rag_interpretation_framing_query.R running
16 queries across 6 topics (narrower than #58/#61's 24 queries
since framing topic surface is smaller). Captures top-5 chunks each
to planning/active/interpretation_framing_quotes.md (373 lines).
Topics: baseline window methodology, normals when trends exist,
time of emergence, cumulative-impact / loaded dice, shifting
baseline climate, departure from recent variability.

Phase 5 — synthesis in findings.md: per-topic methodology quotes
selected from the rag retrieval, cross-cutting methodology section
(Hansen 2012's choice of 1951-1980 base period validates cd's
choice for cumulative-impact reporting — strongest direct precedent
across all three lit reviews), 3 documented deviations (1951-1980
vs WMO 1961-1990 baseline, no AC correction, ToE not quantified
per-AOI), and an 11-row cite-this-for-that menu mapping vignette
framing claim types to BBT-auto-derived citation keys.

3-split scoreboard added to findings.md — pointer to the four
findings.md files (#53/#54 snow, #58/#60 temp, #61/#62 precip+
drying, this) for the downstream vignette wire-up branch.

Refs #63.
@NewGraphEnvironment NewGraphEnvironment merged commit 7f844a4 into main May 5, 2026
1 check passed
@NewGraphEnvironment NewGraphEnvironment deleted the 63-interpretation-framing-lit-review branch May 5, 2026 22:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Lit-review interpretation framing methodology + reporting backing (3/3)

1 participant