@ontrails/config 1.0.0-beta.12

package/dist/generate/json-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema.js","sourceRoot":"","sources":["../../src/generate/json-schema.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+export { appConfig, type AppConfig, type AppConfigExplainOptions, type AppConfigOptions, type ConfigFormat, type ResolveOptions, } from './app-config.js';
+export { collectConfigMeta } from './collect.js';
+export { collectServiceConfigs, type ServiceConfigEntry } from './compose.js';
+export { defineConfig, type DefineConfigOptions } from './define-config.js';
+export { describeConfig, type FieldDescription } from './describe.js';
+export { checkConfig, type CheckResult, type ConfigDiagnostic, } from './doctor.js';
+export { env, secret, deprecated, type ConfigFieldMeta } from './extensions.js';
+export { explainConfig, type ExplainConfigOptions, type ProvenanceEntry, } from './explain.js';
+export { generateEnvExample, generateExample, generateJsonSchema, } from './generate/index.js';
+export { configLayer } from './config-layer.js';
+export { configService } from './config-service.js';
+export { clearConfigState, type ConfigState, getConfigState, registerConfigState, } from './registry.js';
+export { deepMerge } from './merge.js';
+export { configRef, isConfigRef, type ConfigRef } from './ref.js';
+export { resolveConfig, type ResolveConfigOptions } from './resolve.js';
+export { configCheck } from './trails/config-check.js';
+export { configDescribe } from './trails/config-describe.js';
+export { configExplain } from './trails/config-explain.js';
+export { configInit } from './trails/config-init.js';
+export { ensureWorkspace } from './workspace.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,KAAK,SAAS,EACd,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,cAAc,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EACL,WAAW,EACX,KAAK,WAAW,EAChB,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,eAAe,GACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EACL,gBAAgB,EAChB,KAAK,WAAW,EAChB,cAAc,EACd,mBAAmB,GACpB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+export { appConfig, } from './app-config.js';
+export { collectConfigMeta } from './collect.js';
+export { collectServiceConfigs } from './compose.js';
+export { defineConfig } from './define-config.js';
+export { describeConfig } from './describe.js';
+export { checkConfig, } from './doctor.js';
+export { env, secret, deprecated } from './extensions.js';
+export { explainConfig, } from './explain.js';
+export { generateEnvExample, generateExample, generateJsonSchema, } from './generate/index.js';
+export { configLayer } from './config-layer.js';
+export { configService } from './config-service.js';
+export { clearConfigState, getConfigState, registerConfigState, } from './registry.js';
+export { deepMerge } from './merge.js';
+export { configRef, isConfigRef } from './ref.js';
+export { resolveConfig } from './resolve.js';
+export { configCheck } from './trails/config-check.js';
+export { configDescribe } from './trails/config-describe.js';
+export { configExplain } from './trails/config-explain.js';
+export { configInit } from './trails/config-init.js';
+export { ensureWorkspace } from './workspace.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,GAMV,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAA2B,MAAM,cAAc,CAAC;AAC9E,OAAO,EAAE,YAAY,EAA4B,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAyB,MAAM,eAAe,CAAC;AACtE,OAAO,EACL,WAAW,GAGZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAwB,MAAM,iBAAiB,CAAC;AAChF,OAAO,EACL,aAAa,GAGd,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EACL,gBAAgB,EAEhB,cAAc,EACd,mBAAmB,GACpB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAkB,MAAM,UAAU,CAAC;AAClE,OAAO,EAAE,aAAa,EAA6B,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/merge.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Simple recursive deep merge for config objects.
+ *
+ * - Objects merge recursively
+ * - Arrays replace (no concatenation)
+ * - Primitives replace
+ * - `undefined` values in source are skipped
+ */
+/**
+ * Deep-merge `source` into `target`, returning a new object.
+ *
+ * Does not mutate either input. Undefined values in source are skipped,
+ * preserving the target's value at that key.
+ */
+export declare const deepMerge: (target: Record<string, unknown>, source: Record<string, unknown>) => Record<string, unknown>;
+//# sourceMappingURL=merge.d.ts.map

package/dist/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../src/merge.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GACpB,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAiBxB,CAAC"}

package/dist/merge.js

@@ -0,0 +1,34 @@
+/**
+ * Simple recursive deep merge for config objects.
+ *
+ * - Objects merge recursively
+ * - Arrays replace (no concatenation)
+ * - Primitives replace
+ * - `undefined` values in source are skipped
+ */
+/** Check whether a value is a plain object (not array, null, or class instance). */
+const isPlainObject = (value) => typeof value === 'object' &&
+    value !== null &&
+    !Array.isArray(value) &&
+    Object.getPrototypeOf(value) === Object.prototype;
+/**
+ * Deep-merge `source` into `target`, returning a new object.
+ *
+ * Does not mutate either input. Undefined values in source are skipped,
+ * preserving the target's value at that key.
+ */
+export const deepMerge = (target, source) => {
+    const result = { ...target };
+    for (const [key, sourceValue] of Object.entries(source)) {
+        if (sourceValue === undefined) {
+            continue;
+        }
+        const targetValue = result[key];
+        result[key] =
+            isPlainObject(targetValue) && isPlainObject(sourceValue)
+                ? deepMerge(targetValue, sourceValue)
+                : sourceValue;
+    }
+    return result;
+};
+//# sourceMappingURL=merge.js.map

package/dist/merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.js","sourceRoot":"","sources":["../src/merge.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,oFAAoF;AACpF,MAAM,aAAa,GAAG,CAAC,KAAc,EAAoC,EAAE,CACzE,OAAO,KAAK,KAAK,QAAQ;IACzB,KAAK,KAAK,IAAI;IACd,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;IACrB,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,SAAS,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,MAA+B,EAC/B,MAA+B,EACN,EAAE;IAC3B,MAAM,MAAM,GAA4B,EAAE,GAAG,MAAM,EAAE,CAAC;IAEtD,KAAK,MAAM,CAAC,GAAG,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACxD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,SAAS;QACX,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAEhC,MAAM,CAAC,GAAG,CAAC;YACT,aAAa,CAAC,WAAW,CAAC,IAAI,aAAa,CAAC,WAAW,CAAC;gBACtD,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE,WAAW,CAAC;gBACrC,CAAC,CAAC,WAAW,CAAC;IACpB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

package/dist/ref.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Lazy config reference markers for trail input defaults.
+ *
+ * A `ConfigRef` is a marker object that can be embedded as a trail input
+ * default. The resolution stack detects it at invocation time and replaces
+ * it with the live config value at the given path.
+ */
+/** Marker object representing a lazy reference to a config field. */
+export interface ConfigRef {
+    readonly __configRef: true;
+    readonly path: string;
+}
+/**
+ * Create a lazy reference to a config field for use as a trail input default.
+ *
+ * The reference is resolved at invocation time, not at declaration time.
+ *
+ */
+export declare const configRef: (path: string) => ConfigRef;
+/**
+ * Type guard: detect whether an unknown value is a `ConfigRef` marker.
+ */
+export declare const isConfigRef: (value?: unknown) => value is ConfigRef;
+//# sourceMappingURL=ref.d.ts.map

package/dist/ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref.d.ts","sourceRoot":"","sources":["../src/ref.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,qEAAqE;AACrE,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,KAAG,SAGvC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,QAAQ,OAAO,KAAG,KAAK,IAAI,SAIK,CAAC"}

package/dist/ref.js

@@ -0,0 +1,25 @@
+/**
+ * Lazy config reference markers for trail input defaults.
+ *
+ * A `ConfigRef` is a marker object that can be embedded as a trail input
+ * default. The resolution stack detects it at invocation time and replaces
+ * it with the live config value at the given path.
+ */
+/**
+ * Create a lazy reference to a config field for use as a trail input default.
+ *
+ * The reference is resolved at invocation time, not at declaration time.
+ *
+ */
+export const configRef = (path) => ({
+    __configRef: true,
+    path,
+});
+/**
+ * Type guard: detect whether an unknown value is a `ConfigRef` marker.
+ */
+export const isConfigRef = (value) => typeof value === 'object' &&
+    value !== null &&
+    '__configRef' in value &&
+    value['__configRef'] === true;
+//# sourceMappingURL=ref.js.map

package/dist/ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref.js","sourceRoot":"","sources":["../src/ref.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAY,EAAa,EAAE,CAAC,CAAC;IACrD,WAAW,EAAE,IAAI;IACjB,IAAI;CACL,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAe,EAAsB,EAAE,CACjE,OAAO,KAAK,KAAK,QAAQ;IACzB,KAAK,KAAK,IAAI;IACd,aAAa,IAAI,KAAK;IACrB,KAAiC,CAAC,aAAa,CAAC,KAAK,IAAI,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Module-level config state registry.
+ *
+ * Config is resolved once at bootstrap (two-phase init per ADR-010) and
+ * registered here so `configService` can surface it to trails. This is
+ * a process-level singleton — config resolution is inherently global.
+ */
+import type { z } from 'zod';
+/** Resolved config state carrying the schema and all layer values. */
+export interface ConfigState {
+    readonly schema: z.ZodObject<Record<string, z.ZodType>>;
+    readonly resolved: Record<string, unknown>;
+    readonly base?: Record<string, unknown>;
+    readonly loadout?: Record<string, unknown>;
+    readonly local?: Record<string, unknown>;
+    readonly env?: Record<string, string | undefined>;
+}
+/** Register resolved config state at bootstrap. */
+export declare const registerConfigState: (state: ConfigState) => void;
+/** Read the registered config state. Returns `undefined` before registration. */
+export declare const getConfigState: () => ConfigState | undefined;
+/** Clear registered state. Primarily useful in tests. */
+export declare const clearConfigState: () => void;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,sEAAsE;AACtE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACxD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CACnD;AAID,mDAAmD;AACnD,eAAO,MAAM,mBAAmB,GAAI,OAAO,WAAW,KAAG,IAExD,CAAC;AAEF,iFAAiF;AACjF,eAAO,MAAM,cAAc,QAAO,WAAW,GAAG,SAAoB,CAAC;AAErE,yDAAyD;AACzD,eAAO,MAAM,gBAAgB,QAAO,IAEnC,CAAC"}

package/dist/registry.js

@@ -0,0 +1,12 @@
+let current;
+/** Register resolved config state at bootstrap. */
+export const registerConfigState = (state) => {
+    current = state;
+};
+/** Read the registered config state. Returns `undefined` before registration. */
+export const getConfigState = () => current;
+/** Clear registered state. Primarily useful in tests. */
+export const clearConfigState = () => {
+    current = undefined;
+};
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAmBA,IAAI,OAAgC,CAAC;AAErC,mDAAmD;AACnD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAAkB,EAAQ,EAAE;IAC9D,OAAO,GAAG,KAAK,CAAC;AAClB,CAAC,CAAC;AAEF,iFAAiF;AACjF,MAAM,CAAC,MAAM,cAAc,GAAG,GAA4B,EAAE,CAAC,OAAO,CAAC;AAErE,yDAAyD;AACzD,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAS,EAAE;IACzC,OAAO,GAAG,SAAS,CAAC;AACtB,CAAC,CAAC"}

package/dist/resolve.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Config resolution engine — merges config from multiple sources through
+ * a deterministic stack: defaults → base → loadout → local → env.
+ */
+import type { z } from 'zod';
+import { Result } from '@ontrails/core';
+/** Options for resolving config through the full stack. */
+export interface ResolveConfigOptions<T extends z.ZodType> {
+    readonly schema: T;
+    readonly base?: Record<string, unknown> | undefined;
+    readonly loadouts?: Record<string, Record<string, unknown>> | undefined;
+    readonly loadout?: string | undefined;
+    readonly localOverrides?: Record<string, unknown> | undefined;
+    readonly env?: Record<string, string | undefined> | undefined;
+}
+/**
+ * Resolve config through the full stack: defaults → base → loadout → local → env.
+ * Returns `Result.ok` with the validated config, or `Result.err` on validation failure.
+ */
+export declare const resolveConfig: <T extends z.ZodType>(options: ResolveConfigOptions<T>) => Result<z.infer<T>, Error>;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAUxC,2DAA2D;AAC3D,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO;IACvD,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACnB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IACxE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC9D,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;CAC/D;AAkOD;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAC/C,SAAS,oBAAoB,CAAC,CAAC,CAAC,KAC/B,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAkB1B,CAAC"}

package/dist/resolve.js

@@ -0,0 +1,174 @@
+/**
+ * Config resolution engine — merges config from multiple sources through
+ * a deterministic stack: defaults → base → loadout → local → env.
+ */
+import { Result } from '@ontrails/core';
+import { collectConfigMeta } from './collect.js';
+import { deepMerge } from './merge.js';
+import { zodDef } from './zod-utils.js';
+// ---------------------------------------------------------------------------
+// Env coercion helpers (defined before consumers)
+// ---------------------------------------------------------------------------
+/** Boolean string values we accept from environment variables. */
+const BOOL_TRUE = new Set(['true', '1']);
+const BOOL_FALSE = new Set(['false', '0']);
+/** Primitive type names we can coerce env strings into. */
+const PRIMITIVE_TYPES = new Set(['number', 'boolean', 'string']);
+/** Try to advance one level through a Zod wrapper, returning the inner type or undefined. */
+const unwrapOne = (schema) => {
+    const def = zodDef(schema);
+    return {
+        inner: def['innerType'],
+        typeName: def['type'],
+    };
+};
+/** Unwrap ZodDefault / ZodOptional / ZodNullable to find the base type name. */
+const resolveBaseTypeName = (schema) => {
+    let current = schema;
+    for (let depth = 0; depth < 10; depth += 1) {
+        const { typeName, inner } = unwrapOne(current);
+        if (typeName && PRIMITIVE_TYPES.has(typeName)) {
+            return typeName;
+        }
+        if (!inner) {
+            break;
+        }
+        current = inner;
+    }
+    return 'string';
+};
+/** Coerce a boolean env string. Returns the original string if unrecognized. */
+const coerceBooleanEnv = (raw) => {
+    if (BOOL_TRUE.has(raw)) {
+        return true;
+    }
+    if (BOOL_FALSE.has(raw)) {
+        return false;
+    }
+    return raw;
+};
+/** Coerce env var lookup table keyed by base type name. */
+const ENV_COERCERS = {
+    boolean: coerceBooleanEnv,
+    number: Number,
+};
+/** Coerce a string env value to the type expected by the schema field. */
+const coerceEnvValue = (raw, schema) => {
+    const coercer = ENV_COERCERS[resolveBaseTypeName(schema)];
+    return coercer ? coercer(raw) : raw;
+};
+// ---------------------------------------------------------------------------
+// Path utilities
+// ---------------------------------------------------------------------------
+/** Navigate one step of a nested object, creating an intermediate if needed. */
+const navigateOrCreate = (current, key) => {
+    const next = current[key];
+    if (typeof next === 'object' && next !== null && !Array.isArray(next)) {
+        return next;
+    }
+    const nested = {};
+    current[key] = nested;
+    return nested;
+};
+/** Ensure a nested path exists in an object, creating intermediates as needed. */
+const ensurePath = (obj, parts) => {
+    let current = obj;
+    for (const part of parts) {
+        current = navigateOrCreate(current, part);
+    }
+    return current;
+};
+/** Set a value at a dot-separated path in a plain object. */
+const setAtPath = (obj, path, value) => {
+    const parts = path.split('.');
+    const parent = ensurePath(obj, parts.slice(0, -1));
+    parent[parts.at(-1)] = value;
+};
+/** Resolve one step of a Zod shape walk: find the field schema for a key. */
+const resolveShapeStep = (current, key) => {
+    const shape = zodDef(current)['shape'];
+    return shape?.[key];
+};
+/** Walk a Zod schema shape to find the field at a dot-separated path. */
+const getFieldSchema = (schema, path) => {
+    let current = schema;
+    for (const part of path.split('.')) {
+        const next = resolveShapeStep(current, part);
+        if (!next) {
+            return undefined;
+        }
+        current = next;
+    }
+    return current;
+};
+// ---------------------------------------------------------------------------
+// Env overlay
+// ---------------------------------------------------------------------------
+/** Coerce and set a single env override into the result object. */
+const applyOneEnvOverride = (result, schema, path, envValue) => {
+    const fieldSchema = getFieldSchema(schema, path);
+    const coerced = fieldSchema
+        ? coerceEnvValue(envValue, fieldSchema)
+        : envValue;
+    setAtPath(result, path, coerced);
+};
+/** Resolve a single env binding: look up the var, apply if present. */
+const resolveEnvBinding = (result, schema, path, envVar, envVars) => {
+    const envValue = envVars[envVar];
+    if (envValue !== undefined) {
+        applyOneEnvOverride(result, schema, path, envValue);
+    }
+};
+/** Apply env var overrides based on schema metadata. */
+const applyEnvOverrides = (merged, schema, envVars) => {
+    if (zodDef(schema)['type'] !== 'object') {
+        return merged;
+    }
+    const meta = collectConfigMeta(schema);
+    const result = deepMerge({}, merged);
+    for (const [path, fieldMeta] of meta) {
+        if (fieldMeta.env) {
+            resolveEnvBinding(result, schema, path, fieldMeta.env, envVars);
+        }
+    }
+    return result;
+};
+// ---------------------------------------------------------------------------
+// Merge pipeline
+// ---------------------------------------------------------------------------
+/** Apply the layered merge: base → loadout → local overrides. */
+const mergeLayers = (base, loadouts, loadout, localOverrides) => {
+    let merged = {};
+    if (base) {
+        merged = deepMerge(merged, base);
+    }
+    const selected = loadout && loadouts ? loadouts[loadout] : undefined;
+    if (selected) {
+        merged = deepMerge(merged, selected);
+    }
+    if (localOverrides) {
+        merged = deepMerge(merged, localOverrides);
+    }
+    return merged;
+};
+/** Format Zod issues into a human-readable error message. */
+const formatValidationError = (issues) => `Config validation failed: ${issues.map((i) => `${String(i.path.join('.'))}: ${i.message}`).join(', ')}`;
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Resolve config through the full stack: defaults → base → loadout → local → env.
+ * Returns `Result.ok` with the validated config, or `Result.err` on validation failure.
+ */
+export const resolveConfig = (options) => {
+    let merged = mergeLayers(options.base, options.loadouts, options.loadout, options.localOverrides);
+    if (options.env) {
+        merged = applyEnvOverrides(merged, options.schema, options.env);
+    }
+    const parsed = options.schema.safeParse(merged);
+    if (parsed.success) {
+        return Result.ok(parsed.data);
+    }
+    return Result.err(new Error(formatValidationError(parsed.error.issues)));
+};
+//# sourceMappingURL=resolve.js.map

package/dist/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"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"}

package/dist/secret-heuristics.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Heuristic detection of secret env var names.
+ *
+ * Matches common suffixes like `_SECRET`, `_TOKEN`, `_KEY`, `_PASSWORD`,
+ * and `_CREDENTIALS` so that generated `.env.example` files and provenance
+ * output can redact likely-secret values even without explicit `secret()`.
+ */
+/** Return true when `envName` looks like it holds a secret value. */
+export declare const isLikelySecret: (envName: string) => boolean;
+//# sourceMappingURL=secret-heuristics.d.ts.map

package/dist/secret-heuristics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secret-heuristics.d.ts","sourceRoot":"","sources":["../src/secret-heuristics.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,qEAAqE;AACrE,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,KAAG,OACnB,CAAC"}

package/dist/secret-heuristics.js

@@ -0,0 +1,11 @@
+/**
+ * Heuristic detection of secret env var names.
+ *
+ * Matches common suffixes like `_SECRET`, `_TOKEN`, `_KEY`, `_PASSWORD`,
+ * and `_CREDENTIALS` so that generated `.env.example` files and provenance
+ * output can redact likely-secret values even without explicit `secret()`.
+ */
+const SECRET_PATTERN = /_SECRET$|_TOKEN$|_KEY$|_PASSWORD$|_CREDENTIALS$/i;
+/** Return true when `envName` looks like it holds a secret value. */
+export const isLikelySecret = (envName) => SECRET_PATTERN.test(envName);
+//# sourceMappingURL=secret-heuristics.js.map

package/dist/secret-heuristics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secret-heuristics.js","sourceRoot":"","sources":["../src/secret-heuristics.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,cAAc,GAAG,kDAAkD,CAAC;AAE1E,qEAAqE;AACrE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAe,EAAW,EAAE,CACzD,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC"}

package/dist/trails/config-check.d.ts

@@ -0,0 +1,11 @@
+export declare const configCheck: import("@ontrails/core").Trail<{
+    values: Record<string, unknown>;
+}, {
+    diagnostics: {
+        message: string;
+        path: string;
+        status: "default" | "deprecated" | "valid" | "missing" | "invalid";
+    }[];
+    valid: boolean;
+}>;
+//# sourceMappingURL=config-check.d.ts.map

package/dist/trails/config-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-check.d.ts","sourceRoot":"","sources":["../../src/trails/config-check.ts"],"names":[],"mappings":"AAiCA,eAAO,MAAM,WAAW;;;;;;;;;EA0BtB,CAAC"}

package/dist/trails/config-check.js

@@ -0,0 +1,53 @@
+/**
+ * Infrastructure trail that validates config values against a schema.
+ *
+ * Returns structured diagnostics indicating which fields are valid,
+ * missing, invalid, deprecated, or using defaults.
+ */
+import { Result, trail } from '@ontrails/core';
+import { z } from 'zod';
+import { configService } from '../config-service.js';
+import { checkConfig } from '../doctor.js';
+import { deepMerge } from '../merge.js';
+const diagnosticSchema = z.object({
+    message: z.string(),
+    path: z.string(),
+    status: z.enum(['valid', 'missing', 'invalid', 'deprecated', 'default']),
+});
+const outputSchema = z.object({
+    diagnostics: z.array(diagnosticSchema),
+    valid: z.boolean(),
+});
+/** Merge input values on top of resolved config values. */
+const mergeValues = (resolved, overrides) => {
+    const hasOverrides = Object.keys(overrides).length > 0;
+    return hasOverrides ? deepMerge(resolved, overrides) : resolved;
+};
+export const configCheck = trail('config.check', {
+    examples: [
+        {
+            input: {},
+            name: 'Check current config',
+        },
+    ],
+    input: z.object({
+        values: z
+            .record(z.string(), z.unknown())
+            .describe('Config values to check (merged with resolved)')
+            .default({}),
+    }),
+    intent: 'read',
+    metadata: { category: 'infrastructure' },
+    output: outputSchema,
+    run: (input, ctx) => {
+        const state = configService.from(ctx);
+        const effective = mergeValues(state.resolved, input.values);
+        const checked = checkConfig(state.schema, effective);
+        return Result.ok({
+            diagnostics: [...checked.diagnostics],
+            valid: checked.valid,
+        });
+    },
+    services: [configService],
+});
+//# sourceMappingURL=config-check.js.map

package/dist/trails/config-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-check.js","sourceRoot":"","sources":["../../src/trails/config-check.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC;CACzE,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC;IACtC,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;CACnB,CAAC,CAAC;AAEH,2DAA2D;AAC3D,MAAM,WAAW,GAAG,CAClB,QAAiC,EACjC,SAAkC,EACT,EAAE;IAC3B,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IACvD,OAAO,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AAClE,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,CAAC,cAAc,EAAE;IAC/C,QAAQ,EAAE;QACR;YACE,KAAK,EAAE,EAAE;YACT,IAAI,EAAE,sBAAsB;SAC7B;KACF;IACD,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,MAAM,EAAE,CAAC;aACN,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;aAC/B,QAAQ,CAAC,+CAA+C,CAAC;aACzD,OAAO,CAAC,EAAE,CAAC;KACf,CAAC;IACF,MAAM,EAAE,MAAM;IACd,QAAQ,EAAE,EAAE,QAAQ,EAAE,gBAAgB,EAAE;IACxC,MAAM,EAAE,YAAY;IACpB,GAAG,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QAClB,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAC5D,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACrD,OAAO,MAAM,CAAC,EAAE,CAAC;YACf,WAAW,EAAE,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC;YACrC,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAC;IACL,CAAC;IACD,QAAQ,EAAE,CAAC,aAAa,CAAC;CAC1B,CAAC,CAAC"}

package/dist/trails/config-describe.d.ts

@@ -0,0 +1,12 @@
+export declare const configDescribe: import("@ontrails/core").Trail<Record<string, never>, {
+    fields: {
+        path: string;
+        required: boolean;
+        type: string;
+        deprecated?: string | undefined;
+        description?: string | undefined;
+        env?: string | undefined;
+        secret?: boolean | undefined;
+    }[];
+}>;
+//# sourceMappingURL=config-describe.d.ts.map

package/dist/trails/config-describe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-describe.d.ts","sourceRoot":"","sources":["../../src/trails/config-describe.ts"],"names":[],"mappings":"AA0BA,eAAO,MAAM,cAAc;;;;;;;;;;EAiBzB,CAAC"}

package/dist/trails/config-describe.js

@@ -0,0 +1,41 @@
+/**
+ * Infrastructure trail that describes all config fields in a schema.
+ *
+ * Returns a structured catalog of field definitions suitable for
+ * CLI rendering or agent inspection.
+ */
+import { Result, trail } from '@ontrails/core';
+import { z } from 'zod';
+import { configService } from '../config-service.js';
+import { describeConfig } from '../describe.js';
+const fieldSchema = z.object({
+    deprecated: z.string().optional(),
+    description: z.string().optional(),
+    env: z.string().optional(),
+    path: z.string(),
+    required: z.boolean(),
+    secret: z.boolean().optional(),
+    type: z.string(),
+});
+const outputSchema = z.object({
+    fields: z.array(fieldSchema),
+});
+export const configDescribe = trail('config.describe', {
+    examples: [
+        {
+            input: {},
+            name: 'Describe all config fields',
+        },
+    ],
+    input: z.object({}),
+    intent: 'read',
+    metadata: { category: 'infrastructure' },
+    output: outputSchema,
+    run: (_input, ctx) => {
+        const state = configService.from(ctx);
+        const fields = describeConfig(state.schema);
+        return Result.ok({ fields: [...fields] });
+    },
+    services: [configService],
+});
+//# sourceMappingURL=config-describe.js.map

package/dist/trails/config-describe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-describe.js","sourceRoot":"","sources":["../../src/trails/config-describe.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;IACrB,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;CACjB,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC;CAC7B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAC,iBAAiB,EAAE;IACrD,QAAQ,EAAE;QACR;YACE,KAAK,EAAE,EAAE;YACT,IAAI,EAAE,4BAA4B;SACnC;KACF;IACD,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM;IACd,QAAQ,EAAE,EAAE,QAAQ,EAAE,gBAAgB,EAAE;IACxC,MAAM,EAAE,YAAY;IACpB,GAAG,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE;QACnB,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC5C,OAAO,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,QAAQ,EAAE,CAAC,aAAa,CAAC;CAC1B,CAAC,CAAC"}

package/dist/trails/config-explain.d.ts

@@ -0,0 +1,8 @@
+export declare const configExplain: import("@ontrails/core").Trail<{
+    path: string;
+}, {
+    entries: {
+        readonly path: string;
+    }[];
+}>;
+//# sourceMappingURL=config-explain.d.ts.map

package/dist/trails/config-explain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-explain.d.ts","sourceRoot":"","sources":["../../src/trails/config-explain.ts"],"names":[],"mappings":"AAoEA,eAAO,MAAM,aAAa;;;;uBAvCG,MAAM;;EA+DjC,CAAC"}