Changes in version 0.1.1                        

CRAN maintenance release addressing a check-system issue raised by the
CRAN team on 2026-05-31.

  - The \donttest{} example for aei_link() fetched a release file into
    the persistent user cache (tools::R_user_dir()) rather than a
    temporary directory, so it left data behind on the CRAN check
    machines. The example now redirects the cache to tempdir(), matching
    every other example in the package.
  - aei_cache_dir() now redirects to a session-temporary directory when
    it detects an R CMD check run, so the package cannot write to
    persistent storage during checks even if an example, test, or
    vignette omits the redirect.
  - Removed the bls.gov/soc/ reference link from the help page and
    README. The page returns HTTP 403 to automated URL checkers; the
    Standard Occupational Classification is still cited by name.

                 Changes in version 0.1.0 (2026-05-13)                  

Initial release.

Discovery and download

  - aei_releases() lists available Anthropic Economic Index releases on
    Hugging Face, blending bundled metadata with a live listing.
  - aei_files() returns the recursive file tree of a release.
  - aei_index() fetches the canonical usage CSV for a release, handling
    the wide-to-long schema change between the 2025-03-27 and 2025-09-15
    releases automatically.
  - aei_download() is the lower-level escape hatch for fetching any file
    from a release by path.

Structured access

  - aei_clusters() returns the request-hierarchy tree (Clio output) as a
    parsed nested list. Released from 2025-09-15 onwards.
  - aei_tasks() returns the bundled O*NET task statements (released with
    the 2025-03-27 snapshot).
  - aei_geography() filters the long-format enriched table to country or
    US-state rows. Released from 2025-09-15 onwards.

Analysis

  - aei_compare() produces a release-on-release diff of the same metric
    across two AEI snapshots, returning shared keys plus value_a,
    value_b, delta, and pct_change.
  - aei_link() is a generic merge helper that preserves the aei_tbl
    class and provenance metadata. Use it to splice the AEI to your own
    data on a shared key (country code, occupational identifier, cluster
    name, etc.). Supports left, inner, and full joins.
  - aei_concentration() computes the Herfindahl-Hirschman Index, top-N
    concentration ratios (CR4 by default), and Shannon entropy on a
    vector of usage shares. Auto-detects the share column and supports
    per-group computation.

Reproducibility

  - aei_cite() returns a citation in plain text, BibTeX, or bibentry
    form, including the methodological source paper of Handa et al.
    (2025) by default.
  - aei_cache_info(), aei_cache_clear(), and aei_cache_dir() manage the
    local data cache.

S3 class

  - aei_tbl class with print, summary, and [ methods that preserve the
    aei_query provenance attribute (release id, source URL, fetch
    timestamp) across subsetting.