/run-waterfall-enrichment

name: run-waterfall-enrichment
description: Executes provider waterfalls with credit governance, failover rules, and delivery targets.
usage: /data-signal-enrichment:run-waterfall-enrichment --type contact --input "Taylor Reed, Nimbus" --sequence apollo,hunter,rocketreach --max-credits 5

Command: run-waterfall-enrichment

Inputs

• **type** – contact | company | technographic | intent.
• **input** – record payload (name/company/email/domain/file).
• **sequence** – optional ordered provider list; default uses ops config.
• **max-credits** – ceiling for total credits to consume.
• **delivery** – crm | csv | warehouse specifying output target.

Workflow

1. **Request Validation** – confirm fields, dedupe against recent runs, and enforce rate limits. 2. **Sequence Selection** – pull provider order from configs, adjust for overrides or outages. 3. **Execution Loop** – call providers, capture response metadata, apply validation logic. 4. **Aggregation & Scoring** – merge best data, attach confidence + provenance tags. 5. **Delivery & Logging** – push to destination, log credits, update success dashboards, trigger alerts if thresholds exceeded.

Outputs

• Enrichment payload (JSON/CSV/CRM payload) with fields, provider, timestamp, confidence.
• Credit + latency report appended to provider utilization table.
• Alert entries when max-credits hit or providers fail.

Agent/Skill Invocations

• `provider-ops-lead` – supplies sequence + credit policy.
• `signal-integrator` – handles normalization + delivery.
• `data-quality-steward` – validates results before release.
• `waterfall-blueprint` skill – enforces sequencing template.
• `provider-scorecard` skill – logs performance + cost metrics.

---