Adapter Authoring
Use the normative [source adapter guide](../../../dataset/source-adapters.md)
Source adapter authoring and qualification
Use the normative source adapter guide and `source-adapter.v1` schema. An adapter manifest declares identity, version, source kinds, configuration schema, credential locators, capability limits, privacy/network behavior, lifecycle support, checkpoint compatibility, and qualification maturity.
Adapters must implement bounded check and preview behavior before ingestion; redact secrets and sensitive samples; reject undeclared hosts and path escape; and bind checkpoints to adapter version, source schema, and plan digest. A declared capability is not a supported capability until qualification evidence passes. Publication must include versioned schemas, valid and invalid fixtures, security review, compatibility policy, and a release artifact digest.
The reference adapters and SDK live in `src/dataset/`. Addon skills only select and explain them; they must never duplicate adapter execution.