Provider Approvals

P17 adds the approval gate between provider sandbox outputs and the tracked Vancouver PoC product. Provider observations are not facts by default. They enter the PoC only when an approval manifest marks a row approved.

The tracked Vancouver PoC stores provider approval data under data/poc/vancouver/provider_data. Provider-derived rows remain candidate/pending-review observations unless a later review artifact promotes a specific value.

Approval Manifest

Approval manifests use approval_manifest.csv columns documented in schemas/provider_approval_manifest_columns.csv. Supported approval statuses are:

  • approved

  • rejected

  • deferred

  • needs_source_review

  • needs_taxonomy_review

Only approved rows are imported. Rejected, deferred, and review-needed rows remain part of the audit trail but do not update plant, source, supplier, or mowability artifacts.

Provider Data Artifacts

Approved supplier and mowability observations are stored under provider_data beside the Vancouver PoC artifacts:

  • approval_manifest.csv

  • candidate_species.csv

  • candidate_attributes.csv

  • supplier_availability.csv

  • mowability.csv

  • source_attribution.csv

  • manifest.json

  • diagnostics.csv

Supplier rows are separate from plant identity rows because one species can have multiple providers. Mowability remains a provisional 0-5 candidate signal; it does not make UNI, PSI, or RVI score inputs ready.

Commands

Build a static expert review app from a provider sandbox:

bc-nppd build-provider-approval-review outputs/provider_sandbox_source_sweep/PROV-SATIN --poc-dir data/poc/vancouver --out-dir outputs/provider_approval_review/PROV-SATIN --reviewer "expert reviewer" --json

The full reviewer workflow is documented in provider-review-workflow.

Validate an approval manifest:

bc-nppd validate-provider-approvals examples/provider_approval_manifest.csv --json

Apply approved rows to a Vancouver PoC output directory:

bc-nppd apply-provider-approvals examples/provider_approval_manifest.csv --poc-dir data/poc/vancouver --out-dir outputs/provider_approved_vancouver --json

Use --skip-regeneration for fast dry runs that do not regenerate evidence, usability, or pollinator artifacts.

Tracked Provider Data

The current Vancouver PoC includes the July 2026 all-provider promotion from Satinflower, Northwest Meadowscapes, West Coast Seeds, Premier Pacific Seeds, and Oak Summit Nursery. The tracked provider data validates at 5,160 approval rows, 402 candidate-species rows, 1,816 candidate-attribute rows, 603 supplier rows, and 1 provisional mowability row. These rows support inspection and review; they do not promote provider values to reviewed ecological facts.