lorenz 0.1.5 → 0.1.6

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

@@ -0,0 +1 @@
+{"version":3,"file":"default.js","sourceRoot":"","sources":["../src/default.ts"],"names":[],"mappings":"AAEA,oGAAoG;AACpG,IAAI,OAAkC,CAAC;AAEvC,MAAM,UAAU,eAAe;IAC7B,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,6FAA6F;QAC7F,8FAA8F;QAC9F,6BAA6B;QAC7B,MAAM,IAAI,KAAK,CACb,yFAAyF;YACvF,uFAAuF,CAC1F,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAuB;IACrD,OAAO,GAAG,QAAQ,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,OAAO,KAAK,SAAS,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,GAAG,SAAS,CAAC;AACtB,CAAC"}

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

@@ -0,0 +1,20 @@
+import type { FlagManifest } from "./types.js";
+export declare function stderrFlagWarn(message: string): void;
+export interface StagedDeprecation {
+    readonly key: string;
+    readonly message: string;
+}
+/**
+ * Stage (but do not emit) deprecation warnings for the given explicitly-set keys. The resolver
+ * stages during resolution and only {@link commitFlagDeprecations commits} if the overall resolve
+ * succeeds, so a resolve that throws never consumes a once-per-process warning slot.
+ */
+export declare function collectFlagDeprecations(explicitKeys: readonly {
+    readonly key: string;
+    readonly isFeature: boolean;
+}[], manifest: FlagManifest): StagedDeprecation[];
+/** Commit staged warnings to the once-per-process dedup set and emit the not-yet-seen ones. */
+export declare function commitFlagDeprecations(staged: readonly StagedDeprecation[], warn?: (message: string) => void): string[];
+/** Test seam: clear the once-per-process dedup set so a fresh snapshot re-warns. */
+export declare function resetFlagDeprecationWarnings(): void;
+//# sourceMappingURL=deprecations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deprecations.d.ts","sourceRoot":"","sources":["../src/deprecations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,YAAY,EAAE,MAAM,YAAY,CAAC;AAOhE,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEpD;AAKD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,SAAS;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAAE,EAAE,EAC9E,QAAQ,EAAE,YAAY,GACrB,iBAAiB,EAAE,CASrB;AAED,+FAA+F;AAC/F,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,iBAAiB,EAAE,EACpC,IAAI,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAqB,GAC/C,MAAM,EAAE,CASV;AAED,oFAAoF;AACpF,wBAAgB,4BAA4B,IAAI,IAAI,CAEnD"}

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

@@ -0,0 +1,42 @@
+function formatFlagDeprecation(key, deprecation) {
+    const base = `\`${key}\` is deprecated.`;
+    return deprecation.detail ? `${base} ${deprecation.detail}` : base;
+}
+export function stderrFlagWarn(message) {
+    process.stderr.write(`warning: ${message}\n`);
+}
+// Once-per-process dedup, so a deprecated key set on every poll/reload warns only once.
+const warnedDeprecations = new Set();
+/**
+ * Stage (but do not emit) deprecation warnings for the given explicitly-set keys. The resolver
+ * stages during resolution and only {@link commitFlagDeprecations commits} if the overall resolve
+ * succeeds, so a resolve that throws never consumes a once-per-process warning slot.
+ */
+export function collectFlagDeprecations(explicitKeys, manifest) {
+    const staged = [];
+    for (const { key, isFeature } of explicitKeys) {
+        const deprecation = isFeature
+            ? manifest.features[key]?.deprecation
+            : manifest.flags[key]?.deprecation;
+        if (deprecation)
+            staged.push({ key, message: formatFlagDeprecation(key, deprecation) });
+    }
+    return staged;
+}
+/** Commit staged warnings to the once-per-process dedup set and emit the not-yet-seen ones. */
+export function commitFlagDeprecations(staged, warn = stderrFlagWarn) {
+    const emitted = [];
+    for (const { key, message } of staged) {
+        if (warnedDeprecations.has(key))
+            continue;
+        warnedDeprecations.add(key);
+        warn(message);
+        emitted.push(key);
+    }
+    return emitted;
+}
+/** Test seam: clear the once-per-process dedup set so a fresh snapshot re-warns. */
+export function resetFlagDeprecationWarnings() {
+    warnedDeprecations.clear();
+}
+//# sourceMappingURL=deprecations.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deprecations.js","sourceRoot":"","sources":["../src/deprecations.ts"],"names":[],"mappings":"AAEA,SAAS,qBAAqB,CAAC,GAAW,EAAE,WAA4B;IACtE,MAAM,IAAI,GAAG,KAAK,GAAG,mBAAmB,CAAC;IACzC,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,OAAO,IAAI,CAAC,CAAC;AAChD,CAAC;AAED,wFAAwF;AACxF,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAU,CAAC;AAO7C;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACrC,YAA8E,EAC9E,QAAsB;IAEtB,MAAM,MAAM,GAAwB,EAAE,CAAC;IACvC,KAAK,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,YAAY,EAAE,CAAC;QAC9C,MAAM,WAAW,GAAG,SAAS;YAC3B,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,WAAW;YACrC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC;QACrC,IAAI,WAAW;YAAE,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,qBAAqB,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC;IAC1F,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,sBAAsB,CACpC,MAAoC,EACpC,OAAkC,cAAc;IAEhD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,MAAM,EAAE,CAAC;QACtC,IAAI,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC1C,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,CAAC,OAAO,CAAC,CAAC;QACd,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,4BAA4B;IAC1C,kBAAkB,CAAC,KAAK,EAAE,CAAC;AAC7B,CAAC"}

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

@@ -0,0 +1,17 @@
+import type { FlagManifest, RawLayer } from "./types.js";
+export declare function flagEnvName(key: string): string;
+interface EnvBinding {
+    readonly kind: "flag" | "feature";
+    readonly key: string;
+}
+/** Build the reverse env-name -> binding table, throwing on a boot-time name collision. */
+export declare function buildEnvLookup(manifest: FlagManifest): Map<string, EnvBinding>;
+/**
+ * Scan the whole environment for the reserved prefixes. Categorization problems (unknown name,
+ * wrong prefix for a known key, non-boolean feature value) become deferred {@link FlagIssue}s so a
+ * single resolve reports every env problem at once, independent of `process.env` iteration order.
+ * Only a manifest-level env-name collision (from {@link buildEnvLookup}) throws.
+ */
+export declare function flagInputsFromEnv(manifest: FlagManifest, env?: NodeJS.ProcessEnv): RawLayer;
+export {};
+//# sourceMappingURL=env.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAsC,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAY7F,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAMD,UAAU,UAAU;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,2FAA2F;AAC3F,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAmB9E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,YAAY,EACtB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,QAAQ,CA8CV"}

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

@@ -0,0 +1,90 @@
+import { parseBoolToken } from "./coerce.js";
+const FLAG_PREFIX = "LORENZ_FLAG_";
+const FEATURE_PREFIX = "LORENZ_FEATURE_";
+// Manifest keys are lower_snake_case dotted, so the env encoding is a lossless mechanical
+// transform: `scheduler.batch_size` -> `LORENZ_FLAG_SCHEDULER__BATCH_SIZE`. No camelCase boundary
+// handling and no lossy uppercasing, so derived names never collide.
+function encodeKey(key) {
+    return key.split(".").join("__").toUpperCase();
+}
+export function flagEnvName(key) {
+    return `${FLAG_PREFIX}${encodeKey(key)}`;
+}
+function featureEnvName(name) {
+    return `${FEATURE_PREFIX}${encodeKey(name)}`;
+}
+/** Build the reverse env-name -> binding table, throwing on a boot-time name collision. */
+export function buildEnvLookup(manifest) {
+    const table = new Map();
+    const add = (envVar, binding) => {
+        const existing = table.get(envVar);
+        if (existing) {
+            throw new Error(`@lorenz/flags: env var ${envVar} maps to both ${existing.kind} \`${existing.key}\` and ` +
+                `${binding.kind} \`${binding.key}\`; set an explicit envName to disambiguate`);
+        }
+        table.set(envVar, binding);
+    };
+    for (const [key, def] of Object.entries(manifest.flags)) {
+        add(def.envName ?? flagEnvName(key), { kind: "flag", key });
+    }
+    for (const [name, def] of Object.entries(manifest.features)) {
+        add(def.envName ?? featureEnvName(name), { kind: "feature", key: name });
+    }
+    return table;
+}
+/**
+ * Scan the whole environment for the reserved prefixes. Categorization problems (unknown name,
+ * wrong prefix for a known key, non-boolean feature value) become deferred {@link FlagIssue}s so a
+ * single resolve reports every env problem at once, independent of `process.env` iteration order.
+ * Only a manifest-level env-name collision (from {@link buildEnvLookup}) throws.
+ */
+export function flagInputsFromEnv(manifest, env = process.env) {
+    const lookup = buildEnvLookup(manifest);
+    const flags = [];
+    const features = [];
+    const issues = [];
+    for (const [envVar, rawValue] of Object.entries(env)) {
+        const isFlag = envVar.startsWith(FLAG_PREFIX);
+        const isFeature = envVar.startsWith(FEATURE_PREFIX);
+        if ((!isFlag && !isFeature) || rawValue === undefined)
+            continue;
+        const binding = lookup.get(envVar);
+        if (!binding) {
+            issues.push({
+                kind: isFlag ? "unknown_flag" : "unknown_feature",
+                message: `${envVar}: unknown ${isFlag ? "flag" : "feature"} (no manifest key maps to this env var)`,
+            });
+            continue;
+        }
+        if (binding.kind === "flag") {
+            if (!isFlag) {
+                issues.push({
+                    kind: "invalid_value",
+                    message: `${envVar}: \`${binding.key}\` is a flag; use ${FLAG_PREFIX}* not ${FEATURE_PREFIX}*`,
+                });
+                continue;
+            }
+            flags.push({ source: "env", key: binding.key, rawValue, origin: envVar });
+        }
+        else {
+            if (!isFeature) {
+                issues.push({
+                    kind: "invalid_value",
+                    message: `${envVar}: \`${binding.key}\` is a feature; use ${FEATURE_PREFIX}* not ${FLAG_PREFIX}*`,
+                });
+                continue;
+            }
+            const enabled = parseBoolToken(rawValue);
+            if (enabled === undefined) {
+                issues.push({
+                    kind: "invalid_value",
+                    message: `invalid value for ${envVar}: must be true or false`,
+                });
+                continue;
+            }
+            features.push({ source: "env", name: binding.key, enabled, origin: envVar });
+        }
+    }
+    return { flags, features, issues };
+}
+//# sourceMappingURL=env.js.map

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

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

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

@@ -0,0 +1,22 @@
+import type { z } from "zod";
+import type { FlagDef, FlagIssue, FlagManifest } from "./types.js";
+/** Accumulates problems across every layer so one resolve reports them all at once. */
+export declare class FlagIssueCollector {
+    private readonly issues;
+    add(issue: FlagIssue): void;
+    addAll(issues: readonly FlagIssue[]): void;
+    get isEmpty(): boolean;
+    list(): readonly FlagIssue[];
+    throwIfAny(): void;
+}
+export declare function unknownFlagError(sourceLabel: string, key: string, manifest: FlagManifest): FlagIssue;
+export declare function unknownFeatureError(sourceLabel: string, name: string, manifest: FlagManifest): FlagIssue;
+/**
+ * Map a Zod validation error for one flag value to friendly text. The message is keyed off the
+ * flag's `kind` rather than the raw Zod issue, because the coercion unions (`numericInput`,
+ * `coercedBoolean`) surface as `invalid_union` issues whose default wording is unhelpful, and enum
+ * allowed-values come from the manifest (`def.values`) rather than a Zod-internal field. A `custom`
+ * refine failure (e.g. a per-flag bound) keeps its own message so callers can express constraints.
+ */
+export declare function flagValueErrorMessage(error: z.ZodError, def: FlagDef): string;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAG7B,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEnE,uFAAuF;AACvF,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAE1C,GAAG,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAI3B,MAAM,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,GAAG,IAAI;IAI1C,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,IAAI,SAAS,SAAS,EAAE;IAI5B,UAAU,IAAI,IAAI;CAGnB;AAQD,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,YAAY,GACrB,SAAS,CAKX;AAED,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,YAAY,GACrB,SAAS,CAKX;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,CAc7E"}

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

@@ -0,0 +1,61 @@
+import { featureKeys, flagKeys } from "./keys.js";
+/** Accumulates problems across every layer so one resolve reports them all at once. */
+export class FlagIssueCollector {
+    issues = [];
+    add(issue) {
+        this.issues.push(issue);
+    }
+    addAll(issues) {
+        for (const issue of issues)
+            this.issues.push(issue);
+    }
+    get isEmpty() {
+        return this.issues.length === 0;
+    }
+    list() {
+        return this.issues;
+    }
+    throwIfAny() {
+        if (this.issues.length > 0)
+            throw new Error(formatFlagIssues(this.issues));
+    }
+}
+function formatFlagIssues(issues) {
+    const header = issues.length === 1 ? "lorenz flags: 1 problem:" : `lorenz flags: ${issues.length} problems:`;
+    return `${header}\n${issues.map((issue) => `  - ${issue.message}`).join("\n")}`;
+}
+export function unknownFlagError(sourceLabel, key, manifest) {
+    return {
+        kind: "unknown_flag",
+        message: `${sourceLabel} sets unknown flag \`${key}\` (known flags: ${flagKeys(manifest).join(", ")})`,
+    };
+}
+export function unknownFeatureError(sourceLabel, name, manifest) {
+    return {
+        kind: "unknown_feature",
+        message: `${sourceLabel} sets unknown feature \`${name}\` (known features: ${featureKeys(manifest).join(", ")})`,
+    };
+}
+/**
+ * Map a Zod validation error for one flag value to friendly text. The message is keyed off the
+ * flag's `kind` rather than the raw Zod issue, because the coercion unions (`numericInput`,
+ * `coercedBoolean`) surface as `invalid_union` issues whose default wording is unhelpful, and enum
+ * allowed-values come from the manifest (`def.values`) rather than a Zod-internal field. A `custom`
+ * refine failure (e.g. a per-flag bound) keeps its own message so callers can express constraints.
+ */
+export function flagValueErrorMessage(error, def) {
+    const first = error.issues[0];
+    switch (def.kind) {
+        case "int":
+            return first?.code === "custom" ? first.message : "must be an integer";
+        case "float":
+            return first?.code === "custom" ? first.message : "must be a number";
+        case "bool":
+            return "must be true or false";
+        case "enum":
+            return `must be one of: ${(def.values ?? []).join(", ")}`;
+        default:
+            return first ? first.message : "is invalid";
+    }
+}
+//# sourceMappingURL=errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAGlD,uFAAuF;AACvF,MAAM,OAAO,kBAAkB;IACZ,MAAM,GAAgB,EAAE,CAAC;IAE1C,GAAG,CAAC,KAAgB;QAClB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,CAAC,MAA4B;QACjC,KAAK,MAAM,KAAK,IAAI,MAAM;YAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,UAAU;QACR,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7E,CAAC;CACF;AAED,SAAS,gBAAgB,CAAC,MAA4B;IACpD,MAAM,MAAM,GACV,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,iBAAiB,MAAM,CAAC,MAAM,YAAY,CAAC;IAChG,OAAO,GAAG,MAAM,KAAK,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAClF,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,WAAmB,EACnB,GAAW,EACX,QAAsB;IAEtB,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,GAAG,WAAW,wBAAwB,GAAG,oBAAoB,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;KACvG,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,WAAmB,EACnB,IAAY,EACZ,QAAsB;IAEtB,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,GAAG,WAAW,2BAA2B,IAAI,uBAAuB,WAAW,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;KACjH,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAiB,EAAE,GAAY;IACnE,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC9B,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;QACjB,KAAK,KAAK;YACR,OAAO,KAAK,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,oBAAoB,CAAC;QACzE,KAAK,OAAO;YACV,OAAO,KAAK,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,kBAAkB,CAAC;QACvE,KAAK,MAAM;YACT,OAAO,uBAAuB,CAAC;QACjC,KAAK,MAAM;YACT,OAAO,mBAAmB,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5D;YACE,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC;IAChD,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,8 @@
+export type { FeatureDef, FeatureInput, FeatureKeyOf, FeatureMapFor, FlagDef, FlagDeprecation, FlagInput, FlagIssue, FlagIssueKind, FlagKeyOf, FlagKind, FlagManifest, FlagMap, FlagOverrides, FlagsSnapshot, FlagValue, FlagValuesOf, LayerSource, PresetFor, RawLayer, RawLayers, ResolveOptions, } from "./types.js";
+export { bindFlags, defineFeatures, defineFlags, feature, flag, validateManifest, type BoundFlags, } from "./manifest.js";
+export { featureKeys } from "./keys.js";
+export { flagInputsFromEnv } from "./env.js";
+export { flagInputsFromCli, flagInputsFromFile } from "./layers.js";
+export { resolveFlags } from "./resolve.js";
+export { setDefaultFlags } from "./default.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,YAAY,EACV,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,OAAO,EACP,eAAe,EACf,SAAS,EACT,SAAS,EACT,aAAa,EACb,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,OAAO,EACP,aAAa,EACb,aAAa,EACb,SAAS,EACT,YAAY,EACZ,WAAW,EACX,SAAS,EACT,QAAQ,EACR,SAAS,EACT,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,SAAS,EACT,cAAc,EACd,WAAW,EACX,OAAO,EACP,IAAI,EACJ,gBAAgB,EAChB,KAAK,UAAU,GAChB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

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

@@ -0,0 +1,11 @@
+// Public surface of @lorenz/flags. Kept deliberately small: only what the composition root needs to
+// declare a manifest, resolve it, and install the snapshot. Internal helpers (coercion primitives,
+// the issue collector, env-name encoding, the raw singleton holder, key guards) stay unexported so
+// the engine-internal boundary is not widened. Test seams live in the `./testing` subpath.
+export { bindFlags, defineFeatures, defineFlags, feature, flag, validateManifest, } from "./manifest.js";
+export { featureKeys } from "./keys.js";
+export { flagInputsFromEnv } from "./env.js";
+export { flagInputsFromCli, flagInputsFromFile } from "./layers.js";
+export { resolveFlags } from "./resolve.js";
+export { setDefaultFlags } from "./default.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,mGAAmG;AACnG,mGAAmG;AACnG,2FAA2F;AA2B3F,OAAO,EACL,SAAS,EACT,cAAc,EACd,WAAW,EACX,OAAO,EACP,IAAI,EACJ,gBAAgB,GAEjB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

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

@@ -0,0 +1,6 @@
+import type { FlagManifest } from "./types.js";
+export declare function isFlagKey(manifest: FlagManifest, key: string): boolean;
+export declare function isFeatureKey(manifest: FlagManifest, name: string): boolean;
+export declare function flagKeys(manifest: FlagManifest): readonly string[];
+export declare function featureKeys(manifest: FlagManifest): readonly string[];
+//# sourceMappingURL=keys.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../src/keys.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAK/C,wBAAgB,SAAS,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAEtE;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1E;AAED,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,SAAS,MAAM,EAAE,CAElE;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,YAAY,GAAG,SAAS,MAAM,EAAE,CAErE"}

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

@@ -0,0 +1,15 @@
+// `hasOwnProperty` (not the `in` operator) so inherited names like `constructor`/`toString` are not
+// mistaken for declared keys: `isFlagKey(m, "constructor")` must be false so unknown keys fail.
+export function isFlagKey(manifest, key) {
+    return Object.prototype.hasOwnProperty.call(manifest.flags, key);
+}
+export function isFeatureKey(manifest, name) {
+    return Object.prototype.hasOwnProperty.call(manifest.features, name);
+}
+export function flagKeys(manifest) {
+    return Object.keys(manifest.flags).sort();
+}
+export function featureKeys(manifest) {
+    return Object.keys(manifest.features).sort();
+}
+//# sourceMappingURL=keys.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../src/keys.ts"],"names":[],"mappings":"AAEA,oGAAoG;AACpG,gGAAgG;AAEhG,MAAM,UAAU,SAAS,CAAC,QAAsB,EAAE,GAAW;IAC3D,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAsB,EAAE,IAAY;IAC/D,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,QAAsB;IAC7C,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,QAAsB;IAChD,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;AAC/C,CAAC"}

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

@@ -0,0 +1,14 @@
+import type { FlagManifest, RawLayer } from "./types.js";
+/**
+ * Parse repeatable `--flag key=value` / `--feature name[=true|false]` CLI tokens. Like the env
+ * parser, this is fully non-throwing: malformed shape, unknown keys, and non-boolean feature tokens
+ * become deferred {@link FlagIssue}s so the resolver reports every CLI problem at once.
+ */
+export declare function flagInputsFromCli(manifest: FlagManifest, flagTokens: readonly string[], featureTokens: readonly string[]): RawLayer;
+/**
+ * Read the `flags:` / `features:` sections off raw `WORKFLOW.md` front matter. Native YAML scalars
+ * pass through unchanged as `rawValue` (no pre-stringification), so a YAML `8`/`true`/`null` reaches
+ * the right validator. Structural and unknown-key problems become deferred issues.
+ */
+export declare function flagInputsFromFile(manifest: FlagManifest, config: Record<string, unknown>): RawLayer;
+//# sourceMappingURL=layers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"layers.d.ts","sourceRoot":"","sources":["../src/layers.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAsC,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE7F;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,YAAY,EACtB,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,aAAa,EAAE,SAAS,MAAM,EAAE,GAC/B,QAAQ,CA4CV;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,QAAQ,CAkDV"}

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

@@ -0,0 +1,107 @@
+import { isRecord } from "@lorenz/domain";
+import { parseBoolToken } from "./coerce.js";
+import { unknownFeatureError, unknownFlagError } from "./errors.js";
+import { isFeatureKey, isFlagKey } from "./keys.js";
+/**
+ * Parse repeatable `--flag key=value` / `--feature name[=true|false]` CLI tokens. Like the env
+ * parser, this is fully non-throwing: malformed shape, unknown keys, and non-boolean feature tokens
+ * become deferred {@link FlagIssue}s so the resolver reports every CLI problem at once.
+ */
+export function flagInputsFromCli(manifest, flagTokens, featureTokens) {
+    const flags = [];
+    const features = [];
+    const issues = [];
+    for (const token of flagTokens) {
+        const eq = token.indexOf("=");
+        if (eq <= 0) {
+            issues.push({ kind: "invalid_value", message: `--flag expects key=value, got "${token}"` });
+            continue;
+        }
+        const key = token.slice(0, eq).trim();
+        // Split on the FIRST `=` so values may themselves contain `=`.
+        const rawValue = token.slice(eq + 1);
+        if (!isFlagKey(manifest, key)) {
+            issues.push(unknownFlagError("--flag", key, manifest));
+            continue;
+        }
+        flags.push({ source: "cli", key, rawValue, origin: `--flag ${token}` });
+    }
+    for (const token of featureTokens) {
+        const eq = token.indexOf("=");
+        const name = (eq === -1 ? token : token.slice(0, eq)).trim();
+        if (!isFeatureKey(manifest, name)) {
+            issues.push(unknownFeatureError("--feature", name, manifest));
+            continue;
+        }
+        if (eq === -1) {
+            features.push({ source: "cli", name, enabled: true, origin: `--feature ${name}` });
+            continue;
+        }
+        const enabled = parseBoolToken(token.slice(eq + 1));
+        if (enabled === undefined) {
+            issues.push({
+                kind: "invalid_value",
+                message: `--feature ${name} expects true|false, got "${token.slice(eq + 1)}"`,
+            });
+            continue;
+        }
+        features.push({ source: "cli", name, enabled, origin: `--feature ${token}` });
+    }
+    return { flags, features, issues };
+}
+/**
+ * Read the `flags:` / `features:` sections off raw `WORKFLOW.md` front matter. Native YAML scalars
+ * pass through unchanged as `rawValue` (no pre-stringification), so a YAML `8`/`true`/`null` reaches
+ * the right validator. Structural and unknown-key problems become deferred issues.
+ */
+export function flagInputsFromFile(manifest, config) {
+    const flags = [];
+    const features = [];
+    const issues = [];
+    const flagsRaw = config.flags;
+    if (flagsRaw !== undefined) {
+        if (!isRecord(flagsRaw)) {
+            issues.push({
+                kind: "invalid_value",
+                message: "WORKFLOW.md `flags:` must be a map of key to value",
+            });
+        }
+        else {
+            for (const [key, value] of Object.entries(flagsRaw)) {
+                if (!isFlagKey(manifest, key)) {
+                    issues.push(unknownFlagError("WORKFLOW.md flags", key, manifest));
+                    continue;
+                }
+                flags.push({ source: "file", key, rawValue: value, origin: `WORKFLOW.md flags.${key}` });
+            }
+        }
+    }
+    const featuresRaw = config.features;
+    if (featuresRaw !== undefined) {
+        if (!isRecord(featuresRaw)) {
+            issues.push({
+                kind: "invalid_value",
+                message: "WORKFLOW.md `features:` must be a map of name to boolean",
+            });
+        }
+        else {
+            for (const [name, value] of Object.entries(featuresRaw)) {
+                if (!isFeatureKey(manifest, name)) {
+                    issues.push(unknownFeatureError("WORKFLOW.md features", name, manifest));
+                    continue;
+                }
+                const enabled = parseBoolToken(value);
+                if (enabled === undefined) {
+                    issues.push({
+                        kind: "invalid_value",
+                        message: `WORKFLOW.md features.${name} must be a boolean, got "${String(value)}"`,
+                    });
+                    continue;
+                }
+                features.push({ source: "file", name, enabled, origin: `WORKFLOW.md features.${name}` });
+            }
+        }
+    }
+    return { flags, features, issues };
+}
+//# sourceMappingURL=layers.js.map

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

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

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

@@ -0,0 +1,71 @@
+import { z } from "zod";
+import type { FeatureDef, FeatureMapFor, FlagDef, FlagDeprecation, FlagManifest, FlagMap, FlagsSnapshot } from "./types.js";
+interface BaseFlagConfig {
+    readonly description: string;
+    readonly deprecation?: FlagDeprecation | undefined;
+    readonly envName?: string | undefined;
+}
+interface StringFlagConfig extends BaseFlagConfig {
+    readonly default: string;
+}
+interface NumberFlagConfig extends BaseFlagConfig {
+    readonly default: number;
+    /** Optional extra constraint (e.g. `(n) => n >= 1`) applied on top of int/float coercion. */
+    readonly refine?: ((n: number) => boolean) | undefined;
+    readonly refineMessage?: string | undefined;
+}
+interface BoolFlagConfig extends BaseFlagConfig {
+    readonly default: boolean;
+}
+interface EnumFlagConfig<V extends readonly [string, ...string[]]> extends BaseFlagConfig {
+    readonly values: V;
+    readonly default: V[number];
+}
+/** 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 declare const flag: {
+    readonly string: (config: StringFlagConfig) => FlagDef<z.ZodString>;
+    readonly int: (config: NumberFlagConfig) => FlagDef<z.ZodType<number, string | number>>;
+    readonly float: (config: NumberFlagConfig) => FlagDef<z.ZodType<number, string | number>>;
+    readonly bool: (config: BoolFlagConfig) => FlagDef<z.ZodType<boolean, string | boolean>>;
+    readonly enum: <const V extends readonly [string, ...string[]]>(config: EnumFlagConfig<V>) => {
+        kind: "enum";
+        schema: z.ZodEnum<{ [k_1 in V[number]]: k_1; } extends infer T ? { [k in keyof T]: T[k]; } : never>;
+        default: V[number];
+        description: string;
+        deprecation: FlagDeprecation | undefined;
+        values: V;
+        envName: string | undefined;
+    };
+};
+export declare function feature<const Preset extends Record<string, unknown>>(config: {
+    readonly default: boolean;
+    readonly description: string;
+    readonly preset: Preset;
+    readonly deprecation?: FlagDeprecation | undefined;
+    readonly envName?: string | undefined;
+}): FeatureDef<Preset>;
+export declare function defineFlags<const F extends FlagMap>(flags: F): F;
+export declare function defineFeatures<const F extends FlagMap, const Features extends FeatureMapFor<F>>(_flags: F, features: Features): Features;
+/** Scalar-only value set, so reference identity via `Object.is` is correct and obvious. */
+export declare function presetValueEqual(a: unknown, b: unknown): boolean;
+/**
+ * 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 declare function validateManifest(manifest: FlagManifest): void;
+export interface BoundFlags<F extends FlagMap, Features extends Record<string, FeatureDef>> {
+    /** Typed ambient accessor: the installed snapshot, narrowed to this manifest. */
+    getFlags(): FlagsSnapshot<F, Features>;
+}
+/**
+ * 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 declare function bindFlags<F extends FlagMap, Features extends Record<string, FeatureDef>>(_manifest: FlagManifest<F, Features>): BoundFlags<F, Features>;
+export {};
+//# sourceMappingURL=manifest.d.ts.map

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

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