lorenz 0.1.5 → 0.1.7

package/node_modules/@lorenz/flags/dist/manifest.js

@@ -0,0 +1,137 @@
+import { z } from "zod";
+import { coercedBoolean, coercedFloat, coercedInt } from "./coerce.js";
+import { getDefaultFlags } from "./default.js";
+import { flagValueErrorMessage } from "./errors.js";
+function refinedNumber(base, config) {
+    if (!config.refine)
+        return base;
+    const refine = config.refine;
+    return base.refine(refine, { message: config.refineMessage ?? "is invalid" });
+}
+/** Builders for the five flag kinds. Each returns a {@link FlagDef} whose schema output is the
+ *  flag's value type; numeric and boolean schemas coerce string inputs from env/CLI/file. */
+export const flag = {
+    string(config) {
+        return {
+            kind: "string",
+            schema: z.string(),
+            default: config.default,
+            description: config.description,
+            deprecation: config.deprecation,
+            envName: config.envName,
+        };
+    },
+    int(config) {
+        return {
+            kind: "int",
+            schema: refinedNumber(coercedInt, config),
+            default: config.default,
+            description: config.description,
+            deprecation: config.deprecation,
+            envName: config.envName,
+        };
+    },
+    float(config) {
+        return {
+            kind: "float",
+            schema: refinedNumber(coercedFloat, config),
+            default: config.default,
+            description: config.description,
+            deprecation: config.deprecation,
+            envName: config.envName,
+        };
+    },
+    bool(config) {
+        return {
+            kind: "bool",
+            schema: coercedBoolean,
+            default: config.default,
+            description: config.description,
+            deprecation: config.deprecation,
+            envName: config.envName,
+        };
+    },
+    enum(config) {
+        // The return type is inferred from the actual `z.enum(values)` call, so `FlagValue<thisDef>`
+        // narrows to the exact literal union rather than a hand-asserted type.
+        const schema = z.enum(config.values);
+        return {
+            kind: "enum",
+            schema,
+            default: config.default,
+            description: config.description,
+            deprecation: config.deprecation,
+            values: config.values,
+            envName: config.envName,
+        };
+    },
+};
+export function feature(config) {
+    return config;
+}
+// Keys are lower_snake_case dotted segments only, which keeps the env-var transform lossless. The
+// rule is enforced at module load so a stray camelCase key fails fast in CI, not at daemon start.
+const SNAKE_KEY = /^[a-z0-9]+(?:_[a-z0-9]+)*(?:\.[a-z0-9]+(?:_[a-z0-9]+)*)*$/;
+function assertSnakeKeys(keys, what) {
+    for (const key of keys) {
+        if (!SNAKE_KEY.test(key)) {
+            throw new Error(`@lorenz/flags: ${what} key \`${key}\` must be lower_snake_case dotted ` +
+                `(e.g. scheduler.batch_size); camelCase is not allowed.`);
+        }
+    }
+}
+export function defineFlags(flags) {
+    assertSnakeKeys(Object.keys(flags), "flag");
+    return flags;
+}
+export function defineFeatures(_flags, features) {
+    assertSnakeKeys(Object.keys(features), "feature");
+    return features;
+}
+/** Scalar-only value set, so reference identity via `Object.is` is correct and obvious. */
+export function presetValueEqual(a, b) {
+    return Object.is(a, b);
+}
+/**
+ * Validate a manifest once at module load: every flag default parses, and every preset references a
+ * known flag with a valid value. Two features presetting the same flag to differing values is
+ * intentionally allowed (legal for mutually-exclusive features); that conflict is authoritative only
+ * over the actually-enabled set at resolve time.
+ */
+export function validateManifest(manifest) {
+    const errors = [];
+    for (const [key, def] of Object.entries(manifest.flags)) {
+        const result = def.schema.safeParse(def.default);
+        if (!result.success) {
+            errors.push(`flag \`${key}\` default is invalid: ${flagValueErrorMessage(result.error, def)}`);
+        }
+    }
+    for (const [featureName, featureDef] of Object.entries(manifest.features)) {
+        for (const [flagKey, value] of Object.entries(featureDef.preset)) {
+            const flagDef = manifest.flags[flagKey];
+            if (!flagDef) {
+                errors.push(`feature \`${featureName}\` presets unknown flag \`${flagKey}\``);
+                continue;
+            }
+            const result = flagDef.schema.safeParse(value);
+            if (!result.success) {
+                errors.push(`feature \`${featureName}\` presets \`${flagKey}\` to an invalid value: ${flagValueErrorMessage(result.error, flagDef)}`);
+            }
+        }
+    }
+    if (errors.length > 0) {
+        throw new Error(`@lorenz/flags manifest is invalid:\n  - ${errors.join("\n  - ")}`);
+    }
+}
+/**
+ * Bind a manifest to typed ambient accessors. Called once by the manifest-owning module; the rest
+ * of the engine imports the returned `getFlags`/`flag`, so ambient reads are as well-typed as the
+ * manifest. The cast is sound because the composition root installs a snapshot built from the same
+ * manifest, and it is contained to this one factory.
+ */
+export function bindFlags(_manifest) {
+    return {
+        getFlags: () => getDefaultFlags(),
+    };
+}
+//# sourceMappingURL=manifest.js.map

package/node_modules/@lorenz/flags/dist/manifest.js.map

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

package/node_modules/@lorenz/flags/dist/resolve.d.ts

@@ -0,0 +1,8 @@
+import type { FeatureDef, FlagManifest, FlagMap, FlagsSnapshot, RawLayers, ResolveOptions } from "./types.js";
+/**
+ * Fold the CLI, file, and env layers, plus enabled-feature presets and manifest defaults, into one
+ * frozen snapshot. All problems aggregate into a single thrown error (collect-all). Deprecation
+ * warnings are staged during resolution and committed only on success.
+ */
+export declare function resolveFlags<F extends FlagMap, Features extends Record<string, FeatureDef>>(manifest: FlagManifest<F, Features>, layers: RawLayers, options?: ResolveOptions): FlagsSnapshot<F, Features>;
+//# sourceMappingURL=resolve.d.ts.map

package/node_modules/@lorenz/flags/dist/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,UAAU,EAIV,YAAY,EACZ,OAAO,EACP,aAAa,EAEb,SAAS,EACT,cAAc,EACf,MAAM,YAAY,CAAC;AAWpB;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,OAAO,EAAE,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,EACzF,QAAQ,EAAE,YAAY,CAAC,CAAC,EAAE,QAAQ,CAAC,EACnC,MAAM,EAAE,SAAS,EACjB,OAAO,GAAE,cAAmB,GAC3B,aAAa,CAAC,CAAC,EAAE,QAAQ,CAAC,CAoG5B"}

package/node_modules/@lorenz/flags/dist/resolve.js

@@ -0,0 +1,178 @@
+import { parseBoolToken } from "./coerce.js";
+import { collectFlagDeprecations, commitFlagDeprecations, stderrFlagWarn } from "./deprecations.js";
+import { FlagIssueCollector, flagValueErrorMessage } from "./errors.js";
+import { presetValueEqual } from "./manifest.js";
+/**
+ * Fold the CLI, file, and env layers, plus enabled-feature presets and manifest defaults, into one
+ * frozen snapshot. All problems aggregate into a single thrown error (collect-all). Deprecation
+ * warnings are staged during resolution and committed only on success.
+ */
+export function resolveFlags(manifest, layers, options = {}) {
+    const issues = new FlagIssueCollector();
+    for (const layer of [layers.cli, layers.file, layers.env]) {
+        if (layer.issues)
+            issues.addAll(layer.issues);
+    }
+    // Per-layer last-wins maps of explicit flag inputs (parsers guarantee known keys).
+    const cliFlags = lastWins(layers.cli.flags);
+    const fileFlags = lastWins(layers.file.flags);
+    const envFlags = lastWins(layers.env.flags);
+    const explicitFlagKeys = new Set([
+        ...cliFlags.keys(),
+        ...fileFlags.keys(),
+        ...envFlags.keys(),
+    ]);
+    // Feature enablement: the highest layer that mentions the feature wins; otherwise its default.
+    const enabled = new Map();
+    for (const [name, def] of Object.entries(manifest.features)) {
+        const chosen = featureInLayer(layers.cli.features, name) ??
+            featureInLayer(layers.file.features, name) ??
+            featureInLayer(layers.env.features, name);
+        enabled.set(name, chosen ? chosen.enabled : def.default);
+    }
+    // Preset composition over enabled features only, skipping any explicitly-set flag (an explicit
+    // setting both overrides and defuses a would-be conflict). Differing values from two enabled
+    // features that both reach this point is a hard, deterministic error.
+    const presetValue = new Map();
+    const presetOwner = new Map();
+    const conflicts = new Set();
+    for (const [featureName, featureDef] of Object.entries(manifest.features)) {
+        if (!enabled.get(featureName))
+            continue;
+        for (const [flagKey, value] of Object.entries(featureDef.preset)) {
+            if (explicitFlagKeys.has(flagKey))
+                continue;
+            if (presetValue.has(flagKey)) {
+                const existing = presetValue.get(flagKey);
+                if (!presetValueEqual(existing, value) && !conflicts.has(flagKey)) {
+                    conflicts.add(flagKey);
+                    issues.add({
+                        kind: "preset_conflict",
+                        message: `feature preset conflict on flag \`${flagKey}\`: feature \`${presetOwner.get(flagKey) ?? "?"}\` ` +
+                            `sets it to ${display(existing)} but feature \`${featureName}\` sets it to ${display(value)}. ` +
+                            `Enable only one, or set \`${flagKey}\` explicitly to override both.`,
+                    });
+                }
+                continue;
+            }
+            presetValue.set(flagKey, value);
+            presetOwner.set(flagKey, featureName);
+        }
+    }
+    // Flag value resolution: highest explicit layer -> enabled-feature preset -> manifest default.
+    const resolved = new Map();
+    for (const [key, def] of Object.entries(manifest.flags)) {
+        const explicit = cliFlags.get(key) ?? fileFlags.get(key) ?? envFlags.get(key);
+        if (explicit) {
+            const outcome = parseFlagValue(def, explicit.rawValue);
+            if (outcome.ok)
+                resolved.set(key, { value: outcome.value, source: explicit.source });
+            else
+                issues.add({
+                    kind: "invalid_value",
+                    message: `invalid value for ${explicit.origin}: ${outcome.message}`,
+                });
+            continue;
+        }
+        if (presetValue.has(key) && !conflicts.has(key)) {
+            // Preset values were validated at manifest load; re-validate defensively against the schema.
+            const outcome = parseFlagValue(def, presetValue.get(key));
+            if (outcome.ok)
+                resolved.set(key, { value: outcome.value, source: "feature" });
+            else
+                issues.add({
+                    kind: "invalid_value",
+                    message: `feature preset for flag \`${key}\` is invalid: ${outcome.message}`,
+                });
+            continue;
+        }
+        resolved.set(key, { value: def.default, source: "default" });
+    }
+    // Stage deprecation warnings for explicitly-set keys that resolved successfully. A deprecated flag
+    // set to an invalid value is absent from `resolved`, so it neither warns nor consumes a slot.
+    const explicitDeprecationKeys = [];
+    for (const key of explicitFlagKeys) {
+        if (resolved.get(key)?.source !== "default" && resolved.has(key)) {
+            explicitDeprecationKeys.push({ key, isFeature: false });
+        }
+    }
+    for (const name of explicitlyMentionedFeatures(layers)) {
+        explicitDeprecationKeys.push({ key: name, isFeature: true });
+    }
+    const staged = collectFlagDeprecations(explicitDeprecationKeys, manifest);
+    issues.throwIfAny();
+    commitFlagDeprecations(staged, options.warn ?? stderrFlagWarn);
+    return buildSnapshot(resolved, enabled);
+}
+function parseFlagValue(def, raw) {
+    // Boolean tokens are normalized (case-insensitive) before the schema sees them, so env/CLI/file
+    // booleans behave identically.
+    let input = raw;
+    if (def.kind === "bool") {
+        const parsed = parseBoolToken(raw);
+        if (parsed === undefined)
+            return { ok: false, message: "must be true or false" };
+        input = parsed;
+    }
+    const result = def.schema.safeParse(input);
+    if (result.success)
+        return { ok: true, value: result.data };
+    return { ok: false, message: flagValueErrorMessage(result.error, def) };
+}
+function buildSnapshot(resolved, enabled) {
+    const values = {};
+    const sources = new Map();
+    for (const [key, entry] of resolved) {
+        values[key] = entry.value;
+        sources.set(key, entry.source);
+    }
+    Object.freeze(values);
+    const snapshot = {
+        get: (key) => {
+            const name = key;
+            if (!Object.prototype.hasOwnProperty.call(values, name)) {
+                throw new Error(`unknown flag \`${name}\``);
+            }
+            return values[name];
+        },
+        feature: (key) => {
+            const value = enabled.get(key);
+            if (value === undefined)
+                throw new Error(`unknown feature \`${String(key)}\``);
+            return value;
+        },
+        values: values,
+        source: (key) => {
+            const value = sources.get(key);
+            if (value === undefined)
+                throw new Error(`unknown flag \`${String(key)}\``);
+            return value;
+        },
+    };
+    return Object.freeze(snapshot);
+}
+function lastWins(inputs) {
+    const map = new Map();
+    for (const input of inputs)
+        map.set(input.key, input);
+    return map;
+}
+function featureInLayer(inputs, name) {
+    let found;
+    for (const input of inputs)
+        if (input.name === name)
+            found = input;
+    return found;
+}
+function explicitlyMentionedFeatures(layers) {
+    const names = new Set();
+    for (const layer of [layers.cli, layers.file, layers.env]) {
+        for (const input of layer.features)
+            names.add(input.name);
+    }
+    return names;
+}
+function display(value) {
+    return typeof value === "string" ? JSON.stringify(value) : String(value);
+}
+//# sourceMappingURL=resolve.js.map

package/node_modules/@lorenz/flags/dist/resolve.js.map

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

package/node_modules/@lorenz/flags/dist/testing.d.ts

@@ -0,0 +1,19 @@
+import type { FeatureDef, FlagManifest, FlagMap, FlagOverrides, FlagsSnapshot } from "./types.js";
+/**
+ * Build a frozen snapshot from manifest defaults + feature presets + typed overrides, with no
+ * env/CLI/file scanning. Overrides enter at the explicit (CLI) band, so an explicit override beats
+ * an enabled feature preset exactly as in production. Routing through the real {@link resolveFlags}
+ * keeps a single precedence implementation. Deprecation warnings are suppressed (no-op `warn`).
+ */
+export declare function buildTestFlags<F extends FlagMap, Features extends Record<string, FeatureDef>>(manifest: FlagManifest<F, Features>, overrides?: FlagOverrides<F, Features>): FlagsSnapshot<F, Features>;
+/** Build a snapshot from overrides and install it as the default. Returns the snapshot. */
+export declare function setFlagsForTesting<F extends FlagMap, Features extends Record<string, FeatureDef>>(manifest: FlagManifest<F, Features>, overrides?: FlagOverrides<F, Features>): FlagsSnapshot<F, Features>;
+/**
+ * Run `fn` with a fresh snapshot installed as the default, restoring the prior install afterward
+ * (even on throw). Synchronous only: a module-level save/restore is not safe across `await` points
+ * if two scopes interleave.
+ */
+export declare function withFlags<F extends FlagMap, Features extends Record<string, FeatureDef>, T>(manifest: FlagManifest<F, Features>, overrides: FlagOverrides<F, Features>, fn: () => T): T;
+/** Clear the installed snapshot and re-arm once-per-process deprecation warnings. */
+export declare function resetFlags(): void;
+//# sourceMappingURL=testing.d.ts.map

package/node_modules/@lorenz/flags/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,UAAU,EAGV,YAAY,EACZ,OAAO,EACP,aAAa,EACb,aAAa,EAEd,MAAM,YAAY,CAAC;AAQpB;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,OAAO,EAAE,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,EAC3F,QAAQ,EAAE,YAAY,CAAC,CAAC,EAAE,QAAQ,CAAC,EACnC,SAAS,GAAE,aAAa,CAAC,CAAC,EAAE,QAAQ,CAAM,GACzC,aAAa,CAAC,CAAC,EAAE,QAAQ,CAAC,CAe5B;AAED,2FAA2F;AAC3F,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,OAAO,EAAE,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,EAC/F,QAAQ,EAAE,YAAY,CAAC,CAAC,EAAE,QAAQ,CAAC,EACnC,SAAS,GAAE,aAAa,CAAC,CAAC,EAAE,QAAQ,CAAM,GACzC,aAAa,CAAC,CAAC,EAAE,QAAQ,CAAC,CAI5B;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,OAAO,EAAE,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC,EACzF,QAAQ,EAAE,YAAY,CAAC,CAAC,EAAE,QAAQ,CAAC,EACnC,SAAS,EAAE,aAAa,CAAC,CAAC,EAAE,QAAQ,CAAC,EACrC,EAAE,EAAE,MAAM,CAAC,GACV,CAAC,CAkBH;AAUD,qFAAqF;AACrF,wBAAgB,UAAU,IAAI,IAAI,CAGjC"}

package/node_modules/@lorenz/flags/dist/testing.js

@@ -0,0 +1,68 @@
+import { clearDefaultFlags, getDefaultFlags, hasDefaultFlags, setDefaultFlags } from "./default.js";
+import { resetFlagDeprecationWarnings } from "./deprecations.js";
+import { resolveFlags } from "./resolve.js";
+// Test seams (subpath export `@lorenz/flags/testing`), kept out of the production entry point.
+function emptyLayer() {
+    return { flags: [], features: [] };
+}
+/**
+ * Build a frozen snapshot from manifest defaults + feature presets + typed overrides, with no
+ * env/CLI/file scanning. Overrides enter at the explicit (CLI) band, so an explicit override beats
+ * an enabled feature preset exactly as in production. Routing through the real {@link resolveFlags}
+ * keeps a single precedence implementation. Deprecation warnings are suppressed (no-op `warn`).
+ */
+export function buildTestFlags(manifest, overrides = {}) {
+    const flags = [];
+    const features = [];
+    for (const [key, value] of Object.entries(overrides.flags ?? {})) {
+        flags.push({ source: "cli", key, rawValue: value, origin: `test override flags.${key}` });
+    }
+    for (const [name, enabled] of Object.entries(overrides.features ?? {})) {
+        if (enabled === undefined)
+            continue;
+        features.push({ source: "cli", name, enabled, origin: `test override features.${name}` });
+    }
+    return resolveFlags(manifest, { cli: { flags, features }, file: emptyLayer(), env: emptyLayer() }, { warn: () => { } });
+}
+/** Build a snapshot from overrides and install it as the default. Returns the snapshot. */
+export function setFlagsForTesting(manifest, overrides = {}) {
+    const snapshot = buildTestFlags(manifest, overrides);
+    setDefaultFlags(snapshot);
+    return snapshot;
+}
+/**
+ * Run `fn` with a fresh snapshot installed as the default, restoring the prior install afterward
+ * (even on throw). Synchronous only: a module-level save/restore is not safe across `await` points
+ * if two scopes interleave.
+ */
+export function withFlags(manifest, overrides, fn) {
+    const previous = hasDefaultFlags() ? getDefaultFlags() : undefined;
+    setDefaultFlags(buildTestFlags(manifest, overrides));
+    try {
+        const result = fn();
+        if (isThenable(result)) {
+            // An async body would read flags after `finally` has already restored the prior snapshot, so
+            // its post-await reads would silently see the wrong flags. Fail loudly instead.
+            throw new Error("withFlags requires a synchronous callback; it returned a thenable. Use " +
+                "setFlagsForTesting()/resetFlags() to scope flags across awaits.");
+        }
+        return result;
+    }
+    finally {
+        if (previous)
+            setDefaultFlags(previous);
+        else
+            clearDefaultFlags();
+    }
+}
+function isThenable(value) {
+    return ((typeof value === "object" || typeof value === "function") &&
+        value !== null &&
+        typeof value.then === "function");
+}
+/** Clear the installed snapshot and re-arm once-per-process deprecation warnings. */
+export function resetFlags() {
+    clearDefaultFlags();
+    resetFlagDeprecationWarnings();
+}
+//# sourceMappingURL=testing.js.map

package/node_modules/@lorenz/flags/dist/testing.js.map

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

package/node_modules/@lorenz/flags/dist/types.d.ts

@@ -0,0 +1,93 @@
+import type { z } from "zod";
+/** Per-key deprecation marker. `detail` adds optional guidance to the warning. */
+export interface FlagDeprecation {
+    readonly detail?: string | undefined;
+}
+export type FlagKind = "string" | "int" | "float" | "bool" | "enum";
+/** A single flag declaration. `schema`'s output is the flag's value type; `default` is that type. */
+export interface FlagDef<Schema extends z.ZodType = z.ZodType> {
+    readonly kind: FlagKind;
+    readonly schema: Schema;
+    readonly default: z.output<Schema>;
+    readonly description: string;
+    readonly deprecation?: FlagDeprecation | undefined;
+    /** enum only: the allowed values, surfaced in error/help text. */
+    readonly values?: readonly string[] | undefined;
+    /** Optional explicit env var name (including the `LORENZ_FLAG_`/`LORENZ_FEATURE_` prefix). */
+    readonly envName?: string | undefined;
+}
+/** A feature: a named boolean whose enablement applies a preset of flag default-overrides. */
+export interface FeatureDef<Preset extends Record<string, unknown> = Record<string, unknown>> {
+    readonly default: boolean;
+    readonly description: string;
+    readonly preset: Preset;
+    readonly deprecation?: FlagDeprecation | undefined;
+    readonly envName?: string | undefined;
+}
+export type FlagMap = Record<string, FlagDef>;
+export type FlagValue<D extends FlagDef> = D extends FlagDef<infer S> ? z.output<S> : never;
+export type FlagKeyOf<F extends FlagMap> = keyof F & string;
+export type FlagValuesOf<F extends FlagMap> = {
+    [K in keyof F]: FlagValue<F[K]>;
+};
+export type PresetFor<F extends FlagMap> = Partial<FlagValuesOf<F>>;
+export type FeatureMapFor<F extends FlagMap> = Record<string, FeatureDef<PresetFor<F>>>;
+export type FeatureKeyOf<Features extends Record<string, FeatureDef>> = keyof Features & string;
+export interface FlagManifest<F extends FlagMap = FlagMap, Features extends Record<string, FeatureDef> = Record<string, FeatureDef>> {
+    readonly flags: F;
+    readonly features: Features;
+}
+/** Where a resolved value came from. `feature` means an enabled feature's preset supplied it. */
+export type LayerSource = "cli" | "file" | "env" | "feature" | "default";
+export interface FlagInput {
+    readonly source: LayerSource;
+    readonly key: string;
+    readonly rawValue: unknown;
+    /** Human-facing label of where this came from, e.g. `--flag x=1` or `LORENZ_FLAG_X`. */
+    readonly origin: string;
+}
+export interface FeatureInput {
+    readonly source: LayerSource;
+    readonly name: string;
+    readonly enabled: boolean;
+    readonly origin: string;
+}
+export type FlagIssueKind = "unknown_flag" | "unknown_feature" | "invalid_value" | "preset_conflict";
+export interface FlagIssue {
+    readonly kind: FlagIssueKind;
+    readonly message: string;
+}
+export interface RawLayer {
+    readonly flags: readonly FlagInput[];
+    readonly features: readonly FeatureInput[];
+    /** Problems a parser detected but deferred to the resolver's collect-all aggregation. */
+    readonly issues?: readonly FlagIssue[] | undefined;
+}
+/** The three explicit layers, in HIGH-to-LOW precedence order. */
+export interface RawLayers {
+    readonly cli: RawLayer;
+    readonly file: RawLayer;
+    readonly env: RawLayer;
+}
+export interface ResolveOptions {
+    /** Sink for once-per-process deprecation warnings. Defaults to a stderr `warning:` writer. */
+    readonly warn?: ((message: string) => void) | undefined;
+}
+/** A fully-resolved, immutable view. Values are already coerced and validated. */
+export interface FlagsSnapshot<F extends FlagMap = FlagMap, Features extends Record<string, FeatureDef> = Record<string, FeatureDef>> {
+    /** Typed flag read; the return type is exactly this key's value type. */
+    get<K extends FlagKeyOf<F>>(key: K): FlagValue<F[K]>;
+    /** Effective feature state after all layers. */
+    feature(key: FeatureKeyOf<Features>): boolean;
+    /** Frozen value map, for snapshotting into logs/traces. */
+    readonly values: Readonly<{
+        [K in keyof F]: FlagValue<F[K]>;
+    }>;
+    /** Per-flag provenance, for diagnostics (e.g. "timeout_ms came from cli"). */
+    source(key: FlagKeyOf<F>): LayerSource;
+}
+export interface FlagOverrides<F extends FlagMap, Features extends Record<string, FeatureDef>> {
+    flags?: Partial<FlagValuesOf<F>> | undefined;
+    features?: Partial<Record<FeatureKeyOf<Features>, boolean>> | undefined;
+}
+//# sourceMappingURL=types.d.ts.map

package/node_modules/@lorenz/flags/dist/types.d.ts.map

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

package/node_modules/@lorenz/flags/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/node_modules/@lorenz/flags/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/node_modules/@lorenz/flags/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "@lorenz/flags",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./testing": "./dist/testing.js"
+  },
+  "dependencies": {
+    "@lorenz/domain": "0.1.1",
+    "zod": "^4.4.3"
+  }
+}

package/node_modules/@lorenz/jira-tracker/dist/index.d.ts

@@ -2,4 +2,5 @@ export { JiraClient, JiraMcpClient, normalizeJiraIssue, type JiraClientDeps } fr
 export { jiraTrackerOptions, type JiraMcpOptions, type JiraMcpToolMap, type JiraTrackerOptions, } from "./options.js";
 export { jiraMcpTrackerProvider, jiraTrackerProvider } from "./provider.js";
 export { registerJiraTrackers } from "./register.js";
+export { JIRA_TOOL_PACK_NAME, executeJiraTool, jiraToolProvider, trackerToolSpecs, } from "./tools.js";
 //# sourceMappingURL=index.d.ts.map

package/node_modules/@lorenz/jira-tracker/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,kBAAkB,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AACjG,OAAO,EACL,kBAAkB,EAClB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,kBAAkB,GACxB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,kBAAkB,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AACjG,OAAO,EACL,kBAAkB,EAClB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,kBAAkB,GACxB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/node_modules/@lorenz/jira-tracker/dist/index.js

@@ -2,4 +2,5 @@ export { JiraClient, JiraMcpClient, normalizeJiraIssue } from "./client.js";
 export { jiraTrackerOptions, } from "./options.js";
 export { jiraMcpTrackerProvider, jiraTrackerProvider } from "./provider.js";
 export { registerJiraTrackers } from "./register.js";
+export { JIRA_TOOL_PACK_NAME, executeJiraTool, jiraToolProvider, trackerToolSpecs, } from "./tools.js";
 //# sourceMappingURL=index.js.map

package/node_modules/@lorenz/jira-tracker/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,kBAAkB,EAAuB,MAAM,aAAa,CAAC;AACjG,OAAO,EACL,kBAAkB,GAInB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,kBAAkB,EAAuB,MAAM,aAAa,CAAC;AACjG,OAAO,EACL,kBAAkB,GAInB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/node_modules/@lorenz/jira-tracker/dist/provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAkB,eAAe,EAAkB,MAAM,qBAAqB,CAAC;AAgC3F,6FAA6F;AAC7F,eAAO,MAAM,mBAAmB,EAAE,eAgBjC,CAAC;AAEF,wFAAwF;AACxF,eAAO,MAAM,sBAAsB,EAAE,eAapC,CAAC"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAkB,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAiC3E,6FAA6F;AAC7F,eAAO,MAAM,mBAAmB,EAAE,eAejC,CAAC;AAEF,wFAAwF;AACxF,eAAO,MAAM,sBAAsB,EAAE,eAYpC,CAAC"}