@kb-labs/devkit 1.0.0

package/tsconfig/dist/api/product-config.js

@@ -0,0 +1,192 @@
+/**
+ * @module @kb-labs/core/config/api/product-config
+ * High-level product configuration resolver with layered merge
+ */
+import { promises as fsp } from 'node:fs';
+import path from 'node:path';
+import { readWorkspaceConfig } from './read-config';
+import { layeredMergeWithTrace } from '../merge/layered-merge';
+import { toFsProduct } from '../utils/product-normalize';
+import { computeConfigHash } from '../hash/config-hash';
+import { resolvePreset, getPresetConfigForProduct } from '../preset/resolve-preset';
+import { updateLockfile } from '../lockfile/lockfile';
+import { getProductDefaults } from '@kb-labs/core-profiles';
+/**
+ * Get product configuration with layered merge and trace
+ */
+export async function getProductConfig(opts, schema, profileInfo) {
+    const { cwd, product, cli = {}, writeFinal = false } = opts;
+    const fsProduct = toFsProduct(product);
+    // Read workspace configuration
+    const workspaceConfig = await readWorkspaceConfig(cwd);
+    // Build configuration layers
+    const layers = [];
+    // 1. Runtime defaults
+    layers.push({
+        label: 'runtime',
+        value: getRuntimeDefaults(product),
+        source: 'runtime:defaults',
+    });
+    // 2. Profile defaults
+    let profileDefaults = {};
+    if (profileInfo) {
+        try {
+            profileDefaults = await getProductDefaults(profileInfo, toFsProduct(product), schema);
+        }
+        catch (error) {
+            // Profile defaults failed, continue without them
+            console.warn('Warning: Could not load profile defaults:', error);
+        }
+    }
+    layers.push({
+        label: 'profile',
+        value: profileDefaults,
+        source: profileInfo
+            ? `profile:${profileInfo.name}@${profileInfo.version}`
+            : 'profile:none',
+    });
+    // 3. Preset defaults (resolve org preset if configured)
+    let presetConfig = {};
+    if (workspaceConfig?.data) {
+        const workspaceData = workspaceConfig.data;
+        if (workspaceData.$extends) {
+            try {
+                const preset = await resolvePreset(workspaceData.$extends, cwd);
+                presetConfig = getPresetConfigForProduct(preset, product);
+                layers.push({
+                    label: 'preset',
+                    value: presetConfig,
+                    source: `preset:${workspaceData.$extends}`,
+                });
+            }
+            catch (error) {
+                // Preset resolution failed, continue without preset
+                console.warn(`Warning: Could not resolve preset ${workspaceData.$extends}:`, error);
+            }
+        }
+    }
+    if (Object.keys(presetConfig).length === 0) {
+        layers.push({
+            label: 'preset',
+            value: {},
+            source: 'preset:none',
+        });
+    }
+    // 4. Workspace config
+    if (workspaceConfig?.data) {
+        const workspaceData = workspaceConfig.data?.products?.[fsProduct] || {};
+        layers.push({
+            label: 'workspace',
+            value: workspaceData,
+            source: 'workspace:kb-labs.config',
+        });
+    }
+    // 5. Local config (.kb/<product>/<product>.config.json)
+    const localConfigPath = path.join(cwd, '.kb', fsProduct, `${fsProduct}.config.json`);
+    try {
+        const localConfig = await fsp.readFile(localConfigPath, 'utf-8');
+        const localData = JSON.parse(localConfig);
+        layers.push({
+            label: 'local',
+            value: localData,
+            source: `local:.kb/${fsProduct}/${fsProduct}.config.json`,
+        });
+    }
+    catch {
+        // Local config is optional
+    }
+    // 6. CLI overrides
+    if (Object.keys(cli).length > 0) {
+        layers.push({
+            label: 'cli',
+            value: cli,
+            source: 'cli:overrides',
+        });
+    }
+    // Merge all layers
+    const { merged, trace } = layeredMergeWithTrace(layers);
+    // Validate against schema if provided
+    if (schema) {
+        // Schema validation will be implemented with AJV
+        // For now, we'll skip validation
+    }
+    // Write final config if requested
+    if (writeFinal) {
+        await writeFinalConfig(cwd, fsProduct, merged);
+    }
+    // Update lockfile with config hash
+    try {
+        const configHash = computeConfigHash(merged);
+        const configHashes = {};
+        configHashes[product] = configHash;
+        await updateLockfile(cwd, {
+            configHashes
+        });
+    }
+    catch (error) {
+        // Lockfile update is optional, don't fail the config resolution
+        console.warn('Warning: Could not update lockfile:', error);
+    }
+    return {
+        config: merged,
+        trace,
+    };
+}
+/**
+ * Explain product configuration (trace only)
+ */
+export async function explainProductConfig(opts, schema, profileInfo) {
+    const result = await getProductConfig(opts, schema, profileInfo);
+    return { trace: result.trace };
+}
+/**
+ * Get runtime defaults for a product
+ */
+function getRuntimeDefaults(product) {
+    const defaults = {
+        devlink: {
+            watch: true,
+            build: true,
+        },
+        release: {
+            version: '1.0.0',
+            publish: false,
+        },
+        aiReview: {
+            enabled: true,
+            rules: [],
+        },
+        aiDocs: {
+            enabled: true,
+            templates: [],
+        },
+        devkit: {
+            sync: true,
+            check: true,
+        },
+    };
+    return defaults[product] || {};
+}
+/**
+ * Write final configuration to .kb/<product>/<product>.config.json
+ */
+async function writeFinalConfig(cwd, fsProduct, config) {
+    const configDir = path.join(cwd, '.kb', fsProduct);
+    const configPath = path.join(configDir, `${fsProduct}.config.json`);
+    // Ensure directory exists
+    await fsp.mkdir(configDir, { recursive: true });
+    // Write config with schema version
+    const finalConfig = {
+        $schema: 'https://schemas.kb-labs.dev/config.schema.json',
+        schemaVersion: '1.0',
+        ...config,
+    };
+    await fsp.writeFile(configPath, JSON.stringify(finalConfig, null, 2));
+}
+/**
+ * Get configuration hash for lockfile
+ */
+export function getConfigHash(config) {
+    return computeConfigHash(config);
+}
+//# sourceMappingURL=product-config.js.map

package/tsconfig/dist/api/product-config.js.map

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

package/tsconfig/dist/api/read-config.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @module @kb-labs/core/config/api/read-config
+ * Enhanced config file reading with YAML support and find-up
+ */
+export interface ConfigFileResult {
+    data: unknown;
+    format: 'json' | 'yaml';
+    path: string;
+}
+/**
+ * Read config file with format detection and caching
+ */
+export declare function readConfigFile(filePath: string): Promise<ConfigFileResult>;
+/**
+ * Find git root directory
+ */
+export declare function findGitRoot(startDir: string): Promise<string | null>;
+/**
+ * Read workspace config with find-up to git root
+ */
+export declare function readWorkspaceConfig(cwd: string): Promise<ConfigFileResult | null>;
+//# sourceMappingURL=read-config.d.ts.map

package/tsconfig/dist/api/read-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-config.d.ts","sourceRoot":"","sources":["../../../../kb-labs-core/packages/config/src/api/read-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA+ChF;AAqCD;;GAEG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiB1E;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CASvF"}

package/tsconfig/dist/api/read-config.js

@@ -0,0 +1,105 @@
+/**
+ * @module @kb-labs/core/config/api/read-config
+ * Enhanced config file reading with YAML support and find-up
+ */
+import { promises as fsp } from 'node:fs';
+import path from 'node:path';
+import { extname } from 'node:path';
+import YAML from 'yaml';
+import { KbError, ERROR_HINTS } from '../errors/kb-error';
+import { fsCache } from '../cache/fs-cache';
+/**
+ * Read config file with format detection and caching
+ */
+export async function readConfigFile(filePath) {
+    const absPath = path.resolve(filePath);
+    // Check cache first
+    const cached = await fsCache.get(absPath);
+    if (cached !== null) {
+        return cached;
+    }
+    try {
+        const raw = await fsp.readFile(absPath, 'utf-8');
+        const ext = extname(absPath).toLowerCase();
+        let data;
+        let format;
+        if (ext === '.yaml' || ext === '.yml') {
+            data = YAML.parse(raw);
+            format = 'yaml';
+        }
+        else {
+            data = JSON.parse(raw);
+            format = 'json';
+        }
+        const result = { data, format, path: absPath };
+        // Cache the result
+        await fsCache.set(absPath, result);
+        return result;
+    }
+    catch (error) {
+        if (error instanceof SyntaxError) {
+            throw new KbError('ERR_CONFIG_INVALID', `Failed to parse config file: ${filePath}`, ERROR_HINTS.ERR_CONFIG_INVALID, { filePath, error: error.message });
+        }
+        throw new KbError('ERR_CONFIG_NOT_FOUND', `Config file not found: ${filePath}`, ERROR_HINTS.ERR_CONFIG_NOT_FOUND, { filePath, error: error instanceof Error ? error.message : String(error) });
+    }
+}
+/**
+ * Find nearest config file walking up from startDir to git root
+ */
+async function findNearestConfig(startDir, filenames = ['kb-labs.config.json', 'kb-labs.config.yaml', 'kb-labs.config.yml']) {
+    const start = path.resolve(startDir);
+    const tried = [];
+    let dir = start;
+    while (true) {
+        for (const filename of filenames) {
+            const candidate = path.join(dir, filename);
+            tried.push(candidate);
+            try {
+                await fsp.access(candidate);
+                return { path: candidate, tried };
+            }
+            catch {
+                // Continue to next filename
+            }
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir) {
+            // Reached filesystem root
+            break;
+        }
+        dir = parent;
+    }
+    return { path: null, tried };
+}
+/**
+ * Find git root directory
+ */
+export async function findGitRoot(startDir) {
+    let dir = path.resolve(startDir);
+    while (true) {
+        try {
+            await fsp.access(path.join(dir, '.git'));
+            return dir;
+        }
+        catch {
+            const parent = path.dirname(dir);
+            if (parent === dir) {
+                break;
+            }
+            dir = parent;
+        }
+    }
+    return null;
+}
+/**
+ * Read workspace config with find-up to git root
+ */
+export async function readWorkspaceConfig(cwd) {
+    const filenames = ['kb-labs.config.json', 'kb-labs.config.yaml', 'kb-labs.config.yml'];
+    const { path: configPath } = await findNearestConfig(cwd, filenames);
+    if (!configPath) {
+        return null;
+    }
+    return readConfigFile(configPath);
+}
+//# sourceMappingURL=read-config.js.map

package/tsconfig/dist/api/read-config.js.map

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

package/tsconfig/dist/api/upsert-lockfile.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @module @kb-labs/core/config/api/upsert-lockfile
+ * Upsert lockfile operations
+ */
+import type { UpsertLockfileOptions, InitResult } from '../types/init';
+/**
+ * Upsert lockfile with new references
+ */
+export declare function upsertLockfile(opts: UpsertLockfileOptions): Promise<InitResult>;
+//# sourceMappingURL=upsert-lockfile.d.ts.map

package/tsconfig/dist/api/upsert-lockfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upsert-lockfile.d.ts","sourceRoot":"","sources":["../../../../kb-labs-core/packages/config/src/api/upsert-lockfile.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEvE;;GAEG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,UAAU,CAAC,CAyDrB"}

package/tsconfig/dist/api/upsert-lockfile.js

@@ -0,0 +1,63 @@
+/**
+ * @module @kb-labs/core/config/api/upsert-lockfile
+ * Upsert lockfile operations
+ */
+import path from 'node:path';
+import { promises as fs } from 'node:fs';
+import { readLockfile, writeLockfile } from '../lockfile/lockfile';
+import { ensureWithinWorkspace } from '../utils/fs-atomic';
+/**
+ * Upsert lockfile with new references
+ */
+export async function upsertLockfile(opts) {
+    const cwd = path.resolve(opts.cwd);
+    const lockfilePath = path.join(cwd, '.kb', 'lock.json');
+    const oldLockfilePath = path.join(cwd, '.kb', 'lockfile.json');
+    const result = {
+        actions: [],
+        created: [],
+        updated: [],
+        skipped: [],
+        warnings: [],
+    };
+    // Ensure we're writing within workspace
+    ensureWithinWorkspace(lockfilePath, cwd);
+    // Check for deprecated lockfile location
+    try {
+        await fs.access(oldLockfilePath);
+        result.warnings.push('Deprecated lockfile found at .kb/lockfile.json, please migrate to .kb/lock.json');
+    }
+    catch {
+        // No old lockfile, that's fine
+    }
+    // Read existing lockfile
+    const existing = await readLockfile(cwd);
+    // Build lockfile data
+    const lockfileData = {
+        $schema: 'https://schemas.kb-labs.dev/lockfile.schema.json',
+        schemaVersion: '1.0',
+        orgPreset: opts.presetRef !== undefined ? opts.presetRef || undefined : existing?.orgPreset,
+        profile: opts.profileRef !== undefined ? opts.profileRef || undefined : existing?.profile,
+        policyBundle: opts.policyBundle !== undefined ? opts.policyBundle || undefined : existing?.policyBundle,
+        hashes: existing?.hashes || {},
+        generatedAt: new Date().toISOString(),
+    };
+    if (!existing) {
+        // Creating new lockfile
+        if (!opts.dryRun) {
+            await writeLockfile(cwd, lockfileData);
+        }
+        result.actions.push({ kind: 'write', path: lockfilePath });
+        result.created.push(lockfilePath);
+    }
+    else {
+        // Updating existing lockfile
+        if (!opts.dryRun) {
+            await writeLockfile(cwd, lockfileData);
+        }
+        result.actions.push({ kind: 'update', path: lockfilePath });
+        result.updated.push(lockfilePath);
+    }
+    return result;
+}
+//# sourceMappingURL=upsert-lockfile.js.map

package/tsconfig/dist/api/upsert-lockfile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upsert-lockfile.js","sourceRoot":"","sources":["../../../../kb-labs-core/packages/config/src/api/upsert-lockfile.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAqB,MAAM,sBAAsB,CAAC;AACtF,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAG3D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAA2B;IAE3B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;IACxD,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC;IAE/D,MAAM,MAAM,GAAe;QACzB,OAAO,EAAE,EAAE;QACX,OAAO,EAAE,EAAE;QACX,OAAO,EAAE,EAAE;QACX,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE,EAAE;KACb,CAAC;IAEF,wCAAwC;IACxC,qBAAqB,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;IAEzC,yCAAyC;IACzC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QACjC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAClB,iFAAiF,CAClF,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,+BAA+B;IACjC,CAAC;IAED,yBAAyB;IACzB,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC;IAEzC,sBAAsB;IACtB,MAAM,YAAY,GAAiB;QACjC,OAAO,EAAE,kDAAkD;QAC3D,aAAa,EAAE,KAAK;QACpB,SAAS,EAAE,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,SAAS;QAC3F,OAAO,EAAE,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,IAAI,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,OAAO;QACzF,YAAY,EAAE,IAAI,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,IAAI,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,YAAY;QACvG,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,EAAE;QAC9B,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACtC,CAAC;IAEF,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,wBAAwB;QACxB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,aAAa,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QACzC,CAAC;QACD,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;QAC3D,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACpC,CAAC;SAAM,CAAC;QACN,6BAA6B;QAC7B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,aAAa,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QACzC,CAAC;QACD,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;QAC5D,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/tsconfig/dist/cache/fs-cache.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @module @kb-labs/core/config/cache/fs-cache
+ * LRU cache for filesystem reads with clearCaches() support
+ */
+declare class FSCache {
+    private cache;
+    private keyCache;
+    /**
+     * Generate cache key from file path, mtime, and size
+     */
+    private getCacheKey;
+    /**
+     * Get cached file data if available and not stale
+     */
+    get(absPath: string): Promise<any | null>;
+    /**
+     * Cache file data
+     */
+    set(absPath: string, data: any): Promise<void>;
+    /**
+     * Clear all caches
+     */
+    clearCaches(): void;
+    /**
+     * Get cache statistics
+     */
+    getStats(): {
+        size: number;
+        keySize: number;
+    };
+}
+declare const fsCache: FSCache;
+export { fsCache, FSCache };
+/**
+ * Clear all filesystem caches
+ */
+export declare function clearCaches(): void;
+//# sourceMappingURL=fs-cache.d.ts.map

package/tsconfig/dist/cache/fs-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-cache.d.ts","sourceRoot":"","sources":["../../../../kb-labs-core/packages/config/src/cache/fs-cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA8DH,cAAM,OAAO;IACX,OAAO,CAAC,KAAK,CAAyC;IACtD,OAAO,CAAC,QAAQ,CAAuC;IAEvD;;OAEG;YACW,WAAW;IAsBzB;;OAEG;IACG,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IAiC/C;;OAEG;IACG,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAYpD;;OAEG;IACH,WAAW,IAAI,IAAI;IAKnB;;OAEG;IACH,QAAQ,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;CAM9C;AAGD,QAAA,MAAM,OAAO,SAAgB,CAAC;AAE9B,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAE5B;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC"}

package/tsconfig/dist/cache/fs-cache.js

@@ -0,0 +1,142 @@
+/**
+ * @module @kb-labs/core/config/cache/fs-cache
+ * LRU cache for filesystem reads with clearCaches() support
+ */
+import { promises as fsp } from 'node:fs';
+class LRUCache {
+    cache = new Map();
+    maxSize;
+    constructor(maxSize = 100) {
+        this.maxSize = maxSize;
+    }
+    get(key) {
+        const value = this.cache.get(key);
+        if (value !== undefined) {
+            // Move to end (most recently used)
+            this.cache.delete(key);
+            this.cache.set(key, value);
+        }
+        return value;
+    }
+    set(key, value) {
+        if (this.cache.has(key)) {
+            this.cache.delete(key);
+        }
+        else if (this.cache.size >= this.maxSize) {
+            // Remove least recently used (first item)
+            const firstKey = this.cache.keys().next().value;
+            if (firstKey !== undefined) {
+                this.cache.delete(firstKey);
+            }
+        }
+        this.cache.set(key, value);
+    }
+    delete(key) {
+        return this.cache.delete(key);
+    }
+    clear() {
+        this.cache.clear();
+    }
+    size() {
+        return this.cache.size;
+    }
+}
+class FSCache {
+    cache = new LRUCache(100);
+    keyCache = new LRUCache(100);
+    /**
+     * Generate cache key from file path, mtime, and size
+     */
+    async getCacheKey(absPath) {
+        const keyStr = `key:${absPath}`;
+        let key = this.keyCache.get(keyStr);
+        if (!key) {
+            try {
+                const stats = await fsp.stat(absPath);
+                key = {
+                    absPath,
+                    mtime: stats.mtime.getTime(),
+                    size: stats.size,
+                };
+                this.keyCache.set(keyStr, key);
+            }
+            catch {
+                // File doesn't exist or can't be read
+                return { absPath, mtime: 0, size: 0 };
+            }
+        }
+        return key;
+    }
+    /**
+     * Get cached file data if available and not stale
+     */
+    async get(absPath) {
+        const key = await this.getCacheKey(absPath);
+        const cacheKey = `${key.absPath}|${key.mtime}|${key.size}`;
+        const entry = this.cache.get(cacheKey);
+        if (!entry) {
+            return null;
+        }
+        // Check if file has been modified since cache
+        try {
+            const stats = await fsp.stat(absPath);
+            if (stats.mtime.getTime() !== key.mtime || stats.size !== key.size) {
+                // File changed, remove from cache and update key cache
+                this.cache.delete(cacheKey);
+                // Update the key cache with new stats
+                const newKey = {
+                    absPath,
+                    mtime: stats.mtime.getTime(),
+                    size: stats.size,
+                };
+                this.keyCache.set(`key:${absPath}`, newKey);
+                return null;
+            }
+        }
+        catch {
+            // File no longer exists
+            this.cache.delete(cacheKey);
+            return null;
+        }
+        return entry.data;
+    }
+    /**
+     * Cache file data
+     */
+    async set(absPath, data) {
+        const key = await this.getCacheKey(absPath);
+        const cacheKey = `${key.absPath}|${key.mtime}|${key.size}`;
+        this.cache.set(cacheKey, {
+            data,
+            mtime: key.mtime,
+            size: key.size,
+            timestamp: Date.now(),
+        });
+    }
+    /**
+     * Clear all caches
+     */
+    clearCaches() {
+        this.cache.clear();
+        this.keyCache.clear();
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats() {
+        return {
+            size: this.cache.size(),
+            keySize: this.keyCache.size(),
+        };
+    }
+}
+// Singleton instance
+const fsCache = new FSCache();
+export { fsCache, FSCache };
+/**
+ * Clear all filesystem caches
+ */
+export function clearCaches() {
+    fsCache.clearCaches();
+}
+//# sourceMappingURL=fs-cache.js.map

package/tsconfig/dist/cache/fs-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-cache.js","sourceRoot":"","sources":["../../../../kb-labs-core/packages/config/src/cache/fs-cache.ts"],"names":[],"mappings":"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"}

package/tsconfig/dist/errors/kb-error.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @module @kb-labs/core/config/errors
+ * Standardized error class for KB Labs with exit code mapping
+ */
+export declare class KbError extends Error {
+    code: string;
+    hint?: string | undefined;
+    meta?: any | undefined;
+    constructor(code: string, message: string, hint?: string | undefined, meta?: any | undefined);
+}
+/**
+ * Maps KbError codes to CLI exit codes
+ */
+export declare function getExitCode(err: KbError): number;
+/**
+ * Error codes with their standard hints
+ */
+export declare const ERROR_HINTS: {
+    readonly ERR_CONFIG_NOT_FOUND: "Create kb-labs.config.yaml or run: kb init";
+    readonly ERR_CONFIG_INVALID: "Check configuration syntax and required fields";
+    readonly ERR_CONFIG_EXISTS_CONFLICT: "Use --force to overwrite existing configuration";
+    readonly ERR_PATH_OUTSIDE_WORKSPACE: "Check cwd or use a relative path within the workspace";
+    readonly ERR_PRESET_NOT_RESOLVED: "Install the required preset package or check network connectivity";
+    readonly ERR_PROFILE_INCOMPATIBLE: "Profile version is incompatible with current system";
+    readonly ERR_PROFILE_NOT_DEFINED: "Add profiles.default to kb-labs.config.yaml";
+    readonly ERR_PROFILE_RESOLVE_FAILED: "pnpm add -D @kb-labs/profile-...";
+    readonly ERR_PROFILE_INVALID_FORMAT: "Recreate profile with: kb init profile --scaffold-local-profile";
+    readonly ERR_ARTIFACT_LIMIT_EXCEEDED: "Remove or split large artifacts, or reduce artifact count";
+    readonly ERR_FORBIDDEN: "Add role in policy.overrides or use preset...";
+};
+export type ErrorCode = keyof typeof ERROR_HINTS;
+//# sourceMappingURL=kb-error.d.ts.map

package/tsconfig/dist/errors/kb-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kb-error.d.ts","sourceRoot":"","sources":["../../../../kb-labs-core/packages/config/src/errors/kb-error.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qBAAa,OAAQ,SAAQ,KAAK;IAEvB,IAAI,EAAE,MAAM;IAEZ,IAAI,CAAC,EAAE,MAAM;IACb,IAAI,CAAC,EAAE,GAAG;gBAHV,IAAI,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACR,IAAI,CAAC,EAAE,MAAM,YAAA,EACb,IAAI,CAAC,EAAE,GAAG,YAAA;CAKpB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAOhD;AAED;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;CAYd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,WAAW,CAAC"}