schema_version: 3
provider: chain
name: stats-cohort-size
version: 0.1.0

# Resolve the size of an addressee cohort (e.g. "Berliner KMU
# nach WZ-Code", "Gastronomie deutschlandweit").
#
# v0.1.0 ships a built-in stub table for the five pilot cohorts.
# v0.2 adds a DESTATIS GENESIS-API adapter (capability requires
# `net` permission); the API surface here stays identical.
#
# Reuse-lens: any quant analysis that needs cohort sizing —
# market research, audience targeting, public-health tracking.
provides:
  - capability: stats.cohort_size
    version: 0.1.0

inputs:
  cohort_id:
    type: text
    description:
      en: |
        Cohort identifier. v0.1.0 recognises:
          berlin-kmu, de-kmu, gastro-de, handwerk-be, bauwirtschaft-be
      de: |
        Kohorten-Identifier. v0.1.0 kennt:
          berlin-kmu, de-kmu, gastro-de, handwerk-be, bauwirtschaft-be

outputs:
  cohort:
    type: json
    description:
      en: |
        { id, count, year, source, tier }.
        tier ∈ {T1, T2} — T1 when DESTATIS, T2 when Verband-source.
      de: |
        { id, count, year, source, tier }.

# v0.1 stub: no permissions. v0.2 DESTATIS adapter needs:
#   net: ["genesis.destatis.de"]
permissions: []