Files
PandeyandGitHub d9bcbece50 feat(v1alpha1): jsonschema validation for casting (#107)
## Summary
- Wires schema-based validation of `casting.yaml` at config load time.
Schema is generated from the Go types via `swaggest/jsonschema-go`,
embedded as `api/v1alpha1/schema.json`, and validated post-merge with
`google/jsonschema-go`.
- Adds field-level rules: `required`, `enum`, `pattern` (DNS-1123 name,
JSON Pointer paths, OCI image), `minimum`/`minLength`/`minItems` on the
relevant fields. `additionalProperties:false` is set on every nested
type for the published schema.
- Replaces the loose string `Platform` / `Mode` / `Flavor` on
`TypeDeployment` with typed enums following the existing `*Kind`
pattern. Bad values now fail at unmarshal with a clear "invalid
deployment …" message.
- Drops `InfrastructureProvider` in favor of `Platform` — the cloud
subset (aws, gcp, azure) drives the Terraform IaC pipeline directly.
`ResolveProvider` collapses `PlatformECS → PlatformAWS`.
- Side cleanups bundled here: typed errors in `internal/errors` with
stacktrace capture (used by yamlconfig to wrap validation failures as
`TypeInvalidInput`), and removal of the custom pretty slog handler in
`internal/instrumentation` in favor of `slog.NewJSONHandler`.

## Test plan
- [ ] `make gen-schemas` is idempotent (CI's `schemas` job stays green).
- [ ] `go test ./...` passes locally.
- [ ] Every committed example casting (`docs/examples/**/casting.yaml`,
`docs/standalone/casting.yaml`) loads without error.
- [ ] Negative cases at config load: bad `apiVersion`, missing required
fields, unknown enum values for `kind` / `mode` / `flavor` / `platform`
/ patch `op`, non-JSON-Pointer patch paths, negative `replicas`,
`shards: 0`, malformed image refs — each fails with a `TypeInvalidInput`
error pointing at the offending location.
- [ ] `foundryctl forge` against
`docs/examples/docker/compose/casting.yaml` still produces the expected
pours.
2026-05-01 09:04:53 +05:30

87 lines
1.6 KiB
Go

package v1alpha1
import (
"encoding/json"
"errors"
"fmt"
"github.com/swaggest/jsonschema-go"
"go.yaml.in/yaml/v3"
)
var _ yaml.Marshaler = (*Mode)(nil)
var _ yaml.Unmarshaler = (*Mode)(nil)
var _ json.Marshaler = (*Mode)(nil)
var _ json.Unmarshaler = (*Mode)(nil)
var _ fmt.Stringer = (*Mode)(nil)
var _ jsonschema.Enum = (*Mode)(nil)
var (
ModeDocker Mode = Mode{s: "docker"}
ModeSystemd Mode = Mode{s: "systemd"}
ModeKubernetes Mode = Mode{s: "kubernetes"}
ModeEC2 Mode = Mode{s: "ec2"}
)
type Mode struct {
s string
}
func (mode Mode) String() string {
return mode.s
}
func Modes() []Mode {
return []Mode{ModeDocker, ModeSystemd, ModeKubernetes, ModeEC2}
}
func (mode Mode) MarshalJSON() ([]byte, error) {
return json.Marshal(mode.String())
}
func (mode *Mode) UnmarshalJSON(text []byte) error {
var str string
if err := json.Unmarshal(text, &str); err != nil {
return err
}
return mode.UnmarshalText([]byte(str))
}
func (mode *Mode) UnmarshalText(text []byte) error {
for _, available := range Modes() {
if available.String() == string(text) {
*mode = available
return nil
}
}
if len(text) == 0 {
*mode = Mode{s: ""}
return nil
}
return errors.New("invalid deployment mode: " + string(text))
}
func (mode Mode) MarshalText() ([]byte, error) {
return []byte(mode.String()), nil
}
func (mode *Mode) UnmarshalYAML(node *yaml.Node) error {
return mode.UnmarshalText([]byte(node.Value))
}
func (mode Mode) MarshalYAML() (any, error) {
return mode.String(), nil
}
func (mode Mode) Enum() []any {
modes := []any{}
for _, mode := range Modes() {
modes = append(modes, mode.String())
}
return modes
}