Skip to content

Fix YAML schema inconsistencies - #128

Merged
firecow merged 2 commits into
mainfrom
fix/yaml-schema-inconsistencies
May 10, 2026
Merged

Fix YAML schema inconsistencies#128
firecow merged 2 commits into
mainfrom
fix/yaml-schema-inconsistencies

Conversation

@firecow

@firecow firecow commented May 10, 2026

Copy link
Copy Markdown
Member

Summary

Three schema-vs-mapping inconsistencies surfaced while reviewing #127.

  • examples/swarm-app.yml: stop_grace_period: 10 was 10ns. Bumped to 10000000000 # 10s (nanoseconds) to match the convention Fix health_check duration types and example values #109 established for health_check durations.
  • mounts.readonlymounts.read_only — every other multi-word field in the schema is snake_case (stop_signal, target_port, start_interval, …); readonly was the only outlier. Docker Compose itself uses read_only. Breaking for any consumer still on readonly:.
  • ConfigReference.File.Mode was hardcoded to 0 (= chmod 000). Set to 0o444 to match Docker Compose's documented default. Existing deployments will show a one-time diff until redeployed.

Test plan

  • tsc clean
  • eslint . clean
  • jest passes

- examples: stop_grace_period was 10 (= 10ns); change to 10000000000
  with "10s (nanoseconds)" comment to match the convention #109
  established for health_check durations.
- mounts.readonly -> mounts.read_only for snake_case consistency
  with the rest of the schema and Docker Compose. BREAKING.
- Configs File.Mode 0 -> 0o444 to match Docker Compose's default
  for config file permissions.
@firecow firecow self-assigned this May 10, 2026
@firecow
firecow merged commit 0a18a01 into main May 10, 2026
4 checks passed
@firecow
firecow deleted the fix/yaml-schema-inconsistencies branch May 10, 2026 08:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

1 participant