v0.11.0 — Semantic Layer Expansion

[AnthonyPuggs]

Expands get_economic_series from a 4-concept demo to a 28-concept product surface, plus ergonomics and discovery items.

Highlights

• 🧭 24 new curated concepts across prices, labour, activity, rates, FX, external sector, and credit
• 🔧 ABS structure-id hardening unblocks underemployment_rate (live DS_LF_UNDER structure)
• ⚡ last_n parameter on get_economic_series
• 🔎 list_catalogue tool — unranked complement to search_datasets
• 📚 ausecon://concepts resource — index of every shortcut with its resolved target
• 💬 Two new prompts: labour_slack_snapshot, yield_curve_snapshot

Semantic expansion

Area	New concepts
Prices	weighted_median_inflation, monthly_inflation, producer_price_inflation, living_cost_index
Labour	unemployment_rate, underemployment_rate, employment_total, participation_rate, hours_worked, job_vacancies, wage_growth
Activity	household_spending, population
Rates	government_bond_yield_3y, government_bond_yield_10y, mortgage_rate, small_business_rate
FX	aud_usd, trade_weighted_index
External	exports_goods_services, imports_goods_services, current_account_balance, commodity_prices
Credit	housing_credit, business_credit, consumer_credit

Locked default choices

• Bond yields resolve to f17 (zero-coupon AGS yields), not f16 — modelling-friendly and
  coupon-free.
• housing_credit returns two SA series (DLCACOHS owner-occupier + DLCACIHS investor) rather than
  a pre-aggregated total.
• producer_price_inflation uses PPI_FD (final demand), matching the commonly reported headline.
• commodity_prices uses the SDR index (GRCPAISDR) so AUD moves aren't baked into the default.
• underemployment_rate composes via structure id DS_LF_UNDER while keeping dataflow id LF_UNDER
  for the data request.

ABS structure-id hardening

New resolve_abs_structure_id() helper and an optional structure_id field on ABS catalogue entries.
Required because the live ABS SDMX DataStructure for LF_UNDER is exposed as DS_LF_UNDER. Covered by
unit tests and an end-to-end live smoke test.

Ergonomics

• get_economic_series(..., last_n=N) forwards last_n to the underlying ABS or RBA call.

Discovery

• list_catalogue — unranked listing with source, category, tag, include_ceased,
  include_discontinued filters. Returns trimmed rows (id, source, name, category, frequency,
  tags) suitable for UI pickers.
• ausecon://concepts — every curated shortcut with its resolved {source, dataset_id, variant} plus
  declared frequencies and geographies.

Prompts

• labour_slack_snapshot — unemployment + underemployment signal.
• yield_curve_snapshot — 3y vs 10y AGS curve shape and recent shift.
• Existing templates now prefer get_economic_series wherever a v0.11.0 concept covers the workflow.

Verification

• uv run pytest — 407 passed
• uv run pytest integration_tests/test_semantic_live.py — 10/10 live concepts green against real
  upstream (ABS SDMX + RBA CSV)
• uv run ruff check src tests integration_tests scripts — clean
• uv run python scripts/audit_catalogue.py — 0 drift, 0 disappeared
• CI + Integration workflows green

Full changelog: v0.10.0...v0.11.0

---

This discussion was created from the release v0.11.0 — Semantic Layer Expansion.