Helper API to provide metadata item for capturing provenance of a derived data file

[yarikoptic]

E.g. as now came up in the context of the spike sorted data in dandi/dandi-cli#1314 but also is to be used in the use case of @vandermeerlab (attn @TheChymera @manimoh) . I guess it should take a metadata record, original asset(s) information, and return enhanced metadata record. @satra you have mentioned that we had worked that out that somewhere.

Then with that helper in mind, we should provide documentation for https://github.com/dandi/handbook/ .

[satra]

yes, we worked that out for publishing dandisets. it takes the metadata adds the provenannce: https://github.com/dandi/dandi-archive/blob/6cc74347458f1e12a434ac95ccd417ef48fbe4da/dandiapi/api/services/publish/__init__.py#L90

in the context of dandi-schema, one could use the schema library itself to inject derived from: asset_meta.wasDerivedFrom = [other_asset.id] if the field is blank or append if not.

however, right now the wasDerivedFrom is only supporting Biosample derivations to assets (

dandi-schema/dandischema/models.py

Line 1391 in fe96019

wasDerivedFrom: Optional[List[BioSample]] = Field(None, nskey="prov")

). we should add URI as an option.