@opensip-cli/config 0.1.0

package/dist/namespace-claims.js

@@ -0,0 +1,62 @@
+/**
+ * namespace-claims — the ADR-0043 unclaimed-namespace report.
+ *
+ * The composer deliberately tolerates unclaimed top-level keys (the
+ * uninstalled-tool forward-compat contract, `composer.ts` rule 2) — but it
+ * tolerates them SILENTLY, which is the live typo hole: `fitnes:` validates
+ * cleanly and the user's config just never applies. This pure analyzer makes
+ * the tolerance observable: it names each unclaimed namespace and suggests
+ * the nearest claimed one when a typo is plausible. The CLI emits the warning
+ * (config stays log-free); rejection policy (a LOADED tool with an undeclared
+ * namespace) also lives at the caller, which knows the loaded-tool set.
+ */
+/**
+ * Levenshtein distance, bounded: returns early with `max + 1` when the
+ * difference cannot be ≤ `max`. Small inputs (config keys), no dependency.
+ */
+function boundedEditDistance(a, b, max) {
+    if (Math.abs(a.length - b.length) > max)
+        return max + 1;
+    let prev = Array.from({ length: b.length + 1 }, (_, i) => i);
+    for (let i = 1; i <= a.length; i++) {
+        const curr = [i];
+        let rowMin = i;
+        for (let j = 1; j <= b.length; j++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            curr[j] = Math.min(curr[j - 1] + 1, prev[j] + 1, prev[j - 1] + cost);
+            rowMin = Math.min(rowMin, curr[j]);
+        }
+        if (rowMin > max)
+            return max + 1;
+        prev = curr;
+    }
+    return prev[b.length];
+}
+const SUGGESTION_MAX_DISTANCE = 2;
+/**
+ * Report the document's top-level keys that no declaration claims. Pure: no
+ * IO, no logging — the caller decides warn-vs-reject per key (ADR-0043).
+ */
+export function analyzeNamespaceClaims(declarations, document) {
+    if (typeof document !== 'object' || document === null || Array.isArray(document)) {
+        return { unclaimed: [] };
+    }
+    const claimed = new Set(declarations.map((d) => d.namespace));
+    const unclaimed = [];
+    for (const key of Object.keys(document)) {
+        if (claimed.has(key))
+            continue;
+        let suggestion;
+        let best = SUGGESTION_MAX_DISTANCE + 1;
+        for (const candidate of claimed) {
+            const d = boundedEditDistance(key, candidate, SUGGESTION_MAX_DISTANCE);
+            if (d < best) {
+                best = d;
+                suggestion = candidate;
+            }
+        }
+        unclaimed.push({ namespace: key, ...(suggestion === undefined ? {} : { suggestion }) });
+    }
+    return { unclaimed };
+}
+//# sourceMappingURL=namespace-claims.js.map

package/dist/namespace-claims.js.map

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

package/dist/precedence.d.ts

@@ -0,0 +1,47 @@
+/**
+ * precedence — resolves the effective configuration from layered sources.
+ *
+ * Precedence, highest-wins, per namespace/key:
+ *
+ *   flag > env > file > defaults
+ *
+ *   - `defaults` — each declaration's `defaults` (lowest precedence).
+ *   - `file`     — the validated `opensip-cli.config.yml` document.
+ *   - `env`      — values read from environment variables via each
+ *     declaration's `env` bindings, coerced per binding `type`.
+ *   - `flags`    — CLI-supplied overrides (highest precedence).
+ *
+ * Resolution is per-key within each namespace: a flag for `fitness.recipe` does
+ * not clobber a file-supplied `fitness.failOnErrors`. Sources are plain
+ * `namespace -> { key -> value }` maps; the resolver deep-merges them in
+ * precedence order.
+ */
+import type { ToolConfigDeclaration } from './declaration.js';
+/** A `namespace -> { key -> value }` map for one precedence source. */
+type NamespaceMap = Record<string, Record<string, unknown>>;
+/** Inputs to {@link resolveConfig}. All sources are optional. */
+export interface ResolveConfigInput {
+    /** The tool declarations (supply `defaults` + `env` bindings). */
+    readonly declarations: readonly ToolConfigDeclaration[];
+    /** Highest-precedence overrides, e.g. parsed CLI flags. */
+    readonly flags?: NamespaceMap;
+    /** Raw environment map, typically `process.env`. */
+    readonly env?: Readonly<Record<string, string | undefined>>;
+    /** The validated config file document (namespace blocks). */
+    readonly file?: NamespaceMap;
+}
+/** The resolved configuration: `namespace -> { key -> value }`. */
+export type ResolvedConfig = Record<string, Record<string, unknown>>;
+/**
+ * Resolve the effective config by merging sources in precedence order.
+ *
+ * Only namespaces that appear in `declarations` are resolved (unclaimed
+ * top-level keys are not this resolver's concern — they pass through the
+ * composer untouched). For each declared namespace the resolver merges, in
+ * ascending precedence: declaration defaults → file block → env bindings →
+ * flags. A later source's key overrides an earlier source's same key; keys only
+ * present in an earlier source are preserved.
+ */
+export declare function resolveConfig(input: ResolveConfigInput): ResolvedConfig;
+export {};
+//# sourceMappingURL=precedence.d.ts.map

package/dist/precedence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"precedence.d.ts","sourceRoot":"","sources":["../src/precedence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAGV,qBAAqB,EACtB,MAAM,kBAAkB,CAAC;AAE1B,uEAAuE;AACvE,KAAK,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE5D,iEAAiE;AACjE,MAAM,WAAW,kBAAkB;IACjC,kEAAkE;IAClE,QAAQ,CAAC,YAAY,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACxD,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;IAC9B,oDAAoD;IACpD,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC5D,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;CAC9B;AAED,mEAAmE;AACnE,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAsDrE;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,cAAc,CA2BvE"}

package/dist/precedence.js

@@ -0,0 +1,103 @@
+/**
+ * precedence — resolves the effective configuration from layered sources.
+ *
+ * Precedence, highest-wins, per namespace/key:
+ *
+ *   flag > env > file > defaults
+ *
+ *   - `defaults` — each declaration's `defaults` (lowest precedence).
+ *   - `file`     — the validated `opensip-cli.config.yml` document.
+ *   - `env`      — values read from environment variables via each
+ *     declaration's `env` bindings, coerced per binding `type`.
+ *   - `flags`    — CLI-supplied overrides (highest precedence).
+ *
+ * Resolution is per-key within each namespace: a flag for `fitness.recipe` does
+ * not clobber a file-supplied `fitness.failOnErrors`. Sources are plain
+ * `namespace -> { key -> value }` maps; the resolver deep-merges them in
+ * precedence order.
+ */
+/** Accepted truthy / falsy spellings for a `boolean` env binding (case-insensitive). */
+const BOOLEAN_TRUE = new Set(['true', '1']);
+const BOOLEAN_FALSE = new Set(['false', '0']);
+/** Coerce a raw env string for a `boolean` binding; undefined drops an unrecognised value. */
+function coerceBoolean(raw) {
+    const v = raw.trim().toLowerCase();
+    if (BOOLEAN_TRUE.has(v))
+        return true;
+    if (BOOLEAN_FALSE.has(v))
+        return false;
+    return undefined;
+}
+/** Coerce a raw env string per its binding `type`; return undefined to drop it. */
+function coerceEnvValue(raw, type) {
+    switch (type) {
+        case 'number': {
+            const trimmed = raw.trim();
+            if (trimmed.length === 0)
+                return undefined; // empty or whitespace → treat as unset (prevents CI footguns like FAIL_ON_ERRORS=${UNSET} becoming 0)
+            const n = Number(trimmed);
+            return Number.isFinite(n) ? n : undefined;
+        }
+        case 'boolean': {
+            return coerceBoolean(raw);
+        }
+        case 'string':
+        case undefined: {
+            return raw;
+        }
+    }
+}
+/** Project a declaration's env bindings into a `{ key -> coerced value }` map. */
+function readEnvBindings(bindings, env) {
+    const out = {};
+    if (!bindings)
+        return out;
+    for (const binding of bindings) {
+        const raw = env[binding.envVar];
+        if (raw === undefined)
+            continue;
+        const coerced = coerceEnvValue(raw, binding.type);
+        if (coerced !== undefined)
+            out[binding.key] = coerced;
+    }
+    return out;
+}
+/** A plain object check that treats arrays and null as non-objects. */
+function isPlainObject(v) {
+    return typeof v === 'object' && v !== null && !Array.isArray(v);
+}
+/**
+ * Resolve the effective config by merging sources in precedence order.
+ *
+ * Only namespaces that appear in `declarations` are resolved (unclaimed
+ * top-level keys are not this resolver's concern — they pass through the
+ * composer untouched). For each declared namespace the resolver merges, in
+ * ascending precedence: declaration defaults → file block → env bindings →
+ * flags. A later source's key overrides an earlier source's same key; keys only
+ * present in an earlier source are preserved.
+ */
+export function resolveConfig(input) {
+    const { declarations, flags = {}, env = {}, file = {} } = input;
+    const resolved = {};
+    for (const decl of declarations) {
+        const ns = decl.namespace;
+        const merged = {};
+        // 1. defaults (lowest)
+        if (isPlainObject(decl.defaults)) {
+            Object.assign(merged, decl.defaults);
+        }
+        // 2. file
+        if (isPlainObject(file[ns])) {
+            Object.assign(merged, file[ns]);
+        }
+        // 3. env bindings
+        Object.assign(merged, readEnvBindings(decl.env, env));
+        // 4. flags (highest)
+        if (isPlainObject(flags[ns])) {
+            Object.assign(merged, flags[ns]);
+        }
+        resolved[ns] = merged;
+    }
+    return resolved;
+}
+//# sourceMappingURL=precedence.js.map

package/dist/precedence.js.map

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

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@opensip-cli/config",
+  "version": "0.1.0",
+  "license": "Apache-2.0",
+  "description": "Configuration layer for OpenSIP CLI — the capability-configuration composer and schema registry",
+  "keywords": [
+    "opensip-cli",
+    "static-analysis",
+    "code-quality"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/opensip-ai/opensip-cli.git",
+    "directory": "packages/config"
+  },
+  "homepage": "https://github.com/opensip-ai/opensip-cli",
+  "bugs": {
+    "url": "https://github.com/opensip-ai/opensip-cli/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "dependencies": {
+    "yaml": "^2.9.0",
+    "zod": "^4.4.3",
+    "@opensip-cli/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.13.2",
+    "typescript": "~6.0.3",
+    "vitest": "^4.1.8"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}