Skip to content

v1.0.x release notes

v1.0.1 — 2026-06-29 (Performance patch)

Fixed

  • DuckDB bulk-insert speedup (~100×). The DuckDBWriter.write() method now batches inserts into a single transaction; previously each row was a separate insert.
  • country_vs_country filter fusion (~5–10×). The AnalyticsEngine now fuses multiple filter predicates into a single pass over the dataset; previously each filter was a separate iteration.

Removed

  • un_comtrade.logging.DEFAULT_LOG_LEVEL (the deprecated alias) removed in v1.0.1.x. The canonical constant is now un_comtrade.config.DEFAULT_LOG_LEVEL (string value "WARNING"). See F-003 (CHG-0081).

v1.0.0 — 2026-06-28 (First stable release)

Added

  • The public ComtradeClient facade exposing five lazy service attributes: metadata, trade, analytics, etl, storage.
  • The full public SDK surface (251 symbols across 13 modules).
  • The complete Cookbook (29 recipes across metadata, trade, analytics, storage, CLI, and end-to-end).
  • The CLI surface (5 outer commands, 22 sub-subcommands, 5 output formats).
  • The full documentation site (this site).

Changed

  • un_comtrade.logging.DEFAULT_LOG_LEVEL → LOGGING_DEFAULT_LEVEL (deprecation alias removed in v1.0.1).

Deprecated

  • None.

Removed

  • un_comtrade.storage.LocalFilesStorage (placeholder removed in v1.0.0; the public surface is the four concrete backends).
  • ComtradeClient.DECLARED_METHOD_COUNT (decorative counter removed).

Fixed

  • 91.4 / 100 readiness score per docs/031_PRODUCTION_READINESS.md.
  • 0 circular dependencies per the package-hygiene audit.
  • 0 dead modules.

Security

  • No key persistence; UN_COMTRADE_KEY is read from the environment only.
  • SSL is the default; no plaintext HTTP support.
  • Log messages redact API keys (***REDACTED*** placeholder).

Verification

  • 3,117 / 3,117 SDK tests pass.
  • 100% public-API coverage.
  • Layer-boundary audit: 0 violations.
  • Circular-dependency audit: 0 cycles.
  • Package-hygiene score: 95 / 100 (100 / 100 after R1 rename).