@a1st/aix-core 0.0.3

package/dist/editors/strategies/zed/prompts.js

@@ -0,0 +1,25 @@
+/**
+ * Zed prompts strategy. Zed uses a Rules Library UI, not file-based prompts.
+ * Prompts are not supported in Zed at this time.
+ */
+export class ZedPromptsStrategy {
+    isSupported() {
+        return false;
+    }
+    getPromptsDir() {
+        return '';
+    }
+    getFileExtension() {
+        return '';
+    }
+    getGlobalPromptsPath() {
+        return null;
+    }
+    formatPrompt(_prompt) {
+        return '';
+    }
+    async parseGlobalPrompts(_files, _readFile) {
+        return { prompts: {}, warnings: [] };
+    }
+}
+//# sourceMappingURL=prompts.js.map

package/dist/editors/strategies/zed/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../../../src/editors/strategies/zed/prompts.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IAC5B,WAAW;QACR,OAAO,KAAK,CAAC;IAChB,CAAC;IAED,aAAa;QACV,OAAO,EAAE,CAAC;IACb,CAAC;IAED,gBAAgB;QACb,OAAO,EAAE,CAAC;IACb,CAAC;IAED,oBAAoB;QACjB,OAAO,IAAI,CAAC;IACf,CAAC;IAED,YAAY,CAAC,OAAqB;QAC/B,OAAO,EAAE,CAAC;IACb,CAAC;IAED,KAAK,CAAC,kBAAkB,CACrB,MAAgB,EAChB,SAAgD;QAEhD,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IACxC,CAAC;CACH"}

package/dist/editors/strategies/zed/rules.d.ts

@@ -0,0 +1,17 @@
+import type { RulesStrategy } from '../types.js';
+import type { EditorRule } from '../../types.js';
+/**
+ * Zed rules strategy. Uses a single `.rules` file at project root (plain markdown, no frontmatter).
+ * Zed reads `.rules` files at the top level of worktrees.
+ */
+export declare class ZedRulesStrategy implements RulesStrategy {
+    getRulesDir(): string;
+    getFileExtension(): string;
+    getGlobalRulesPath(): string | null;
+    parseGlobalRules(_content: string): {
+        rules: string[];
+        warnings: string[];
+    };
+    formatRule(rule: EditorRule): string;
+}
+//# sourceMappingURL=rules.d.ts.map

package/dist/editors/strategies/zed/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../../../src/editors/strategies/zed/rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,aAAa;IACnD,WAAW,IAAI,MAAM;IAKrB,gBAAgB,IAAI,MAAM;IAK1B,kBAAkB,IAAI,MAAM,GAAG,IAAI;IAKnC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE;IAI3E,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM;CActC"}

package/dist/editors/strategies/zed/rules.js

@@ -0,0 +1,33 @@
+/**
+ * Zed rules strategy. Uses a single `.rules` file at project root (plain markdown, no frontmatter).
+ * Zed reads `.rules` files at the top level of worktrees.
+ */
+export class ZedRulesStrategy {
+    getRulesDir() {
+        // Zed uses .rules at project root, not in .zed/
+        return '..';
+    }
+    getFileExtension() {
+        // Zed uses .rules extension (no .md)
+        return '';
+    }
+    getGlobalRulesPath() {
+        // Zed doesn't have global rules file
+        return null;
+    }
+    parseGlobalRules(_content) {
+        return { rules: [], warnings: [] };
+    }
+    formatRule(rule) {
+        const lines = [];
+        // Zed uses plain markdown without frontmatter
+        // Include rule name as heading for context, but only if content doesn't already start with one
+        const contentStartsWithHeading = /^#\s/.test(rule.content.trim());
+        if (rule.name && !contentStartsWithHeading) {
+            lines.push(`# ${rule.name}`, '');
+        }
+        lines.push(rule.content);
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=rules.js.map

package/dist/editors/strategies/zed/rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.js","sourceRoot":"","sources":["../../../../src/editors/strategies/zed/rules.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IAC1B,WAAW;QACR,gDAAgD;QAChD,OAAO,IAAI,CAAC;IACf,CAAC;IAED,gBAAgB;QACb,qCAAqC;QACrC,OAAO,EAAE,CAAC;IACb,CAAC;IAED,kBAAkB;QACf,qCAAqC;QACrC,OAAO,IAAI,CAAC;IACf,CAAC;IAED,gBAAgB,CAAC,QAAgB;QAC9B,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IACtC,CAAC;IAED,UAAU,CAAC,IAAgB;QACxB,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,8CAA8C;QAC9C,+FAA+F;QAC/F,MAAM,wBAAwB,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAElE,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,wBAAwB,EAAE,CAAC;YAC1C,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACpC,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;CACH"}

package/dist/editors/types.d.ts

@@ -0,0 +1,164 @@
+import type { AiJsonConfig, McpServerConfig, HooksConfig } from '@a1st/aix-schema';
+import type { ConfigScope } from '../merge.js';
+/**
+ * Describes features in ai.json that won't be applied to an editor because the editor doesn't
+ * support them.
+ */
+export interface UnsupportedFeatures {
+    /** MCP servers that won't be configured (editor doesn't support MCP) */
+    mcp?: {
+        reason: string;
+        servers: string[];
+    };
+    /** Hooks that won't be configured */
+    hooks?: {
+        reason: string;
+        /** If editor supports hooks but not all events, lists unsupported events */
+        unsupportedEvents?: string[];
+        /** If editor doesn't support hooks at all, true */
+        allUnsupported?: boolean;
+    };
+    /** Prompts that won't be configured (editor doesn't support prompts) */
+    prompts?: {
+        reason: string;
+        prompts: string[];
+    };
+}
+export type EditorName = 'windsurf' | 'cursor' | 'claude-code' | 'vscode' | 'zed' | 'codex';
+/**
+ * Editor-specific rule format after translation from ai.json rules.
+ */
+export interface EditorRule {
+    name?: string;
+    content: string;
+    activation: {
+        type: 'always' | 'auto' | 'glob' | 'manual';
+        description?: string;
+        globs?: string[];
+    };
+    /** Source path for deriving filename (e.g., git URL with path, local file path) */
+    sourcePath?: string;
+}
+/**
+ * Editor-specific prompt/command format after translation from ai.json prompts.
+ */
+export interface EditorPrompt {
+    name: string;
+    content: string;
+    description?: string;
+    argumentHint?: string;
+    /** Source path for deriving filename (e.g., git URL with path, local file path) */
+    sourcePath?: string;
+}
+/**
+ * Generated configuration for an editor, ready to be written to disk.
+ */
+export interface EditorConfig {
+    rules: EditorRule[];
+    prompts: EditorPrompt[];
+    mcp: Record<string, McpServerConfig>;
+    hooks?: HooksConfig;
+}
+/**
+ * Options for applying editor configuration.
+ */
+export interface ApplyOptions {
+    dryRun?: boolean;
+    scopes?: ConfigScope[];
+    /**
+     * If true, overwrite existing JSON config files entirely instead of merging. Default is false,
+     * which means JSON files in editor config folders are recursively merged with existing content.
+     * Markdown files are always overwritten regardless of this setting.
+     */
+    overwrite?: boolean;
+    /**
+     * If true, skip all global configuration changes (for editors with global-only features).
+     * Useful in CI environments or when user doesn't want to modify global config.
+     */
+    skipGlobal?: boolean;
+    /**
+     * If true, automatically confirm global changes without prompting.
+     * Used for testing or non-interactive environments.
+     */
+    autoConfirmGlobal?: boolean;
+    /**
+     * If true, remove the .aix folder before installing to ensure a clean state.
+     * This ensures the folder contents exactly match what ai.json declares.
+     */
+    clean?: boolean;
+}
+/**
+ * Category of a file change for display grouping.
+ */
+export type FileChangeCategory = 'skill' | 'rule' | 'workflow' | 'mcp' | 'hook' | 'other';
+/**
+ * A single file operation to be performed.
+ */
+export interface FileChange {
+    path: string;
+    action: 'create' | 'update' | 'delete' | 'unchanged';
+    content?: string;
+    /** If true, this change represents a directory that was already copied (e.g., skills) */
+    isDirectory?: boolean;
+    /** File mode (permissions) to set, e.g., 0o755 for executable scripts */
+    mode?: number;
+    /** Category for display grouping */
+    category?: FileChangeCategory;
+}
+/**
+ * Information about global configuration changes.
+ */
+export interface GlobalChangesInfo {
+    /** Global changes that were applied */
+    applied: Array<{
+        type: 'mcp' | 'prompt';
+        name: string;
+        globalPath: string;
+    }>;
+    /** Global changes that were skipped */
+    skipped: Array<{
+        type: 'mcp' | 'prompt';
+        name: string;
+        reason: string;
+    }>;
+    /** Warnings from global change processing */
+    warnings: string[];
+}
+/**
+ * Result of applying editor configuration.
+ */
+export interface ApplyResult {
+    editor: EditorName;
+    success: boolean;
+    changes: FileChange[];
+    errors: string[];
+    /** Features that were skipped because the editor doesn't support them */
+    unsupportedFeatures?: UnsupportedFeatures;
+    /** Information about global configuration changes (for global-only features) */
+    globalChanges?: GlobalChangesInfo;
+}
+/**
+ * Interface for editor-specific adapters. Each supported editor implements this interface to
+ * translate ai.json configuration into editor-native formats.
+ */
+export interface EditorAdapter {
+    readonly name: EditorName;
+    readonly configDir: string;
+    /**
+     * Check if this editor's config directory exists in the project.
+     */
+    detect(projectRoot: string): Promise<boolean>;
+    /**
+     * Generate editor-specific configuration from ai.json config.
+     */
+    generateConfig(config: AiJsonConfig, projectRoot: string, options?: ApplyOptions): Promise<EditorConfig>;
+    /**
+     * Apply the generated configuration to the editor's config files.
+     */
+    apply(editorConfig: EditorConfig, projectRoot: string, options?: ApplyOptions): Promise<ApplyResult>;
+    /**
+     * Get features from the config that this editor doesn't support.
+     */
+    getUnsupportedFeatures(config: AiJsonConfig): UnsupportedFeatures;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/editors/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/editors/types.js.map

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

package/dist/env/ci.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Check if the current environment is a CI environment.
+ * Uses the is-in-ci package for reliable detection across CI providers.
+ */
+export declare function isCI(): Promise<boolean>;
+//# sourceMappingURL=ci.d.ts.map

package/dist/env/ci.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci.d.ts","sourceRoot":"","sources":["../../src/env/ci.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAsB,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAkB7C"}

package/dist/env/ci.js

@@ -0,0 +1,22 @@
+/**
+ * Check if the current environment is a CI environment.
+ * Uses the is-in-ci package for reliable detection across CI providers.
+ */
+export async function isCI() {
+    try {
+        const { default: isInCI } = await import('is-in-ci');
+        return isInCI;
+    }
+    catch {
+        // Fallback to basic CI detection if package not available
+        return Boolean(process.env.CI ||
+            process.env.CONTINUOUS_INTEGRATION ||
+            process.env.GITHUB_ACTIONS ||
+            process.env.GITLAB_CI ||
+            process.env.CIRCLECI ||
+            process.env.TRAVIS ||
+            process.env.JENKINS_URL ||
+            process.env.BUILDKITE);
+    }
+}
+//# sourceMappingURL=ci.js.map

package/dist/env/ci.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci.js","sourceRoot":"","sources":["../../src/env/ci.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI;IACvB,IAAI,CAAC;QACF,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QAErD,OAAO,MAAM,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACN,0DAA0D;QAC1D,OAAO,OAAO,CACX,OAAO,CAAC,GAAG,CAAC,EAAE;YACX,OAAO,CAAC,GAAG,CAAC,sBAAsB;YAClC,OAAO,CAAC,GAAG,CAAC,cAAc;YAC1B,OAAO,CAAC,GAAG,CAAC,SAAS;YACrB,OAAO,CAAC,GAAG,CAAC,QAAQ;YACpB,OAAO,CAAC,GAAG,CAAC,MAAM;YAClB,OAAO,CAAC,GAAG,CAAC,WAAW;YACvB,OAAO,CAAC,GAAG,CAAC,SAAS,CAC1B,CAAC;IACL,CAAC;AACJ,CAAC"}

package/dist/env/index.d.ts

@@ -0,0 +1,2 @@
+export { isCI } from './ci.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/env/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC"}

package/dist/env/index.js

@@ -0,0 +1,2 @@
+export { isCI } from './ci.js';
+//# sourceMappingURL=index.js.map

package/dist/env/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/env/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,44 @@
+export declare class ConfigError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+export declare class ConfigNotFoundError extends ConfigError {
+    constructor(searchPath?: string);
+}
+export declare class ConfigValidationError extends ConfigError {
+    readonly errors: Array<{
+        path: string;
+        message: string;
+    }>;
+    constructor(errors: Array<{
+        path: string;
+        message: string;
+    }>);
+}
+export declare class CircularDependencyError extends ConfigError {
+    readonly path: string[];
+    constructor(path: string[]);
+}
+export interface ConfigParseIssue {
+    path: string;
+    message: string;
+}
+export declare class ConfigParseError extends ConfigError {
+    readonly filePath: string;
+    readonly issues?: ConfigParseIssue[] | undefined;
+    constructor(message: string, filePath: string, issues?: ConfigParseIssue[] | undefined);
+}
+export declare class EmbeddedConfigUpdateError extends ConfigError {
+    readonly packageJsonPath: string;
+    constructor(packageJsonPath: string);
+}
+export declare class RemoteFetchError extends ConfigError {
+    readonly url: string;
+    readonly cause: string;
+    constructor(url: string, cause: string);
+}
+export declare class UnsupportedUrlError extends ConfigError {
+    readonly url: string;
+    constructor(url: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAY,SAAQ,KAAK;aAGhB,IAAI,EAAE,MAAM;gBAD5B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM;CAKjC;AAED,qBAAa,mBAAoB,SAAQ,WAAW;gBACrC,UAAU,CAAC,EAAE,MAAM;CAQjC;AAED,qBAAa,qBAAsB,SAAQ,WAAW;aACvB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;gBAAhD,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAQ9E;AAED,qBAAa,uBAAwB,SAAQ,WAAW;aACzB,IAAI,EAAE,MAAM,EAAE;gBAAd,IAAI,EAAE,MAAM,EAAE;CAG5C;AAED,MAAM,WAAW,gBAAgB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,gBAAiB,SAAQ,WAAW;aAG3B,QAAQ,EAAE,MAAM;aAChB,MAAM,CAAC,EAAE,gBAAgB,EAAE;gBAF3C,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,gBAAgB,EAAE,YAAA;CAIhD;AAED,qBAAa,yBAA0B,SAAQ,WAAW;aAC3B,eAAe,EAAE,MAAM;gBAAvB,eAAe,EAAE,MAAM;CAQrD;AAED,qBAAa,gBAAiB,SAAQ,WAAW;aAE3B,GAAG,EAAE,MAAM;aACX,KAAK,EAAE,MAAM;gBADb,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM;CAIlC;AAED,qBAAa,mBAAoB,SAAQ,WAAW;aACrB,GAAG,EAAE,MAAM;gBAAX,GAAG,EAAE,MAAM;CAMzC"}

package/dist/errors.js

@@ -0,0 +1,68 @@
+export class ConfigError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = 'ConfigError';
+    }
+}
+export class ConfigNotFoundError extends ConfigError {
+    constructor(searchPath) {
+        super(searchPath
+            ? `Config file not found at: ${searchPath}`
+            : 'No ai.json found in current directory or parents', 'CONFIG_NOT_FOUND');
+    }
+}
+export class ConfigValidationError extends ConfigError {
+    errors;
+    constructor(errors) {
+        const message = [
+            'Invalid ai.json configuration:',
+            ...errors.map((e) => `  - ${e.path}: ${e.message}`),
+        ].join('\n');
+        super(message, 'CONFIG_VALIDATION_ERROR');
+        this.errors = errors;
+    }
+}
+export class CircularDependencyError extends ConfigError {
+    path;
+    constructor(path) {
+        super(`Circular dependency detected: ${path.join(' -> ')}`, 'CIRCULAR_DEPENDENCY');
+        this.path = path;
+    }
+}
+export class ConfigParseError extends ConfigError {
+    filePath;
+    issues;
+    constructor(message, filePath, issues) {
+        super(`Failed to parse ${filePath}: ${message}`, 'CONFIG_PARSE_ERROR');
+        this.filePath = filePath;
+        this.issues = issues;
+    }
+}
+export class EmbeddedConfigUpdateError extends ConfigError {
+    packageJsonPath;
+    constructor(packageJsonPath) {
+        super(`Cannot update config embedded in package.json (${packageJsonPath}). ` +
+            'Extract the "ai" field to a separate ai.json file first, or use ' +
+            '"ai": "./ai.json" in package.json to reference an external file.', 'EMBEDDED_CONFIG_UPDATE');
+        this.packageJsonPath = packageJsonPath;
+    }
+}
+export class RemoteFetchError extends ConfigError {
+    url;
+    cause;
+    constructor(url, cause) {
+        super(`Failed to fetch remote config from ${url}: ${cause}`, 'REMOTE_FETCH_ERROR');
+        this.url = url;
+        this.cause = cause;
+    }
+}
+export class UnsupportedUrlError extends ConfigError {
+    url;
+    constructor(url) {
+        super(`Unsupported URL format: ${url}. Use HTTPS URLs or git shorthand (github:, gitlab:, bitbucket:).`, 'UNSUPPORTED_URL');
+        this.url = url;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,WAAY,SAAQ,KAAK;IAGhB;IAFnB,YACG,OAAe,EACC,IAAY;QAE5B,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,SAAI,GAAJ,IAAI,CAAQ;QAG5B,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC7B,CAAC;CACH;AAED,MAAM,OAAO,mBAAoB,SAAQ,WAAW;IACjD,YAAY,UAAmB;QAC5B,KAAK,CACF,UAAU;YACP,CAAC,CAAC,6BAA6B,UAAU,EAAE;YAC3C,CAAC,CAAC,kDAAkD,EACvD,kBAAkB,CACpB,CAAC;IACL,CAAC;CACH;AAED,MAAM,OAAO,qBAAsB,SAAQ,WAAW;IACvB;IAA5B,YAA4B,MAAgD;QACzE,MAAM,OAAO,GAAG;YACb,gCAAgC;YAChC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;SACrD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,KAAK,CAAC,OAAO,EAAE,yBAAyB,CAAC,CAAC;QANjB,WAAM,GAAN,MAAM,CAA0C;IAO5E,CAAC;CACH;AAED,MAAM,OAAO,uBAAwB,SAAQ,WAAW;IACzB;IAA5B,YAA4B,IAAc;QACvC,KAAK,CAAC,iCAAiC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,qBAAqB,CAAC,CAAC;QAD1D,SAAI,GAAJ,IAAI,CAAU;IAE1C,CAAC;CACH;AAOD,MAAM,OAAO,gBAAiB,SAAQ,WAAW;IAG3B;IACA;IAHnB,YACG,OAAe,EACC,QAAgB,EAChB,MAA2B;QAE3C,KAAK,CAAC,mBAAmB,QAAQ,KAAK,OAAO,EAAE,EAAE,oBAAoB,CAAC,CAAC;QAHvD,aAAQ,GAAR,QAAQ,CAAQ;QAChB,WAAM,GAAN,MAAM,CAAqB;IAG9C,CAAC;CACH;AAED,MAAM,OAAO,yBAA0B,SAAQ,WAAW;IAC3B;IAA5B,YAA4B,eAAuB;QAChD,KAAK,CACF,kDAAkD,eAAe,KAAK;YACnE,kEAAkE;YAClE,kEAAkE,EACrE,wBAAwB,CAC1B,CAAC;QANuB,oBAAe,GAAf,eAAe,CAAQ;IAOnD,CAAC;CACH;AAED,MAAM,OAAO,gBAAiB,SAAQ,WAAW;IAE3B;IACA;IAFnB,YACmB,GAAW,EACX,KAAa;QAE7B,KAAK,CAAC,sCAAsC,GAAG,KAAK,KAAK,EAAE,EAAE,oBAAoB,CAAC,CAAC;QAHnE,QAAG,GAAH,GAAG,CAAQ;QACX,UAAK,GAAL,KAAK,CAAQ;IAGhC,CAAC;CACH;AAED,MAAM,OAAO,mBAAoB,SAAQ,WAAW;IACrB;IAA5B,YAA4B,GAAW;QACpC,KAAK,CACF,2BAA2B,GAAG,mEAAmE,EACjG,iBAAiB,CACnB,CAAC;QAJuB,QAAG,GAAH,GAAG,CAAQ;IAKvC,CAAC;CACH"}

package/dist/format-error.d.ts

@@ -0,0 +1,18 @@
+import type { ZodError } from 'zod';
+import { ConfigValidationError } from './errors.js';
+export interface ValidationIssue {
+    path: string;
+    message: string;
+}
+/**
+ * Convert a ZodError to a ConfigValidationError. Returns undefined if the error is not a ZodError.
+ */
+export declare function toConfigValidationError(error: unknown): ConfigValidationError | undefined;
+/**
+ * Extract validation issues from a ZodError. Simplifies union errors to show the most relevant
+ * message.
+ * @param error - The ZodError to extract issues from
+ * @param input - Original input data (used to show actual values in errors)
+ */
+export declare function extractValidationIssues(error: ZodError, input?: unknown): ValidationIssue[];
+//# sourceMappingURL=format-error.d.ts.map

package/dist/format-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-error.d.ts","sourceRoot":"","sources":["../src/format-error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAY,MAAM,KAAK,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,qBAAqB,GAAG,SAAS,CAczF;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,eAAe,EAAE,CAS3F"}

package/dist/format-error.js

@@ -0,0 +1,113 @@
+import { ConfigValidationError } from './errors.js';
+/**
+ * Convert a ZodError to a ConfigValidationError. Returns undefined if the error is not a ZodError.
+ */
+export function toConfigValidationError(error) {
+    if (error instanceof Error && 'issues' in error) {
+        const zodError = error;
+        return new ConfigValidationError(zodError.issues.map((issue) => ({
+            path: Array.isArray(issue.path) ? issue.path.join('.') : '',
+            message: issue.message,
+        })));
+    }
+    return undefined;
+}
+/**
+ * Extract validation issues from a ZodError. Simplifies union errors to show the most relevant
+ * message.
+ * @param error - The ZodError to extract issues from
+ * @param input - Original input data (used to show actual values in errors)
+ */
+export function extractValidationIssues(error, input) {
+    return error.issues.map((issue) => {
+        const path = Array.isArray(issue.path) ? issue.path : [];
+        return {
+            path: path.join('.') || '(root)',
+            message: simplifyZodMessage(issue, input, path),
+        };
+    });
+}
+/**
+ * Simplify a Zod error message for human readability. Union errors are particularly verbose, so we
+ * extract the most relevant message from them.
+ */
+function simplifyZodMessage(issue, input, path) {
+    // Handle union errors specially - they're verbose
+    if (issue.code === 'invalid_union') {
+        const unionIssues = issue.unionErrors.flatMap((e) => e.issues);
+        // Look for a type error first (most common and clear)
+        const typeError = unionIssues.find((i) => i.code === 'invalid_type');
+        if (typeError && typeError.code === 'invalid_type') {
+            return formatTypeError(typeError.expected, input, path);
+        }
+        // Look for a literal error (e.g., expected false but got true)
+        const literalError = unionIssues.find((i) => i.code === 'invalid_literal');
+        if (literalError && literalError.code === 'invalid_literal') {
+            const actualValue = getValueAtPath(input, path);
+            return `Expected object or false, received ${formatReceivedValue(actualValue)}`;
+        }
+        // Fall back to first error message
+        return unionIssues[0]?.message ?? issue.message;
+    }
+    if (issue.code === 'invalid_type') {
+        return formatTypeError(issue.expected, input, path);
+    }
+    // For custom refinement errors, use the message directly
+    if (issue.code === 'custom') {
+        return issue.message;
+    }
+    return issue.message;
+}
+/**
+ * Format type errors with actual values for literals like true/false/null. Shows "received true"
+ * instead of "received boolean" for clarity.
+ */
+function formatTypeError(expected, input, path) {
+    const actualValue = getValueAtPath(input, path), receivedStr = formatReceivedValue(actualValue);
+    return `Expected ${expected}, received ${receivedStr}`;
+}
+/**
+ * Get a value at a nested path in an object.
+ */
+function getValueAtPath(obj, path) {
+    let current = obj;
+    for (const key of path) {
+        if (current == null || typeof current !== 'object') {
+            return undefined;
+        }
+        current = current[key];
+    }
+    return current;
+}
+/**
+ * Format a received value for display in error messages. Shows actual literal values for
+ * primitives.
+ */
+function formatReceivedValue(value) {
+    if (value === true) {
+        return 'true';
+    }
+    if (value === false) {
+        return 'false';
+    }
+    if (value === null) {
+        return 'null';
+    }
+    if (value === undefined) {
+        return 'undefined';
+    }
+    if (typeof value === 'string') {
+        return `string ("${value}")`;
+    }
+    if (typeof value === 'number') {
+        return `number (${value})`;
+    }
+    if (Array.isArray(value)) {
+        return 'array';
+    }
+    if (typeof value === 'object') {
+        return 'object';
+    }
+    return typeof value;
+}
+//# sourceMappingURL=format-error.js.map

package/dist/format-error.js.map

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

package/dist/fs/safe-rm.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Error thrown when attempting to remove a protected path.
+ */
+export declare class UnsafePathError extends Error {
+    readonly path: string;
+    readonly reason: string;
+    constructor(path: string, reason: string);
+}
+/**
+ * Safely remove a directory recursively, with validation to prevent accidental deletion
+ * of critical system or project directories.
+ *
+ * @param targetPath - The path to remove
+ * @param options - Options passed to fs.rm (force is commonly used)
+ * @throws UnsafePathError if the path is protected
+ */
+export declare function safeRm(targetPath: string, options?: {
+    force?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=safe-rm.d.ts.map

package/dist/fs/safe-rm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-rm.d.ts","sourceRoot":"","sources":["../../src/fs/safe-rm.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;aAEpB,IAAI,EAAE,MAAM;aACZ,MAAM,EAAE,MAAM;gBADd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM;CAKnC;AAkGD;;;;;;;GAOG;AACH,wBAAsB,MAAM,CACzB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,OAAO,CAAC,IAAI,CAAC,CAmCf"}