Plugin entities
Contribute structured entity workspaces to the host.
AlphaWorkspace
Define workspace identity, collections, entity types, fields and supported commands through IEntityWorkspacePlugin.
Validation
Return field-specific validation issues and prevent invalid records from being used by actions.
References and preview
Declare reference targets explicitly and provide previews only for supported entity variants.
Portable collections
Assign PluginEntityTransferDescriptor to the workspace Transfer property to enable .shubentities.json import and export. The host owns the package envelope and transaction; the plugin owns PayloadJson, PayloadSchemaVersion, dependency discovery and reference remapping.
Analyze before apply
AnalyzeImportAsync must not mutate state and may be called repeatedly. Report counts and issues for Skip, Replace and KeepBoth. Stage all changes in ImportAsync before committing them.
Atomic rollback
Provide CaptureRollbackState and RestoreRollbackState for every import-capable workspace. The host rejects a stale preview and restores the snapshot after a failed result, error issue or exception.
Portable data
Never export passwords, tokens or private keys. Warn when machine-local paths or files may require relinking on the destination.