/measure-portfolio-diversity

name: measure-portfolio-diversity
description: "Quantify portfolio diversity/coverage across declared feature, mechanism, domain, or failure-mode dimensions and expose concentration/niche collapse."

measure-portfolio-diversity

Purpose

Quantify portfolio diversity and coverage across declared feature, mechanism, domain, or failure-mode dimensions.

Input contract

required: [portfolio, diversity_dimensions, feature_assignments]
optional: [niche_universe, strength_threshold, concentration_measure]
constraints: [niche definitions and distance/overlap rules are explicit]

Procedure

1. Define niches and assign each portfolio member to them. 2. Compute coverage, concentration, and duplication using the supplied measure. 3. Identify empty niches and collapse risks. 4. Return diversity results with sensitivity to assignment uncertainty.

Output contract

produces: [diversity_metrics, niche_coverage, concentration_risks, empty_niches]
delta_fields: [findings, uncertainties, decisions]

Quality gates

• Coverage is reported as a fraction of a declared niche universe.
• A caller-supplied strong-candidate threshold is applied consistently.
• Concentration and niche collapse are disclosed, not hidden by aggregate diversity.

Parameterization

Caller supplies portfolio schema, niche universe, assignment rules, strength threshold, and concentration metric.

Failure and counterexamples

Reject diversity scores without niche definitions or portfolios assessed on incompatible dimensions.

Provenance map

• concept: convergence/diversity-maximization
• concept: convergence/niche-coverage-analysis

Preserved source criteria ledger

| source | criterion | |---|---| | convergence/diversity-maximization | Coverage threshold may be caller-supplied; preserve declared threshold verbatim. |