uscogdata

57 Commits 34 Branches 1 Tag

3 Commits

Include renames

Author	SHA1	Message	Date
jared	919548685b	polish(per-year-pop): expand popyear in cog_explain + propagate pop_range R-CMD-check / check (push) Failing after 1m30s Details Final-review followups: 1. cog_explain rendered the popyear range as raw 2-digit values ("popyear range: 19-20"), which a user could read as the years 19-20. Added .expand_popyear() helper to format as 4-digit calendar years (2019-2020). Pivot at 70 to handle pre-2000 vintages if the corpus ever extends backward. 2. cog_peer_compare provenance was missing pop_range and is_ratio, omitted from the spec-required reproducibility metadata. cog_find_peers now stamps both as tibble attributes; cog_peer_compare reads them through to provenance$pop_range and provenance$is_ratio. Test coverage extended: explain test asserts the 4-digit format and rejects the old 2-digit form; peer-compare test asserts pop_range + is_ratio propagate end-to-end. 326 PASS / 0 FAIL.	2026-04-29 19:16:48 -04:00
jared	916212c327	feat(explain): render new per-capita provenance fields cog_explain() now prints denominator_source, popyear_range, and pop_source_counts under the Transformations section.	2026-04-29 19:02:37 -04:00
jared	c682e6547d	feat: cog_spending + cog_revenue + cog_explain Three core query verbs over the spending_annotated / revenue_annotated DuckDB views. Each verb accepts vector govid, vector years, optional category filter, per_capita flag, and adjust_to_year for CPI-U real-dollar conversion (bundled index). Amounts are returned in full USD (SUM(amt) * 1000) so callers can freely rescale to millions/billions. The $1,000s -> $USD conversion is recorded in provenance$transformations$units_conversion. Every result carries an attr(., "provenance") list matching inst/schemas/provenance-v1.json. cog_explain() prints the structured form via cli or returns the raw list for MCP/JSON consumers. Also: .fetch_or_cache_manifest() now handles local fixture paths so tests can point USCOGDATA_FIXTURE_URL at the pipeline publish_cache/ without a working HTTP server. Tests: 80 pass / 0 fail. devtools::check() 0E/0W/2N (both notes pre-existing / environmental).	2026-04-24 09:49:09 -04:00

Author

SHA1

Message

Date

jared

919548685b

polish(per-year-pop): expand popyear in cog_explain + propagate pop_range

R-CMD-check / check (push) Failing after 1m30s

Details

Final-review followups:

1. cog_explain rendered the popyear range as raw 2-digit values
   ("popyear range: 19-20"), which a user could read as the years 19-20.
   Added .expand_popyear() helper to format as 4-digit calendar years
   (2019-2020). Pivot at 70 to handle pre-2000 vintages if the corpus
   ever extends backward.

2. cog_peer_compare provenance was missing pop_range and is_ratio,
   omitted from the spec-required reproducibility metadata.
   cog_find_peers now stamps both as tibble attributes; cog_peer_compare
   reads them through to provenance$pop_range and provenance$is_ratio.

Test coverage extended: explain test asserts the 4-digit format and
rejects the old 2-digit form; peer-compare test asserts pop_range +
is_ratio propagate end-to-end.

326 PASS / 0 FAIL.

2026-04-29 19:16:48 -04:00

jared

916212c327

feat(explain): render new per-capita provenance fields

cog_explain() now prints denominator_source, popyear_range, and
pop_source_counts under the Transformations section.

2026-04-29 19:02:37 -04:00

jared

c682e6547d

feat: cog_spending + cog_revenue + cog_explain

Three core query verbs over the spending_annotated / revenue_annotated
DuckDB views. Each verb accepts vector govid, vector years, optional
category filter, per_capita flag, and adjust_to_year for CPI-U
real-dollar conversion (bundled index).

Amounts are returned in full USD (SUM(amt) * 1000) so callers can
freely rescale to millions/billions. The $1,000s -> $USD conversion
is recorded in provenance$transformations$units_conversion.

Every result carries an attr(., "provenance") list matching
inst/schemas/provenance-v1.json. cog_explain() prints the structured
form via cli or returns the raw list for MCP/JSON consumers.

Also: .fetch_or_cache_manifest() now handles local fixture paths so
tests can point USCOGDATA_FIXTURE_URL at the pipeline publish_cache/
without a working HTTP server.

Tests: 80 pass / 0 fail. devtools::check() 0E/0W/2N (both notes
pre-existing / environmental).

2026-04-24 09:49:09 -04:00