@stoneforge/quarry 0.1.0

package/dist/config/merge.js

@@ -0,0 +1,226 @@
+/**
+ * Configuration Merging
+ *
+ * Deep merge utilities for combining configuration from multiple sources
+ * with precedence handling.
+ */
+import { getDefaultConfig } from './defaults.js';
+// ============================================================================
+// Deep Merge Utilities
+// ============================================================================
+/**
+ * Checks if a value is a plain object (not array, null, etc.)
+ */
+function isPlainObject(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        !Array.isArray(value) &&
+        Object.getPrototypeOf(value) === Object.prototype);
+}
+/**
+ * Deep merges two objects, with source values overriding target values
+ * Arrays are replaced, not merged
+ *
+ * @param target - Base object
+ * @param source - Override object
+ * @returns Merged object
+ */
+export function deepMerge(target, source) {
+    const result = { ...target };
+    for (const key of Object.keys(source)) {
+        const sourceValue = source[key];
+        const targetValue = target[key];
+        if (sourceValue === undefined) {
+            // Skip undefined values - don't override with undefined
+            continue;
+        }
+        if (isPlainObject(sourceValue) && isPlainObject(targetValue)) {
+            // Recursively merge objects
+            result[key] = deepMerge(targetValue, sourceValue);
+        }
+        else {
+            // Replace value (arrays, primitives, etc.)
+            result[key] = sourceValue;
+        }
+    }
+    return result;
+}
+/**
+ * Merges partial configuration into a complete configuration
+ *
+ * @param base - Base configuration (typically defaults)
+ * @param partial - Partial configuration to merge in
+ * @returns Complete merged configuration
+ */
+export function mergeConfiguration(base, partial) {
+    const result = {
+        actor: partial.actor !== undefined ? partial.actor : base.actor,
+        database: partial.database !== undefined ? partial.database : base.database,
+        sync: {
+            autoExport: partial.sync?.autoExport !== undefined ? partial.sync.autoExport : base.sync.autoExport,
+            exportDebounce: partial.sync?.exportDebounce !== undefined ? partial.sync.exportDebounce : base.sync.exportDebounce,
+            elementsFile: partial.sync?.elementsFile !== undefined ? partial.sync.elementsFile : base.sync.elementsFile,
+            dependenciesFile: partial.sync?.dependenciesFile !== undefined ? partial.sync.dependenciesFile : base.sync.dependenciesFile,
+        },
+        playbooks: {
+            paths: partial.playbooks?.paths !== undefined ? partial.playbooks.paths : [...base.playbooks.paths],
+        },
+        tombstone: {
+            ttl: partial.tombstone?.ttl !== undefined ? partial.tombstone.ttl : base.tombstone.ttl,
+            minTtl: partial.tombstone?.minTtl !== undefined ? partial.tombstone.minTtl : base.tombstone.minTtl,
+        },
+        identity: {
+            mode: partial.identity?.mode !== undefined ? partial.identity.mode : base.identity.mode,
+            timeTolerance: partial.identity?.timeTolerance !== undefined ? partial.identity.timeTolerance : base.identity.timeTolerance,
+        },
+        plugins: {
+            packages: partial.plugins?.packages !== undefined ? partial.plugins.packages : [...(base.plugins?.packages ?? [])],
+        },
+    };
+    return result;
+}
+/**
+ * Merges multiple partial configurations in order
+ * Later configurations override earlier ones
+ *
+ * @param base - Base configuration
+ * @param partials - Partial configurations to merge, in order
+ * @returns Complete merged configuration
+ */
+export function mergeConfigurations(base, ...partials) {
+    let result = base;
+    for (const partial of partials) {
+        result = mergeConfiguration(result, partial);
+    }
+    return result;
+}
+/**
+ * Creates a configuration by merging defaults with partial config
+ *
+ * @param partial - Partial configuration
+ * @returns Complete configuration with defaults filled in
+ */
+export function createConfiguration(partial) {
+    const defaults = getDefaultConfig();
+    if (!partial) {
+        return defaults;
+    }
+    return mergeConfiguration(defaults, partial);
+}
+// ============================================================================
+// Clone Utilities
+// ============================================================================
+/**
+ * Creates a deep clone of a configuration
+ */
+export function cloneConfiguration(config) {
+    return {
+        actor: config.actor,
+        database: config.database,
+        sync: {
+            autoExport: config.sync.autoExport,
+            exportDebounce: config.sync.exportDebounce,
+            elementsFile: config.sync.elementsFile,
+            dependenciesFile: config.sync.dependenciesFile,
+        },
+        playbooks: {
+            paths: [...config.playbooks.paths],
+        },
+        tombstone: {
+            ttl: config.tombstone.ttl,
+            minTtl: config.tombstone.minTtl,
+        },
+        identity: {
+            mode: config.identity.mode,
+            timeTolerance: config.identity.timeTolerance,
+        },
+        plugins: {
+            packages: [...(config.plugins?.packages ?? [])],
+        },
+    };
+}
+// ============================================================================
+// Diff Utilities
+// ============================================================================
+/**
+ * Compares two configurations and returns the differences
+ */
+export function diffConfigurations(a, b) {
+    const diff = {};
+    if (a.actor !== b.actor) {
+        diff.actor = b.actor;
+    }
+    if (a.database !== b.database) {
+        diff.database = b.database;
+    }
+    // Sync diff
+    const syncDiff = {};
+    if (a.sync.autoExport !== b.sync.autoExport) {
+        syncDiff.autoExport = b.sync.autoExport;
+    }
+    if (a.sync.exportDebounce !== b.sync.exportDebounce) {
+        syncDiff.exportDebounce = b.sync.exportDebounce;
+    }
+    if (a.sync.elementsFile !== b.sync.elementsFile) {
+        syncDiff.elementsFile = b.sync.elementsFile;
+    }
+    if (a.sync.dependenciesFile !== b.sync.dependenciesFile) {
+        syncDiff.dependenciesFile = b.sync.dependenciesFile;
+    }
+    if (Object.keys(syncDiff).length > 0) {
+        diff.sync = syncDiff;
+    }
+    // Playbooks diff
+    if (JSON.stringify(a.playbooks.paths) !== JSON.stringify(b.playbooks.paths)) {
+        diff.playbooks = { paths: b.playbooks.paths };
+    }
+    // Tombstone diff
+    const tombstoneDiff = {};
+    if (a.tombstone.ttl !== b.tombstone.ttl) {
+        tombstoneDiff.ttl = b.tombstone.ttl;
+    }
+    if (a.tombstone.minTtl !== b.tombstone.minTtl) {
+        tombstoneDiff.minTtl = b.tombstone.minTtl;
+    }
+    if (Object.keys(tombstoneDiff).length > 0) {
+        diff.tombstone = tombstoneDiff;
+    }
+    // Identity diff
+    const identityDiff = {};
+    if (a.identity.mode !== b.identity.mode) {
+        identityDiff.mode = b.identity.mode;
+    }
+    if (a.identity.timeTolerance !== b.identity.timeTolerance) {
+        identityDiff.timeTolerance = b.identity.timeTolerance;
+    }
+    if (Object.keys(identityDiff).length > 0) {
+        diff.identity = identityDiff;
+    }
+    // Plugins diff
+    const aPackages = a.plugins?.packages ?? [];
+    const bPackages = b.plugins?.packages ?? [];
+    if (JSON.stringify(aPackages) !== JSON.stringify(bPackages)) {
+        diff.plugins = { packages: bPackages };
+    }
+    return diff;
+}
+/**
+ * Checks if two configurations are equal
+ */
+export function configurationsEqual(a, b) {
+    const aPackages = a.plugins?.packages ?? [];
+    const bPackages = b.plugins?.packages ?? [];
+    return (a.actor === b.actor &&
+        a.database === b.database &&
+        a.sync.autoExport === b.sync.autoExport &&
+        a.sync.exportDebounce === b.sync.exportDebounce &&
+        a.sync.elementsFile === b.sync.elementsFile &&
+        a.sync.dependenciesFile === b.sync.dependenciesFile &&
+        JSON.stringify(a.playbooks.paths) === JSON.stringify(b.playbooks.paths) &&
+        a.tombstone.ttl === b.tombstone.ttl &&
+        a.tombstone.minTtl === b.tombstone.minTtl &&
+        a.identity.mode === b.identity.mode &&
+        a.identity.timeTolerance === b.identity.timeTolerance &&
+        JSON.stringify(aPackages) === JSON.stringify(bPackages));
+}
+//# sourceMappingURL=merge.js.map

package/dist/config/merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.js","sourceRoot":"","sources":["../../src/config/merge.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E;;GAEG;AACH,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACrB,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,SAAS,CAClD,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CACvB,MAAS,EACT,MAAkB;IAElB,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;IAE7B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAmB,EAAE,CAAC;QACxD,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAEhC,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,wDAAwD;YACxD,SAAS;QACX,CAAC;QAED,IAAI,aAAa,CAAC,WAAW,CAAC,IAAI,aAAa,CAAC,WAAW,CAAC,EAAE,CAAC;YAC7D,4BAA4B;YAC5B,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CACrB,WAAsC,EACtC,WAAsC,CACzB,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,2CAA2C;YAC3C,MAAM,CAAC,GAAG,CAAC,GAAG,WAAyB,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAmB,EACnB,OAA6B;IAE7B,MAAM,MAAM,GAAkB;QAC5B,KAAK,EAAE,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK;QAC/D,QAAQ,EAAE,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ;QAC3E,IAAI,EAAE;YACJ,UAAU,EAAE,OAAO,CAAC,IAAI,EAAE,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU;YACnG,cAAc,EAAE,OAAO,CAAC,IAAI,EAAE,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc;YACnH,YAAY,EAAE,OAAO,CAAC,IAAI,EAAE,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY;YAC3G,gBAAgB,EAAE,OAAO,CAAC,IAAI,EAAE,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB;SAC5H;QACD,SAAS,EAAE;YACT,KAAK,EAAE,OAAO,CAAC,SAAS,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;SACpG;QACD,SAAS,EAAE;YACT,GAAG,EAAE,OAAO,CAAC,SAAS,EAAE,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG;YACtF,MAAM,EAAE,OAAO,CAAC,SAAS,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM;SACnG;QACD,QAAQ,EAAE;YACR,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI;YACvF,aAAa,EAAE,OAAO,CAAC,QAAQ,EAAE,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa;SAC5H;QACD,OAAO,EAAE;YACP,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC;SACnH;KACF,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAmB,EACnB,GAAG,QAAgC;IAEnC,IAAI,MAAM,GAAG,IAAI,CAAC;IAClB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,GAAG,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAA8B;IAChE,MAAM,QAAQ,GAAG,gBAAgB,EAAE,CAAC;IACpC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,kBAAkB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC;AAED,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAqB;IACtD,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,IAAI,EAAE;YACJ,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU;YAClC,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,cAAc;YAC1C,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,YAAY;YACtC,gBAAgB,EAAE,MAAM,CAAC,IAAI,CAAC,gBAAgB;SAC/C;QACD,SAAS,EAAE;YACT,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC;SACnC;QACD,SAAS,EAAE;YACT,GAAG,EAAE,MAAM,CAAC,SAAS,CAAC,GAAG;YACzB,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,MAAM;SAChC;QACD,QAAQ,EAAE;YACR,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI;YAC1B,aAAa,EAAE,MAAM,CAAC,QAAQ,CAAC,aAAa;SAC7C;QACD,OAAO,EAAE;YACP,QAAQ,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC;SAChD;KACF,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,CAAgB,EAChB,CAAgB;IAEhB,MAAM,IAAI,GAAyB,EAAE,CAAC;IAEtC,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;IACvB,CAAC;IACD,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC;IAC7B,CAAC;IAED,YAAY;IACZ,MAAM,QAAQ,GAAmC,EAAE,CAAC;IACpD,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QAC5C,QAAQ,CAAC,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;IAC1C,CAAC;IACD,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,KAAK,CAAC,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;QACpD,QAAQ,CAAC,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC;IAClD,CAAC;IACD,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,KAAK,CAAC,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;QAChD,QAAQ,CAAC,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC;IAC9C,CAAC;IACD,IAAI,CAAC,CAAC,IAAI,CAAC,gBAAgB,KAAK,CAAC,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxD,QAAQ,CAAC,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC;IACtD,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrC,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC;IACvB,CAAC;IAED,iBAAiB;IACjB,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5E,IAAI,CAAC,SAAS,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IAChD,CAAC;IAED,iBAAiB;IACjB,MAAM,aAAa,GAAwC,EAAE,CAAC;IAC9D,IAAI,CAAC,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;QACxC,aAAa,CAAC,GAAG,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC;IACtC,CAAC;IACD,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;QAC9C,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC;IAC5C,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,IAAI,CAAC,SAAS,GAAG,aAAa,CAAC;IACjC,CAAC;IAED,gBAAgB;IAChB,MAAM,YAAY,GAAuC,EAAE,CAAC;IAC5D,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACxC,YAAY,CAAC,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;IACtC,CAAC;IACD,IAAI,CAAC,CAAC,QAAQ,CAAC,aAAa,KAAK,CAAC,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;QAC1D,YAAY,CAAC,aAAa,GAAG,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC;IACxD,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzC,IAAI,CAAC,QAAQ,GAAG,YAAY,CAAC;IAC/B,CAAC;IAED,eAAe;IACf,MAAM,SAAS,GAAG,CAAC,CAAC,OAAO,EAAE,QAAQ,IAAI,EAAE,CAAC;IAC5C,MAAM,SAAS,GAAG,CAAC,CAAC,OAAO,EAAE,QAAQ,IAAI,EAAE,CAAC;IAC5C,IAAI,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5D,IAAI,CAAC,OAAO,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACzC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,CAAgB,EAAE,CAAgB;IACpE,MAAM,SAAS,GAAG,CAAC,CAAC,OAAO,EAAE,QAAQ,IAAI,EAAE,CAAC;IAC5C,MAAM,SAAS,GAAG,CAAC,CAAC,OAAO,EAAE,QAAQ,IAAI,EAAE,CAAC;IAC5C,OAAO,CACL,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;QACnB,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ;QACzB,CAAC,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,CAAC,IAAI,CAAC,UAAU;QACvC,CAAC,CAAC,IAAI,CAAC,cAAc,KAAK,CAAC,CAAC,IAAI,CAAC,cAAc;QAC/C,CAAC,CAAC,IAAI,CAAC,YAAY,KAAK,CAAC,CAAC,IAAI,CAAC,YAAY;QAC3C,CAAC,CAAC,IAAI,CAAC,gBAAgB,KAAK,CAAC,CAAC,IAAI,CAAC,gBAAgB;QACnD,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC;QACvE,CAAC,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC,GAAG;QACnC,CAAC,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,SAAS,CAAC,MAAM;QACzC,CAAC,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,CAAC,QAAQ,CAAC,IAAI;QACnC,CAAC,CAAC,QAAQ,CAAC,aAAa,KAAK,CAAC,CAAC,QAAQ,CAAC,aAAa;QACrD,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CACxD,CAAC;AACJ,CAAC"}

package/dist/config/types.d.ts

@@ -0,0 +1,257 @@
+/**
+ * Configuration System Types
+ *
+ * Defines all configuration interfaces and types for the Stoneforge system.
+ * Supports file-based configuration, environment variables, and CLI overrides
+ * with a clear precedence hierarchy.
+ */
+import { IdentityMode } from '../systems/identity.js';
+/**
+ * Duration in milliseconds
+ * Can be specified as number (ms) or duration string (e.g., '5m', '500ms')
+ */
+export type Duration = number;
+/**
+ * Duration string format
+ * Supported units: ms, s, m, h, d
+ */
+export type DurationString = `${number}${'ms' | 's' | 'm' | 'h' | 'd'}`;
+/**
+ * Sync configuration settings
+ */
+export interface SyncConfig {
+    /** Auto-export on mutations (default: true) */
+    autoExport: boolean;
+    /** Debounce interval for exports (default: 500ms) */
+    exportDebounce: Duration;
+    /** Elements JSONL file name (default: 'elements.jsonl') */
+    elementsFile: string;
+    /** Dependencies JSONL file name (default: 'dependencies.jsonl') */
+    dependenciesFile: string;
+}
+/**
+ * Playbook configuration settings
+ */
+export interface PlaybookConfig {
+    /** Playbook search paths */
+    paths: string[];
+}
+/**
+ * Tombstone (soft delete) configuration
+ */
+export interface TombstoneConfig {
+    /** Time-to-live for tombstones (default: 30 days = 2592000000ms) */
+    ttl: Duration;
+    /** Minimum TTL allowed (default: 7 days = 604800000ms) */
+    minTtl: Duration;
+}
+/**
+ * CLI plugins configuration
+ */
+export interface PluginsConfig {
+    /** Package names that export CLI plugins */
+    packages: string[];
+}
+/**
+ * Identity system configuration
+ */
+export interface IdentityConfigSection {
+    /** Identity verification mode (default: 'soft') */
+    mode: IdentityMode;
+    /** Time tolerance for signature expiry (default: 5 minutes) */
+    timeTolerance: Duration;
+}
+/**
+ * Complete Stoneforge configuration
+ */
+export interface Configuration {
+    /** Default actor name for operations */
+    actor?: string;
+    /** Database filename (default: 'stoneforge.db') */
+    database: string;
+    /** Sync settings */
+    sync: SyncConfig;
+    /** Playbook settings */
+    playbooks: PlaybookConfig;
+    /** Tombstone settings */
+    tombstone: TombstoneConfig;
+    /** Identity settings */
+    identity: IdentityConfigSection;
+    /** CLI plugins settings */
+    plugins: PluginsConfig;
+}
+/**
+ * Partial configuration for merging
+ */
+export type PartialConfiguration = {
+    actor?: string;
+    database?: string;
+    sync?: Partial<SyncConfig>;
+    playbooks?: Partial<PlaybookConfig>;
+    tombstone?: Partial<TombstoneConfig>;
+    identity?: Partial<IdentityConfigSection>;
+    plugins?: Partial<PluginsConfig>;
+};
+/**
+ * Source of a configuration value
+ */
+export declare const ConfigSource: {
+    /** Built-in default value */
+    readonly DEFAULT: "default";
+    /** From config file */
+    readonly FILE: "file";
+    /** From environment variable */
+    readonly ENVIRONMENT: "environment";
+    /** From CLI flag */
+    readonly CLI: "cli";
+};
+export type ConfigSource = (typeof ConfigSource)[keyof typeof ConfigSource];
+/**
+ * Configuration value with source tracking
+ */
+export interface TrackedValue<T> {
+    /** The configuration value */
+    value: T;
+    /** Where the value came from */
+    source: ConfigSource;
+}
+/**
+ * Configuration with source tracking for each value
+ */
+export interface TrackedConfiguration {
+    actor?: TrackedValue<string>;
+    database: TrackedValue<string>;
+    sync: {
+        autoExport: TrackedValue<boolean>;
+        exportDebounce: TrackedValue<Duration>;
+        elementsFile: TrackedValue<string>;
+        dependenciesFile: TrackedValue<string>;
+    };
+    playbooks: {
+        paths: TrackedValue<string[]>;
+    };
+    tombstone: {
+        ttl: TrackedValue<Duration>;
+        minTtl: TrackedValue<Duration>;
+    };
+    identity: {
+        mode: TrackedValue<IdentityMode>;
+        timeTolerance: TrackedValue<Duration>;
+    };
+    plugins: {
+        packages: TrackedValue<string[]>;
+    };
+}
+/**
+ * YAML configuration file structure
+ * Uses snake_case to match YAML conventions
+ */
+export interface YamlConfigFile {
+    actor?: string;
+    database?: string;
+    sync?: {
+        auto_export?: boolean;
+        export_debounce?: string | number;
+        elements_file?: string;
+        dependencies_file?: string;
+    };
+    playbooks?: {
+        paths?: string[];
+    };
+    tombstone?: {
+        ttl?: string | number;
+        min_ttl?: string | number;
+    };
+    identity?: {
+        mode?: string;
+        time_tolerance?: string | number;
+    };
+    plugins?: {
+        packages?: string[];
+    };
+}
+/**
+ * Environment variable names for configuration
+ */
+export declare const EnvVars: {
+    /** Default actor name */
+    readonly ACTOR: "STONEFORGE_ACTOR";
+    /** Database file path */
+    readonly DATABASE: "STONEFORGE_DB";
+    /** Config file path override */
+    readonly CONFIG: "STONEFORGE_CONFIG";
+    /** JSON output mode */
+    readonly JSON: "STONEFORGE_JSON";
+    /** Verbose/debug mode */
+    readonly VERBOSE: "STONEFORGE_VERBOSE";
+    /** Auto-export on mutations */
+    readonly SYNC_AUTO_EXPORT: "STONEFORGE_SYNC_AUTO_EXPORT";
+    /** Identity mode */
+    readonly IDENTITY_MODE: "STONEFORGE_IDENTITY_MODE";
+};
+export type EnvVar = (typeof EnvVars)[keyof typeof EnvVars];
+/**
+ * Options for loading configuration
+ */
+export interface LoadConfigOptions {
+    /** Override config file path */
+    configPath?: string;
+    /** Skip environment variables */
+    skipEnv?: boolean;
+    /** Skip config file loading (use defaults only) */
+    skipFile?: boolean;
+    /** CLI flag overrides */
+    cliOverrides?: PartialConfiguration;
+}
+/**
+ * Result of configuration file discovery
+ */
+export interface ConfigFileDiscovery {
+    /** Path to found config file, if any */
+    path?: string;
+    /** Whether the file exists */
+    exists: boolean;
+    /** Directory containing .stoneforge */
+    stoneforgeDir?: string;
+}
+/**
+ * Result of configuration validation
+ */
+export interface ConfigValidationResult {
+    /** Whether validation passed */
+    valid: boolean;
+    /** Validation error messages */
+    errors: string[];
+    /** Warning messages (non-fatal) */
+    warnings: string[];
+}
+/**
+ * Valid configuration paths (as const array for runtime validation)
+ */
+export declare const VALID_CONFIG_PATHS: readonly ["actor", "database", "sync.autoExport", "sync.exportDebounce", "sync.elementsFile", "sync.dependenciesFile", "playbooks.paths", "tombstone.ttl", "tombstone.minTtl", "identity.mode", "identity.timeTolerance", "plugins.packages"];
+/**
+ * Dot-notation paths for configuration values
+ */
+export type ConfigPath = (typeof VALID_CONFIG_PATHS)[number];
+/**
+ * Type guard to check if a string is a valid ConfigPath
+ */
+export declare function isValidConfigPath(value: string): value is ConfigPath;
+/**
+ * Maps config paths to their value types
+ */
+export interface ConfigPathTypes {
+    actor: string | undefined;
+    database: string;
+    'sync.autoExport': boolean;
+    'sync.exportDebounce': Duration;
+    'sync.elementsFile': string;
+    'sync.dependenciesFile': string;
+    'playbooks.paths': string[];
+    'tombstone.ttl': Duration;
+    'tombstone.minTtl': Duration;
+    'identity.mode': IdentityMode;
+    'identity.timeTolerance': Duration;
+    'plugins.packages': string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/config/types.d.ts.map

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

package/dist/config/types.js

@@ -0,0 +1,72 @@
+/**
+ * Configuration System Types
+ *
+ * Defines all configuration interfaces and types for the Stoneforge system.
+ * Supports file-based configuration, environment variables, and CLI overrides
+ * with a clear precedence hierarchy.
+ */
+// ============================================================================
+// Configuration Source Tracking
+// ============================================================================
+/**
+ * Source of a configuration value
+ */
+export const ConfigSource = {
+    /** Built-in default value */
+    DEFAULT: 'default',
+    /** From config file */
+    FILE: 'file',
+    /** From environment variable */
+    ENVIRONMENT: 'environment',
+    /** From CLI flag */
+    CLI: 'cli',
+};
+// ============================================================================
+// Environment Variable Mapping
+// ============================================================================
+/**
+ * Environment variable names for configuration
+ */
+export const EnvVars = {
+    /** Default actor name */
+    ACTOR: 'STONEFORGE_ACTOR',
+    /** Database file path */
+    DATABASE: 'STONEFORGE_DB',
+    /** Config file path override */
+    CONFIG: 'STONEFORGE_CONFIG',
+    /** JSON output mode */
+    JSON: 'STONEFORGE_JSON',
+    /** Verbose/debug mode */
+    VERBOSE: 'STONEFORGE_VERBOSE',
+    /** Auto-export on mutations */
+    SYNC_AUTO_EXPORT: 'STONEFORGE_SYNC_AUTO_EXPORT',
+    /** Identity mode */
+    IDENTITY_MODE: 'STONEFORGE_IDENTITY_MODE',
+};
+// ============================================================================
+// Configuration Path Types
+// ============================================================================
+/**
+ * Valid configuration paths (as const array for runtime validation)
+ */
+export const VALID_CONFIG_PATHS = [
+    'actor',
+    'database',
+    'sync.autoExport',
+    'sync.exportDebounce',
+    'sync.elementsFile',
+    'sync.dependenciesFile',
+    'playbooks.paths',
+    'tombstone.ttl',
+    'tombstone.minTtl',
+    'identity.mode',
+    'identity.timeTolerance',
+    'plugins.packages',
+];
+/**
+ * Type guard to check if a string is a valid ConfigPath
+ */
+export function isValidConfigPath(value) {
+    return VALID_CONFIG_PATHS.includes(value);
+}
+//# sourceMappingURL=types.js.map

package/dist/config/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA2GH,+EAA+E;AAC/E,gCAAgC;AAChC,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,6BAA6B;IAC7B,OAAO,EAAE,SAAS;IAClB,uBAAuB;IACvB,IAAI,EAAE,MAAM;IACZ,gCAAgC;IAChC,WAAW,EAAE,aAAa;IAC1B,oBAAoB;IACpB,GAAG,EAAE,KAAK;CACF,CAAC;AA2EX,+EAA+E;AAC/E,+BAA+B;AAC/B,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,yBAAyB;IACzB,KAAK,EAAE,kBAAkB;IACzB,yBAAyB;IACzB,QAAQ,EAAE,eAAe;IACzB,gCAAgC;IAChC,MAAM,EAAE,mBAAmB;IAC3B,uBAAuB;IACvB,IAAI,EAAE,iBAAiB;IACvB,yBAAyB;IACzB,OAAO,EAAE,oBAAoB;IAC7B,+BAA+B;IAC/B,gBAAgB,EAAE,6BAA6B;IAC/C,oBAAoB;IACpB,aAAa,EAAE,0BAA0B;CACjC,CAAC;AA8CX,+EAA+E;AAC/E,2BAA2B;AAC3B,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,OAAO;IACP,UAAU;IACV,iBAAiB;IACjB,qBAAqB;IACrB,mBAAmB;IACnB,uBAAuB;IACvB,iBAAiB;IACjB,eAAe;IACf,kBAAkB;IAClB,eAAe;IACf,wBAAwB;IACxB,kBAAkB;CACV,CAAC;AAOX;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAQ,kBAAwC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC"}

package/dist/config/validation.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Configuration Validation
+ *
+ * Validates configuration values for correctness and consistency.
+ */
+import type { Configuration, PartialConfiguration, ConfigValidationResult } from './types.js';
+/**
+ * Validates an actor name
+ */
+export declare function isValidActor(value: unknown): value is string;
+/**
+ * Validates actor and throws if invalid
+ */
+export declare function validateActor(value: unknown): string;
+/**
+ * Validates a database filename
+ */
+export declare function isValidDatabase(value: unknown): value is string;
+/**
+ * Validates database and throws if invalid
+ */
+export declare function validateDatabase(value: unknown): string;
+/**
+ * Validates a JSONL filename
+ */
+export declare function isValidJsonlFilename(value: unknown): value is string;
+/**
+ * Validates JSONL filename and throws if invalid
+ */
+export declare function validateJsonlFilename(value: unknown, field: string): string;
+/**
+ * Validates playbook paths array
+ */
+export declare function isValidPlaybookPaths(value: unknown): value is string[];
+/**
+ * Validates playbook paths and throws if invalid
+ */
+export declare function validatePlaybookPaths(value: unknown): string[];
+/**
+ * Validates a complete configuration object
+ *
+ * @param config - Configuration to validate
+ * @returns Validated configuration
+ * @throws ValidationError if validation fails
+ */
+export declare function validateConfiguration(config: unknown): Configuration;
+/**
+ * Validates a configuration without throwing, returns result
+ */
+export declare function validateConfigurationSafe(config: unknown): ConfigValidationResult;
+/**
+ * Validates partial configuration for merging
+ */
+export declare function validatePartialConfiguration(config: PartialConfiguration): void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/config/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/config/validation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAcpB;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAM5D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAuBpD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAW/D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CA8BvD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAUpE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CA8B3E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,EAAE,CAKtE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAyB9D;AAMD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,aAAa,CAoHpE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,OAAO,GAAG,sBAAsB,CAejF;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAiD/E"}