core — Wagoe Docs

Foundation library providing shared utilities used by all other Wagoe libraries. Contains no shell layer — everything is pure functions.

Key namespaces

Namespace Purpose

Namespace	Purpose
`wagoe.core.validation`	Malli-based validation framework with error codes, messages, and "did you mean?" suggestions
`wagoe.core.validation.registry`	Central registry for validation rules across libraries
`wagoe.core.validation.coverage`	Validation coverage reporting and analysis
`wagoe.core.validation.snapshot`	Snapshot-based validation testing
`wagoe.core.utils.case-conversion`	kebab-case / snake_case / camelCase conversions
`wagoe.core.utils.type-conversion`	UUID, Instant, BigDecimal string conversions
`wagoe.core.utils.pii-redaction`	PII filtering for logs and error reports
`wagoe.core.utils.validation`	Value predicates for CLI arguments (`valid-output-format?`, `valid-uuid?`)
`wagoe.core.interceptor`	Interceptor pipeline runner (enter/leave/error phases)
`wagoe.core.interceptor-context`	Interceptor context creation and management
`wagoe.core.config.feature-flags`	Feature flag evaluation logic. Pure — the environment map is a parameter; `wagoe.platform.shell.feature-flags` is the shell wrapper that reads it

wagoe.core.validation

Malli-based validation framework with error codes, messages, and "did you mean?" suggestions

wagoe.core.validation.registry

Central registry for validation rules across libraries

wagoe.core.validation.coverage

Validation coverage reporting and analysis

wagoe.core.validation.snapshot

Snapshot-based validation testing

wagoe.core.utils.case-conversion

kebab-case / snake_case / camelCase conversions

wagoe.core.utils.type-conversion

UUID, Instant, BigDecimal string conversions

wagoe.core.utils.pii-redaction

PII filtering for logs and error reports

wagoe.core.utils.validation

Value predicates for CLI arguments (valid-output-format?, valid-uuid?)

wagoe.core.interceptor

Interceptor pipeline runner (enter/leave/error phases)

wagoe.core.interceptor-context

Interceptor context creation and management

wagoe.core.config.feature-flags

Feature flag evaluation logic. Pure — the environment map is a parameter; wagoe.platform.shell.feature-flags is the shell wrapper that reads it

Case conversion

The most commonly used utilities across the entire monorepo:

(require '[wagoe.core.utils.case-conversion :as cc])

;; Persistence boundary — DB record → Clojure entity
(cc/snake-case->kebab-case-map db-record)

;; Persistence boundary — Clojure entity → DB insert/update
(cc/kebab-case->snake-case-map entity)

;; HTTP boundary — Clojure entity → JSON response
(cc/kebab-case->camel-case-map entity)

;; HTTP boundary — JSON request → Clojure map
(cc/camel-case->kebab-case-map api-input)

Validation framework

(require '[wagoe.core.validation :as validation]
         '[malli.transform :as mt])

;; Decode, then validate. Both compilers are cached on the schema.
(let [data ((validation/decoder SomeSchema mt/string-transformer) input)]
  (if (validation/valid? SomeSchema data)
    data
    (validation/explain SomeSchema data)))

Interceptor pipeline

The interceptor system supports enter/leave/error phases, used by both HTTP and service layers:

(require '[wagoe.core.interceptor :as ic])

;; Enter phases run forward, leave phases run in reverse
(ic/run-pipeline initial-ctx [interceptor1 interceptor2 interceptor3])
;; Enter order:  int1 → int2 → int3
;; Leave order:  int3 → int2 → int1

Important conventions

All functions must be pure — no I/O, no logging, no side effects
This library has no ports.clj or shell/ — it’s entirely functional core
Only dependencies: org.clojure/clojure and metosin/malli
All other Wagoe libraries depend on core

Testing

clojure -M:test :core
clojure -M:test --focus-meta :unit   # All core tests are :unit