5 Commits

Include renames

Author	SHA1	Message	Date
jared	7522b48a08	feat: report suppressed component dollars in the signpost message (#9) ... .inform_suggestions() and cog_explain() now render suppressed_amount / suppressed_years / suppressed_codes as a continuation line on each suggestion bullet whenever suppressed_amount > 0 (an empty_year fire can carry them too, so this keys off the amount, not trigger). Also renames the cli header from "Coverage gap detected" to "Incomplete coverage" -- a partial-coverage fire is not a gap, the year has rows, they're just short.	2026-08-04 22:02:01 -04:00
jared	693f8d81a6	fix: signpost aggregate-suppressed components in a category that still has rows (#9)	2026-08-04 21:49:23 -04:00
jared	db35fa9058	feat: measure structurally-suppressed recipe component dollars (#9)	2026-08-04 21:38:22 -04:00
jared	77f48047b1	fix: exercise real harmonized-view SQL in tests; unambiguous recipe provenance ... test-views.R's harmonized-view test previously ran a hand-rolled REPLACE query with no WHERE clause, so a regression in any of inst/sql/22-spending_long_harmonized.sql / 23-revenue_long_harmonized.sql's three predicates (NOT is_aggregate, harmonized_code IS NOT NULL, the E/F/G/K or T/A/U/B/C/D prefix filter) would go uncaught. Replaced it with a test that reads the real SQL files off disk, substitutes {url} exactly as .register_views() does, and executes them (plus their 10-long.sql dependency) against a synthetic hive-partitioned parquet tree written via DuckDB's own COPY ... TO (FORMAT PARQUET) (no arrow dependency, matching this package's existing convention). Ten rows are crafted so each predicate is independently falsifiable by a specific row; manually broke each predicate in turn to confirm the test fails exactly as expected, then restored the SQL files (see the task report for the RED-phase transcript). Also fixes a provenance ambiguity: a recipe= query bypasses spending_annotated(_harmonized)/revenue_annotated(_harmonized) entirely (.run_recipe() joins `long` directly), so basis= has no effect on it, but provenance was still reporting basis = "harmonized"/"raw" (whatever the argument resolved to) with harmonization$applied = FALSE alongside it -- misleading, since it looks like harmonization was evaluated and found nothing to exclude rather than "not applicable here." Recipe results now report basis = "recipe" with an inert harmonization block carrying an explicit note, regardless of what basis= was passed.	2026-07-18 23:55:48 -04:00
jared	4de915b557	feat: cog_recipes + recipe= + signposting suggestions ... Adds cog_recipes() to list the curated harmonization_recipes catalog (24 recipes / schema_version >= 5), and a recipe= argument on cog_spending()/ cog_revenue() that runs a recipe's generic multi-code join instead of the category view: SUM(amt * weight) across whichever component codes are present for a (year, canonical_govid), scoped by gov_type_scope. The join deliberately does not filter is_aggregate -- the wide era (<= 2011) exposes these split families (corrections 04+05, IG *89/*47, U4- rents, etc.) ONLY as aggregate rows, with leaf codes first appearing in 2012, so excluding aggregates would zero out the wide-era half of every recipe. This is safe by corpus construction: wide-era rows are aggregate-only, modern rows are leaf-only, and every component is year-scoped, so there is no double-counting. recipe= is mutually exclusive with category=; the result's subtype column reads "recipe" and category reads the recipe's label. Adds recipe-component-driven signposting: when a basis="harmonized" + category query comes back with zero rows in a requested year, and a harmonization recipe covering that category would actually produce rows for this government in that year (via the same join .run_recipe() uses), the recipe is surfaced in provenance$suggestions plus one cli::cli_inform() message. This is deliberately keyed off recipe components rather than harmonization_map's suggested_recipe_id column (which is empty on every live row -- the wide era's split families are NA-by-construction via aggregate exclusion, not an NA ruling to hang a suggestion off of). Also populates the previously-always-empty provenance$series_break_refs (schema v5 only: series_breaks_pq rows whose fin_code is among the observed codes and whose break_year falls in the requested span), and extends cog_explain() with Basis/Harmonization/Recipe/Suggestions/Series breaks sections.	2026-07-18 23:33:02 -04:00