@kb-labs/core-config 1.0.0 → 1.2.0

package/dist/__tests__/profiles-resolver.spec.js.map

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

package/dist/__tests__/profiles-section.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=profiles-section.spec.d.ts.map

package/dist/__tests__/profiles-section.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles-section.spec.d.ts","sourceRoot":"","sources":["../../src/__tests__/profiles-section.spec.ts"],"names":[],"mappings":""}

package/dist/__tests__/profiles-section.spec.js

@@ -0,0 +1,50 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { readProfilesSection } from "../profiles/loader";
+import { promises as fs } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { KbError } from "../errors/kb-error";
+describe("readProfilesSection", () => {
+    let tmpDir;
+    beforeEach(async () => {
+        tmpDir = path.join(os.tmpdir(), `kb-profiles-${Date.now()}-${Math.random()}`);
+        await fs.mkdir(tmpDir, { recursive: true });
+    });
+    afterEach(async () => {
+        await fs.rm(tmpDir, { recursive: true, force: true });
+    });
+    it("returns empty list when kb.config is missing", async () => {
+        const result = await readProfilesSection(tmpDir);
+        expect(result.profiles).toHaveLength(0);
+        expect(result.sourcePath).toBeUndefined();
+    });
+    it("returns empty list when profiles section absent", async () => {
+        await fs.writeFile(path.join(tmpDir, "kb.config.json"), JSON.stringify({ aiReview: { enabled: true } }, null, 2));
+        const result = await readProfilesSection(tmpDir);
+        expect(result.profiles).toHaveLength(0);
+        expect(result.sourcePath).toMatch(/kb\.config\.json$/);
+    });
+    it("parses valid profiles array", async () => {
+        await fs.writeFile(path.join(tmpDir, "kb.config.json"), JSON.stringify({
+            profiles: [
+                {
+                    id: "default",
+                    label: "Default profile",
+                    scopes: [{ id: "root", include: ["**/*"], default: true }],
+                    products: {
+                        aiReview: { engine: "openai" },
+                    },
+                },
+            ],
+        }, null, 2));
+        const result = await readProfilesSection(tmpDir);
+        expect(result.profiles).toHaveLength(1);
+        expect(result.profiles[0].id).toBe("default");
+        expect(result.profiles[0].products?.aiReview).toBeDefined();
+    });
+    it("throws KbError when profiles section invalid", async () => {
+        await fs.writeFile(path.join(tmpDir, "kb.config.json"), JSON.stringify({ profiles: { invalid: true } }, null, 2));
+        await expect(readProfilesSection(tmpDir)).rejects.toBeInstanceOf(KbError);
+    });
+});
+//# sourceMappingURL=profiles-section.spec.js.map

package/dist/__tests__/profiles-section.spec.js.map

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

package/dist/__tests__/runtime.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtime.spec.d.ts.map

package/dist/__tests__/runtime.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.spec.d.ts","sourceRoot":"","sources":["../../src/__tests__/runtime.spec.ts"],"names":[],"mappings":""}

package/dist/__tests__/runtime.spec.js

@@ -0,0 +1,170 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
+import { promises as fsp } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { findNearestConfig, readJsonWithDiagnostics, mergeDefined, resolveConfig, pickDefined, } from "../runtime";
+async function makeTmpDir(prefix = "kb-core-config-") {
+    return fsp.mkdtemp(path.join(os.tmpdir(), prefix));
+}
+async function rmDirSafe(dir) {
+    try {
+        await fsp.rm(dir, { recursive: true, force: true });
+    }
+    catch { }
+}
+describe("runtime utils", () => {
+    let tmp;
+    beforeEach(async () => {
+        tmp = await makeTmpDir();
+    });
+    afterEach(async () => {
+        await rmDirSafe(tmp);
+    });
+    describe("findNearestConfig", () => {
+        it("walks up directories and finds the nearest file", async () => {
+            const a = path.join(tmp, "a");
+            const b = path.join(a, "b");
+            await fsp.mkdir(b, { recursive: true });
+            const rc = path.join(a, ".sentinelrc.json");
+            await fsp.writeFile(rc, "{}", "utf8");
+            const res = await findNearestConfig({
+                startDir: b,
+                filenames: [".sentinelrc.json"],
+            });
+            expect(res.path).toBe(rc);
+            expect(res.tried.length).toBeGreaterThan(0);
+            expect(path.isAbsolute(res.path)).toBe(true);
+        });
+        it("respects stopDir boundary", async () => {
+            const a = path.join(tmp, "a");
+            const b = path.join(a, "b");
+            const c = path.join(b, "c");
+            await fsp.mkdir(c, { recursive: true });
+            const rc = path.join(tmp, ".sentinelrc.json");
+            await fsp.writeFile(rc, "{}", "utf8");
+            const res = await findNearestConfig({
+                startDir: c,
+                stopDir: a,
+                filenames: [".sentinelrc.json"],
+            });
+            expect(res.path).toBeNull();
+            expect(res.tried.some((p) => p.endsWith(".sentinelrc.json"))).toBe(true);
+        });
+    });
+    describe("readJsonWithDiagnostics", () => {
+        it("returns ok with data on valid JSON", async () => {
+            const file = path.join(tmp, "ok.json");
+            await fsp.writeFile(file, '{"x":1}', "utf8");
+            const res = await readJsonWithDiagnostics(file);
+            expect(res.ok).toBe(true);
+            if (res.ok) {
+                expect(res.data.x).toBe(1);
+            }
+            expect(res.diagnostics).toEqual([]);
+        });
+        it("returns diagnostics on parse error", async () => {
+            const file = path.join(tmp, "bad.json");
+            await fsp.writeFile(file, "{x:}", "utf8");
+            const res = await readJsonWithDiagnostics(file);
+            expect(res.ok).toBe(false);
+            if (!res.ok) {
+                expect(res.diagnostics.find((d) => d.code === "JSON_PARSE_FAILED")).toBeTruthy();
+            }
+        });
+        it("returns diagnostics on read error", async () => {
+            const file = path.join(tmp, "missing.json");
+            const res = await readJsonWithDiagnostics(file);
+            expect(res.ok).toBe(false);
+            if (!res.ok) {
+                expect(res.diagnostics.find((d) => d.code === "FILE_READ_FAILED")).toBeTruthy();
+            }
+        });
+    });
+    describe("mergeDefined", () => {
+        it("deep merges objects and arrays ignoring undefined", () => {
+            const base = { a: 1, b: { x: 1, y: [1] }, c: [1, 2], d: "keep" };
+            const over = {
+                a: undefined,
+                b: { y: [2], z: 3 },
+                c: [3],
+                d: "set",
+                e: 5,
+            };
+            const m = mergeDefined(base, over);
+            expect(m).toEqual({
+                a: 1,
+                b: { x: 1, y: [1, 2], z: 3 },
+                c: [1, 2, 3],
+                d: "set",
+                e: 5,
+            });
+        });
+        it("overlay wins on different types when defined", () => {
+            const base = { a: 1 };
+            const over = { a: { z: 1 } };
+            const m = mergeDefined(base, over);
+            expect(m.a).toEqual({ z: 1 });
+        });
+    });
+    describe("pickDefined", () => {
+        it("picks only defined values", () => {
+            const res = pickDefined({ a: 1, b: undefined, c: false });
+            expect(Object.prototype.hasOwnProperty.call(res, "b")).toBe(false);
+            expect(res).toEqual({ a: 1, c: false });
+        });
+    });
+    describe("resolveConfig", () => {
+        it("applies precedence: defaults < file < env < cli; and validate", () => {
+            const defaults = { a: 1, b: { x: 1 }, c: "d", f: 0 };
+            const file = { a: 2, b: { y: 2 } };
+            const envMapper = (env) => ({
+                b: { x: Number(env.TEST_X ?? 1), z: Number(env.TEST_Z ?? 0) },
+                c: env.TEST_C,
+            });
+            const cli = { c: "cli", f: undefined };
+            const validate = (cfg) => ({
+                ok: cfg.a > 0,
+                diagnostics: [
+                    { level: "info", code: "VALIDATED", message: "ok" },
+                ],
+            });
+            const { value, diagnostics } = resolveConfig({
+                defaults,
+                fileConfig: file,
+                envMapper,
+                cliOverrides: cli,
+                validate,
+            });
+            expect(value).toEqual({
+                a: 2,
+                b: { x: 1, y: 2, z: 0 },
+                c: "cli",
+                f: 0,
+                profiles: {
+                    rootDir: ".kb/profiles",
+                    defaultName: "default",
+                    strict: true,
+                },
+            });
+            expect(diagnostics.some((d) => d.code === "VALIDATED")).toBe(true);
+        });
+        it("env mapper reads real env; can be stubbed", () => {
+            vi.stubEnv("TEST_Z", "5");
+            const defaults = { b: { z: 0 } };
+            const { value } = resolveConfig({
+                defaults: defaults,
+                envMapper: (e) => ({ b: { z: Number(e.TEST_Z) } }),
+            });
+            expect(value).toEqual({
+                b: { z: 5 },
+                profiles: {
+                    rootDir: ".kb/profiles",
+                    defaultName: "default",
+                    strict: true,
+                },
+            });
+            vi.unstubAllEnvs();
+        });
+    });
+});
+//# sourceMappingURL=runtime.spec.js.map

package/dist/__tests__/runtime.spec.js.map

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

package/dist/__tests__/upsert-lockfile.spec.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=upsert-lockfile.spec.d.ts.map

package/dist/__tests__/upsert-lockfile.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upsert-lockfile.spec.d.ts","sourceRoot":"","sources":["../../src/__tests__/upsert-lockfile.spec.ts"],"names":[],"mappings":""}

package/dist/__tests__/upsert-lockfile.spec.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=upsert-lockfile.spec.js.map

package/dist/__tests__/upsert-lockfile.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upsert-lockfile.spec.js","sourceRoot":"","sources":["../../src/__tests__/upsert-lockfile.spec.ts"],"names":[],"mappings":""}

package/dist/__tests__/validate-config.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=validate-config.spec.d.ts.map

package/dist/__tests__/validate-config.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-config.spec.d.ts","sourceRoot":"","sources":["../../src/__tests__/validate-config.spec.ts"],"names":[],"mappings":""}

package/dist/__tests__/validate-config.spec.js

@@ -0,0 +1,14 @@
+import { describe, it, expect } from 'vitest';
+import { validateProductConfig } from '../validation/validate-config';
+describe('config: validate product config', () => {
+    it('validates aiReview config with review schema', () => {
+        const cfg = { rules: [], maxFiles: 10 };
+        const result = validateProductConfig('aiReview', cfg);
+        expect(result.ok).toBe(true);
+    });
+    it('allows unknown product (no schema)', () => {
+        const result = validateProductConfig('release', {});
+        expect(result.ok).toBe(true);
+    });
+});
+//# sourceMappingURL=validate-config.spec.js.map

package/dist/__tests__/validate-config.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-config.spec.js","sourceRoot":"","sources":["../../src/__tests__/validate-config.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;IAC/C,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,GAAG,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAS,CAAC;QAC/C,MAAM,MAAM,GAAG,qBAAqB,CAAC,UAAiB,EAAE,GAAG,CAAC,CAAC;QAC7D,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAgB,EAAE,EAAE,CAAC,CAAC;QAC3D,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/api/init-workspace.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @module @kb-labs/core/config/api/init-workspace
+ * Initialize workspace configuration with idempotent operations
+ */
+import type { InitWorkspaceOptions, InitResult } from '../types/init';
+/**
+ * Initialize or update workspace configuration
+ */
+export declare function initWorkspaceConfig(opts: InitWorkspaceOptions): Promise<InitResult>;
+//# sourceMappingURL=init-workspace.d.ts.map

package/dist/api/init-workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-workspace.d.ts","sourceRoot":"","sources":["../../src/api/init-workspace.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,OAAO,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAc,MAAM,eAAe,CAAC;AAmElF;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,UAAU,CAAC,CAwIrB"}

package/dist/api/init-workspace.js

@@ -0,0 +1,186 @@
+/**
+ * @module @kb-labs/core/config/api/init-workspace
+ * Initialize workspace configuration with idempotent operations
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import YAML from 'yaml';
+import { KbError, ERROR_HINTS } from '../errors/kb-error';
+import { findGitRoot } from './read-config';
+import { writeFileAtomic, ensureWithinWorkspace } from '../utils/fs-atomic';
+import { toFsProduct } from '../utils/product-normalize';
+/**
+ * Generate diff preview (first ~20 lines) for conflicts
+ */
+function generateDiffPreview(oldContent, newContent) {
+    const oldLines = oldContent.split('\n');
+    const newLines = newContent.split('\n');
+    const maxLines = 20;
+    const diff = [];
+    for (let i = 0; i < Math.min(maxLines, Math.max(oldLines.length, newLines.length)); i++) {
+        const oldLine = oldLines[i] || '';
+        const newLine = newLines[i] || '';
+        if (oldLine !== newLine) {
+            if (oldLine) {
+                diff.push(`- ${oldLine}`);
+            }
+            if (newLine) {
+                diff.push(`+ ${newLine}`);
+            }
+        }
+    }
+    if (oldLines.length > maxLines || newLines.length > maxLines) {
+        diff.push('... truncated');
+    }
+    return diff.slice(0, 20).join('\n');
+}
+/**
+ * Find workspace config file, walking up to git root
+ * Prioritizes .kb/ location over root
+ */
+async function findWorkspaceConfig(cwd) {
+    const filenames = [
+        '.kb/kb.config.yaml',
+        '.kb/kb.config.yml',
+        '.kb/kb.config.json',
+    ];
+    const gitRoot = await findGitRoot(cwd);
+    const stopDir = gitRoot || path.parse(cwd).root;
+    let dir = path.resolve(cwd);
+    while (true) {
+        for (const filename of filenames) {
+            const candidate = path.join(dir, filename);
+            try {
+                await fs.access(candidate);
+                const format = filename.endsWith('.json') ? 'json' : 'yaml';
+                return { path: candidate, format };
+            }
+            catch {
+                // Continue to next filename
+            }
+        }
+        // Stop at git root or filesystem root
+        if (dir === stopDir || dir === path.dirname(dir)) {
+            break;
+        }
+        dir = path.dirname(dir);
+    }
+    return null;
+}
+/**
+ * Initialize or update workspace configuration
+ */
+export async function initWorkspaceConfig(opts) {
+    const cwd = path.resolve(opts.cwd);
+    const result = {
+        actions: [],
+        created: [],
+        updated: [],
+        skipped: [],
+        warnings: [],
+    };
+    if (opts.profiles && Object.keys(opts.profiles).length > 0) {
+        result.warnings.push('profiles option is deprecated. Define profiles[] inside kb.config.json (Profiles v2).');
+    }
+    // Find existing config
+    const existing = await findWorkspaceConfig(cwd);
+    const format = existing?.format || opts.format || 'yaml';
+    const configFileName = format === 'json' ? 'kb.config.json' : 'kb.config.yaml';
+    // Create .kb directory if needed for new configs
+    const configPath = existing?.path || path.join(cwd, '.kb', configFileName);
+    // Ensure we're writing within workspace
+    ensureWithinWorkspace(configPath, cwd);
+    // Build new config structure
+    const newConfig = {
+        schemaVersion: '1.0',
+        products: {},
+    };
+    // Add product sections
+    if (opts.products && opts.products.length > 0) {
+        for (const product of opts.products) {
+            const fsProduct = toFsProduct(product);
+            newConfig.products[product] = {};
+        }
+    }
+    // Add preset if specified
+    if (opts.presetRef !== undefined) {
+        newConfig.$extends = opts.presetRef;
+    }
+    // Check if config already exists
+    if (existing) {
+        try {
+            const existingContent = await fs.readFile(existing.path, 'utf-8');
+            const existingData = format === 'json'
+                ? JSON.parse(existingContent)
+                : YAML.parse(existingContent);
+            // Merge with existing config (only add missing keys)
+            let modified = false;
+            // Ensure schemaVersion
+            if (!existingData.schemaVersion) {
+                existingData.schemaVersion = '1.0';
+                modified = true;
+            }
+            // Merge products
+            if (opts.products) {
+                if (!existingData.products) {
+                    existingData.products = {};
+                    modified = true;
+                }
+                for (const product of opts.products) {
+                    if (!existingData.products[product]) {
+                        existingData.products[product] = {};
+                        modified = true;
+                    }
+                }
+            }
+            // Merge preset
+            if (opts.presetRef !== undefined && existingData.$extends !== opts.presetRef) {
+                existingData.$extends = opts.presetRef;
+                modified = true;
+            }
+            if (!modified) {
+                // No changes needed
+                result.actions.push({ kind: 'skip', path: configPath });
+                result.skipped.push(configPath);
+                return result;
+            }
+            // Serialize new content
+            const newContent = format === 'json'
+                ? JSON.stringify(existingData, null, 2) + '\n'
+                : YAML.stringify(existingData);
+            // Check for conflicts
+            if (!opts.force && existingContent !== newContent) {
+                const action = {
+                    kind: 'conflict',
+                    path: configPath,
+                    previewDiff: generateDiffPreview(existingContent, newContent),
+                };
+                result.actions.push(action);
+                result.warnings.push(`Config file has changes, use --force to overwrite: ${configPath}`);
+                return result;
+            }
+            // Write updated config
+            if (!opts.dryRun) {
+                await writeFileAtomic(configPath, newContent);
+            }
+            result.actions.push({ kind: 'update', path: configPath });
+            result.updated.push(configPath);
+        }
+        catch (error) {
+            throw new KbError('ERR_CONFIG_INVALID', `Failed to read or parse existing config: ${existing.path}`, ERROR_HINTS.ERR_CONFIG_INVALID, { error: error instanceof Error ? error.message : String(error) });
+        }
+    }
+    else {
+        // Create new config
+        const content = format === 'json'
+            ? JSON.stringify(newConfig, null, 2) + '\n'
+            : YAML.stringify(newConfig);
+        if (!opts.dryRun) {
+            await writeFileAtomic(configPath, content);
+        }
+        result.actions.push({ kind: 'write', path: configPath });
+        result.created.push(configPath);
+    }
+    return result;
+}
+//# sourceMappingURL=init-workspace.js.map

package/dist/api/init-workspace.js.map

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

package/dist/api/product-config.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @module @kb-labs/core/config/api/product-config
+ * High-level product configuration resolver with layered merge
+ */
+import type { ResolveOptions, ProductConfigResult } from '../types';
+/**
+ * Get product configuration with layered merge and trace
+ */
+export declare function getProductConfig<T = Record<string, any>>(opts: ResolveOptions, schema: any): Promise<ProductConfigResult<T>>;
+/**
+ * Explain product configuration (trace only)
+ */
+export declare function explainProductConfig(opts: Omit<ResolveOptions, 'writeFinal'>, schema: any): Promise<{
+    trace: any[];
+}>;
+/**
+ * Get configuration hash for lockfile
+ */
+export declare function getConfigHash(config: any): string;
+//# sourceMappingURL=product-config.d.ts.map

package/dist/api/product-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-config.d.ts","sourceRoot":"","sources":["../../src/api/product-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAe,MAAM,UAAU,CAAC;AAKjF;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5D,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,GAAG,GACV,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CA2IjC;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,EACxC,MAAM,EAAE,GAAG,GACV,OAAO,CAAC;IAAE,KAAK,EAAE,GAAG,EAAE,CAAA;CAAE,CAAC,CAG3B;AAwFD;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CAEjD"}