P4-REQ-21-12-007

Return to Requirements

Each approved script SHALL identify its error-handling behavior.

Part 4, Section 21.12: Script and Execution Requirements.

Scripts that fail silently can leave generated artifacts, repository state, runtime participants, or configuration in an ambiguous or invalid condition.

Explicit error-handling behavior ensures that failures are reported, appropriate exit status is returned where applicable, and partial operations are handled according to approved implementation rules.

This requirement applies to:

• approved scripts;
• generation failures;
• prerequisite failures;
• execution failures;
• cleanup failures; and
• repository-state errors.

Verification SHALL confirm that each approved script identifies its error-handling behavior.

Verification activities should include review checks confirming that:

• failure conditions are identified;
• failures are reported;
• appropriate exit status is returned where applicable;
• ambiguous partial states are avoided or reported; and
• error handling follows the Developer Handbook.

This requirement connects script failure handling to the Phase 0 exception-handling and repository-governance conventions.

Related requirement identifiers:

• P4-REQ-21-12-006
• P4-REQ-21-11-007
• P4-REQ-21-12-011

Related source section:

• 21.12 Script and Execution Requirements

Draft