@untangle-code/config 0.0.0-stage → 0.1.1

package/dist/schema.js

@@ -0,0 +1,19 @@
+/**
+ * JSON Schema export (architecture.md §6.3, §7.3; docs/BUILD_PLAN.md §3
+ * assigns the repo-level `schemas/` directory to this package's WP).
+ *
+ * NOTE (openIssues): the task that produced this package restricts writes to
+ * `packages/config/**`, so the authoritative file lives at
+ * `packages/config/schemas/config-v1.json`, not the (currently empty, WP-02
+ * owned per docs/BUILD_PLAN.md §4) repo-root `schemas/`. It still needs to be
+ * mirrored to `schemas/config-v1.json` by whoever is authorized to write
+ * there.
+ */
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+const schemaUrl = new URL("../schemas/config-v1.json", import.meta.url);
+/** Absolute filesystem path to the hand-authored JSON Schema (Draft 2020-12) for `UntangleConfigV1`. */
+export const CONFIG_SCHEMA_PATH = fileURLToPath(schemaUrl);
+/** The parsed JSON Schema object itself, read once at module load. */
+export const CONFIG_SCHEMA = JSON.parse(readFileSync(schemaUrl, "utf8"));
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,2BAA2B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAExE,wGAAwG;AACxG,MAAM,CAAC,MAAM,kBAAkB,GAAW,aAAa,CAAC,SAAS,CAAC,CAAC;AAEnE,sEAAsE;AACtE,MAAM,CAAC,MAAM,aAAa,GAA4B,IAAI,CAAC,KAAK,CAC9D,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CACL,CAAC"}

package/dist/secrets.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Secret references and redaction (spec.md §4.4/§4.5 `apiKeyEnv`; §24
+ * "API-Keys DÜRFEN nicht in Status, Logs oder Crash Reports erscheinen";
+ * architecture.md §23.2: "Der Wert wird nie in Effective Config Dumps
+ * geschrieben.").
+ *
+ * The primary guarantee is structural: `QdrantConfig`/`EmbeddingConfig` only
+ * ever carry `apiKeyEnv` — the NAME of an environment variable — never a
+ * resolved secret value, so an `EffectiveUntangleConfigV1` cannot contain a
+ * secret by construction. `redactSecrets` is a defense-in-depth belt: it
+ * scrubs any resolved-secret-shaped field (e.g. code elsewhere mistakenly
+ * attaching a resolved key onto a config object for convenience) before that
+ * object is serialized, dumped, or logged.
+ */
+/**
+ * Returns a deep copy of `value` with any field whose name looks like a
+ * resolved secret (`apiKey`, `token`, `password`, `secret`, `credential`, but
+ * NOT the `...Env` reference fields) replaced by a fixed placeholder. Safe to
+ * call on an `EffectiveUntangleConfigV1`, a partial layer, or arbitrary
+ * nested data.
+ */
+export declare function redactSecrets<T>(value: T): T;
+/** `JSON.stringify` through {@link redactSecrets} — the one safe way to dump a config. */
+export declare function toRedactedJson(value: unknown, space?: number): string;
+/**
+ * Resolves an `apiKeyEnv` reference to its actual secret value AT CALL TIME.
+ * The result MUST NOT be stored back onto any config object — callers (e.g.
+ * a Qdrant/Ollama adapter) use it immediately for one connection attempt.
+ * Returns `undefined` when `envVarName` is unset or the variable is not
+ * present in `env`.
+ */
+export declare function resolveApiKey(envVarName: string | undefined, env?: NodeJS.ProcessEnv): string | undefined;
+//# sourceMappingURL=secrets.d.ts.map

package/dist/secrets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.d.ts","sourceRoot":"","sources":["../src/secrets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAiCH;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAE5C;AAED,0FAA0F;AAC1F,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAErE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,GAAG,SAAS,CAKpB"}

package/dist/secrets.js

@@ -0,0 +1,69 @@
+/**
+ * Secret references and redaction (spec.md §4.4/§4.5 `apiKeyEnv`; §24
+ * "API-Keys DÜRFEN nicht in Status, Logs oder Crash Reports erscheinen";
+ * architecture.md §23.2: "Der Wert wird nie in Effective Config Dumps
+ * geschrieben.").
+ *
+ * The primary guarantee is structural: `QdrantConfig`/`EmbeddingConfig` only
+ * ever carry `apiKeyEnv` — the NAME of an environment variable — never a
+ * resolved secret value, so an `EffectiveUntangleConfigV1` cannot contain a
+ * secret by construction. `redactSecrets` is a defense-in-depth belt: it
+ * scrubs any resolved-secret-shaped field (e.g. code elsewhere mistakenly
+ * attaching a resolved key onto a config object for convenience) before that
+ * object is serialized, dumped, or logged.
+ */
+const REDACTED_PLACEHOLDER = "[REDACTED]";
+// Field name ends in one of these -> looks like a *resolved* secret value.
+const SECRET_VALUE_KEY_PATTERN = /(apikey|secret|password|token|credential)$/i;
+// ...unless it ends in "Env" (e.g. `apiKeyEnv`), which holds an env var NAME
+// and is exactly what spec.md §24 requires to stay visible for transparency.
+const ENV_REFERENCE_SUFFIX_PATTERN = /env$/i;
+function looksLikeResolvedSecretKey(key) {
+    if (ENV_REFERENCE_SUFFIX_PATTERN.test(key)) {
+        return false;
+    }
+    return SECRET_VALUE_KEY_PATTERN.test(key);
+}
+function redactRecursive(value) {
+    if (Array.isArray(value)) {
+        return value.map(redactRecursive);
+    }
+    if (value !== null && typeof value === "object") {
+        const result = {};
+        for (const [key, entryValue] of Object.entries(value)) {
+            result[key] = looksLikeResolvedSecretKey(key)
+                ? REDACTED_PLACEHOLDER
+                : redactRecursive(entryValue);
+        }
+        return result;
+    }
+    return value;
+}
+/**
+ * Returns a deep copy of `value` with any field whose name looks like a
+ * resolved secret (`apiKey`, `token`, `password`, `secret`, `credential`, but
+ * NOT the `...Env` reference fields) replaced by a fixed placeholder. Safe to
+ * call on an `EffectiveUntangleConfigV1`, a partial layer, or arbitrary
+ * nested data.
+ */
+export function redactSecrets(value) {
+    return redactRecursive(value);
+}
+/** `JSON.stringify` through {@link redactSecrets} — the one safe way to dump a config. */
+export function toRedactedJson(value, space) {
+    return JSON.stringify(redactSecrets(value), null, space);
+}
+/**
+ * Resolves an `apiKeyEnv` reference to its actual secret value AT CALL TIME.
+ * The result MUST NOT be stored back onto any config object — callers (e.g.
+ * a Qdrant/Ollama adapter) use it immediately for one connection attempt.
+ * Returns `undefined` when `envVarName` is unset or the variable is not
+ * present in `env`.
+ */
+export function resolveApiKey(envVarName, env = process.env) {
+    if (envVarName === undefined || envVarName.length === 0) {
+        return undefined;
+    }
+    return env[envVarName];
+}
+//# sourceMappingURL=secrets.js.map

package/dist/secrets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.js","sourceRoot":"","sources":["../src/secrets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,oBAAoB,GAAG,YAAY,CAAC;AAE1C,2EAA2E;AAC3E,MAAM,wBAAwB,GAAG,6CAA6C,CAAC;AAC/E,6EAA6E;AAC7E,6EAA6E;AAC7E,MAAM,4BAA4B,GAAG,OAAO,CAAC;AAE7C,SAAS,0BAA0B,CAAC,GAAW;IAC7C,IAAI,4BAA4B,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3C,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,wBAAwB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IACpC,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACtD,MAAM,CAAC,GAAG,CAAC,GAAG,0BAA0B,CAAC,GAAG,CAAC;gBAC3C,CAAC,CAAC,oBAAoB;gBACtB,CAAC,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAI,KAAQ;IACvC,OAAO,eAAe,CAAC,KAAK,CAAM,CAAC;AACrC,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,cAAc,CAAC,KAAc,EAAE,KAAc;IAC3D,OAAO,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,UAA8B,EAC9B,MAAyB,OAAO,CAAC,GAAG;IAEpC,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,GAAG,CAAC,UAAU,CAAC,CAAC;AACzB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,323 @@
+/**
+ * Configuration types (spec.md §4.2–§4.8, §5.7; product.md §11; portfolio.md
+ * §14.4; architecture.md §6.3, §23.2).
+ *
+ * These are the *raw*, *partial*-friendly shapes a `.untangle.json`,
+ * environment layer or CLI argument object may contribute. The fully merged,
+ * defaulted and validated shape produced by {@link "./load.js"} carries the
+ * same interfaces but with all optional fields the product defaults fill in
+ * actually present — see `EffectiveUntangleConfigV1` at the bottom of this
+ * file.
+ */
+import type { ContextArtifactConfig, RepositoryConfig } from "@untangle-code/domain";
+export type { ContextArtifactConfig, ContextArtifactType } from "@untangle-code/domain";
+export type { RepositoryConfig } from "@untangle-code/domain";
+/** spec.md §4.4. */
+export interface QdrantConfig {
+    mode: "managed" | "external";
+    url?: string;
+    /** Name of the environment variable holding the API key — never the key itself (architecture.md §23.2). */
+    apiKeyEnv?: string;
+    collectionPrefix?: string;
+    requestTimeoutMs?: number;
+    maxRetries?: number;
+    upsertMaxPoints?: number;
+    upsertBudgetBytes?: number;
+}
+/** Search backend selection. Relative local paths resolve against the repository root. */
+export interface StorageConfig {
+    backend: "lancedb" | "qdrant";
+    /** Embedded LanceDB directory; defaults to `.untangle/index/lancedb`. */
+    path?: string;
+}
+/** spec.md §4.5. */
+export interface EmbeddingConfig {
+    provider: "ollama";
+    mode: "auto" | "managed" | "external";
+    url?: string;
+    /** Name of the environment variable holding the API key — never the key itself (architecture.md §23.2). */
+    apiKeyEnv?: string;
+    model: string;
+    dimensions: number;
+    contextLength: number;
+    queryPrefix: string;
+    documentPrefix: string;
+    includePath: boolean;
+    batchSize: number;
+    maxConnections: number;
+    requestTimeoutMs: number;
+}
+/** spec.md §4.6. */
+export interface IndexConfig {
+    watch: boolean;
+    reconcileIntervalMinutes: number;
+    maxFileSizeMb: number;
+    maxGraphFileSizeMb: number;
+    scanConcurrency: number;
+    embeddingConcurrency: number;
+    filesPerCheckpoint: number;
+    targetChunkTokens: number;
+    maxChunkTokens: number;
+    fallbackOverlapTokens: number;
+    includeDotFiles: boolean;
+    indexExtensionless: boolean;
+    extraExtensions: string[];
+    extensionLanguageMap: Record<string, string>;
+}
+/**
+ * Search defaults (Untangle decision — spec.md §13 defines the request/result
+ * shapes `SearchRequestV1`/`SearchResultV1` in domain, but names no
+ * `SearchConfig` fields; this shape documents which of those request knobs
+ * get a project-wide default and adds the boost weights spec.md §13.3 lists
+ * without assigning default magnitudes).
+ */
+export interface SearchConfig {
+    /** Default `limit` when a search request omits it. */
+    defaultLimit: number;
+    /** Default `candidateLimit` (pre-RRF/pre-filter pool size) when omitted. */
+    defaultCandidateLimit: number;
+    /** Hard ceiling a caller-supplied `candidateLimit` is clamped to. */
+    maxCandidateLimit: number;
+    /** Default `diversify` (MMR, architecture.md §18.5) when a request omits it. */
+    diversifyByDefault: boolean;
+    /** Default `minScore` when a request omits it. */
+    minScoreDefault?: number;
+    /**
+     * Calibrated absence decisions, keyed by the exact embedding profile id.
+     *
+     * These values are deliberately optional and have no product default: raw
+     * cosine scores are model-specific, and their useful separation also
+     * depends on the indexed corpus. A policy therefore only applies when its
+     * key, workspace id, and physical collection all match the active target.
+     */
+    relevancePolicies?: Record<string, SearchRelevancePolicyBindingConfigV1>;
+    /** Relative weights of the additive score components (spec.md §13.3). */
+    boostWeights: {
+        exactSymbol: number;
+        exactPath: number;
+        repoPriority: number;
+        graphProximity: number;
+        recency: number;
+        duplicatePenalty: number;
+    };
+}
+/** Corpus binding for a calibrated search relevance policy (WP-231). */
+export interface SearchRelevancePolicyBindingConfigV1 {
+    /** Exact logical workspace used while calibrating the thresholds. */
+    workspaceId: string;
+    /** Exact physical vector collection used while calibrating the thresholds. */
+    collection: string;
+    policy: SearchRelevancePolicyConfigV1;
+}
+/** Config representation of the search engine's calibrated relevance policy (WP-231). */
+export interface SearchRelevancePolicyConfigV1 {
+    /** Human- and machine-readable provenance of the measurements behind the thresholds. */
+    calibrationId: string;
+    /** Absolute minimum cosine score of the strongest dense candidate, in [-1, 1]. */
+    minimumDenseScore: number;
+    /** Minimum difference between rank 1 and `denseReferenceRank`, in [0, 2]. */
+    minimumDenseSpread: number;
+    /** One-based dense rank used for the relative comparison; at least 2. */
+    denseReferenceRank: number;
+    /** Minimum IDF-weighted fraction of query evidence found together in one candidate. */
+    minimumCandidateIdfCoverage: number;
+}
+/**
+ * Graph traversal limits (Untangle decision — architecture.md §17.4 names
+ * `maxDepth`/`maxNodes`/`maxEdges`/`maxWallTimeMs` as per-query traversal
+ * limits without a config shape; this makes them project-configurable
+ * defaults). `includeDynamicImports` reflects the `dynamic_import` edge kind
+ * from spec.md §14.2 being switchable.
+ */
+export interface GraphConfig {
+    enabled: boolean;
+    maxTraversalDepth: number;
+    maxTraversalNodes: number;
+    maxTraversalEdges: number;
+    maxTraversalWallTimeMs: number;
+    includeDynamicImports: boolean;
+}
+/**
+ * Complexity engine switches (Untangle decision — spec.md §16 defines the
+ * metrics and algorithm IDs exhaustively but no `ComplexityConfig` shape;
+ * product.md §11's example config uses `enabled` and `cognitiveAlgorithm`,
+ * which anchor this shape). `cyclomaticVariant` selects which of classic
+ * (§16.2) and extended (§16.3) get computed; both are cheap to compute
+ * together so "both" is the default.
+ */
+export interface ComplexityConfig {
+    enabled: boolean;
+    /** Overridable for future algorithm versions; defaults to `COGNITIVE_ALGORITHM_ID` from domain. */
+    cognitiveAlgorithm: string;
+    cyclomaticVariant: "classic" | "extended" | "both";
+    maintainabilityIndexEnabled: boolean;
+}
+/**
+ * Change Intelligence configuration (Untangle decision — spec.md §17.6 gives
+ * the default risk score weights and requires every component to be
+ * disclosed with its weight and contribution, but does not name a config
+ * type). Weights MUST sum to `1.0` within a `±0.001` tolerance, mirroring the
+ * validation rule portfolio.md §14.4 states for `blueprint.weights`.
+ */
+export interface ChangeConfig {
+    enabled: boolean;
+    riskWeights: {
+        churn: number;
+        positiveCognitiveDelta: number;
+        positiveCyclomaticDelta: number;
+        blastRadius: number;
+        graphCentrality: number;
+        semanticChange: number;
+        testDistance: number;
+    };
+    symbolMatching: {
+        /** Minimum token/MinHash similarity (spec.md §17.3 step 4) to accept a rename/move candidate. */
+        tokenSimilarityMin: number;
+        /** Whether step 6 (embedding cosine at equal profile) participates at all. */
+        enableEmbeddingSimilarity: boolean;
+    };
+}
+/** spec.md §4.7. */
+export interface QualityGateConfig {
+    mode: "off" | "warn" | "fail";
+    newCyclesAllowed: number;
+    cognitivePerSymbolMax?: number;
+    cognitiveDeltaPerSymbolMax?: number;
+    cyclomaticPerSymbolMax?: number;
+    cyclomaticDeltaPerSymbolMax?: number;
+    maxNestingPerSymbolMax?: number;
+    maintainabilityIndexMin?: number;
+    riskScoreMax?: number;
+    minimumParseQuality: "failed" | "partial" | "complete";
+    ignoreExistingViolations: boolean;
+    include?: string[];
+    exclude?: string[];
+}
+/**
+ * Telemetry (spec.md §24: "Telemetrie MUSS standardmäßig aus sein" — telemetry
+ * MUST default to off; §23.2/§23.3 name the log/metrics facilities this
+ * switches). Shape beyond `enabled` is an Untangle decision.
+ */
+export interface TelemetryConfig {
+    /** Default `false` — local-first, opt-in only (spec.md §24). */
+    enabled: boolean;
+    logLevel: "error" | "warn" | "info" | "debug" | "trace";
+    /** Whether internal counters (spec.md §23.3) are exported to an external system. */
+    metricsExport: "none" | "prometheus";
+}
+/** portfolio.md §13. */
+export interface PortfolioEnrichmentConfig {
+    /** Default `false` — no registry/network access without opt-in (portfolio.md §13). */
+    enabled: boolean;
+    registries: ("npm" | "pypi" | "crates" | "maven" | "nuget" | "go" | "composer")[];
+    registryUrls?: Record<string, string>;
+    /** Default `168` (one week). */
+    cacheTtlHours: number;
+    timeoutMs: number;
+}
+/** portfolio.md §14.4 — normative shape. */
+export interface PortfolioConfig {
+    /** Default `true`. */
+    enabled?: boolean;
+    /** Default `false`. */
+    includeTransitive?: boolean;
+    /** Default `2`. */
+    conventionMinRepos?: number;
+    conventions?: {
+        pinned?: string[];
+        suppressed?: string[];
+    };
+    radar?: {
+        /** Default `0.5`. */
+        adoptShareMin?: number;
+        /** Default `0.2`. */
+        maintainShareMin?: number;
+        /** Default `540`. */
+        retireAfterDays?: number;
+    };
+    blueprint?: {
+        weights?: {
+            /** Default `0.40`. */
+            adoption?: number;
+            /** Default `0.20`. */
+            recency?: number;
+            /** Default `0.25`. */
+            health?: number;
+            /** Default `0.15`. */
+            versionConsistency?: number;
+        };
+    };
+    enrichment?: PortfolioEnrichmentConfig;
+}
+/**
+ * Main configuration schema (spec.md §4.2), extended with `portfolio`
+ * (portfolio.md §14.4, folded into `UntangleConfigV1` per portfolio.md
+ * §18.1's planned spec.md §4.2 amendment).
+ */
+export interface UntangleConfigV1 {
+    schemaVersion: 1;
+    workspaceId?: string;
+    projectId?: string;
+    repositories?: RepositoryConfig[];
+    storage?: StorageConfig;
+    qdrant?: QdrantConfig;
+    embeddings?: EmbeddingConfig;
+    index?: IndexConfig;
+    search?: SearchConfig;
+    graph?: GraphConfig;
+    complexity?: ComplexityConfig;
+    changes?: ChangeConfig;
+    qualityGate?: QualityGateConfig;
+    contextArtifacts?: ContextArtifactConfig[];
+    telemetry?: TelemetryConfig;
+    portfolio?: PortfolioConfig;
+}
+/** The set of `UntangleConfigV1` top-level keys, used to detect unknown fields (spec.md §4.8). */
+export declare const UNTANGLE_CONFIG_V1_KEYS: readonly ["schemaVersion", "workspaceId", "projectId", "repositories", "storage", "qdrant", "embeddings", "index", "search", "graph", "complexity", "changes", "qualityGate", "contextArtifacts", "telemetry", "portfolio"];
+/**
+ * Recursively makes every field of `T` optional, including inside array
+ * elements. Used for {@link RawConfigLayer}: a single JSON file, an env-var
+ * layer, or an `explicit` argument object commonly sets only a handful of
+ * leaves inside a nested config section (e.g. just `qdrant.collectionPrefix`)
+ * — a shallow `Partial<T>` would still require every OTHER field of
+ * `QdrantConfig` once `qdrant` is present at all, which is not how any of
+ * the six layers in spec.md §4.1 are actually written. Runtime validation
+ * (`validate.ts`) is what enforces which fields are truly required once all
+ * layers are merged with the product defaults.
+ */
+export type DeepPartial<T> = T extends (infer U)[] ? DeepPartial<U>[] : T extends object ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : T;
+/**
+ * A raw configuration layer as read from JSON, environment mapping or passed
+ * explicitly: every field optional (deeply — see {@link DeepPartial}),
+ * `schemaVersion` not required (defaults are applied and validated later).
+ * `$schema` is accepted and ignored (spec.md §11's example config carries it).
+ */
+export type RawConfigLayer = {
+    $schema?: string;
+    schemaVersion?: number;
+} & DeepPartial<Omit<UntangleConfigV1, "schemaVersion">>;
+/**
+ * The fully merged, defaulted and validated configuration
+ * ({@link "./load.js"}'s `loadConfig` result). All fields the product
+ * defaults (spec.md §4.5, this package's `defaults.ts`) supply are guaranteed
+ * present; `repositories` and `contextArtifacts` stay optional because they
+ * have no universal default (spec.md §4.3: the current project path MAY
+ * serve as an implicit single repository instead).
+ */
+export interface EffectiveUntangleConfigV1 extends UntangleConfigV1 {
+    schemaVersion: 1;
+    storage: StorageConfig;
+    qdrant: QdrantConfig;
+    embeddings: EmbeddingConfig;
+    index: IndexConfig;
+    search: SearchConfig;
+    graph: GraphConfig;
+    complexity: ComplexityConfig;
+    changes: ChangeConfig;
+    qualityGate: QualityGateConfig;
+    telemetry: TelemetryConfig;
+    portfolio: PortfolioConfig;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAOrF,YAAY,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACxF,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,oBAAoB;AACpB,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,GAAG,UAAU,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2GAA2G;IAC3G,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,0FAA0F;AAC1F,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC9B,yEAAyE;IACzE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,oBAAoB;AACpB,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2GAA2G;IAC3G,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,oBAAoB;AACpB,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,OAAO,CAAC;IACf,wBAAwB,EAAE,MAAM,CAAC;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,eAAe,EAAE,OAAO,CAAC;IACzB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9C;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,sDAAsD;IACtD,YAAY,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,qBAAqB,EAAE,MAAM,CAAC;IAC9B,qEAAqE;IACrE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gFAAgF;IAChF,kBAAkB,EAAE,OAAO,CAAC;IAC5B,kDAAkD;IAClD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;;;OAOG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,oCAAoC,CAAC,CAAC;IACzE,yEAAyE;IACzE,YAAY,EAAE;QACZ,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,MAAM,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC;QAChB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAED,wEAAwE;AACxE,MAAM,WAAW,oCAAoC;IACnD,qEAAqE;IACrE,WAAW,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,6BAA6B,CAAC;CACvC;AAED,yFAAyF;AACzF,MAAM,WAAW,6BAA6B;IAC5C,wFAAwF;IACxF,aAAa,EAAE,MAAM,CAAC;IACtB,kFAAkF;IAClF,iBAAiB,EAAE,MAAM,CAAC;IAC1B,6EAA6E;IAC7E,kBAAkB,EAAE,MAAM,CAAC;IAC3B,yEAAyE;IACzE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,uFAAuF;IACvF,2BAA2B,EAAE,MAAM,CAAC;CACrC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,qBAAqB,EAAE,OAAO,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,mGAAmG;IACnG,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;IACnD,2BAA2B,EAAE,OAAO,CAAC;CACtC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE;QACX,KAAK,EAAE,MAAM,CAAC;QACd,sBAAsB,EAAE,MAAM,CAAC;QAC/B,uBAAuB,EAAE,MAAM,CAAC;QAChC,WAAW,EAAE,MAAM,CAAC;QACpB,eAAe,EAAE,MAAM,CAAC;QACxB,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,cAAc,EAAE;QACd,iGAAiG;QACjG,kBAAkB,EAAE,MAAM,CAAC;QAC3B,8EAA8E;QAC9E,yBAAyB,EAAE,OAAO,CAAC;KACpC,CAAC;CACH;AAED,oBAAoB;AACpB,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;IACvD,wBAAwB,EAAE,OAAO,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IACxD,oFAAoF;IACpF,aAAa,EAAE,MAAM,GAAG,YAAY,CAAC;CACtC;AAED,wBAAwB;AACxB,MAAM,WAAW,yBAAyB;IACxC,sFAAsF;IACtF,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,CAAC,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,IAAI,GAAG,UAAU,CAAC,EAAE,CAAC;IAClF,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,gCAAgC;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,4CAA4C;AAC5C,MAAM,WAAW,eAAe;IAC9B,sBAAsB;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uBAAuB;IACvB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,mBAAmB;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,WAAW,CAAC,EAAE;QACZ,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC;IACF,KAAK,CAAC,EAAE;QACN,qBAAqB;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,qBAAqB;QACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,qBAAqB;QACrB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,SAAS,CAAC,EAAE;QACV,OAAO,CAAC,EAAE;YACR,sBAAsB;YACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,sBAAsB;YACtB,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,sBAAsB;YACtB,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,sBAAsB;YACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;SAC7B,CAAC;KACH,CAAC;IACF,UAAU,CAAC,EAAE,yBAAyB,CAAC;CACxC;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,CAAC,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAClC,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,gBAAgB,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAC3C,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B;AAED,kGAAkG;AAClG,eAAO,MAAM,uBAAuB,6NAiBoB,CAAC;AAEzD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAC9C,WAAW,CAAC,CAAC,CAAC,EAAE,GAChB,CAAC,SAAS,MAAM,GACd;KAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GACtC,CAAC,CAAC;AAER;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,WAAW,CAAC,IAAI,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAAC,CAAC;AAEzD;;;;;;;GAOG;AACH,MAAM,WAAW,yBAA0B,SAAQ,gBAAgB;IACjE,aAAa,EAAE,CAAC,CAAC;IACjB,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,EAAE,eAAe,CAAC;IAC5B,KAAK,EAAE,WAAW,CAAC;IACnB,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,WAAW,CAAC;IACnB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,OAAO,EAAE,YAAY,CAAC;IACtB,WAAW,EAAE,iBAAiB,CAAC;IAC/B,SAAS,EAAE,eAAe,CAAC;IAC3B,SAAS,EAAE,eAAe,CAAC;CAC5B"}

package/dist/types.js

@@ -0,0 +1,20 @@
+/** The set of `UntangleConfigV1` top-level keys, used to detect unknown fields (spec.md §4.8). */
+export const UNTANGLE_CONFIG_V1_KEYS = [
+    "schemaVersion",
+    "workspaceId",
+    "projectId",
+    "repositories",
+    "storage",
+    "qdrant",
+    "embeddings",
+    "index",
+    "search",
+    "graph",
+    "complexity",
+    "changes",
+    "qualityGate",
+    "contextArtifacts",
+    "telemetry",
+    "portfolio",
+];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAwSA,kGAAkG;AAClG,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,eAAe;IACf,aAAa;IACb,WAAW;IACX,cAAc;IACd,SAAS;IACT,QAAQ;IACR,YAAY;IACZ,OAAO;IACP,QAAQ;IACR,OAAO;IACP,YAAY;IACZ,SAAS;IACT,aAAa;IACb,kBAAkB;IAClB,WAAW;IACX,WAAW;CAC2C,CAAC"}

package/dist/user-config.d.ts

@@ -0,0 +1,13 @@
+export declare const USER_CONFIG_FILE_NAME = "config.json";
+/**
+ * Resolves the per-OS Untangle config directory:
+ * - Linux: `$XDG_CONFIG_HOME/untangle` or `~/.config/untangle`;
+ * - macOS: `~/Library/Application Support/untangle`;
+ * - Windows: `%APPDATA%\untangle` or `~/AppData/Roaming/untangle`.
+ *
+ * `env` and `platform` are injectable for deterministic tests.
+ */
+export declare function resolveUserConfigDir(env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform): string;
+/** Full path to the user config file, or `undefined` when it does not exist. */
+export declare function resolveUserConfigPath(env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform): string | undefined;
+//# sourceMappingURL=user-config.d.ts.map

package/dist/user-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-config.d.ts","sourceRoot":"","sources":["../src/user-config.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,qBAAqB,gBAAgB,CAAC;AAEnD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,MAAM,CAgBR;AAED,gFAAgF;AAChF,wBAAgB,qBAAqB,CACnC,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,MAAM,GAAG,SAAS,CAGpB"}

package/dist/user-config.js

@@ -0,0 +1,34 @@
+/**
+ * User configuration location (spec.md §4.1 layer 5: "Nutzerkonfiguration im
+ * OS-Konfigurationsverzeichnis"). The exact directory and file name are an
+ * Untangle decision — spec.md does not name them.
+ */
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+export const USER_CONFIG_FILE_NAME = "config.json";
+/**
+ * Resolves the per-OS Untangle config directory:
+ * - Linux: `$XDG_CONFIG_HOME/untangle` or `~/.config/untangle`;
+ * - macOS: `~/Library/Application Support/untangle`;
+ * - Windows: `%APPDATA%\untangle` or `~/AppData/Roaming/untangle`.
+ *
+ * `env` and `platform` are injectable for deterministic tests.
+ */
+export function resolveUserConfigDir(env = process.env, platform = process.platform) {
+    if (platform === "win32") {
+        const appData = env["APPDATA"];
+        return join(appData && appData.length > 0 ? appData : join(homedir(), "AppData", "Roaming"), "untangle");
+    }
+    if (platform === "darwin") {
+        return join(homedir(), "Library", "Application Support", "untangle");
+    }
+    const xdgConfigHome = env["XDG_CONFIG_HOME"];
+    return join(xdgConfigHome && xdgConfigHome.length > 0 ? xdgConfigHome : join(homedir(), ".config"), "untangle");
+}
+/** Full path to the user config file, or `undefined` when it does not exist. */
+export function resolveUserConfigPath(env = process.env, platform = process.platform) {
+    const candidate = join(resolveUserConfigDir(env, platform), USER_CONFIG_FILE_NAME);
+    return existsSync(candidate) ? candidate : undefined;
+}
+//# sourceMappingURL=user-config.js.map

package/dist/user-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-config.js","sourceRoot":"","sources":["../src/user-config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,MAAM,qBAAqB,GAAG,aAAa,CAAC;AAEnD;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAyB,OAAO,CAAC,GAAG,EACpC,WAA4B,OAAO,CAAC,QAAQ;IAE5C,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC;QAC/B,OAAO,IAAI,CACT,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,EAC/E,UAAU,CACX,CAAC;IACJ,CAAC;IACD,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,qBAAqB,EAAE,UAAU,CAAC,CAAC;IACvE,CAAC;IACD,MAAM,aAAa,GAAG,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC7C,OAAO,IAAI,CACT,aAAa,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,EACtF,UAAU,CACX,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,qBAAqB,CACnC,MAAyB,OAAO,CAAC,GAAG,EACpC,WAA4B,OAAO,CAAC,QAAQ;IAE5C,MAAM,SAAS,GAAG,IAAI,CAAC,oBAAoB,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,qBAAqB,CAAC,CAAC;IACnF,OAAO,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC"}

package/dist/validate.d.ts

@@ -0,0 +1,36 @@
+export interface ConfigIssue {
+    /** An `ErrorCode` (domain) for errors; a short machine-readable slug for warnings. */
+    code: string;
+    message: string;
+    /** Dotted path into the config object, e.g. `"embeddings.mode"`. */
+    path: string;
+}
+export interface ValidationResult {
+    errors: ConfigIssue[];
+    warnings: ConfigIssue[];
+}
+/**
+ * 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 declare function validateEffectiveConfig(config: Record<string, unknown>): ValidationResult;
+/**
+ * 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 declare function assertConfigValid(errors: readonly ConfigIssue[]): void;
+/**
+ * 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 declare function assertEmbeddingDimensionsMatch(configuredDimensions: number, existingCollectionDimensions: number | undefined): void;
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,WAAW;IAC1B,sFAAsF;IACtF,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAkJD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,CA0MzF;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,GAAG,IAAI,CAatE;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,oBAAoB,EAAE,MAAM,EAC5B,4BAA4B,EAAE,MAAM,GAAG,SAAS,GAC/C,IAAI,CAcN"}