@untangle-code/config 0.0.0-stage → 0.1.0

package/dist/load.d.ts

@@ -0,0 +1,61 @@
+import type { RawConfigLayer, EffectiveUntangleConfigV1 } from "./types.js";
+import type { ConfigIssue } from "./validate.js";
+export interface LoadConfigOptions {
+    /** Directory to start upward config-file discovery from. Defaults to `process.cwd()`. */
+    cwd?: string;
+    /** Highest-priority layer (spec.md §4.1 layer 1): explicit API/CLI arguments. */
+    explicit?: RawConfigLayer;
+    env?: NodeJS.ProcessEnv;
+    platform?: NodeJS.Platform;
+}
+export interface ConfigSources {
+    userConfigPath: string | undefined;
+    projectConfigPath: string | undefined;
+    /**
+     * `untangle.toml` (layer 4b) — the file `untangle init` writes. Reported
+     * separately so a diagnostic command can name the file the user actually
+     * has instead of the one it expected (WP-222).
+     */
+    tomlConfigPath: string | undefined;
+    localConfigPath: string | undefined;
+    explicitProvided: boolean;
+    /** `UNTANGLE_*` variables from `ENV_MAPPING` that were actually set. */
+    envVarsApplied: string[];
+    /**
+     * Fallback directory shown for diagnostics only: `.untangle.json`'s
+     * directory, else `untangle.toml`'s, else `.untangle.local.json`'s, else
+     * `cwd`. It is NOT
+     * necessarily what `repositories`/`contextArtifacts` paths were resolved
+     * against — each of those resolves against the directory of whichever
+     * layer actually defined it (spec.md §4.3; see `loadConfig`'s
+     * `originBaseDirFor`), which may be the OS user config directory or `cwd`
+     * (env/explicit layers) instead.
+     */
+    configBaseDir: string;
+    /** Logical project root for `.untangle/config.json`; legacy layouts keep their existing base. */
+    projectRoot?: string;
+}
+export interface LoadConfigResult {
+    effectiveConfig: EffectiveUntangleConfigV1;
+    warnings: ConfigIssue[];
+    errors: ConfigIssue[];
+    sources: ConfigSources;
+    /** Canonical effective-config hash; Qdrant excludes additive storage fields for legacy identity. */
+    configHash: string;
+    /** `buildWorkspaceId({ explicitId: effectiveConfig.workspaceId, configHash })` (spec.md §5.1). */
+    workspaceId: string;
+    /** `buildEmbeddingProfileId` over the derived profile (spec.md §5.7). */
+    embeddingProfileId: string;
+}
+/**
+ * Loads and resolves the effective Untangle configuration through all six
+ * layers of spec.md §4.1: explicit args > env (`UNTANGLE_*`) >
+ * `.untangle.local.json` > `.untangle.json` > OS user config > product
+ * defaults. Never throws for validation problems — see {@link ConfigIssue}
+ * and `validate.ts`'s `assertConfigValid` for the "MUST abort" behavior
+ * spec.md §4.8 requires from a caller.
+ */
+export declare function loadConfig(options?: LoadConfigOptions): LoadConfigResult;
+/** Re-exported for callers that only need to check whether a discovered path exists (rare; mostly test convenience). */
+export declare function configFileExists(path: string | undefined): boolean;
+//# sourceMappingURL=load.d.ts.map

package/dist/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../src/load.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,cAAc,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAE5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGjD,MAAM,WAAW,iBAAiB;IAChC,yFAAyF;IACzF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC;;;;OAIG;IACH,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,wEAAwE;IACxE,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB;;;;;;;;;OASG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,iGAAiG;IACjG,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,yBAAyB,CAAC;IAC3C,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,OAAO,EAAE,aAAa,CAAC;IACvB,oGAAoG;IACpG,UAAU,EAAE,MAAM,CAAC;IACnB,kGAAkG;IAClG,WAAW,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AA2FD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,gBAAgB,CA0K5E;AAED,wHAAwH;AACxH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAElE"}

package/dist/load.js

@@ -0,0 +1,264 @@
+/**
+ * Top-level configuration loading: discovery + six-level layering (spec.md
+ * §4.1) + path resolution (spec.md §4.3) + validation (spec.md §4.8) +
+ * canonical hashing and embedding profile derivation (architecture.md §6.3).
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { buildWorkspaceId } from "@untangle-code/domain";
+import { parse as parseToml } from "smol-toml";
+import { PRODUCT_DEFAULT_CONFIG } from "./defaults.js";
+import { discoverConfigFiles } from "./discovery.js";
+import { buildEnvConfigLayer } from "./env.js";
+import { computeConfigHash, deriveEmbeddingProfileId } from "./hash.js";
+import { mergeConfigLayers } from "./merge.js";
+import { migrateConfig } from "./migrations.js";
+import { resolveConfigPath } from "./paths.js";
+import { resolveUserConfigPath } from "./user-config.js";
+import { validateEffectiveConfig } from "./validate.js";
+function readJsonConfigFile(path) {
+    let text;
+    try {
+        text = readFileSync(path, "utf8");
+    }
+    catch (error) {
+        return {
+            layer: {},
+            error: {
+                code: "CONFIG_INVALID",
+                message: `failed to read config file "${path}": ${String(error)}`,
+                path,
+            },
+        };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch (error) {
+        return {
+            layer: {},
+            error: {
+                code: "CONFIG_INVALID",
+                message: `"${path}" is not valid JSON: ${error instanceof Error ? error.message : String(error)}`,
+                path,
+            },
+        };
+    }
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+        return {
+            layer: {},
+            error: { code: "CONFIG_INVALID", message: `"${path}" must contain a JSON object`, path },
+        };
+    }
+    const migrated = migrateConfig(parsed);
+    return { layer: migrated.config, error: undefined };
+}
+/**
+ * Reads `untangle.toml` into the same raw layer shape a JSON config produces.
+ *
+ * The TOML file `untangle init` writes carries the SAME keys as
+ * `.untangle.json` — `schemaVersion`, `repositories`, `qdrant`, `embeddings`
+ * and so on — so it needs no separate schema, only a separate parser. It
+ * runs through `migrateConfig` and the ordinary validation like every other
+ * layer; a typo in it is reported the same way, in the same list, against
+ * the same paths.
+ */
+function readTomlConfigFile(path) {
+    let text;
+    try {
+        text = readFileSync(path, "utf8");
+    }
+    catch (error) {
+        return {
+            layer: {},
+            error: {
+                code: "CONFIG_INVALID",
+                message: `failed to read config file "${path}": ${String(error)}`,
+                path,
+            },
+        };
+    }
+    let parsed;
+    try {
+        parsed = parseToml(text);
+    }
+    catch (error) {
+        return {
+            layer: {},
+            error: {
+                code: "CONFIG_INVALID",
+                message: `"${path}" is not valid TOML: ${error instanceof Error ? error.message : String(error)}`,
+                path,
+            },
+        };
+    }
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+        return {
+            layer: {},
+            error: { code: "CONFIG_INVALID", message: `"${path}" must contain a TOML table`, path },
+        };
+    }
+    const migrated = migrateConfig(parsed);
+    return { layer: migrated.config, error: undefined };
+}
+/**
+ * Loads and resolves the effective Untangle configuration through all six
+ * layers of spec.md §4.1: explicit args > env (`UNTANGLE_*`) >
+ * `.untangle.local.json` > `.untangle.json` > OS user config > product
+ * defaults. Never throws for validation problems — see {@link ConfigIssue}
+ * and `validate.ts`'s `assertConfigValid` for the "MUST abort" behavior
+ * spec.md §4.8 requires from a caller.
+ */
+export function loadConfig(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const env = options.env ?? process.env;
+    const platform = options.platform ?? process.platform;
+    const { projectConfigPath, tomlConfigPath, localConfigPath, projectRoot } = discoverConfigFiles(cwd);
+    const userConfigPath = resolveUserConfigPath(env, platform);
+    const errors = [];
+    const userLayerOutcome = userConfigPath
+        ? readJsonConfigFile(userConfigPath)
+        : { layer: {}, error: undefined };
+    const projectLayerOutcome = projectConfigPath
+        ? readJsonConfigFile(projectConfigPath)
+        : { layer: {}, error: undefined };
+    const tomlLayerOutcome = tomlConfigPath
+        ? readTomlConfigFile(tomlConfigPath)
+        : { layer: {}, error: undefined };
+    const localLayerOutcome = localConfigPath
+        ? readJsonConfigFile(localConfigPath)
+        : { layer: {}, error: undefined };
+    for (const outcome of [
+        userLayerOutcome,
+        tomlLayerOutcome,
+        projectLayerOutcome,
+        localLayerOutcome,
+    ]) {
+        if (outcome.error) {
+            errors.push(outcome.error);
+        }
+    }
+    const envLayerResult = buildEnvConfigLayer(env);
+    for (const parseError of envLayerResult.parseErrors) {
+        errors.push({
+            code: "CONFIG_INVALID",
+            message: `environment variable ${parseError.env}: ${parseError.message}`,
+            path: parseError.env,
+        });
+    }
+    const explicitLayer = options.explicit ?? {};
+    // Each layer's OWN directory (spec.md §4.3: a path resolves relative to
+    // the config file that declared it). Layers with no backing file (product
+    // defaults, the env layer, explicit args) have no directory of their own,
+    // so they fall back to `cwd` — the directory the caller is running from.
+    const namedLayers = [
+        { layer: PRODUCT_DEFAULT_CONFIG, baseDir: cwd },
+        { layer: userLayerOutcome.layer, baseDir: userConfigPath ? dirname(userConfigPath) : cwd },
+        // Layer 4b, directly beneath `.untangle.json`: `untangle.toml`. Where
+        // both exist the JSON file wins — and `warnings` says so out loud, so a
+        // user never wonders why an edit had no effect (WP-222).
+        { layer: tomlLayerOutcome.layer, baseDir: tomlConfigPath ? dirname(tomlConfigPath) : cwd },
+        {
+            layer: projectLayerOutcome.layer,
+            baseDir: projectConfigPath ? dirname(projectConfigPath) : cwd,
+        },
+        { layer: localLayerOutcome.layer, baseDir: localConfigPath ? dirname(localConfigPath) : cwd },
+        { layer: envLayerResult.layer, baseDir: cwd },
+        { layer: explicitLayer, baseDir: cwd },
+    ];
+    // Preserve existing Qdrant projects without letting the product-default
+    // qdrant section choose a backend for new projects. This compatibility
+    // default sits below every user layer: an explicit storage.backend at any
+    // priority overrides it, while storage.path alone never migrates an index.
+    const configuredLayers = namedLayers.slice(1).map((named) => named.layer);
+    const legacyStorageDefault = configuredLayers.some((layer) => layer.qdrant !== undefined)
+        ? { storage: { backend: "qdrant" } }
+        : {};
+    const merged = mergeConfigLayers([
+        PRODUCT_DEFAULT_CONFIG,
+        legacyStorageDefault,
+        ...configuredLayers,
+    ]);
+    const configBaseDir = projectConfigPath
+        ? dirname(projectConfigPath)
+        : tomlConfigPath
+            ? dirname(tomlConfigPath)
+            : localConfigPath
+                ? dirname(localConfigPath)
+                : cwd;
+    /**
+     * `mergeConfigLayers` REPLACES arrays wholesale rather than concatenating
+     * them (merge.ts) — so the final `repositories`/`contextArtifacts` array
+     * in `merged` originates entirely from ONE layer: the highest-priority
+     * layer that defined it. Its entries' `path` fields MUST resolve against
+     * THAT layer's own directory (spec.md §4.3), not a single global
+     * `configBaseDir` computed after the merge — otherwise a repository
+     * defined in the OS user config (or via an env/explicit layer) silently
+     * loses its origin and resolves against the wrong directory. Walking
+     * `namedLayers` highest-priority-first and taking the first one that set
+     * `key` recovers exactly the layer the merge itself used.
+     */
+    function originBaseDirFor(key) {
+        for (let i = namedLayers.length - 1; i >= 0; i -= 1) {
+            const candidate = namedLayers[i];
+            if (candidate && Array.isArray(candidate.layer[key])) {
+                return candidate.baseDir;
+            }
+        }
+        return cwd;
+    }
+    if (Array.isArray(merged["repositories"])) {
+        const baseDir = originBaseDirFor("repositories");
+        merged["repositories"] = merged["repositories"].map((repo) => ({
+            ...repo,
+            path: resolveConfigPath(repo.path, baseDir),
+        }));
+    }
+    if (Array.isArray(merged["contextArtifacts"])) {
+        const baseDir = originBaseDirFor("contextArtifacts");
+        merged["contextArtifacts"] = merged["contextArtifacts"].map((artifact) => ({
+            ...artifact,
+            path: resolveConfigPath(artifact.path, baseDir),
+        }));
+    }
+    const { errors: validationErrors, warnings } = validateEffectiveConfig(merged);
+    errors.push(...validationErrors);
+    if (projectConfigPath !== undefined && tomlConfigPath !== undefined) {
+        warnings.push({
+            code: "CONFIG_DUPLICATE_PROJECT_FILE",
+            message: `both "${projectConfigPath}" and "${tomlConfigPath}" exist; ` +
+                `"${projectConfigPath}" wins for every key it sets`,
+            path: "(project config)",
+        });
+    }
+    const effectiveConfig = merged;
+    const configHash = computeConfigHash(effectiveConfig);
+    const workspaceId = buildWorkspaceId(effectiveConfig.workspaceId === undefined
+        ? { configHash }
+        : { explicitId: effectiveConfig.workspaceId, configHash });
+    const embeddingProfileId = deriveEmbeddingProfileId(effectiveConfig);
+    return {
+        effectiveConfig,
+        warnings,
+        errors,
+        sources: {
+            userConfigPath,
+            projectConfigPath,
+            tomlConfigPath,
+            localConfigPath,
+            explicitProvided: options.explicit !== undefined,
+            envVarsApplied: Object.keys(env).filter((key) => key.startsWith("UNTANGLE_") && env[key] !== undefined),
+            configBaseDir,
+            ...(projectRoot === undefined ? {} : { projectRoot }),
+        },
+        configHash,
+        workspaceId,
+        embeddingProfileId,
+    };
+}
+/** Re-exported for callers that only need to check whether a discovered path exists (rare; mostly test convenience). */
+export function configFileExists(path) {
+    return path !== undefined && existsSync(path);
+}
+//# sourceMappingURL=load.js.map

package/dist/load.js.map

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

package/dist/merge.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Deep merge for the layering pipeline (spec.md §4.1).
+ *
+ * Array semantics: arrays REPLACE, they never concatenate. A layer with
+ * `index.extraExtensions: [".proto"]` fully replaces a lower layer's array —
+ * two layers are never spliced together, because there is no reasonable way
+ * to know whether a higher layer meant to add to or reset a list (e.g.
+ * `exclude` globs), and silent concatenation would make higher-priority
+ * layers unable to shrink a list at all.
+ *
+ * Relevance-policy bindings are another deliberate replacement boundary:
+ * entries below `search.relevancePolicies.<profileId>` are calibrated,
+ * corpus-bound units. Merging a new workspace/collection with thresholds
+ * inherited from a lower layer would silently apply one corpus's policy to
+ * another corpus.
+ */
+/**
+ * Merges `override` onto `base`. Plain objects merge key by key (recursively);
+ * arrays, primitives, `null` and any non-plain object (e.g. would-be class
+ * instances) from `override` replace the corresponding value in `base`
+ * wholesale. `undefined` values in `override` are treated as "not set" and do
+ * not overwrite a present `base` value — this lets a layer omit a field
+ * without needing to know the value from lower layers.
+ */
+export declare function deepMergeConfig<T>(base: T, override: unknown): T;
+/**
+ * Merges layers left to right — later layers win — mirroring spec.md §4.1's
+ * priority order when called with `[productDefaults, userConfig, projectConfig,
+ * localConfig, envLayer, explicitArgs]` (lowest priority first).
+ */
+export declare function mergeConfigLayers<T>(layers: readonly unknown[]): T;
+//# 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;;;;;;;;;;;;;;;GAeG;AAMH;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,OAAO,GAAG,CAAC,CAEhE;AA8BD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,CAAC,CAElE"}

package/dist/merge.js

@@ -0,0 +1,65 @@
+/**
+ * Deep merge for the layering pipeline (spec.md §4.1).
+ *
+ * Array semantics: arrays REPLACE, they never concatenate. A layer with
+ * `index.extraExtensions: [".proto"]` fully replaces a lower layer's array —
+ * two layers are never spliced together, because there is no reasonable way
+ * to know whether a higher layer meant to add to or reset a list (e.g.
+ * `exclude` globs), and silent concatenation would make higher-priority
+ * layers unable to shrink a list at all.
+ *
+ * Relevance-policy bindings are another deliberate replacement boundary:
+ * entries below `search.relevancePolicies.<profileId>` are calibrated,
+ * corpus-bound units. Merging a new workspace/collection with thresholds
+ * inherited from a lower layer would silently apply one corpus's policy to
+ * another corpus.
+ */
+function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+ * Merges `override` onto `base`. Plain objects merge key by key (recursively);
+ * arrays, primitives, `null` and any non-plain object (e.g. would-be class
+ * instances) from `override` replace the corresponding value in `base`
+ * wholesale. `undefined` values in `override` are treated as "not set" and do
+ * not overwrite a present `base` value — this lets a layer omit a field
+ * without needing to know the value from lower layers.
+ */
+export function deepMergeConfig(base, override) {
+    return deepMergeConfigAtPath(base, override, []);
+}
+function isAtomicReplacementPath(path) {
+    return path.length === 3 && path[0] === "search" && path[1] === "relevancePolicies";
+}
+function deepMergeConfigAtPath(base, override, path) {
+    if (override === undefined) {
+        return base;
+    }
+    if (isAtomicReplacementPath(path)) {
+        return override;
+    }
+    if (!isPlainObject(base) || !isPlainObject(override)) {
+        return override;
+    }
+    const result = { ...base };
+    for (const [key, value] of Object.entries(override)) {
+        if (value === undefined) {
+            continue;
+        }
+        const baseValue = base[key];
+        result[key] =
+            isPlainObject(baseValue) && isPlainObject(value)
+                ? deepMergeConfigAtPath(baseValue, value, [...path, key])
+                : value;
+    }
+    return result;
+}
+/**
+ * Merges layers left to right — later layers win — mirroring spec.md §4.1's
+ * priority order when called with `[productDefaults, userConfig, projectConfig,
+ * localConfig, envLayer, explicitArgs]` (lowest priority first).
+ */
+export function mergeConfigLayers(layers) {
+    return layers.reduce((acc, layer) => deepMergeConfig(acc, layer), {});
+}
+//# 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;;;;;;;;;;;;;;;GAeG;AAEH,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAI,IAAO,EAAE,QAAiB;IAC3D,OAAO,qBAAqB,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,uBAAuB,CAAC,IAAuB;IACtD,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,mBAAmB,CAAC;AACtF,CAAC;AAED,SAAS,qBAAqB,CAAI,IAAO,EAAE,QAAiB,EAAE,IAAuB;IACnF,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,uBAAuB,CAAC,IAAI,CAAC,EAAE,CAAC;QAClC,OAAO,QAAa,CAAC;IACvB,CAAC;IACD,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrD,OAAO,QAAa,CAAC;IACvB,CAAC;IACD,MAAM,MAAM,GAA4B,EAAE,GAAG,IAAI,EAAE,CAAC;IACpD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,SAAS;QACX,CAAC;QACD,MAAM,SAAS,GAAI,IAAgC,CAAC,GAAG,CAAC,CAAC;QACzD,MAAM,CAAC,GAAG,CAAC;YACT,aAAa,CAAC,SAAS,CAAC,IAAI,aAAa,CAAC,KAAK,CAAC;gBAC9C,CAAC,CAAC,qBAAqB,CAAC,SAAS,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,CAAC;gBACzD,CAAC,CAAC,KAAK,CAAC;IACd,CAAC;IACD,OAAO,MAAW,CAAC;AACrB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAI,MAA0B;IAC7D,OAAO,MAAM,CAAC,MAAM,CAAU,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAM,CAAC;AACtF,CAAC"}

package/dist/migrations.d.ts

@@ -0,0 +1,26 @@
+export interface MigrationStep {
+    fromVersion: number;
+    toVersion: number;
+    /** Pure transform: old raw config shape in, new raw config shape out. */
+    migrate: (raw: Record<string, unknown>) => Record<string, unknown>;
+}
+/** Registers a migration step keyed by its `fromVersion`. Overwrites a step already registered for that version. */
+export declare function registerMigration(step: MigrationStep): void;
+/** Removes every registered migration step (test isolation). */
+export declare function clearMigrations(): void;
+export interface MigrationResult {
+    config: Record<string, unknown>;
+    finalVersion: number;
+    /** Versions the config was migrated through, e.g. `[1, 2]` for a single `1 -> 2` hop. */
+    appliedFrom: number[];
+}
+/**
+ * Applies registered migration steps in sequence starting from
+ * `raw.schemaVersion` (defaulting to `1` when absent) until
+ * `targetVersion` (default: {@link CURRENT_SCHEMA_VERSION}) is reached.
+ *
+ * A config already at `targetVersion` is returned unchanged — the identity
+ * migration — without requiring any step to be registered for it.
+ */
+export declare function migrateConfig(raw: Record<string, unknown>, targetVersion?: number): MigrationResult;
+//# sourceMappingURL=migrations.d.ts.map

package/dist/migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../src/migrations.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpE;AAID,oHAAoH;AACpH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAE3D;AAED,gEAAgE;AAChE,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,yFAAyF;IACzF,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,aAAa,GAAE,MAA+B,GAC7C,eAAe,CAkBjB"}

package/dist/migrations.js

@@ -0,0 +1,40 @@
+/**
+ * Migration scaffold for future `schemaVersion` jumps (architecture.md §6.3:
+ * "Migration älterer Configversionen"). spec.md is at `schemaVersion: 1`
+ * today; this registry lets a future WP register a `1 -> 2` step (etc.)
+ * without `loadConfig` needing to change.
+ */
+import { CURRENT_SCHEMA_VERSION } from "./defaults.js";
+const registry = new Map();
+/** Registers a migration step keyed by its `fromVersion`. Overwrites a step already registered for that version. */
+export function registerMigration(step) {
+    registry.set(step.fromVersion, step);
+}
+/** Removes every registered migration step (test isolation). */
+export function clearMigrations() {
+    registry.clear();
+}
+/**
+ * Applies registered migration steps in sequence starting from
+ * `raw.schemaVersion` (defaulting to `1` when absent) until
+ * `targetVersion` (default: {@link CURRENT_SCHEMA_VERSION}) is reached.
+ *
+ * A config already at `targetVersion` is returned unchanged — the identity
+ * migration — without requiring any step to be registered for it.
+ */
+export function migrateConfig(raw, targetVersion = CURRENT_SCHEMA_VERSION) {
+    let current = raw;
+    let version = typeof raw["schemaVersion"] === "number" ? raw["schemaVersion"] : 1;
+    const appliedFrom = [version];
+    while (version < targetVersion) {
+        const step = registry.get(version);
+        if (step === undefined) {
+            throw new Error(`no migration registered from schemaVersion ${version} towards ${targetVersion}`);
+        }
+        current = { ...step.migrate(current), schemaVersion: step.toVersion };
+        version = step.toVersion;
+        appliedFrom.push(version);
+    }
+    return { config: current, finalVersion: version, appliedFrom };
+}
+//# sourceMappingURL=migrations.js.map

package/dist/migrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.js","sourceRoot":"","sources":["../src/migrations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AASvD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAC;AAElD,oHAAoH;AACpH,MAAM,UAAU,iBAAiB,CAAC,IAAmB;IACnD,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;AACvC,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,eAAe;IAC7B,QAAQ,CAAC,KAAK,EAAE,CAAC;AACnB,CAAC;AASD;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAC3B,GAA4B,EAC5B,gBAAwB,sBAAsB;IAE9C,IAAI,OAAO,GAA4B,GAAG,CAAC;IAC3C,IAAI,OAAO,GAAG,OAAO,GAAG,CAAC,eAAe,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClF,MAAM,WAAW,GAAa,CAAC,OAAO,CAAC,CAAC;IAExC,OAAO,OAAO,GAAG,aAAa,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACnC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CACb,8CAA8C,OAAO,YAAY,aAAa,EAAE,CACjF,CAAC;QACJ,CAAC;QACD,OAAO,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;QACtE,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC;QACzB,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;AACjE,CAAC"}

package/dist/parse.d.ts

@@ -0,0 +1,7 @@
+import type { RawConfigLayer } from "./types.js";
+/**
+ * Parses a config document without filesystem access, defaults or environment
+ * overrides. Syntax and non-object input errors propagate to the caller.
+ */
+export declare function parseConfigText(text: string, format: "json" | "toml"): RawConfigLayer;
+//# sourceMappingURL=parse.d.ts.map

package/dist/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,cAAc,CAQrF"}

package/dist/parse.js

@@ -0,0 +1,14 @@
+import { parse as parseToml } from "smol-toml";
+import { migrateConfig } from "./migrations.js";
+/**
+ * Parses a config document without filesystem access, defaults or environment
+ * overrides. Syntax and non-object input errors propagate to the caller.
+ */
+export function parseConfigText(text, format) {
+    const parsed = format === "json" ? JSON.parse(text) : parseToml(text);
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+        throw new TypeError(`Configuration must contain a ${format === "json" ? "JSON object" : "TOML table"}.`);
+    }
+    return migrateConfig(parsed).config;
+}
+//# sourceMappingURL=parse.js.map

package/dist/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AAE/C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,MAAuB;IACnE,MAAM,MAAM,GAAY,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC/E,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,SAAS,CACjB,gCAAgC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,YAAY,GAAG,CACpF,CAAC;IACJ,CAAC;IACD,OAAO,aAAa,CAAC,MAAiC,CAAC,CAAC,MAAwB,CAAC;AACnF,CAAC"}

package/dist/paths.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Resolves `candidatePath` against `configFileDir` (the directory containing
+ * the config file that declared it). An already-absolute `candidatePath` is
+ * returned canonicalized as-is (spec.md §4.3 allows absolute paths).
+ */
+export declare function resolveConfigPath(candidatePath: string, configFileDir: string): string;
+/**
+ * Resolves every `RepositoryConfig.path` in `repositories` relative to
+ * `configFileDir`, returning new objects (inputs are not mutated).
+ */
+export declare function resolveRepositoryPaths<T extends {
+    path: string;
+}>(repositories: readonly T[], configFileDir: string): T[];
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAiBA;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAKtF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAC/D,YAAY,EAAE,SAAS,CAAC,EAAE,EAC1B,aAAa,EAAE,MAAM,GACpB,CAAC,EAAE,CAKL"}

package/dist/paths.js

@@ -0,0 +1,37 @@
+/**
+ * Path resolution relative to the configuration file (spec.md §4.3:
+ * "Pfade MÜSSEN relativ zur Konfigurationsdatei oder absolut auflösbar
+ * sein."). Results are canonical: absolute, `/`-separated, no trailing slash,
+ * no `.`/`..` segments.
+ */
+import { isAbsolute, resolve, sep } from "node:path";
+/** Canonicalizes a resolved absolute filesystem path to forward slashes, no trailing slash. */
+function toCanonicalAbsolute(absolutePath) {
+    const normalized = absolutePath.split(sep).join("/");
+    if (normalized.length > 1 && normalized.endsWith("/")) {
+        return normalized.slice(0, -1);
+    }
+    return normalized;
+}
+/**
+ * Resolves `candidatePath` against `configFileDir` (the directory containing
+ * the config file that declared it). An already-absolute `candidatePath` is
+ * returned canonicalized as-is (spec.md §4.3 allows absolute paths).
+ */
+export function resolveConfigPath(candidatePath, configFileDir) {
+    const absolute = isAbsolute(candidatePath)
+        ? candidatePath
+        : resolve(configFileDir, candidatePath);
+    return toCanonicalAbsolute(absolute);
+}
+/**
+ * Resolves every `RepositoryConfig.path` in `repositories` relative to
+ * `configFileDir`, returning new objects (inputs are not mutated).
+ */
+export function resolveRepositoryPaths(repositories, configFileDir) {
+    return repositories.map((repo) => ({
+        ...repo,
+        path: resolveConfigPath(repo.path, configFileDir),
+    }));
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAErD,+FAA+F;AAC/F,SAAS,mBAAmB,CAAC,YAAoB;IAC/C,MAAM,UAAU,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACtD,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,aAAqB,EAAE,aAAqB;IAC5E,MAAM,QAAQ,GAAG,UAAU,CAAC,aAAa,CAAC;QACxC,CAAC,CAAC,aAAa;QACf,CAAC,CAAC,OAAO,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;IAC1C,OAAO,mBAAmB,CAAC,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,YAA0B,EAC1B,aAAqB;IAErB,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACjC,GAAG,IAAI;QACP,IAAI,EAAE,iBAAiB,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC;KAClD,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/schema.d.ts

@@ -0,0 +1,5 @@
+/** Absolute filesystem path to the hand-authored JSON Schema (Draft 2020-12) for `UntangleConfigV1`. */
+export declare const CONFIG_SCHEMA_PATH: string;
+/** The parsed JSON Schema object itself, read once at module load. */
+export declare const CONFIG_SCHEMA: Record<string, unknown>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAgBA,wGAAwG;AACxG,eAAO,MAAM,kBAAkB,EAAE,MAAiC,CAAC;AAEnE,sEAAsE;AACtE,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAEtB,CAAC"}