@untangle-code/config 0.0.0-stage → 0.1.0

package/dist/defaults.js

@@ -0,0 +1,179 @@
+/**
+ * Product defaults (spec.md §4.5 "Defaultprofil für MVP"; product.md §11).
+ *
+ * These are layer 6 (lowest priority) of spec.md §4.1's six-level layering.
+ * Every field an `EffectiveUntangleConfigV1` guarantees present is defaulted
+ * here.
+ */
+import { COGNITIVE_ALGORITHM_ID } from "@untangle-code/domain";
+/**
+ * Embedding profile fields that are NOT part of `EmbeddingConfig` (spec.md
+ * §4.5 lists exactly ten fields, none of them `normalization` or
+ * `preparedTextVersion`) but ARE required inputs to
+ * `buildEmbeddingProfileId` (spec.md §5.7). Untangle decision: default
+ * normalization to "none" (no vector post-processing) and mint an explicit
+ * prepared-text format version so a future change to how document text is
+ * assembled can roll `embedding_profile_id` forward deliberately.
+ */
+export const DEFAULT_EMBEDDING_NORMALIZATION = "none";
+export const PREPARED_TEXT_VERSION = "untangle-prepared-text-v1";
+/** spec.md §4.5 "Defaultprofil für MVP" — Ollama, nomic-embed-text, 768 dims. */
+export const DEFAULT_EMBEDDING_CONFIG = {
+    provider: "ollama",
+    mode: "auto",
+    model: "nomic-embed-text",
+    dimensions: 768,
+    contextLength: 2048,
+    queryPrefix: "search_query: ",
+    documentPrefix: "search_document: ",
+    includePath: true,
+    batchSize: 32,
+    maxConnections: 4,
+    requestTimeoutMs: 120000,
+};
+/**
+ * Qdrant defaults. spec.md §4.4 defines the shape but not default values;
+ * `managed` mode with no explicit `url` matches product.md §4.1's
+ * zero-config narrative (the CLI starts a managed container and fills `url`
+ * in from that at runtime — this package only supplies the mode default).
+ */
+export const DEFAULT_QDRANT_CONFIG = {
+    mode: "managed",
+    collectionPrefix: "untangle_",
+    requestTimeoutMs: 30000,
+    maxRetries: 3,
+    upsertMaxPoints: 256,
+    upsertBudgetBytes: 4 * 1024 * 1024,
+};
+/** Embedded search for new projects; explicit legacy Qdrant layers retain their backend. */
+export const DEFAULT_STORAGE_CONFIG = {
+    backend: "lancedb",
+    path: ".untangle/index/lancedb",
+};
+/** spec.md §4.6; numeric defaults are an Untangle decision, chosen conservatively. */
+export const DEFAULT_INDEX_CONFIG = {
+    watch: true,
+    reconcileIntervalMinutes: 30,
+    maxFileSizeMb: 5,
+    maxGraphFileSizeMb: 20,
+    scanConcurrency: 8,
+    embeddingConcurrency: 4,
+    filesPerCheckpoint: 200,
+    targetChunkTokens: 900,
+    maxChunkTokens: 1500,
+    fallbackOverlapTokens: 100,
+    includeDotFiles: false,
+    indexExtensionless: false,
+    extraExtensions: [],
+    extensionLanguageMap: {},
+};
+/** Untangle decision (see `types.ts` `SearchConfig` doc comment). */
+export const DEFAULT_SEARCH_CONFIG = {
+    defaultLimit: 10,
+    defaultCandidateLimit: 50,
+    maxCandidateLimit: 200,
+    diversifyByDefault: false,
+    boostWeights: {
+        exactSymbol: 0.15,
+        exactPath: 0.1,
+        repoPriority: 0.05,
+        graphProximity: 0.1,
+        recency: 0.05,
+        duplicatePenalty: 0.2,
+    },
+};
+/** Untangle decision, values taken from architecture.md §17.4's per-query limits. */
+export const DEFAULT_GRAPH_CONFIG = {
+    enabled: true,
+    maxTraversalDepth: 20,
+    maxTraversalNodes: 2000,
+    maxTraversalEdges: 4000,
+    maxTraversalWallTimeMs: 5000,
+    includeDynamicImports: true,
+};
+/** Untangle decision (see `types.ts` `ComplexityConfig` doc comment). */
+export const DEFAULT_COMPLEXITY_CONFIG = {
+    enabled: true,
+    cognitiveAlgorithm: COGNITIVE_ALGORITHM_ID,
+    cyclomaticVariant: "both",
+    maintainabilityIndexEnabled: true,
+};
+/** spec.md §17.6 default risk score weights. */
+export const DEFAULT_CHANGE_CONFIG = {
+    enabled: true,
+    riskWeights: {
+        churn: 0.25,
+        positiveCognitiveDelta: 0.2,
+        positiveCyclomaticDelta: 0.15,
+        blastRadius: 0.15,
+        graphCentrality: 0.1,
+        semanticChange: 0.1,
+        testDistance: 0.05,
+    },
+    symbolMatching: {
+        tokenSimilarityMin: 0.6,
+        enableEmbeddingSimilarity: true,
+    },
+};
+/** spec.md §4.7 shape; MVP defaults chosen deliberately permissive (warn, not fail). */
+export const DEFAULT_QUALITY_GATE_CONFIG = {
+    mode: "warn",
+    newCyclesAllowed: 0,
+    minimumParseQuality: "partial",
+    ignoreExistingViolations: true,
+};
+/** spec.md §24: "Telemetrie MUSS standardmäßig aus sein." */
+export const DEFAULT_TELEMETRY_CONFIG = {
+    enabled: false,
+    logLevel: "info",
+    metricsExport: "none",
+};
+/** portfolio.md §14.4 defaults, spelled out explicitly. */
+export const DEFAULT_PORTFOLIO_CONFIG = {
+    enabled: true,
+    includeTransitive: false,
+    conventionMinRepos: 2,
+    radar: {
+        adoptShareMin: 0.5,
+        maintainShareMin: 0.2,
+        retireAfterDays: 540,
+    },
+    blueprint: {
+        weights: {
+            adoption: 0.4,
+            recency: 0.2,
+            health: 0.25,
+            versionConsistency: 0.15,
+        },
+    },
+    enrichment: {
+        enabled: false,
+        registries: [],
+        cacheTtlHours: 168,
+        timeoutMs: 10000,
+    },
+};
+/** Current config schema version this package produces and validates against. */
+export const CURRENT_SCHEMA_VERSION = 1;
+/**
+ * The complete product-default layer (spec.md §4.1 layer 6, lowest
+ * priority). Every optional sub-config `EffectiveUntangleConfigV1`
+ * guarantees present is defaulted here; `repositories` and
+ * `contextArtifacts` are deliberately absent (spec.md §4.3: no universal
+ * default repository set exists).
+ */
+export const PRODUCT_DEFAULT_CONFIG = {
+    schemaVersion: CURRENT_SCHEMA_VERSION,
+    storage: DEFAULT_STORAGE_CONFIG,
+    qdrant: DEFAULT_QDRANT_CONFIG,
+    embeddings: DEFAULT_EMBEDDING_CONFIG,
+    index: DEFAULT_INDEX_CONFIG,
+    search: DEFAULT_SEARCH_CONFIG,
+    graph: DEFAULT_GRAPH_CONFIG,
+    complexity: DEFAULT_COMPLEXITY_CONFIG,
+    changes: DEFAULT_CHANGE_CONFIG,
+    qualityGate: DEFAULT_QUALITY_GATE_CONFIG,
+    telemetry: DEFAULT_TELEMETRY_CONFIG,
+    portfolio: DEFAULT_PORTFOLIO_CONFIG,
+};
+//# sourceMappingURL=defaults.js.map

package/dist/defaults.js.map

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

package/dist/discovery.d.ts

@@ -0,0 +1,40 @@
+export declare const PROJECT_CONFIG_FILE_NAME = ".untangle.json";
+export declare const LOCAL_CONFIG_FILE_NAME = ".untangle.local.json";
+/** Folder-contained project configuration; legacy root files retain priority. */
+export declare const PROJECT_FOLDER_CONFIG_FILE_NAME: string;
+/**
+ * `untangle.toml`, the file `untangle init` writes (WP-125).
+ *
+ * WP-222: it used to be invisible here. `init` wrote `untangle.toml`,
+ * discovery looked only for `.untangle.json`, and so `untangle doctor`
+ * reported "no configuration found" about a configuration that had just been
+ * written — and advised running `untangle init`, which had just run. A user
+ * following that advice loops forever. One file name known in one place ends
+ * that: whatever `init` writes is exactly what discovery finds.
+ */
+export declare const PROJECT_TOML_CONFIG_FILE_NAME = "untangle.toml";
+/**
+ * Searches `startPath` and its ancestors for `fileName`, stopping after the
+ * first directory that is a repository root (has `.git`) or after the
+ * filesystem root. Returns the absolute path of the first match, or
+ * `undefined` if none is found.
+ */
+export declare function discoverConfigFile(startPath: string, fileName: string): string | undefined;
+/** Result of discovering the project-level config files (spec.md §4.1, layers 3–4). */
+export interface DiscoveredConfigFiles {
+    /** `.untangle.json`, or `.untangle/config.json` when no legacy project file exists. */
+    projectConfigPath: string | undefined;
+    /**
+     * `untangle.toml`, layer 4b — the file `untangle init` writes. It sits
+     * directly BENEATH `.untangle.json`: where both exist, the JSON file wins,
+     * and `loadConfig` warns rather than picking a winner in silence.
+     */
+    tomlConfigPath: string | undefined;
+    /** `.untangle.local.json`, layer 3 — SHOULD be gitignored (spec.md §4.1). */
+    localConfigPath: string | undefined;
+    /** Logical project directory for the folder layout, distinct from the config directory. */
+    projectRoot?: string;
+}
+/** Discovers project configuration upward, without crossing a repository boundary. */
+export declare function discoverConfigFiles(startPath: string): DiscoveredConfigFiles;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,wBAAwB,mBAAmB,CAAC;AACzD,eAAO,MAAM,sBAAsB,yBAAyB,CAAC;AAC7D,iFAAiF;AACjF,eAAO,MAAM,+BAA+B,QAAmC,CAAC;AAChF;;;;;;;;;GASG;AACH,eAAO,MAAM,6BAA6B,kBAAkB,CAAC;AAM7D;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAuB1F;AAED,uFAAuF;AACvF,MAAM,WAAW,qBAAqB;IACpC,uFAAuF;IACvF,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC;;;;OAIG;IACH,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,6EAA6E;IAC7E,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,2FAA2F;IAC3F,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,sFAAsF;AACtF,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,qBAAqB,CAa5E"}

package/dist/discovery.js

@@ -0,0 +1,76 @@
+/**
+ * Config file discovery (spec.md §4.1, §4.3 mention `.untangle.json` /
+ * `.untangle.local.json` without specifying how they are found;
+ * architecture.md §6.3 assigns "Config Discovery" to this package).
+ *
+ * Upward search from a start path, checking one directory at a time, until
+ * either the file is found, the repository root is reached (a directory
+ * containing `.git`, checked AFTER that directory's own candidate file so the
+ * repo root itself is still searched), or the filesystem root is reached.
+ */
+import { existsSync, statSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+export const PROJECT_CONFIG_FILE_NAME = ".untangle.json";
+export const LOCAL_CONFIG_FILE_NAME = ".untangle.local.json";
+/** Folder-contained project configuration; legacy root files retain priority. */
+export const PROJECT_FOLDER_CONFIG_FILE_NAME = join(".untangle", "config.json");
+/**
+ * `untangle.toml`, the file `untangle init` writes (WP-125).
+ *
+ * WP-222: it used to be invisible here. `init` wrote `untangle.toml`,
+ * discovery looked only for `.untangle.json`, and so `untangle doctor`
+ * reported "no configuration found" about a configuration that had just been
+ * written — and advised running `untangle init`, which had just run. A user
+ * following that advice loops forever. One file name known in one place ends
+ * that: whatever `init` writes is exactly what discovery finds.
+ */
+export const PROJECT_TOML_CONFIG_FILE_NAME = "untangle.toml";
+function isRepoRoot(dir) {
+    return existsSync(join(dir, ".git"));
+}
+/**
+ * Searches `startPath` and its ancestors for `fileName`, stopping after the
+ * first directory that is a repository root (has `.git`) or after the
+ * filesystem root. Returns the absolute path of the first match, or
+ * `undefined` if none is found.
+ */
+export function discoverConfigFile(startPath, fileName) {
+    let dir = resolve(startPath);
+    // If startPath is a file (e.g. process.cwd() equivalent passed by mistake),
+    // callers are expected to pass a directory; we do not stat startPath itself.
+    for (;;) {
+        const candidate = join(dir, fileName);
+        if (existsSync(candidate)) {
+            try {
+                if (statSync(candidate).isFile()) {
+                    return candidate;
+                }
+            }
+            catch {
+                // Unreadable candidate (race, permissions): treat as not found here.
+            }
+        }
+        const atRepoRoot = isRepoRoot(dir);
+        const parent = dirname(dir);
+        const atFilesystemRoot = parent === dir;
+        if (atRepoRoot || atFilesystemRoot) {
+            return undefined;
+        }
+        dir = parent;
+    }
+}
+/** Discovers project configuration upward, without crossing a repository boundary. */
+export function discoverConfigFiles(startPath) {
+    const projectConfigPath = discoverConfigFile(startPath, PROJECT_CONFIG_FILE_NAME);
+    const tomlConfigPath = discoverConfigFile(startPath, PROJECT_TOML_CONFIG_FILE_NAME);
+    const folderConfigPath = projectConfigPath === undefined && tomlConfigPath === undefined
+        ? discoverConfigFile(startPath, PROJECT_FOLDER_CONFIG_FILE_NAME)
+        : undefined;
+    return {
+        projectConfigPath: projectConfigPath ?? folderConfigPath,
+        tomlConfigPath,
+        localConfigPath: discoverConfigFile(startPath, LOCAL_CONFIG_FILE_NAME),
+        ...(folderConfigPath === undefined ? {} : { projectRoot: dirname(dirname(folderConfigPath)) }),
+    };
+}
+//# sourceMappingURL=discovery.js.map

package/dist/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEnD,MAAM,CAAC,MAAM,wBAAwB,GAAG,gBAAgB,CAAC;AACzD,MAAM,CAAC,MAAM,sBAAsB,GAAG,sBAAsB,CAAC;AAC7D,iFAAiF;AACjF,MAAM,CAAC,MAAM,+BAA+B,GAAG,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;AAChF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,eAAe,CAAC;AAE7D,SAAS,UAAU,CAAC,GAAW;IAC7B,OAAO,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAiB,EAAE,QAAgB;IACpE,IAAI,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAC7B,4EAA4E;IAC5E,6EAA6E;IAC7E,SAAS,CAAC;QACR,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACtC,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC;gBACH,IAAI,QAAQ,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;oBACjC,OAAO,SAAS,CAAC;gBACnB,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,qEAAqE;YACvE,CAAC;QACH,CAAC;QACD,MAAM,UAAU,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,MAAM,gBAAgB,GAAG,MAAM,KAAK,GAAG,CAAC;QACxC,IAAI,UAAU,IAAI,gBAAgB,EAAE,CAAC;YACnC,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;AACH,CAAC;AAkBD,sFAAsF;AACtF,MAAM,UAAU,mBAAmB,CAAC,SAAiB;IACnD,MAAM,iBAAiB,GAAG,kBAAkB,CAAC,SAAS,EAAE,wBAAwB,CAAC,CAAC;IAClF,MAAM,cAAc,GAAG,kBAAkB,CAAC,SAAS,EAAE,6BAA6B,CAAC,CAAC;IACpF,MAAM,gBAAgB,GACpB,iBAAiB,KAAK,SAAS,IAAI,cAAc,KAAK,SAAS;QAC7D,CAAC,CAAC,kBAAkB,CAAC,SAAS,EAAE,+BAA+B,CAAC;QAChE,CAAC,CAAC,SAAS,CAAC;IAChB,OAAO;QACL,iBAAiB,EAAE,iBAAiB,IAAI,gBAAgB;QACxD,cAAc;QACd,eAAe,EAAE,kBAAkB,CAAC,SAAS,EAAE,sBAAsB,CAAC;QACtE,GAAG,CAAC,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC;KAC/F,CAAC;AACJ,CAAC"}

package/dist/env.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Environment variable layer (spec.md §4.1 layer 2, prefix `UNTANGLE_`).
+ *
+ * spec.md does not enumerate the mapping, so this table is an explicit
+ * Untangle decision: it covers the fields most likely to be overridden
+ * outside a checked-in config file (endpoints, modes, secrets-by-reference,
+ * gate strictness, telemetry opt-in), not every leaf field of
+ * `UntangleConfigV1`. New mappings MAY be added additively; removing or
+ * renaming one is a breaking change to this package's public contract.
+ *
+ * `UNTANGLE_QDRANT_API_KEY_ENV` / `UNTANGLE_EMBEDDINGS_API_KEY_ENV` set the
+ * NAME of a further environment variable holding a secret; they never carry
+ * the secret value itself (architecture.md §23.2).
+ */
+import type { RawConfigLayer } from "./types.js";
+type Parser = (raw: string) => unknown;
+export interface EnvMappingEntry {
+    /** Environment variable name, e.g. `UNTANGLE_QDRANT_URL`. */
+    env: string;
+    /** Dotted path into `UntangleConfigV1`, e.g. `["qdrant", "url"]`. */
+    path: readonly string[];
+    parse: Parser;
+}
+/** The complete, documented `UNTANGLE_*` → config-path mapping table. */
+export declare const ENV_MAPPING: readonly EnvMappingEntry[];
+export interface EnvLayerResult {
+    layer: RawConfigLayer;
+    /** Env vars that were present but failed to parse (e.g. non-numeric `UNTANGLE_EMBEDDINGS_DIMENSIONS`). */
+    parseErrors: {
+        env: string;
+        message: string;
+    }[];
+}
+/** Builds a `RawConfigLayer` from `env` using {@link ENV_MAPPING}. Unset variables are skipped. */
+export declare function buildEnvConfigLayer(env?: NodeJS.ProcessEnv): EnvLayerResult;
+export {};
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,KAAK,MAAM,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;AA0BvC,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,GAAG,EAAE,MAAM,CAAC;IACZ,qEAAqE;IACrE,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,yEAAyE;AACzE,eAAO,MAAM,WAAW,EAAE,SAAS,eAAe,EAgDxC,CAAC;AAgBX,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,cAAc,CAAC;IACtB,0GAA0G;IAC1G,WAAW,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACjD;AAED,mGAAmG;AACnG,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,cAAc,CAkBxF"}

package/dist/env.js

@@ -0,0 +1,100 @@
+const parseString = (raw) => raw;
+const parseNumber = (raw) => {
+    const value = Number(raw);
+    if (!Number.isFinite(value)) {
+        throw new Error(`expected a finite number, got "${raw}"`);
+    }
+    return value;
+};
+const parseBoolean = (raw) => {
+    const normalized = raw.trim().toLowerCase();
+    if (normalized === "true" || normalized === "1") {
+        return true;
+    }
+    if (normalized === "false" || normalized === "0") {
+        return false;
+    }
+    throw new Error(`expected a boolean ("true"/"false"/"1"/"0"), got "${raw}"`);
+};
+const parseCsv = (raw) => raw
+    .split(",")
+    .map((entry) => entry.trim())
+    .filter((entry) => entry.length > 0);
+/** The complete, documented `UNTANGLE_*` → config-path mapping table. */
+export const ENV_MAPPING = [
+    { env: "UNTANGLE_WORKSPACE_ID", path: ["workspaceId"], parse: parseString },
+    { env: "UNTANGLE_PROJECT_ID", path: ["projectId"], parse: parseString },
+    { env: "UNTANGLE_STORAGE_BACKEND", path: ["storage", "backend"], parse: parseString },
+    { env: "UNTANGLE_LANCEDB_PATH", path: ["storage", "path"], parse: parseString },
+    { env: "UNTANGLE_QDRANT_MODE", path: ["qdrant", "mode"], parse: parseString },
+    { env: "UNTANGLE_QDRANT_URL", path: ["qdrant", "url"], parse: parseString },
+    { env: "UNTANGLE_QDRANT_API_KEY_ENV", path: ["qdrant", "apiKeyEnv"], parse: parseString },
+    {
+        env: "UNTANGLE_QDRANT_COLLECTION_PREFIX",
+        path: ["qdrant", "collectionPrefix"],
+        parse: parseString,
+    },
+    {
+        env: "UNTANGLE_QDRANT_REQUEST_TIMEOUT_MS",
+        path: ["qdrant", "requestTimeoutMs"],
+        parse: parseNumber,
+    },
+    { env: "UNTANGLE_QDRANT_MAX_RETRIES", path: ["qdrant", "maxRetries"], parse: parseNumber },
+    { env: "UNTANGLE_EMBEDDINGS_MODE", path: ["embeddings", "mode"], parse: parseString },
+    { env: "UNTANGLE_EMBEDDINGS_URL", path: ["embeddings", "url"], parse: parseString },
+    { env: "UNTANGLE_EMBEDDINGS_API_KEY_ENV", path: ["embeddings", "apiKeyEnv"], parse: parseString },
+    { env: "UNTANGLE_EMBEDDINGS_MODEL", path: ["embeddings", "model"], parse: parseString },
+    { env: "UNTANGLE_EMBEDDINGS_DIMENSIONS", path: ["embeddings", "dimensions"], parse: parseNumber },
+    {
+        env: "UNTANGLE_EMBEDDINGS_REQUEST_TIMEOUT_MS",
+        path: ["embeddings", "requestTimeoutMs"],
+        parse: parseNumber,
+    },
+    { env: "UNTANGLE_INDEX_WATCH", path: ["index", "watch"], parse: parseBoolean },
+    { env: "UNTANGLE_INDEX_MAX_FILE_SIZE_MB", path: ["index", "maxFileSizeMb"], parse: parseNumber },
+    { env: "UNTANGLE_INDEX_EXTRA_EXTENSIONS", path: ["index", "extraExtensions"], parse: parseCsv },
+    { env: "UNTANGLE_QUALITY_GATE_MODE", path: ["qualityGate", "mode"], parse: parseString },
+    {
+        env: "UNTANGLE_QUALITY_GATE_MINIMUM_PARSE_QUALITY",
+        path: ["qualityGate", "minimumParseQuality"],
+        parse: parseString,
+    },
+    { env: "UNTANGLE_TELEMETRY_ENABLED", path: ["telemetry", "enabled"], parse: parseBoolean },
+    { env: "UNTANGLE_TELEMETRY_LOG_LEVEL", path: ["telemetry", "logLevel"], parse: parseString },
+    { env: "UNTANGLE_PORTFOLIO_ENABLED", path: ["portfolio", "enabled"], parse: parseBoolean },
+];
+function setAtPath(target, path, value) {
+    let cursor = target;
+    for (let i = 0; i < path.length - 1; i += 1) {
+        const key = path[i];
+        const next = cursor[key];
+        if (typeof next !== "object" || next === null || Array.isArray(next)) {
+            cursor[key] = {};
+        }
+        cursor = cursor[key];
+    }
+    const lastKey = path[path.length - 1];
+    cursor[lastKey] = value;
+}
+/** Builds a `RawConfigLayer` from `env` using {@link ENV_MAPPING}. Unset variables are skipped. */
+export function buildEnvConfigLayer(env = process.env) {
+    const layer = {};
+    const parseErrors = [];
+    for (const entry of ENV_MAPPING) {
+        const raw = env[entry.env];
+        if (raw === undefined) {
+            continue;
+        }
+        try {
+            setAtPath(layer, entry.path, entry.parse(raw));
+        }
+        catch (error) {
+            parseErrors.push({
+                env: entry.env,
+                message: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    return { layer: layer, parseErrors };
+}
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

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

package/dist/hash.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Canonical effective config and embedding profile derivation
+ * (architecture.md §6.3: "kanonische Effective Config", "Embedding- und
+ * Indexprofil-Hashing"; spec.md §5.1 `workspace_id` fallback derivation;
+ * spec.md §5.7 `embedding_profile_id`).
+ */
+import type { EmbeddingProfile } from "@untangle-code/domain";
+import type { EffectiveUntangleConfigV1 } from "./types.js";
+/**
+ * SHA-256 of the canonical JSON of `config`. The additive storage section
+ * is excluded for Qdrant to preserve existing workspace identities; its
+ * connection remains represented by the unchanged qdrant section. Used as `buildWorkspaceId`'s
+ * `configHash` input (spec.md §5.1) when no explicit `workspaceId` is
+ * configured, and to detect effective-config drift between index runs
+ * (architecture.md §6.3, §13.4 "Generation-Commit").
+ */
+export declare function computeConfigHash(config: unknown): string;
+/**
+ * Assembles the `EmbeddingProfile` (domain, spec.md §5.7's eight mandatory
+ * fields) from an effective config's `embeddings` section and derives
+ * `embedding_profile_id` via `buildEmbeddingProfileId`.
+ *
+ * `normalization` and `preparedTextVersion` are not part of `EmbeddingConfig`
+ * (spec.md §4.5 does not list them); they default to this package's fixed
+ * constants (`defaults.ts`) unless overridden here — e.g. a future config
+ * revision that exposes them per-project.
+ */
+export declare function deriveEmbeddingProfile(config: Pick<EffectiveUntangleConfigV1, "embeddings">, overrides?: {
+    normalization?: string;
+    preparedTextVersion?: string;
+}): EmbeddingProfile;
+/** Convenience: `buildEmbeddingProfileId(deriveEmbeddingProfile(config, overrides))`. */
+export declare function deriveEmbeddingProfileId(config: Pick<EffectiveUntangleConfigV1, "embeddings">, overrides?: {
+    normalization?: string;
+    preparedTextVersion?: string;
+}): string;
+//# sourceMappingURL=hash.d.ts.map

package/dist/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAI9D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAE5D;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAgBzD;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,IAAI,CAAC,yBAAyB,EAAE,YAAY,CAAC,EACrD,SAAS,GAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAAO,GACvE,gBAAgB,CAWlB;AAED,yFAAyF;AACzF,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,IAAI,CAAC,yBAAyB,EAAE,YAAY,CAAC,EACrD,SAAS,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAAE,GACnE,MAAM,CAER"}

package/dist/hash.js

@@ -0,0 +1,52 @@
+import { buildEmbeddingProfileId, canonicalJson, sha256Hex } from "@untangle-code/domain";
+import { DEFAULT_EMBEDDING_NORMALIZATION, PREPARED_TEXT_VERSION } from "./defaults.js";
+/**
+ * SHA-256 of the canonical JSON of `config`. The additive storage section
+ * is excluded for Qdrant to preserve existing workspace identities; its
+ * connection remains represented by the unchanged qdrant section. Used as `buildWorkspaceId`'s
+ * `configHash` input (spec.md §5.1) when no explicit `workspaceId` is
+ * configured, and to detect effective-config drift between index runs
+ * (architecture.md §6.3, §13.4 "Generation-Commit").
+ */
+export function computeConfigHash(config) {
+    if (typeof config === "object" && config !== null && !Array.isArray(config)) {
+        const record = config;
+        const storage = record["storage"];
+        if (typeof storage === "object" &&
+            storage !== null &&
+            "backend" in storage &&
+            storage.backend === "qdrant") {
+            const legacyConfig = { ...record };
+            delete legacyConfig["storage"];
+            return sha256Hex(canonicalJson(legacyConfig));
+        }
+    }
+    return sha256Hex(canonicalJson(config));
+}
+/**
+ * Assembles the `EmbeddingProfile` (domain, spec.md §5.7's eight mandatory
+ * fields) from an effective config's `embeddings` section and derives
+ * `embedding_profile_id` via `buildEmbeddingProfileId`.
+ *
+ * `normalization` and `preparedTextVersion` are not part of `EmbeddingConfig`
+ * (spec.md §4.5 does not list them); they default to this package's fixed
+ * constants (`defaults.ts`) unless overridden here — e.g. a future config
+ * revision that exposes them per-project.
+ */
+export function deriveEmbeddingProfile(config, overrides = {}) {
+    return {
+        provider: config.embeddings.provider,
+        model: config.embeddings.model,
+        dimensions: config.embeddings.dimensions,
+        queryPrefix: config.embeddings.queryPrefix,
+        documentPrefix: config.embeddings.documentPrefix,
+        includePath: config.embeddings.includePath,
+        normalization: overrides.normalization ?? DEFAULT_EMBEDDING_NORMALIZATION,
+        preparedTextVersion: overrides.preparedTextVersion ?? PREPARED_TEXT_VERSION,
+    };
+}
+/** Convenience: `buildEmbeddingProfileId(deriveEmbeddingProfile(config, overrides))`. */
+export function deriveEmbeddingProfileId(config, overrides) {
+    return buildEmbeddingProfileId(deriveEmbeddingProfile(config, overrides));
+}
+//# sourceMappingURL=hash.js.map

package/dist/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,uBAAuB,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAE1F,OAAO,EAAE,+BAA+B,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAGvF;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAe;IAC/C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5E,MAAM,MAAM,GAAG,MAAiC,CAAC;QACjD,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;QAClC,IACE,OAAO,OAAO,KAAK,QAAQ;YAC3B,OAAO,KAAK,IAAI;YAChB,SAAS,IAAI,OAAO;YACpB,OAAO,CAAC,OAAO,KAAK,QAAQ,EAC5B,CAAC;YACD,MAAM,YAAY,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;YACnC,OAAO,YAAY,CAAC,SAAS,CAAC,CAAC;YAC/B,OAAO,SAAS,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAqD,EACrD,YAAsE,EAAE;IAExE,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,UAAU,CAAC,QAAQ;QACpC,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,KAAK;QAC9B,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,UAAU;QACxC,WAAW,EAAE,MAAM,CAAC,UAAU,CAAC,WAAW;QAC1C,cAAc,EAAE,MAAM,CAAC,UAAU,CAAC,cAAc;QAChD,WAAW,EAAE,MAAM,CAAC,UAAU,CAAC,WAAW;QAC1C,aAAa,EAAE,SAAS,CAAC,aAAa,IAAI,+BAA+B;QACzE,mBAAmB,EAAE,SAAS,CAAC,mBAAmB,IAAI,qBAAqB;KAC5E,CAAC;AACJ,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,wBAAwB,CACtC,MAAqD,EACrD,SAAoE;IAEpE,OAAO,uBAAuB,CAAC,sBAAsB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;AAC5E,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @untangle-code/config — Untangle configuration: types, discovery,
+ * layering, JSON Schema, secret redaction, canonical hashing and migration.
+ *
+ * This module is the ONLY public export of the package.
+ */
+export * from "./types.js";
+export * from "./defaults.js";
+export * from "./schema.js";
+export * from "./discovery.js";
+export * from "./user-config.js";
+export * from "./env.js";
+export * from "./merge.js";
+export * from "./paths.js";
+export * from "./secrets.js";
+export * from "./hash.js";
+export * from "./validate.js";
+export * from "./migrations.js";
+export * from "./load.js";
+export * from "./parse.js";
+export * from "./chunker-budget.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,YAAY,CAAC;AAG3B,cAAc,eAAe,CAAC;AAG9B,cAAc,aAAa,CAAC;AAG5B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,kBAAkB,CAAC;AAGjC,cAAc,UAAU,CAAC;AAGzB,cAAc,YAAY,CAAC;AAG3B,cAAc,YAAY,CAAC;AAG3B,cAAc,cAAc,CAAC;AAG7B,cAAc,WAAW,CAAC;AAG1B,cAAc,eAAe,CAAC;AAG9B,cAAc,iBAAiB,CAAC;AAGhC,cAAc,WAAW,CAAC;AAG1B,cAAc,YAAY,CAAC;AAG3B,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,37 @@
+/**
+ * @untangle-code/config — Untangle configuration: types, discovery,
+ * layering, JSON Schema, secret redaction, canonical hashing and migration.
+ *
+ * This module is the ONLY public export of the package.
+ */
+// Configuration types (spec.md §4.2-4.8; portfolio.md §14.4)
+export * from "./types.js";
+// Product defaults (spec.md §4.5; product.md §11)
+export * from "./defaults.js";
+// JSON Schema (Draft 2020-12)
+export * from "./schema.js";
+// Config file discovery (spec.md §4.1)
+export * from "./discovery.js";
+// OS user config directory (spec.md §4.1 layer 5)
+export * from "./user-config.js";
+// Environment variable layer (spec.md §4.1 layer 2)
+export * from "./env.js";
+// Deep merge with array-replace semantics (spec.md §4.1)
+export * from "./merge.js";
+// Path resolution relative to the config file (spec.md §4.3)
+export * from "./paths.js";
+// Secret references and redaction (spec.md §4.4/§4.5, §24; architecture.md §23.2)
+export * from "./secrets.js";
+// Canonical effective config hash and embedding profile derivation (architecture.md §6.3)
+export * from "./hash.js";
+// Validation (spec.md §4.8)
+export * from "./validate.js";
+// Migration scaffold for future schemaVersion jumps (architecture.md §6.3)
+export * from "./migrations.js";
+// Top-level orchestration
+export * from "./load.js";
+// Parse an existing document without loading defaults or environment layers.
+export * from "./parse.js";
+// IndexConfig -> chunker token-budget wiring (spec.md §4.6)
+export * from "./chunker-budget.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,6DAA6D;AAC7D,cAAc,YAAY,CAAC;AAE3B,kDAAkD;AAClD,cAAc,eAAe,CAAC;AAE9B,8BAA8B;AAC9B,cAAc,aAAa,CAAC;AAE5B,uCAAuC;AACvC,cAAc,gBAAgB,CAAC;AAE/B,kDAAkD;AAClD,cAAc,kBAAkB,CAAC;AAEjC,oDAAoD;AACpD,cAAc,UAAU,CAAC;AAEzB,yDAAyD;AACzD,cAAc,YAAY,CAAC;AAE3B,6DAA6D;AAC7D,cAAc,YAAY,CAAC;AAE3B,kFAAkF;AAClF,cAAc,cAAc,CAAC;AAE7B,0FAA0F;AAC1F,cAAc,WAAW,CAAC;AAE1B,4BAA4B;AAC5B,cAAc,eAAe,CAAC;AAE9B,2EAA2E;AAC3E,cAAc,iBAAiB,CAAC;AAEhC,0BAA0B;AAC1B,cAAc,WAAW,CAAC;AAE1B,6EAA6E;AAC7E,cAAc,YAAY,CAAC;AAE3B,4DAA4D;AAC5D,cAAc,qBAAqB,CAAC"}