InstallHub
Post-Install Verification
After all artifacts are installed but before the transaction is committed, the engine performs a verification pass to confirm every artifact is queryable and that cross-references resolve correctly.
What Verification Checks
Verification runs within the open database transaction — after install, before commit. If verification fails, the transaction is rolled back and the target tenant remains unchanged.
| Check | Description | Failure Action |
|---|---|---|
| Artifact accessibility | Query each installed artifact by its new ID — confirm it can be retrieved from the database | Rollback + VerificationFailed |
| Cross-reference resolution | For each artifact, confirm its referenced dependencies exist (e.g., the form ID referenced in a workflow node can be found) | Rollback + BrokenReference |
| Entity schema integrity | Confirm installed EntitySchemas are valid and queryable by the entity service | Rollback + EntitySchemaInvalid |
| Form load check | Attempt to load the installed AtlasForm definitions to confirm they parse correctly | Rollback + FormLoadFailed |
Verification Result in Import Response
{
"importId": "imp-f9a2c1e8-...",
"status": "Success",
"verification": {
"passed": true,
"checks": [
{ "artifactId": "ent-2291", "check": "Accessibility", "result": "Pass" },
{ "artifactId": "rule-6612", "check": "Accessibility", "result": "Pass" },
{ "artifactId": "form-9104", "check": "Accessibility", "result": "Pass" },
{ "artifactId": "form-9104", "check": "CrossReference", "result": "Pass" },
{ "artifactId": "proc-7823", "check": "Accessibility", "result": "Pass" },
{ "artifactId": "proc-7823", "check": "CrossReference", "result": "Pass" }
]
}
}When Verification Fails
{
"importId": "imp-f9a2c1e8-...",
"status": "Failed",
"stage": "PostInstallVerification",
"error": "BrokenReference",
"message": "ProcessDefinition 'proc-7823' references form 'form-9104' but the form could not be loaded.",
"verification": {
"passed": false,
"checks": [
{ "artifactId": "form-9104", "check": "FormLoadFailed", "result": "Fail",
"details": "JSON schema validation failed: field 'f3.dataSource.entityId' references 'ent-2291' which does not exist" }
]
},
"rolledBack": true
}
Transaction Rollback on Verification Failure
If any verification check fails, the transaction is rolled back automatically. The target tenant is left exactly as it was before the import. No partial state is ever committed.
Verification Timeout
Verification is subject to a 30-second timeout per package. Large packages (many artifacts) complete verification in parallel where possible. If verification exceeds the timeout, the transaction is rolled back and the import is reported as failed with VerificationTimeout.