Skip to content

plugin-seed-data schema

metadata/seed-data/*.json — Entity-Engine data rows a plugin seeds on install/upgrade, idempotently (upsert by keyFields). See ai/patterns/plugin-install-data-seeding.md.

Pull the full JSON Schema: erp schema pull plugin-seed-data  ·  MCP: erp_get_schema {"name":"plugin-seed-data"}

Top-level properties

PropertyTypeRequiredNotes
entitystringyesEntity Engine entity name the rows belong to. Must already exist (ship it in metadata/entities/ if the plugin owns it).
keyFieldsarrayyesThe natural-key fields that uniquely identify a row. On re-install, a row matching all keyFields is updated (only if a non-key value changed); otherwise inserted. Never produces duplicates.
sourcestringThe plugin id. Stamped into a seeded_by field when the entity has one.
rowsarrayyesThe rows to upsert. Each is a plain field map for the entity - no tenant id (the installer supplies it).