Skip to content

puremacro 6.4.0: own-data fiscal brief, connector freshness, LP contracts, and correctness fixes

Choose a tag to compare

@jalonso1979 jalonso1979 released this 12 Nov 22:10
· 46 commits to main since this release

puremacro 6.4.0 adds reusable own-data quarterly fiscal policy briefs, bounded connector provenance and freshness reporting, local-projection chronological and specification contracts with two-way fixed-effects panel IV, and eleven numerical and data-provenance correctness fixes across DSGE, sovereign DSA, weak-IV, SMC, proxy-SVAR, and trade.

  • Reusable own-data quarterly fiscal policy brief (examples.first_brief_fiscal: FiscalBriefConfig, prepare_fiscal_data, parse_quarterly_index, and CLI flags) supporting custom CSV/DataFrame inputs, Gordon–Krenn scaling, explicit external-instrument vs opt-in Blanchard–Perotti identification, lagged state regimes, short-sample/short-regime guards, and portable bilingual (en/es) SHA-256 output bundles while preserving exact reproduction of Ramey–Zubairy (2018).
  • Bounded connector provenance and freshness reporting (fetch.freshness: connector_freshness_report, write_freshness_report, RateBudget, and python -m puremacro.fetch.freshness) across cache, recorded, and rate-budgeted live modes with domain-identity checks (LF = E + U on BLS LAUS, nominal/real/deflator consistency on OECD QNA, and [0, 100]% non-fixture share bounds on energy transition), plus ten registered cross-country panel builders in fetch.registry.
  • Local-projection contracts across lp_hac, lp_iv, estimate_distributional_lp, and estimate_quantile_lp enforcing chronological regularity on date indices, rejecting ±np.inf and conflicting canonical/alias arguments, recording specification provenance and weak-IV warnings, and estimating genuine horizon-matched two-way fixed-effects 2SLS with structural residuals and entity-clustered standard errors in panel_lp_iv.
  • Eleven wrong-number or silent-substitution conditions fixed and documented in the correctness advisories: deterministic .mod space-separated signed shock lists, var.identify.sign_zero orientation and joint restriction verification, BLS LAUS measure codes 04/06, explicit failure/warning instead of fixture substitution in fetch.energy, third-order Sylvester (1, 1, 2) mixed real/complex Schur blocks, quarterly compounding in sovereign.dsa.simulate_stochastic_dsa, multivariate Kleibergen–Paap rk Wald $F$ and FWL-consistent weak_iv_summary, exact [lb, ub]-truncated SMC priors, Jentsch–Lunsford (2019, 2022) centered moving-block bootstrap in proxy_svar, baseline-anchored Geary–Khamis welfare accounting in trade.optimal_tariffs, and non-fallback live snapshot accounting in connector_health.
  • Lazy module loading in inference and models decoupling import puremacro.lp from DSGE and trade graphs, plus arch>=9.0 lowercase Literal compatibility across GARCH wrappers.

Install with python -m pip install puremacro==6.4.0 on Python 3.11 or later. Read the fiscal brief guide https://jalonso1979.github.io/puremacro/docs/first_brief_fiscal/, connector freshness guide https://jalonso1979.github.io/puremacro/docs/CONNECTOR_HEALTH/, local-projections guide https://jalonso1979.github.io/puremacro/docs/lp/, correctness advisories https://jalonso1979.github.io/puremacro/docs/ADVISORY/, and full changelog https://github.com/jalonso1979/puremacro/blob/v6.4.0/CHANGELOG.md.

Own-data fiscal estimates require user-supplied causal identification; opt-in shock_mode="blanchard_perotti" imposes recursive within-quarter timing and should be defended explicitly for the application. Short samples (< 120 effective quarters) and small state regimes (< 40 observations) emit explicit asymptotic warnings rather than blocking estimation. Connector freshness reports inspect bounded metadata, cached series, recorded wire fixtures, or rate-budgeted live probes and do not certify permanent upstream API stability. Previously saved BLS LAUS panels, energy-transition tables, third-order complex-root DSGE solutions, and quarterly stochastic DSA paths produced with versions up to 6.3.0 should be rebuilt or re-run per docs/ADVISORY.md.

Validation on 4be8a2ffc3cb8be447453916bdf971c0921e40d9: 24,044 local tests passed, 89 skipped, and all seven local release gates passed. The main CI matrix https://github.com/jalonso1979/puremacro/actions/runs/43270156065 and tag release workflow https://github.com/jalonso1979/puremacro/actions/runs/43293497320 passed, including nine OS/Python targets, native and Windows typing on Python 3.11/3.12 (arch 9.0.0, mypy 2.4.1), strict documentation builds, 134 opt-in slow/reference/replication tests (19 skipped), and installed-wheel examples. The real Pyodide 0.28.3 kernel passed 121 smoke tests. Downloaded PyPI artifact hashes and all 1,052 packaged wheel files (1,058 entries including .dist-info) and 1,588 repository sdist files were verified byte-for-byte against v6.4.0, followed by a fresh --no-cache PyPI installation and isolated execution of the four base workflows, own-data fiscal brief CLI, and 9-connector freshness CLI. These cohorts overlap. See the attached release-validation.json for artifact hashes and scope.

The examples gallery retains the documented Romer–Romer (2010) published t-statistic rounding mismatch; it is not relabeled as passing. Timing checks use the repository's CI scale of 10 and do not certify unscaled wall-clock deadlines.

The pinned course edition keeps its own package version and validation record. This library release does not upgrade or requalify those course environments.

Español. puremacro 6.4.0 incorpora informes fiscales trimestrales reutilizables con datos propios (examples.first_brief_fiscal), informes acotados de procedencia y frescura de conectores (fetch.freshness), contratos cronológicos y de especificación en proyecciones locales con IV de panel de efectos fijos bidireccionales (lp.panel_lp_iv), y once correcciones numéricas y de procedencia de datos documentadas en los avisos de corrección. Consulte la guía del informe fiscal https://jalonso1979.github.io/puremacro/docs/es/first_brief_fiscal/, la salud de conectores https://jalonso1979.github.io/puremacro/docs/es/CONNECTOR_HEALTH/, proyecciones locales https://jalonso1979.github.io/puremacro/docs/es/lp/ y los avisos de corrección https://jalonso1979.github.io/puremacro/docs/es/ADVISORY/.

Las estimaciones fiscales con datos propios requieren justificar explícitamente la identificación causal, y las muestras cortas emiten advertencias asintóticas explícitas. Los paneles BLS LAUS, tablas de transición energética, soluciones DSGE de tercer orden con raíces complejas y trayectorias DSA trimestrales generadas con versiones hasta 6.3.0 deben recalcularse según docs/es/ADVISORY.md. La galería de ejemplos conserva la discrepancia de redondeo publicada de Romer–Romer (2010) sin reclasificarla, y la edición fija del curso mantiene su entorno y validación independientes.