Troubleshooting

buildPkg fails with “requires -Ppkg={name}”`

Run the task with a package code:

gradle clean buildPkg -Ppkg=iflowkit-email

Compilation fails due to Groovy or Java version mismatch

Confirm that your environment can use Java 17 and that the build uses the configured CPI-compatible Groovy compiler.

java -version
gradle -version

Class not found at runtime in CPI

Check that the class belongs to the package, a declared plugin, or a declared system service. The package build includes only what the manifest declares.

Plugin parameters are not applied

Verify that the plugin ID in the package manifest matches the plugin manifest ID exactly.

Example:

com.iflowkit.plugin.email

HTTP calls fail after payload generation

Separate payload generation from transport execution while debugging. Validate:

• endpoint base URL
• tenant environment
• credential mapping
• generated payload
• CPI adapter configuration

Secrets were accidentally committed

1. Remove the secret from the repository.
2. Rotate the exposed credential.
3. Review commit history and access logs.
4. Add .gitignore rules to prevent recurrence.