@untangle-code/config 0.0.0-stage → 0.1.1

package/dist/validate.js

@@ -0,0 +1,337 @@
+/**
+ * Configuration validation (spec.md §4.8):
+ *
+ * - unknown top-level fields SHOULD warn, never be silently dropped;
+ * - invalid enum values or unresolvable core values MUST abort startup;
+ * - dimension misconfiguration MUST be detectable before the first index upsert;
+ * - the validated effective profile MUST be stored with the index.
+ *
+ * This module never throws for warnings. It returns both lists; callers that
+ * want spec.md §4.8's "MUST abort" behavior call {@link assertConfigValid}.
+ */
+import { isErrorCode, UntangleError } from "@untangle-code/domain";
+import { UNTANGLE_CONFIG_V1_KEYS } from "./types.js";
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** URI-backed and network locations are outside the embedded backend contract. */
+function isLocalStoragePath(value) {
+    if (typeof value !== "string" || value.trim() === "" || value.includes("\0"))
+        return false;
+    if (/^[\\/]{2}/u.test(value))
+        return false;
+    if (/^[A-Za-z]:[\\/]/u.test(value))
+        return true;
+    return !/^[A-Za-z][A-Za-z0-9+.-]*:/u.test(value);
+}
+function checkEnum(value, allowed, path, errors) {
+    if (value === undefined) {
+        return;
+    }
+    if (typeof value !== "string" || !allowed.includes(value)) {
+        errors.push({
+            code: "CONFIG_INVALID",
+            message: `"${path}" must be one of ${allowed.map((v) => `"${v}"`).join(", ")}, got ${JSON.stringify(value)}`,
+            path,
+        });
+    }
+}
+function checkPositiveInteger(value, path, errors) {
+    if (value === undefined) {
+        return;
+    }
+    if (typeof value !== "number" || !Number.isInteger(value) || value <= 0) {
+        errors.push({
+            code: "CONFIG_INVALID",
+            message: `"${path}" must be a positive integer, got ${JSON.stringify(value)}`,
+            path,
+        });
+    }
+}
+function checkFiniteRange(value, minimum, maximum, path, errors) {
+    if (typeof value !== "number" || !Number.isFinite(value) || value < minimum || value > maximum) {
+        errors.push({
+            code: "CONFIG_INVALID",
+            message: `"${path}" must be a finite number in [${String(minimum)}, ${String(maximum)}], got ${JSON.stringify(value)}`,
+            path,
+        });
+    }
+}
+function validateRelevancePolicies(search, errors) {
+    const policies = search["relevancePolicies"];
+    if (policies === undefined)
+        return;
+    if (!isRecord(policies)) {
+        errors.push({
+            code: "CONFIG_INVALID",
+            message: '"search.relevancePolicies" must be an object keyed by embedding profile id',
+            path: "search.relevancePolicies",
+        });
+        return;
+    }
+    for (const [profileId, value] of Object.entries(policies)) {
+        const basePath = `search.relevancePolicies.${profileId}`;
+        if (profileId.trim() === "") {
+            errors.push({
+                code: "CONFIG_INVALID",
+                message: '"search.relevancePolicies" keys must be non-empty embedding profile ids',
+                path: "search.relevancePolicies",
+            });
+        }
+        if (!isRecord(value)) {
+            errors.push({
+                code: "CONFIG_INVALID",
+                message: `"${basePath}" must be a relevance policy object`,
+                path: basePath,
+            });
+            continue;
+        }
+        for (const scopeField of ["workspaceId", "collection"]) {
+            if (typeof value[scopeField] !== "string" || value[scopeField].trim() === "") {
+                errors.push({
+                    code: "CONFIG_INVALID",
+                    message: `"${basePath}.${scopeField}" must be a non-empty string`,
+                    path: `${basePath}.${scopeField}`,
+                });
+            }
+        }
+        const policy = value["policy"];
+        if (!isRecord(policy)) {
+            errors.push({
+                code: "CONFIG_INVALID",
+                message: `"${basePath}.policy" must be a relevance policy object`,
+                path: `${basePath}.policy`,
+            });
+            continue;
+        }
+        const policyPath = `${basePath}.policy`;
+        if (typeof policy["calibrationId"] !== "string" || policy["calibrationId"].trim() === "") {
+            errors.push({
+                code: "CONFIG_INVALID",
+                message: `"${policyPath}.calibrationId" must be a non-empty string`,
+                path: `${policyPath}.calibrationId`,
+            });
+        }
+        checkFiniteRange(policy["minimumDenseScore"], -1, 1, `${policyPath}.minimumDenseScore`, errors);
+        checkFiniteRange(policy["minimumDenseSpread"], 0, 2, `${policyPath}.minimumDenseSpread`, errors);
+        const referenceRank = policy["denseReferenceRank"];
+        if (typeof referenceRank !== "number" ||
+            !Number.isInteger(referenceRank) ||
+            referenceRank < 2) {
+            errors.push({
+                code: "CONFIG_INVALID",
+                message: `"${policyPath}.denseReferenceRank" must be an integer >= 2, got ${JSON.stringify(referenceRank)}`,
+                path: `${policyPath}.denseReferenceRank`,
+            });
+        }
+        checkFiniteRange(policy["minimumCandidateIdfCoverage"], 0, 1, `${policyPath}.minimumCandidateIdfCoverage`, errors);
+    }
+}
+/**
+ * Validates a fully layer-merged (but not yet necessarily complete-with-defaults)
+ * configuration object. Returns warnings for unknown top-level fields and
+ * errors for invalid enums, unresolvable core values, and structural
+ * uniqueness violations (spec.md §4.3 repository ids; portfolio.md §14.4
+ * blueprint weight sum).
+ */
+export function validateEffectiveConfig(config) {
+    const errors = [];
+    const warnings = [];
+    // Unknown top-level fields (spec.md §4.8). `$schema` is an accepted,
+    // ignored editor/tooling hint (product.md §11's example config carries it).
+    for (const key of Object.keys(config)) {
+        if (key === "$schema") {
+            continue;
+        }
+        if (!UNTANGLE_CONFIG_V1_KEYS.includes(key)) {
+            warnings.push({
+                code: "unknown_field",
+                message: `unknown top-level config field "${key}" is ignored`,
+                path: key,
+            });
+        }
+    }
+    if (config["schemaVersion"] !== undefined && config["schemaVersion"] !== 1) {
+        errors.push({
+            code: "CONFIG_INVALID",
+            message: `unsupported "schemaVersion" ${JSON.stringify(config["schemaVersion"])}; only 1 is understood without migration`,
+            path: "schemaVersion",
+        });
+    }
+    const storage = config["storage"];
+    if (storage !== undefined) {
+        if (!isRecord(storage)) {
+            errors.push({
+                code: "CONFIG_INVALID",
+                message: '"storage" must be an object',
+                path: "storage",
+            });
+        }
+        else {
+            checkEnum(storage["backend"], ["lancedb", "qdrant"], "storage.backend", errors);
+            if (storage["path"] !== undefined && !isLocalStoragePath(storage["path"])) {
+                errors.push({
+                    code: "CONFIG_INVALID",
+                    message: '"storage.path" must be a non-empty local filesystem path, not a URI or network path',
+                    path: "storage.path",
+                });
+            }
+        }
+    }
+    const qdrant = config["qdrant"];
+    if (isRecord(qdrant)) {
+        checkEnum(qdrant["mode"], ["managed", "external"], "qdrant.mode", errors);
+        if (qdrant["mode"] === "external" &&
+            (typeof qdrant["url"] !== "string" || qdrant["url"].length === 0)) {
+            errors.push({
+                code: "CONFIG_INVALID",
+                message: `"qdrant.url" is required when "qdrant.mode" is "external"`,
+                path: "qdrant.url",
+            });
+        }
+    }
+    const embeddings = config["embeddings"];
+    if (isRecord(embeddings)) {
+        checkEnum(embeddings["provider"], ["ollama"], "embeddings.provider", errors);
+        checkEnum(embeddings["mode"], ["auto", "managed", "external"], "embeddings.mode", errors);
+        checkPositiveInteger(embeddings["dimensions"], "embeddings.dimensions", errors);
+        if (embeddings["mode"] === "external" &&
+            (typeof embeddings["url"] !== "string" || embeddings["url"].length === 0)) {
+            errors.push({
+                code: "CONFIG_INVALID",
+                message: `"embeddings.url" is required when "embeddings.mode" is "external"`,
+                path: "embeddings.url",
+            });
+        }
+    }
+    const search = config["search"];
+    if (isRecord(search)) {
+        validateRelevancePolicies(search, errors);
+    }
+    const qualityGate = config["qualityGate"];
+    if (isRecord(qualityGate)) {
+        checkEnum(qualityGate["mode"], ["off", "warn", "fail"], "qualityGate.mode", errors);
+        checkEnum(qualityGate["minimumParseQuality"], ["failed", "partial", "complete"], "qualityGate.minimumParseQuality", errors);
+    }
+    const complexity = config["complexity"];
+    if (isRecord(complexity)) {
+        checkEnum(complexity["cyclomaticVariant"], ["classic", "extended", "both"], "complexity.cyclomaticVariant", errors);
+    }
+    const telemetry = config["telemetry"];
+    if (isRecord(telemetry)) {
+        checkEnum(telemetry["logLevel"], ["error", "warn", "info", "debug", "trace"], "telemetry.logLevel", errors);
+        checkEnum(telemetry["metricsExport"], ["none", "prometheus"], "telemetry.metricsExport", errors);
+    }
+    const portfolio = config["portfolio"];
+    if (isRecord(portfolio)) {
+        const enrichment = portfolio["enrichment"];
+        if (isRecord(enrichment) && Array.isArray(enrichment["registries"])) {
+            const allowed = ["npm", "pypi", "crates", "maven", "nuget", "go", "composer"];
+            for (const [index, registry] of enrichment["registries"].entries()) {
+                checkEnum(registry, allowed, `portfolio.enrichment.registries[${index}]`, errors);
+            }
+        }
+        const weights = isRecord(portfolio["blueprint"])
+            ? portfolio["blueprint"]["weights"]
+            : undefined;
+        if (isRecord(weights)) {
+            const adoption = typeof weights["adoption"] === "number" ? weights["adoption"] : 0;
+            const recency = typeof weights["recency"] === "number" ? weights["recency"] : 0;
+            const health = typeof weights["health"] === "number" ? weights["health"] : 0;
+            const versionConsistency = typeof weights["versionConsistency"] === "number" ? weights["versionConsistency"] : 0;
+            const sum = adoption + recency + health + versionConsistency;
+            if (Math.abs(sum - 1.0) > 0.001) {
+                errors.push({
+                    code: "CONFIG_INVALID",
+                    message: `"portfolio.blueprint.weights" must sum to 1.0 (±0.001), got ${sum}`,
+                    path: "portfolio.blueprint.weights",
+                });
+            }
+        }
+    }
+    // Repository id uniqueness (spec.md §4.3: "id MUSS innerhalb eines Workspaces eindeutig sein").
+    const repositories = config["repositories"];
+    if (Array.isArray(repositories)) {
+        const seen = new Set();
+        for (const [index, repo] of repositories.entries()) {
+            const id = isRecord(repo) ? repo["id"] : undefined;
+            if (typeof id !== "string" || id.length === 0) {
+                errors.push({
+                    code: "CONFIG_INVALID",
+                    message: `"repositories[${index}].id" is required`,
+                    path: `repositories[${index}].id`,
+                });
+                continue;
+            }
+            if (seen.has(id)) {
+                errors.push({
+                    code: "CONFIG_INVALID",
+                    message: `duplicate repository id "${id}"`,
+                    path: `repositories[${index}].id`,
+                });
+            }
+            seen.add(id);
+        }
+    }
+    // Context artifact name uniqueness (spec.md §19.2: unique per project).
+    const contextArtifacts = config["contextArtifacts"];
+    if (Array.isArray(contextArtifacts)) {
+        const seen = new Set();
+        for (const [index, artifact] of contextArtifacts.entries()) {
+            const name = isRecord(artifact) ? artifact["name"] : undefined;
+            if (typeof name !== "string" || name.length === 0) {
+                errors.push({
+                    code: "CONFIG_INVALID",
+                    message: `"contextArtifacts[${index}].name" is required`,
+                    path: `contextArtifacts[${index}].name`,
+                });
+                continue;
+            }
+            if (seen.has(name)) {
+                errors.push({
+                    code: "CONFIG_INVALID",
+                    message: `duplicate context artifact name "${name}"`,
+                    path: `contextArtifacts[${index}].name`,
+                });
+            }
+            seen.add(name);
+        }
+    }
+    return { errors, warnings };
+}
+/**
+ * Throws `UntangleError("CONFIG_INVALID", …)` when `errors` is non-empty
+ * (spec.md §4.8: invalid enums / unresolvable core values MUST abort
+ * startup). Callers decide when to call this — `loadConfig` itself never
+ * throws for either warnings or errors, so a caller can inspect both lists
+ * first (e.g. to print them) before deciding to abort.
+ */
+export function assertConfigValid(errors) {
+    if (errors.length === 0) {
+        return;
+    }
+    const code = isErrorCode(errors[0]?.code) ? errors[0].code : "CONFIG_INVALID";
+    throw new UntangleError(code, `configuration is invalid: ${errors.map((e) => e.message).join("; ")}`, {
+        operation: "config.validate",
+        context: { issues: errors },
+    });
+}
+/**
+ * Pre-upsert dimension check (spec.md §4.8: "Falsch konfigurierte Dimensionen
+ * MÜSSEN vor dem ersten Index-Upsert erkannt werden."). Callers invoke this
+ * with the configured `embeddings.dimensions` and the dimension already
+ * committed to an existing Qdrant collection (from `MetadataStore`/
+ * `VectorStore` introspection) before ANY upsert into that collection.
+ */
+export function assertEmbeddingDimensionsMatch(configuredDimensions, existingCollectionDimensions) {
+    if (existingCollectionDimensions === undefined) {
+        return;
+    }
+    if (configuredDimensions !== existingCollectionDimensions) {
+        throw new UntangleError("EMBEDDING_DIMENSION_MISMATCH", `configured embedding dimensions (${configuredDimensions}) do not match the existing collection's dimensions (${existingCollectionDimensions})`, {
+            operation: "config.validate",
+            context: { configuredDimensions, existingCollectionDimensions },
+        });
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

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

package/package.json

@@ -1,6 +1,68 @@
 {
   "name": "@untangle-code/config",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "private": false,
+  "type": "module",
+  "description": "Untangle configuration: types, discovery, layering, JSON Schema, secret redaction and canonical effective config.",
+  "license": "AGPL-3.0-only",
+  "homepage": "https://github.com/lboel/untangle",
+  "bugs": {
+    "url": "https://github.com/lboel/untangle/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lboel/untangle.git",
+    "directory": "packages/config"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": "^22.13.0 || >=24.0.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./schema": {
+      "types": "./dist/schema.d.ts",
+      "default": "./dist/schema.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.test.*",
+    "!dist/**/test-helpers.*",
+    "!dist/**/test-support.*",
+    "!dist/**/test-support/**",
+    "!dist/**/testing/**",
+    "!dist/**/__tests__/**",
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/test-helpers.ts",
+    "!src/**/test-support.ts",
+    "!src/**/test-support/**",
+    "!src/**/testing/**",
+    "schemas",
+    "LICENSE",
+    "NOTICE",
+    "README.md",
+    "THIRD_PARTY_LICENSES.md"
+  ],
+  "dependencies": {
+    "smol-toml": "1.8.0",
+    "@untangle-code/domain": "0.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "22.19.7",
+    "typescript": "5.9.3",
+    "vitest": "3.2.7"
+  },
+  "scripts": {
+    "build": "node ../../scripts/tsc-build.mjs tsconfig.json",
+    "typecheck": "tsc -p tsconfig.typecheck.json",
+    "test": "vitest run",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  }
 }