Description
The dispatch-repository configuration block uses kebab-case for its top-level key (dispatch-repository) but snake_case for its nested keys (event_type, allowed_repositories). This is inconsistent with the rest of the frontmatter which uses kebab-case uniformly.
Flagged by the Schema Consistency Checker (discussion #46731).
Suggested Changes
- Determine the correct long-term naming policy: add kebab-case aliases (
event-type, allowed-repositories) alongside the existing snake_case keys, OR rename and deprecate with a warning
- Update
pkg/workflow/dispatch_repository.go to accept both forms (with deprecation warning for snake_case) or rename
- Update
docs/src/content/docs/reference/frontmatter.md and frontmatter-full.md to document the canonical form
- Update schema in
pkg/parser/schemas/main_workflow_schema.json to reflect the preferred keys
- Add/update tests to cover both forms during the transition
Files Affected
pkg/workflow/dispatch_repository.go
pkg/parser/schemas/main_workflow_schema.json
docs/src/content/docs/reference/frontmatter.md
docs/src/content/docs/reference/frontmatter-full.md
Success Criteria
dispatch-repository nested keys follow kebab-case convention OR a clear exception is documented
- No breaking change for existing workflows using snake_case keys (backward-compatible aliases or deprecation warnings)
- Schema examples reflect the canonical form
- Docs are updated
Source
Extracted from [Schema Consistency] Schema Consistency Check - 2026-07-20
Priority
Medium — naming inconsistency creates authoring confusion; low-risk to fix with aliases
🔍 Task mining by Discussion Task Miner - Code Quality Improvement Agent · 44.8 AIC · ⌖ 7.87 AIC · ⊞ 7K · ◷
Description
The
dispatch-repositoryconfiguration block uses kebab-case for its top-level key (dispatch-repository) but snake_case for its nested keys (event_type,allowed_repositories). This is inconsistent with the rest of the frontmatter which uses kebab-case uniformly.Flagged by the Schema Consistency Checker (discussion #46731).
Suggested Changes
event-type,allowed-repositories) alongside the existing snake_case keys, OR rename and deprecate with a warningpkg/workflow/dispatch_repository.goto accept both forms (with deprecation warning for snake_case) or renamedocs/src/content/docs/reference/frontmatter.mdandfrontmatter-full.mdto document the canonical formpkg/parser/schemas/main_workflow_schema.jsonto reflect the preferred keysFiles Affected
pkg/workflow/dispatch_repository.gopkg/parser/schemas/main_workflow_schema.jsondocs/src/content/docs/reference/frontmatter.mddocs/src/content/docs/reference/frontmatter-full.mdSuccess Criteria
dispatch-repositorynested keys follow kebab-case convention OR a clear exception is documentedSource
Extracted from [Schema Consistency] Schema Consistency Check - 2026-07-20
Priority
Medium — naming inconsistency creates authoring confusion; low-risk to fix with aliases