Pack metadata and versions
Each complete configuration document must have a pack: object. Verdictan uses its fields to validate and trace the file:
- Verdictan writes
pack.versiontoconfig_version. - Verdictan writes
pack.nametopack_name. - Verdictan calculates
config_sha256, a SHA-256 fingerprint, from the source file bytes.
The schema accepts only the keys on this page. The name, version, and enabled fields are necessary.
Recommended pack block
pack:
name: finance-compliance
version: 2.1.0
enabled: true
This example is the smallest correct pack block.
Field behavior
| Field | Used by Verdictan | Behavior |
|---|---|---|
name | yes | The pack must have a nonempty name. Verdictan stores it as pack_name. |
version | yes | The pack must have a semantic version. Verdictan stores it as config_version. |
enabled | yes | A value of false excludes the complete pack from the loaded runtime. |
id | metadata | This optional identifier has a maximum length of 200 characters. |
author | metadata | This optional owner or team name has a maximum length of 200 characters. |
description | metadata | This optional description has a maximum length of 2,000 characters. |
tags | metadata | This optional string map supplies tags for the managed configuration resource. |
Important effects
The enabled field excludes the pack
This value disables the complete configuration when the gateway loads it:
pack:
name: disabled-pack
version: 1.0.0
enabled: false
The loader does not register chains, routes, providers, callbacks, test suites,
or pack side effects. It records local evidence with code pack.excluded and
cause pack.enabled=false.
Use the deployment workflow to select the specified pack. Use enabled: false
only when complete pack exclusion is the specified result.
Configuration fingerprint
Verdictan calculates the configuration fingerprint from the source file bytes before it parses the file.
config_sha256 = sha256_prefixed(policy-config.yaml bytes)
The fingerprint changes when one or more source bytes change. This includes changes to
pack.id, pack.version, comments, or whitespace.