Testing and Debugging

Audience: operator maintainers Status: Preview

The minimum useful checks for an operator package are:

• validate the manifest shape
• ensure the entrypoint or implementation loads
• verify the declared operator ids appear in the catalog
• run preview mode before materialization
• inspect the run bundle or project run evidence
• verify generated outputs record exact input revisions and parameters

Debugging Rule

If behavior differs between implementation code and the manifest contract, trust the manifest as the public contract and fix the implementation to match it.

Evidence Rule

An operator is not ready for product use until its run evidence is inspectable without knowing the implementation internals.