====== P4-REQ-21-12-007 ======

[[dido:99_annexes:annex-d-requirements:part-04:start| Return to Requirements]]

===== Statement =====

Each approved script SHALL identify its error-handling behavior.

===== Source =====

Part 4, Section 21.12: Script and Execution Requirements.

===== Rationale =====

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.

===== Applies To =====

This requirement applies to:

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

===== Verification =====

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.

===== Traceability =====

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

Related requirement identifiers:

  * [[dido:99_annexes:annex-d-requirements:part-04:p4-req-21-12-006]]
  * [[dido:99_annexes:annex-d-requirements:part-04:p4-req-21-11-007]]
  * [[dido:99_annexes:annex-d-requirements:part-04:p4-req-21-12-011]]

Related source section:

  * [[fxdemo:04-part:21-phase-0-implementation-requirements:21-12-script-and-execution-requirements:start]]

===== Status =====

Draft

----

<WRAP centeralign>

© 2026 Dido Solutions, Inc. and Jackrabbit Consulting, Inc.

</WRAP>