kustodian 1.0.0

package/dist/cli/utils/defaults.js

@@ -0,0 +1,43 @@
+/**
+ * Schema-level defaults (hardcoded fallbacks).
+ * These match the current behavior for 100% backward compatibility.
+ */
+const SCHEMA_DEFAULTS = {
+    flux_namespace: 'flux-system',
+    oci_repository_name: 'kustodian-oci',
+    oci_registry_secret_name: 'kustodian-oci-registry',
+    flux_reconciliation_interval: '10m',
+    flux_reconciliation_timeout: '5m',
+};
+/**
+ * Resolves defaults for a cluster using three-tier cascading:
+ * 1. Cluster spec.defaults (highest priority)
+ * 2. Project spec.defaults
+ * 3. Schema defaults (hardcoded fallbacks)
+ *
+ * @param cluster - The cluster configuration
+ * @param project_config - Optional project configuration from kustodian.yaml
+ * @returns Resolved defaults with all values defined
+ */
+export function resolve_defaults(cluster, project_config) {
+    const project_defaults = project_config?.spec?.defaults || {};
+    const cluster_defaults = cluster.spec.defaults || {};
+    return {
+        flux_namespace: cluster_defaults.flux_namespace ||
+            project_defaults.flux_namespace ||
+            SCHEMA_DEFAULTS.flux_namespace,
+        oci_repository_name: cluster_defaults.oci_repository_name ||
+            project_defaults.oci_repository_name ||
+            SCHEMA_DEFAULTS.oci_repository_name,
+        oci_registry_secret_name: cluster_defaults.oci_registry_secret_name ||
+            project_defaults.oci_registry_secret_name ||
+            SCHEMA_DEFAULTS.oci_registry_secret_name,
+        flux_reconciliation_interval: cluster_defaults.flux_reconciliation_interval ||
+            project_defaults.flux_reconciliation_interval ||
+            SCHEMA_DEFAULTS.flux_reconciliation_interval,
+        flux_reconciliation_timeout: cluster_defaults.flux_reconciliation_timeout ||
+            project_defaults.flux_reconciliation_timeout ||
+            SCHEMA_DEFAULTS.flux_reconciliation_timeout,
+    };
+}
+//# sourceMappingURL=defaults.js.map

package/dist/cli/utils/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../../src/cli/utils/defaults.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,eAAe,GAAG;IACtB,cAAc,EAAE,aAAa;IAC7B,mBAAmB,EAAE,eAAe;IACpC,wBAAwB,EAAE,wBAAwB;IAClD,4BAA4B,EAAE,KAAK;IACnC,2BAA2B,EAAE,IAAI;CACzB,CAAC;AAaX;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAoB,EACpB,cAAkC;IAElC,MAAM,gBAAgB,GAAG,cAAc,EAAE,IAAI,EAAE,QAAQ,IAAI,EAAE,CAAC;IAC9D,MAAM,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;IAErD,OAAO;QACL,cAAc,EACZ,gBAAgB,CAAC,cAAc;YAC/B,gBAAgB,CAAC,cAAc;YAC/B,eAAe,CAAC,cAAc;QAEhC,mBAAmB,EACjB,gBAAgB,CAAC,mBAAmB;YACpC,gBAAgB,CAAC,mBAAmB;YACpC,eAAe,CAAC,mBAAmB;QAErC,wBAAwB,EACtB,gBAAgB,CAAC,wBAAwB;YACzC,gBAAgB,CAAC,wBAAwB;YACzC,eAAe,CAAC,wBAAwB;QAE1C,4BAA4B,EAC1B,gBAAgB,CAAC,4BAA4B;YAC7C,gBAAgB,CAAC,4BAA4B;YAC7C,eAAe,CAAC,4BAA4B;QAE9C,2BAA2B,EACzB,gBAAgB,CAAC,2BAA2B;YAC5C,gBAAgB,CAAC,2BAA2B;YAC5C,eAAe,CAAC,2BAA2B;KAC9C,CAAC;AACJ,CAAC"}

package/dist/core/error.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Base error type for all Kustodian errors.
+ */
+export interface KustodianErrorType {
+    readonly code: string;
+    readonly message: string;
+    readonly cause?: unknown;
+}
+/**
+ * Creates a Kustodian error.
+ */
+export declare function create_error(code: string, message: string, cause?: unknown): KustodianErrorType;
+/**
+ * Error codes for common operations.
+ */
+export declare const ErrorCodes: {
+    readonly UNKNOWN: "UNKNOWN";
+    readonly INVALID_ARGUMENT: "INVALID_ARGUMENT";
+    readonly NOT_FOUND: "NOT_FOUND";
+    readonly ALREADY_EXISTS: "ALREADY_EXISTS";
+    readonly FILE_NOT_FOUND: "FILE_NOT_FOUND";
+    readonly FILE_READ_ERROR: "FILE_READ_ERROR";
+    readonly FILE_WRITE_ERROR: "FILE_WRITE_ERROR";
+    readonly DIRECTORY_NOT_FOUND: "DIRECTORY_NOT_FOUND";
+    readonly PARSE_ERROR: "PARSE_ERROR";
+    readonly YAML_PARSE_ERROR: "YAML_PARSE_ERROR";
+    readonly JSON_PARSE_ERROR: "JSON_PARSE_ERROR";
+    readonly VALIDATION_ERROR: "VALIDATION_ERROR";
+    readonly SCHEMA_VALIDATION_ERROR: "SCHEMA_VALIDATION_ERROR";
+    readonly CONFIG_NOT_FOUND: "CONFIG_NOT_FOUND";
+    readonly CONFIG_INVALID: "CONFIG_INVALID";
+    readonly TEMPLATE_NOT_FOUND: "TEMPLATE_NOT_FOUND";
+    readonly CLUSTER_NOT_FOUND: "CLUSTER_NOT_FOUND";
+    readonly PROFILE_NOT_FOUND: "PROFILE_NOT_FOUND";
+    readonly NETWORK_ERROR: "NETWORK_ERROR";
+    readonly CONNECTION_REFUSED: "CONNECTION_REFUSED";
+    readonly TIMEOUT: "TIMEOUT";
+    readonly SSH_CONNECTION_ERROR: "SSH_CONNECTION_ERROR";
+    readonly SSH_AUTH_ERROR: "SSH_AUTH_ERROR";
+    readonly SSH_COMMAND_ERROR: "SSH_COMMAND_ERROR";
+    readonly K8S_CONNECTION_ERROR: "K8S_CONNECTION_ERROR";
+    readonly K8S_API_ERROR: "K8S_API_ERROR";
+    readonly NODE_NOT_READY: "NODE_NOT_READY";
+    readonly BOOTSTRAP_ERROR: "BOOTSTRAP_ERROR";
+    readonly BOOTSTRAP_STATE_ERROR: "BOOTSTRAP_STATE_ERROR";
+    readonly CLUSTER_PROVIDER_ERROR: "CLUSTER_PROVIDER_ERROR";
+    readonly PLUGIN_NOT_FOUND: "PLUGIN_NOT_FOUND";
+    readonly PLUGIN_LOAD_ERROR: "PLUGIN_LOAD_ERROR";
+    readonly PLUGIN_EXECUTION_ERROR: "PLUGIN_EXECUTION_ERROR";
+    readonly DEPENDENCY_CYCLE: "DEPENDENCY_CYCLE";
+    readonly DEPENDENCY_MISSING: "DEPENDENCY_MISSING";
+    readonly DEPENDENCY_SELF_REFERENCE: "DEPENDENCY_SELF_REFERENCE";
+    readonly DEPENDENCY_VALIDATION_ERROR: "DEPENDENCY_VALIDATION_ERROR";
+    readonly SECRET_CLI_NOT_FOUND: "SECRET_CLI_NOT_FOUND";
+    readonly SECRET_NOT_FOUND: "SECRET_NOT_FOUND";
+    readonly SECRET_AUTH_ERROR: "SECRET_AUTH_ERROR";
+    readonly SECRET_TIMEOUT: "SECRET_TIMEOUT";
+    readonly SOURCE_FETCH_ERROR: "SOURCE_FETCH_ERROR";
+    readonly SOURCE_AUTH_ERROR: "SOURCE_AUTH_ERROR";
+    readonly SOURCE_TIMEOUT: "SOURCE_TIMEOUT";
+    readonly SOURCE_CHECKSUM_MISMATCH: "SOURCE_CHECKSUM_MISMATCH";
+    readonly SOURCE_VERSION_NOT_FOUND: "SOURCE_VERSION_NOT_FOUND";
+    readonly CACHE_READ_ERROR: "CACHE_READ_ERROR";
+    readonly CACHE_WRITE_ERROR: "CACHE_WRITE_ERROR";
+    readonly CACHE_CORRUPT: "CACHE_CORRUPT";
+};
+export type ErrorCodeType = (typeof ErrorCodes)[keyof typeof ErrorCodes];
+/**
+ * Error factory functions for common error types.
+ */
+export declare const Errors: {
+    readonly unknown: (message: string, cause?: unknown) => KustodianErrorType;
+    readonly invalid_argument: (argument: string, reason: string) => KustodianErrorType;
+    readonly not_found: (resource: string, identifier: string) => KustodianErrorType;
+    readonly already_exists: (resource: string, identifier: string) => KustodianErrorType;
+    readonly file_not_found: (path: string) => KustodianErrorType;
+    readonly file_read_error: (path: string, cause?: unknown) => KustodianErrorType;
+    readonly file_write_error: (path: string, cause?: unknown) => KustodianErrorType;
+    readonly parse_error: (format: string, message: string, cause?: unknown) => KustodianErrorType;
+    readonly yaml_parse_error: (message: string, cause?: unknown) => KustodianErrorType;
+    readonly validation_error: (message: string, cause?: unknown) => KustodianErrorType;
+    readonly schema_validation_error: (errors: string[]) => KustodianErrorType;
+    readonly config_not_found: (config_type: string, path: string) => KustodianErrorType;
+    readonly template_not_found: (name: string) => KustodianErrorType;
+    readonly cluster_not_found: (name: string) => KustodianErrorType;
+    readonly profile_not_found: (name: string) => KustodianErrorType;
+    readonly ssh_connection_error: (host: string, cause?: unknown) => KustodianErrorType;
+    readonly ssh_auth_error: (host: string, cause?: unknown) => KustodianErrorType;
+    readonly bootstrap_error: (message: string, cause?: unknown) => KustodianErrorType;
+    readonly plugin_not_found: (name: string) => KustodianErrorType;
+    readonly plugin_load_error: (name: string, cause?: unknown) => KustodianErrorType;
+    readonly dependency_cycle: (cycle: string[]) => KustodianErrorType;
+    readonly dependency_missing: (source: string, target: string) => KustodianErrorType;
+    readonly dependency_self_reference: (node: string) => KustodianErrorType;
+    readonly dependency_validation_error: (errors: string[]) => KustodianErrorType;
+    readonly secret_cli_not_found: (provider: string, cli_name: string) => KustodianErrorType;
+    readonly secret_not_found: (provider: string, ref: string) => KustodianErrorType;
+    readonly secret_auth_error: (provider: string, cause?: unknown) => KustodianErrorType;
+    readonly secret_timeout: (provider: string, timeout: number) => KustodianErrorType;
+    readonly source_fetch_error: (source: string, cause?: unknown) => KustodianErrorType;
+    readonly source_auth_error: (source: string, cause?: unknown) => KustodianErrorType;
+    readonly source_timeout: (source: string, timeout: number) => KustodianErrorType;
+    readonly source_checksum_mismatch: (source: string, expected: string, actual: string) => KustodianErrorType;
+    readonly source_version_not_found: (source: string, version: string) => KustodianErrorType;
+    readonly cache_read_error: (path: string, cause?: unknown) => KustodianErrorType;
+    readonly cache_write_error: (path: string, cause?: unknown) => KustodianErrorType;
+    readonly cache_corrupt: (path: string) => KustodianErrorType;
+};
+/**
+ * Formats a KustodianError for display.
+ */
+export declare function format_error(error: KustodianErrorType): string;
+/**
+ * Type guard to check if an error is a KustodianError.
+ */
+export declare function is_kustodian_error(error: unknown): error is KustodianErrorType;
+//# sourceMappingURL=error.d.ts.map

package/dist/core/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/core/error.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,kBAAkB,CAE/F;AAED;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6Eb,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAEzE;;GAEG;AACH,eAAO,MAAM,MAAM;gCACA,MAAM,UAAU,OAAO,KAAG,kBAAkB;0CAIlC,MAAM,UAAU,MAAM,KAAG,kBAAkB;mCAIlD,MAAM,cAAc,MAAM,KAAG,kBAAkB;wCAI1C,MAAM,cAAc,MAAM,KAAG,kBAAkB;oCAInD,MAAM,KAAG,kBAAkB;qCAI1B,MAAM,UAAU,OAAO,KAAG,kBAAkB;sCAI3C,MAAM,UAAU,OAAO,KAAG,kBAAkB;mCAI/C,MAAM,WAAW,MAAM,UAAU,OAAO,KAAG,kBAAkB;yCAIvD,MAAM,UAAU,OAAO,KAAG,kBAAkB;yCAI5C,MAAM,UAAU,OAAO,KAAG,kBAAkB;+CAItC,MAAM,EAAE,KAAG,kBAAkB;6CAO/B,MAAM,QAAQ,MAAM,KAAG,kBAAkB;wCAO9C,MAAM,KAAG,kBAAkB;uCAI5B,MAAM,KAAG,kBAAkB;uCAI3B,MAAM,KAAG,kBAAkB;0CAIxB,MAAM,UAAU,OAAO,KAAG,kBAAkB;oCAQlD,MAAM,UAAU,OAAO,KAAG,kBAAkB;wCAIxC,MAAM,UAAU,OAAO,KAAG,kBAAkB;sCAI9C,MAAM,KAAG,kBAAkB;uCAI1B,MAAM,UAAU,OAAO,KAAG,kBAAkB;uCAI5C,MAAM,EAAE,KAAG,kBAAkB;0CAK1B,MAAM,UAAU,MAAM,KAAG,kBAAkB;+CAOtC,MAAM,KAAG,kBAAkB;mDAOvB,MAAM,EAAE,KAAG,kBAAkB;8CAOlC,MAAM,YAAY,MAAM,KAAG,kBAAkB;0CAOjD,MAAM,OAAO,MAAM,KAAG,kBAAkB;2CAIvC,MAAM,UAAU,OAAO,KAAG,kBAAkB;wCAQ/C,MAAM,WAAW,MAAM,KAAG,kBAAkB;0CAO1C,MAAM,UAAU,OAAO,KAAG,kBAAkB;yCAQ7C,MAAM,UAAU,OAAO,KAAG,kBAAkB;sCAQ/C,MAAM,WAAW,MAAM,KAAG,kBAAkB;gDAOlC,MAAM,YAAY,MAAM,UAAU,MAAM,KAAG,kBAAkB;gDAO7D,MAAM,WAAW,MAAM,KAAG,kBAAkB;sCAOtD,MAAM,UAAU,OAAO,KAAG,kBAAkB;uCAI3C,MAAM,UAAU,OAAO,KAAG,kBAAkB;mCAIhD,MAAM,KAAG,kBAAkB;CAGvC,CAAC;AAEX;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAM9D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAS9E"}

package/dist/core/error.js

@@ -0,0 +1,210 @@
+/**
+ * Creates a Kustodian error.
+ */
+export function create_error(code, message, cause) {
+    return { code, message, cause };
+}
+/**
+ * Error codes for common operations.
+ */
+export const ErrorCodes = {
+    // General errors
+    UNKNOWN: 'UNKNOWN',
+    INVALID_ARGUMENT: 'INVALID_ARGUMENT',
+    NOT_FOUND: 'NOT_FOUND',
+    ALREADY_EXISTS: 'ALREADY_EXISTS',
+    // IO errors
+    FILE_NOT_FOUND: 'FILE_NOT_FOUND',
+    FILE_READ_ERROR: 'FILE_READ_ERROR',
+    FILE_WRITE_ERROR: 'FILE_WRITE_ERROR',
+    DIRECTORY_NOT_FOUND: 'DIRECTORY_NOT_FOUND',
+    // Parsing errors
+    PARSE_ERROR: 'PARSE_ERROR',
+    YAML_PARSE_ERROR: 'YAML_PARSE_ERROR',
+    JSON_PARSE_ERROR: 'JSON_PARSE_ERROR',
+    // Validation errors
+    VALIDATION_ERROR: 'VALIDATION_ERROR',
+    SCHEMA_VALIDATION_ERROR: 'SCHEMA_VALIDATION_ERROR',
+    // Configuration errors
+    CONFIG_NOT_FOUND: 'CONFIG_NOT_FOUND',
+    CONFIG_INVALID: 'CONFIG_INVALID',
+    TEMPLATE_NOT_FOUND: 'TEMPLATE_NOT_FOUND',
+    CLUSTER_NOT_FOUND: 'CLUSTER_NOT_FOUND',
+    PROFILE_NOT_FOUND: 'PROFILE_NOT_FOUND',
+    // Network errors
+    NETWORK_ERROR: 'NETWORK_ERROR',
+    CONNECTION_REFUSED: 'CONNECTION_REFUSED',
+    TIMEOUT: 'TIMEOUT',
+    // SSH errors
+    SSH_CONNECTION_ERROR: 'SSH_CONNECTION_ERROR',
+    SSH_AUTH_ERROR: 'SSH_AUTH_ERROR',
+    SSH_COMMAND_ERROR: 'SSH_COMMAND_ERROR',
+    // Kubernetes errors
+    K8S_CONNECTION_ERROR: 'K8S_CONNECTION_ERROR',
+    K8S_API_ERROR: 'K8S_API_ERROR',
+    NODE_NOT_READY: 'NODE_NOT_READY',
+    // Bootstrap errors
+    BOOTSTRAP_ERROR: 'BOOTSTRAP_ERROR',
+    BOOTSTRAP_STATE_ERROR: 'BOOTSTRAP_STATE_ERROR',
+    CLUSTER_PROVIDER_ERROR: 'CLUSTER_PROVIDER_ERROR',
+    // Plugin errors
+    PLUGIN_NOT_FOUND: 'PLUGIN_NOT_FOUND',
+    PLUGIN_LOAD_ERROR: 'PLUGIN_LOAD_ERROR',
+    PLUGIN_EXECUTION_ERROR: 'PLUGIN_EXECUTION_ERROR',
+    // Dependency graph errors
+    DEPENDENCY_CYCLE: 'DEPENDENCY_CYCLE',
+    DEPENDENCY_MISSING: 'DEPENDENCY_MISSING',
+    DEPENDENCY_SELF_REFERENCE: 'DEPENDENCY_SELF_REFERENCE',
+    DEPENDENCY_VALIDATION_ERROR: 'DEPENDENCY_VALIDATION_ERROR',
+    // Secret provider errors
+    SECRET_CLI_NOT_FOUND: 'SECRET_CLI_NOT_FOUND',
+    SECRET_NOT_FOUND: 'SECRET_NOT_FOUND',
+    SECRET_AUTH_ERROR: 'SECRET_AUTH_ERROR',
+    SECRET_TIMEOUT: 'SECRET_TIMEOUT',
+    // Source fetching errors
+    SOURCE_FETCH_ERROR: 'SOURCE_FETCH_ERROR',
+    SOURCE_AUTH_ERROR: 'SOURCE_AUTH_ERROR',
+    SOURCE_TIMEOUT: 'SOURCE_TIMEOUT',
+    SOURCE_CHECKSUM_MISMATCH: 'SOURCE_CHECKSUM_MISMATCH',
+    SOURCE_VERSION_NOT_FOUND: 'SOURCE_VERSION_NOT_FOUND',
+    // Cache errors
+    CACHE_READ_ERROR: 'CACHE_READ_ERROR',
+    CACHE_WRITE_ERROR: 'CACHE_WRITE_ERROR',
+    CACHE_CORRUPT: 'CACHE_CORRUPT',
+};
+/**
+ * Error factory functions for common error types.
+ */
+export const Errors = {
+    unknown(message, cause) {
+        return create_error(ErrorCodes.UNKNOWN, message, cause);
+    },
+    invalid_argument(argument, reason) {
+        return create_error(ErrorCodes.INVALID_ARGUMENT, `Invalid argument '${argument}': ${reason}`);
+    },
+    not_found(resource, identifier) {
+        return create_error(ErrorCodes.NOT_FOUND, `${resource} '${identifier}' not found`);
+    },
+    already_exists(resource, identifier) {
+        return create_error(ErrorCodes.ALREADY_EXISTS, `${resource} '${identifier}' already exists`);
+    },
+    file_not_found(path) {
+        return create_error(ErrorCodes.FILE_NOT_FOUND, `File not found: ${path}`);
+    },
+    file_read_error(path, cause) {
+        return create_error(ErrorCodes.FILE_READ_ERROR, `Failed to read file: ${path}`, cause);
+    },
+    file_write_error(path, cause) {
+        return create_error(ErrorCodes.FILE_WRITE_ERROR, `Failed to write file: ${path}`, cause);
+    },
+    parse_error(format, message, cause) {
+        return create_error(ErrorCodes.PARSE_ERROR, `Failed to parse ${format}: ${message}`, cause);
+    },
+    yaml_parse_error(message, cause) {
+        return create_error(ErrorCodes.YAML_PARSE_ERROR, `YAML parse error: ${message}`, cause);
+    },
+    validation_error(message, cause) {
+        return create_error(ErrorCodes.VALIDATION_ERROR, message, cause);
+    },
+    schema_validation_error(errors) {
+        return create_error(ErrorCodes.SCHEMA_VALIDATION_ERROR, `Schema validation failed:\n${errors.map((e) => `  - ${e}`).join('\n')}`);
+    },
+    config_not_found(config_type, path) {
+        return create_error(ErrorCodes.CONFIG_NOT_FOUND, `${config_type} configuration not found at: ${path}`);
+    },
+    template_not_found(name) {
+        return create_error(ErrorCodes.TEMPLATE_NOT_FOUND, `Template '${name}' not found`);
+    },
+    cluster_not_found(name) {
+        return create_error(ErrorCodes.CLUSTER_NOT_FOUND, `Cluster '${name}' not found`);
+    },
+    profile_not_found(name) {
+        return create_error(ErrorCodes.PROFILE_NOT_FOUND, `Node profile '${name}' not found`);
+    },
+    ssh_connection_error(host, cause) {
+        return create_error(ErrorCodes.SSH_CONNECTION_ERROR, `Failed to connect to ${host} via SSH`, cause);
+    },
+    ssh_auth_error(host, cause) {
+        return create_error(ErrorCodes.SSH_AUTH_ERROR, `SSH authentication failed for ${host}`, cause);
+    },
+    bootstrap_error(message, cause) {
+        return create_error(ErrorCodes.BOOTSTRAP_ERROR, `Bootstrap failed: ${message}`, cause);
+    },
+    plugin_not_found(name) {
+        return create_error(ErrorCodes.PLUGIN_NOT_FOUND, `Plugin '${name}' not found`);
+    },
+    plugin_load_error(name, cause) {
+        return create_error(ErrorCodes.PLUGIN_LOAD_ERROR, `Failed to load plugin '${name}'`, cause);
+    },
+    dependency_cycle(cycle) {
+        const cycle_str = cycle.join(' → ');
+        return create_error(ErrorCodes.DEPENDENCY_CYCLE, `Dependency cycle detected: ${cycle_str}`);
+    },
+    dependency_missing(source, target) {
+        return create_error(ErrorCodes.DEPENDENCY_MISSING, `Kustomization '${source}' depends on '${target}' which does not exist`);
+    },
+    dependency_self_reference(node) {
+        return create_error(ErrorCodes.DEPENDENCY_SELF_REFERENCE, `Kustomization '${node}' cannot depend on itself`);
+    },
+    dependency_validation_error(errors) {
+        return create_error(ErrorCodes.DEPENDENCY_VALIDATION_ERROR, `Dependency validation failed:\n${errors.map((e) => `  - ${e}`).join('\n')}`);
+    },
+    secret_cli_not_found(provider, cli_name) {
+        return create_error(ErrorCodes.SECRET_CLI_NOT_FOUND, `${provider} CLI (${cli_name}) not found. Please install it first.`);
+    },
+    secret_not_found(provider, ref) {
+        return create_error(ErrorCodes.SECRET_NOT_FOUND, `Secret not found in ${provider}: ${ref}`);
+    },
+    secret_auth_error(provider, cause) {
+        return create_error(ErrorCodes.SECRET_AUTH_ERROR, `${provider} authentication failed. Check your credentials.`, cause);
+    },
+    secret_timeout(provider, timeout) {
+        return create_error(ErrorCodes.SECRET_TIMEOUT, `${provider} operation timed out after ${timeout}ms`);
+    },
+    source_fetch_error(source, cause) {
+        return create_error(ErrorCodes.SOURCE_FETCH_ERROR, `Failed to fetch template source '${source}'`, cause);
+    },
+    source_auth_error(source, cause) {
+        return create_error(ErrorCodes.SOURCE_AUTH_ERROR, `Authentication failed for source '${source}'`, cause);
+    },
+    source_timeout(source, timeout) {
+        return create_error(ErrorCodes.SOURCE_TIMEOUT, `Source '${source}' operation timed out after ${timeout}ms`);
+    },
+    source_checksum_mismatch(source, expected, actual) {
+        return create_error(ErrorCodes.SOURCE_CHECKSUM_MISMATCH, `Checksum mismatch for '${source}': expected ${expected}, got ${actual}`);
+    },
+    source_version_not_found(source, version) {
+        return create_error(ErrorCodes.SOURCE_VERSION_NOT_FOUND, `Version '${version}' not found for source '${source}'`);
+    },
+    cache_read_error(path, cause) {
+        return create_error(ErrorCodes.CACHE_READ_ERROR, `Failed to read cache at: ${path}`, cause);
+    },
+    cache_write_error(path, cause) {
+        return create_error(ErrorCodes.CACHE_WRITE_ERROR, `Failed to write cache at: ${path}`, cause);
+    },
+    cache_corrupt(path) {
+        return create_error(ErrorCodes.CACHE_CORRUPT, `Cache is corrupt at: ${path}`);
+    },
+};
+/**
+ * Formats a KustodianError for display.
+ */
+export function format_error(error) {
+    let message = `[${error.code}] ${error.message}`;
+    if (error.cause) {
+        message += `\nCaused by: ${String(error.cause)}`;
+    }
+    return message;
+}
+/**
+ * Type guard to check if an error is a KustodianError.
+ */
+export function is_kustodian_error(error) {
+    return (typeof error === 'object' &&
+        error !== null &&
+        'code' in error &&
+        'message' in error &&
+        typeof error.code === 'string' &&
+        typeof error.message === 'string');
+}
+//# sourceMappingURL=error.js.map

package/dist/core/error.js.map

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

package/dist/core/index.d.ts

@@ -0,0 +1,6 @@
+export * from './error.js';
+export * from './logger.js';
+export * from './path.js';
+export * from './result.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,6 @@
+export * from './error.js';
+export * from './logger.js';
+export * from './path.js';
+export * from './result.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/core/logger.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Log levels supported by the logger.
+ */
+export type LogLevelType = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * Logger interface used throughout Kustodian.
+ */
+export interface LoggerType {
+    debug(message: string, context?: Record<string, unknown>): void;
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>): void;
+    child(context: Record<string, unknown>): LoggerType;
+}
+/**
+ * Console logger implementation.
+ */
+export interface ConsoleLoggerOptionsType {
+    level?: LogLevelType;
+    context?: Record<string, unknown>;
+    timestamp?: boolean;
+}
+/**
+ * Creates a console logger.
+ */
+export declare function create_console_logger(options?: ConsoleLoggerOptionsType): LoggerType;
+/**
+ * Creates a silent logger that discards all messages.
+ */
+export declare function create_silent_logger(): LoggerType;
+//# sourceMappingURL=logger.d.ts.map

package/dist/core/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAY/D;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAChE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAChE,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAiBD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,wBAA6B,GAAG,UAAU,CAgDxF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,UAAU,CASjD"}

package/dist/core/logger.js

@@ -0,0 +1,78 @@
+/**
+ * Log level priority for filtering.
+ */
+const LOG_LEVEL_PRIORITY = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+function format_timestamp() {
+    return new Date().toISOString();
+}
+function format_context(context) {
+    if (!context || Object.keys(context).length === 0) {
+        return '';
+    }
+    return ` ${JSON.stringify(context)}`;
+}
+function should_log(current_level, message_level) {
+    return LOG_LEVEL_PRIORITY[message_level] >= LOG_LEVEL_PRIORITY[current_level];
+}
+/**
+ * Creates a console logger.
+ */
+export function create_console_logger(options = {}) {
+    const level = options.level ?? 'info';
+    const base_context = options.context ?? {};
+    const show_timestamp = options.timestamp ?? true;
+    function log(message_level, message, context) {
+        if (!should_log(level, message_level)) {
+            return;
+        }
+        const merged_context = { ...base_context, ...context };
+        const timestamp = show_timestamp ? `[${format_timestamp()}] ` : '';
+        const level_tag = `[${message_level.toUpperCase()}]`;
+        const context_str = format_context(merged_context);
+        const formatted = `${timestamp}${level_tag} ${message}${context_str}`;
+        switch (message_level) {
+            case 'debug':
+                console.debug(formatted);
+                break;
+            case 'info':
+                console.info(formatted);
+                break;
+            case 'warn':
+                console.warn(formatted);
+                break;
+            case 'error':
+                console.error(formatted);
+                break;
+        }
+    }
+    return {
+        debug: (message, context) => log('debug', message, context),
+        info: (message, context) => log('info', message, context),
+        warn: (message, context) => log('warn', message, context),
+        error: (message, context) => log('error', message, context),
+        child: (context) => create_console_logger({
+            level,
+            context: { ...base_context, ...context },
+            timestamp: show_timestamp,
+        }),
+    };
+}
+/**
+ * Creates a silent logger that discards all messages.
+ */
+export function create_silent_logger() {
+    const noop = () => { };
+    return {
+        debug: noop,
+        info: noop,
+        warn: noop,
+        error: noop,
+        child: () => create_silent_logger(),
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/core/logger.js.map

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

package/dist/core/path.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Normalizes a path, removing any leading "./" and trailing slashes.
+ */
+export declare function normalize_path(path: string): string;
+/**
+ * Joins path segments and normalizes the result.
+ */
+export declare function join_paths(...segments: string[]): string;
+/**
+ * Resolves a path relative to a base path.
+ */
+export declare function resolve_path(base: string, path: string): string;
+/**
+ * Gets the relative path from one path to another.
+ */
+export declare function relative_path(from: string, to: string): string;
+/**
+ * Gets the directory name from a path.
+ */
+export declare function get_dirname(path: string): string;
+/**
+ * Gets the file name from a path.
+ */
+export declare function get_basename(path: string, ext?: string): string;
+/**
+ * Gets the file extension from a path.
+ */
+export declare function get_extension(path: string): string;
+/**
+ * Checks if a path is absolute.
+ */
+export declare function is_absolute_path(path: string): boolean;
+/**
+ * Ensures a path starts with "./" for relative paths.
+ */
+export declare function ensure_relative(path: string): string;
+/**
+ * Removes the extension from a file path.
+ */
+export declare function remove_extension(path: string): string;
+/**
+ * Changes the extension of a file path.
+ */
+export declare function change_extension(path: string, new_ext: string): string;
+/**
+ * Checks if a path matches any of the given patterns (simple glob support).
+ */
+export declare function matches_pattern(path: string, patterns: string[]): boolean;
+/**
+ * Splits a path into its segments.
+ */
+export declare function split_path(path: string): string[];
+/**
+ * Gets the common prefix of multiple paths.
+ */
+export declare function common_path_prefix(paths: string[]): string;
+//# sourceMappingURL=path.d.ts.map

package/dist/core/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/core/path.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASnD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQpD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMrD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAItE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAuBzE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAEjD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CA+B1D"}