@a1st/aix-core 0.0.3

package/dist/global/types.d.ts

@@ -0,0 +1,54 @@
+import type { McpServerConfig } from '@a1st/aix-schema';
+import type { EditorName } from '../editors/types.js';
+/**
+ * A request to modify global configuration.
+ */
+export interface GlobalChangeRequest {
+    /** Editor this change applies to */
+    editor: EditorName;
+    /** Type of global config */
+    type: 'mcp' | 'prompt';
+    /** Name of the config item (e.g., MCP server name, prompt name) */
+    name: string;
+    /** Action to perform */
+    action: 'add' | 'skip';
+    /** Reason for skipping (if action is 'skip') */
+    skipReason?: string;
+    /** Path to global config file */
+    globalPath: string;
+    /** The new config to add (for MCP) */
+    mcpConfig?: McpServerConfig;
+    /** The new content to add (for prompts) */
+    promptContent?: string;
+    /** Existing config if it already exists */
+    existingMcpConfig?: McpServerConfig;
+    /** Existing content if it already exists */
+    existingPromptContent?: string;
+    /** Whether configs match (no action needed) */
+    configsMatch?: boolean;
+}
+/**
+ * Result of processing global changes.
+ */
+export interface GlobalChangeResult {
+    /** Changes that were applied */
+    applied: GlobalChangeRequest[];
+    /** Changes that were skipped */
+    skipped: GlobalChangeRequest[];
+    /** Warnings generated during processing */
+    warnings: string[];
+}
+/**
+ * Options for processing global changes.
+ */
+export interface GlobalChangeOptions {
+    /** If true, skip all global changes without prompting */
+    skipGlobal?: boolean;
+    /** If true, apply all global changes without prompting (for testing) */
+    autoConfirm?: boolean;
+    /** Project root path for tracking */
+    projectPath: string;
+    /** Dry run - don't actually write files */
+    dryRun?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/global/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACjC,oCAAoC;IACpC,MAAM,EAAE,UAAU,CAAC;IACnB,4BAA4B;IAC5B,IAAI,EAAE,KAAK,GAAG,QAAQ,CAAC;IACvB,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,iBAAiB,CAAC,EAAE,eAAe,CAAC;IACpC,4CAA4C;IAC5C,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,+CAA+C;IAC/C,YAAY,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAChC,gCAAgC;IAChC,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,gCAAgC;IAChC,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACjC,yDAAyD;IACzD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,wEAAwE;IACxE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/dist/global/types.js

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

package/dist/global/types.js.map

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

package/dist/import-writer.d.ts

@@ -0,0 +1,37 @@
+import type { EditorName } from './editors/types.js';
+export interface WrittenImports {
+    rules: Record<string, string>;
+    prompts: Record<string, string>;
+}
+export interface ImportContent {
+    rules: string[];
+    prompts: Record<string, string>;
+}
+/**
+ * Write imported content to staging directory and return path references.
+ * Files are written to `.aix/.tmp/import-staging/<editor>/` and path references
+ * point to the final location `.aix/imported/<editor>/`.
+ *
+ * @param projectRoot - The project root directory
+ * @param editor - The source editor name
+ * @param content - The imported content (rules and prompts)
+ * @returns Path references for rules and prompts (relative to project root)
+ */
+export declare function writeImportedContent(projectRoot: string, editor: EditorName, content: ImportContent): Promise<WrittenImports>;
+/**
+ * Commit staged import: backup existing, move staging to final location, cleanup.
+ * This should be called after ai.json has been successfully written.
+ *
+ * @param projectRoot - The project root directory
+ * @param editor - The source editor name
+ */
+export declare function commitImport(projectRoot: string, editor: EditorName): Promise<void>;
+/**
+ * Rollback import: delete staging, restore backup if exists.
+ * This should be called if ai.json write or any subsequent step fails.
+ *
+ * @param projectRoot - The project root directory
+ * @param editor - The source editor name
+ */
+export declare function rollbackImport(projectRoot: string, editor: EditorName): Promise<void>;
+//# sourceMappingURL=import-writer.d.ts.map

package/dist/import-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-writer.d.ts","sourceRoot":"","sources":["../src/import-writer.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGrD,MAAM,WAAW,cAAc;IAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC3B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAyBD;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CACvC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,aAAa,GACtB,OAAO,CAAC,cAAc,CAAC,CAsCzB;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAkCzF;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAiC3F"}

package/dist/import-writer.js

@@ -0,0 +1,129 @@
+import { mkdir, writeFile, rm, rename, access, constants } from 'node:fs/promises';
+import { join } from 'pathe';
+import { getImportedEditorDir, getImportStagingDir, getImportBackupDir, } from './cache/paths.js';
+import { safeRm } from './fs/safe-rm.js';
+/**
+ * Sanitize a string for use as a filename.
+ */
+function sanitizeFileName(name) {
+    return name
+        .toLowerCase()
+        .replace(/[^a-z0-9-]/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+/**
+ * Check if a directory exists.
+ */
+async function dirExists(path) {
+    try {
+        await access(path, constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Write imported content to staging directory and return path references.
+ * Files are written to `.aix/.tmp/import-staging/<editor>/` and path references
+ * point to the final location `.aix/imported/<editor>/`.
+ *
+ * @param projectRoot - The project root directory
+ * @param editor - The source editor name
+ * @param content - The imported content (rules and prompts)
+ * @returns Path references for rules and prompts (relative to project root)
+ */
+export async function writeImportedContent(projectRoot, editor, content) {
+    const stagingDir = join(getImportStagingDir(projectRoot), editor), stagingRulesDir = join(stagingDir, 'rules'), stagingPromptsDir = join(stagingDir, 'prompts'), result = { rules: {}, prompts: {} };
+    // Clean any existing staging for this editor
+    await safeRm(stagingDir, { force: true });
+    // Create staging directories
+    await mkdir(stagingRulesDir, { recursive: true });
+    await mkdir(stagingPromptsDir, { recursive: true });
+    // Build rule write operations
+    const ruleWrites = content.rules.map((ruleContent, i) => {
+        const name = `imported-rule-${i + 1}`, fileName = `${sanitizeFileName(name)}.md`, stagingPath = join(stagingRulesDir, fileName), relativePath = `./.aix/imported/${editor}/rules/${fileName}`;
+        result.rules[name] = relativePath;
+        return writeFile(stagingPath, ruleContent, 'utf-8');
+    });
+    // Build prompt write operations
+    const promptWrites = Object.entries(content.prompts).map(([name, promptContent]) => {
+        const fileName = `${sanitizeFileName(name)}.md`, stagingPath = join(stagingPromptsDir, fileName), relativePath = `./.aix/imported/${editor}/prompts/${fileName}`;
+        result.prompts[name] = relativePath;
+        return writeFile(stagingPath, promptContent, 'utf-8');
+    });
+    // Execute all writes in parallel
+    await Promise.all([...ruleWrites, ...promptWrites]);
+    return result;
+}
+/**
+ * Commit staged import: backup existing, move staging to final location, cleanup.
+ * This should be called after ai.json has been successfully written.
+ *
+ * @param projectRoot - The project root directory
+ * @param editor - The source editor name
+ */
+export async function commitImport(projectRoot, editor) {
+    const stagingDir = join(getImportStagingDir(projectRoot), editor), finalDir = getImportedEditorDir(projectRoot, editor), backupDir = join(getImportBackupDir(projectRoot), editor);
+    // If staging directory doesn't exist, nothing was staged - skip commit
+    if (!(await dirExists(stagingDir))) {
+        return;
+    }
+    // Clean any existing backup for this editor
+    await safeRm(backupDir, { force: true });
+    // If final directory exists, move it to backup
+    if (await dirExists(finalDir)) {
+        await mkdir(getImportBackupDir(projectRoot), { recursive: true });
+        await rename(finalDir, backupDir);
+    }
+    // Move staging to final location
+    await mkdir(join(projectRoot, '.aix', 'imported'), { recursive: true });
+    await rename(stagingDir, finalDir);
+    // Clean up backup (success path)
+    await safeRm(backupDir, { force: true });
+    // Clean up empty staging parent if no other editors are staged
+    const stagingParent = getImportStagingDir(projectRoot);
+    try {
+        await rm(stagingParent, { recursive: false });
+    }
+    catch {
+        // Directory not empty or doesn't exist, that's fine
+    }
+}
+/**
+ * Rollback import: delete staging, restore backup if exists.
+ * This should be called if ai.json write or any subsequent step fails.
+ *
+ * @param projectRoot - The project root directory
+ * @param editor - The source editor name
+ */
+export async function rollbackImport(projectRoot, editor) {
+    const stagingDir = join(getImportStagingDir(projectRoot), editor), finalDir = getImportedEditorDir(projectRoot, editor), backupDir = join(getImportBackupDir(projectRoot), editor);
+    // Delete staging directory
+    await safeRm(stagingDir, { force: true });
+    // If backup exists, restore it
+    if (await dirExists(backupDir)) {
+        // Remove any partial final directory
+        await safeRm(finalDir, { force: true });
+        // Restore backup
+        await rename(backupDir, finalDir);
+    }
+    // Clean up empty staging parent
+    const stagingParent = getImportStagingDir(projectRoot);
+    try {
+        await rm(stagingParent, { recursive: false });
+    }
+    catch {
+        // Directory not empty or doesn't exist, that's fine
+    }
+    // Clean up empty backup parent
+    const backupParent = getImportBackupDir(projectRoot);
+    try {
+        await rm(backupParent, { recursive: false });
+    }
+    catch {
+        // Directory not empty or doesn't exist, that's fine
+    }
+}
+//# sourceMappingURL=import-writer.js.map

package/dist/import-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-writer.js","sourceRoot":"","sources":["../src/import-writer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACnF,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAC7B,OAAO,EACJ,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,GACpB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAYzC;;GAEG;AACH,SAAS,gBAAgB,CAAC,IAAY;IACnC,OAAO,IAAI;SACP,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,SAAS,CAAC,IAAY;IAClC,IAAI,CAAC;QACF,MAAM,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACN,OAAO,KAAK,CAAC;IAChB,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACvC,WAAmB,EACnB,MAAkB,EAClB,OAAsB;IAEtB,MAAM,UAAU,GAAG,IAAI,CAAC,mBAAmB,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,EAC3D,eAAe,GAAG,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,EAC3C,iBAAiB,GAAG,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,EAC/C,MAAM,GAAmB,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAE1D,6CAA6C;IAC7C,MAAM,MAAM,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1C,6BAA6B;IAC7B,MAAM,KAAK,CAAC,eAAe,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,MAAM,KAAK,CAAC,iBAAiB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEpD,8BAA8B;IAC9B,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,EAAE,EAAE;QACrD,MAAM,IAAI,GAAG,iBAAiB,CAAC,GAAG,CAAC,EAAE,EAC/B,QAAQ,GAAG,GAAG,gBAAgB,CAAC,IAAI,CAAC,KAAK,EACzC,WAAW,GAAG,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,EAC7C,YAAY,GAAG,mBAAmB,MAAM,UAAU,QAAQ,EAAE,CAAC;QAEnE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC;QAClC,OAAO,SAAS,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,gCAAgC;IAChC,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,aAAa,CAAC,EAAE,EAAE;QAChF,MAAM,QAAQ,GAAG,GAAG,gBAAgB,CAAC,IAAI,CAAC,KAAK,EACzC,WAAW,GAAG,IAAI,CAAC,iBAAiB,EAAE,QAAQ,CAAC,EAC/C,YAAY,GAAG,mBAAmB,MAAM,YAAY,QAAQ,EAAE,CAAC;QAErE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC;QACpC,OAAO,SAAS,CAAC,WAAW,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,iCAAiC;IACjC,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,UAAU,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC;IAEpD,OAAO,MAAM,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,WAAmB,EAAE,MAAkB;IACvE,MAAM,UAAU,GAAG,IAAI,CAAC,mBAAmB,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,EAC3D,QAAQ,GAAG,oBAAoB,CAAC,WAAW,EAAE,MAAM,CAAC,EACpD,SAAS,GAAG,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,CAAC;IAEhE,uEAAuE;IACvE,IAAI,CAAC,CAAC,MAAM,SAAS,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QAClC,OAAO;IACV,CAAC;IAED,4CAA4C;IAC5C,MAAM,MAAM,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAEzC,+CAA+C;IAC/C,IAAI,MAAM,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,KAAK,CAAC,kBAAkB,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAClE,MAAM,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACrC,CAAC;IAED,iCAAiC;IACjC,MAAM,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxE,MAAM,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAEnC,iCAAiC;IACjC,MAAM,MAAM,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAEzC,+DAA+D;IAC/D,MAAM,aAAa,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAEvD,IAAI,CAAC;QACF,MAAM,EAAE,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACN,oDAAoD;IACvD,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,WAAmB,EAAE,MAAkB;IACzE,MAAM,UAAU,GAAG,IAAI,CAAC,mBAAmB,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,EAC3D,QAAQ,GAAG,oBAAoB,CAAC,WAAW,EAAE,MAAM,CAAC,EACpD,SAAS,GAAG,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,CAAC;IAEhE,2BAA2B;IAC3B,MAAM,MAAM,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1C,+BAA+B;IAC/B,IAAI,MAAM,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,qCAAqC;QACrC,MAAM,MAAM,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACxC,iBAAiB;QACjB,MAAM,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED,gCAAgC;IAChC,MAAM,aAAa,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAEvD,IAAI,CAAC;QACF,MAAM,EAAE,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACN,oDAAoD;IACvD,CAAC;IAED,+BAA+B;IAC/B,MAAM,YAAY,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAErD,IAAI,CAAC;QACF,MAAM,EAAE,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACN,oDAAoD;IACvD,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+export * from './errors.js';
+export * from './format-error.js';
+export * from './discovery.js';
+export * from './inheritance.js';
+export * from './json.js';
+export * from './loader.js';
+export * from './updater.js';
+export * from './backup.js';
+export * from './cache/index.js';
+export * from './skills/index.js';
+export * from './mcp/index.js';
+export * from './rules/index.js';
+export * from './editors/index.js';
+export * from './url-parsing.js';
+export * from './remote-loader.js';
+export * from './merge.js';
+export * from './prompts/index.js';
+export * from './npm/index.js';
+export * from './import-writer.js';
+export * from './global/index.js';
+export * from './env/index.js';
+export { safeRm, UnsafePathError } from './fs/safe-rm.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,23 @@
+export * from './errors.js';
+export * from './format-error.js';
+export * from './discovery.js';
+export * from './inheritance.js';
+export * from './json.js';
+export * from './loader.js';
+export * from './updater.js';
+export * from './backup.js';
+export * from './cache/index.js';
+export * from './skills/index.js';
+export * from './mcp/index.js';
+export * from './rules/index.js';
+export * from './editors/index.js';
+export * from './url-parsing.js';
+export * from './remote-loader.js';
+export * from './merge.js';
+export * from './prompts/index.js';
+export * from './npm/index.js';
+export * from './import-writer.js';
+export * from './global/index.js';
+export * from './env/index.js';
+export { safeRm, UnsafePathError } from './fs/safe-rm.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/inheritance.d.ts

@@ -0,0 +1,9 @@
+import type { AiJsonConfig } from '@a1st/aix-schema';
+export interface ResolveOptions {
+    baseDir: string;
+    visited?: Set<string>;
+    /** Whether the baseDir is a remote URL (for resolving relative extends) */
+    isRemote?: boolean;
+}
+export declare function resolveExtends(config: Record<string, unknown>, options: ResolveOptions): Promise<AiJsonConfig>;
+//# sourceMappingURL=inheritance.d.ts.map

package/dist/inheritance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inheritance.d.ts","sourceRoot":"","sources":["../src/inheritance.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,WAAW,cAAc;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACtB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,wBAAsB,cAAc,CACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,cAAc,GACvB,OAAO,CAAC,YAAY,CAAC,CA6BvB"}

package/dist/inheritance.js

@@ -0,0 +1,133 @@
+import { resolve, dirname } from 'pathe';
+import { existsSync, readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { downloadTemplate } from 'giget';
+import { parseJsonc } from '@a1st/aix-schema';
+import { parseConfigContent } from './discovery.js';
+import { CircularDependencyError, ConfigParseError, RemoteFetchError } from './errors.js';
+import { convertBlobToRawUrl, isLocalPath } from './url-parsing.js';
+import { deepMergeJson } from './json.js';
+export async function resolveExtends(config, options) {
+    const { baseDir, visited = new Set(), isRemote = false } = options;
+    if (!config.extends) {
+        return config;
+    }
+    const extendsValue = config.extends, extendsList = Array.isArray(extendsValue) ? extendsValue : [extendsValue];
+    let merged = {};
+    // Process extends sequentially - order matters for proper inheritance chain
+    for (const extendPath of extendsList) {
+        if (typeof extendPath !== 'string') {
+            continue;
+        }
+        // eslint-disable-next-line no-await-in-loop -- Sequential: inheritance chain order matters
+        const resolvedConfig = await resolveExtendsPath(extendPath, baseDir, visited, isRemote);
+        merged = deepMergeJson(merged, resolvedConfig, { resolver: aiJsonMergeResolver });
+    }
+    const { extends: _, ...currentConfig } = config;
+    merged = deepMergeJson(merged, currentConfig, { resolver: aiJsonMergeResolver });
+    return merged;
+}
+async function resolveExtendsPath(extendPath, baseDir, visited, isRemote) {
+    // If base is a remote URL and extend is a relative path, resolve as remote URL
+    if (isRemote && isRelativePath(extendPath)) {
+        return resolveRemoteExtends(new URL(extendPath, baseDir).href, visited);
+    }
+    if (isLocalPath(extendPath)) {
+        return resolveLocalExtends(extendPath, baseDir, visited);
+    }
+    if (isGitPath(extendPath)) {
+        return resolveGitExtends(extendPath, visited);
+    }
+    return resolveNpmExtends(extendPath, visited);
+}
+function isRelativePath(path) {
+    return path.startsWith('./') || path.startsWith('../');
+}
+function isGitPath(path) {
+    return (path.startsWith('github:') ||
+        path.startsWith('gitlab:') ||
+        path.startsWith('bitbucket:') ||
+        path.startsWith('https://'));
+}
+/**
+ * Resolve extends from a remote URL (fetch the file directly).
+ */
+async function resolveRemoteExtends(url, visited) {
+    if (visited.has(url)) {
+        throw new CircularDependencyError([...visited, url]);
+    }
+    visited.add(url);
+    const rawUrl = convertBlobToRawUrl(url);
+    let content;
+    try {
+        const response = await fetch(rawUrl);
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        content = await response.text();
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new RemoteFetchError(url, message);
+    }
+    const result = parseJsonc(content);
+    if (result.errors.length > 0) {
+        throw new ConfigParseError(`Parse error: ${result.errors[0]?.message}`, url);
+    }
+    const parsed = result.data, newBaseUrl = rawUrl.substring(0, rawUrl.lastIndexOf('/') + 1);
+    return resolveExtends(parsed, { baseDir: newBaseUrl, visited, isRemote: true });
+}
+async function resolveLocalExtends(extendPath, baseDir, visited) {
+    const absolutePath = resolve(baseDir, extendPath);
+    if (visited.has(absolutePath)) {
+        throw new CircularDependencyError([...visited, absolutePath]);
+    }
+    if (!existsSync(absolutePath)) {
+        throw new ConfigParseError(`Extended config not found: ${extendPath}`, absolutePath);
+    }
+    visited.add(absolutePath);
+    const content = readFileSync(absolutePath, 'utf-8'), parsed = parseConfigContent(content), newBaseDir = dirname(absolutePath);
+    return resolveExtends(parsed, { baseDir: newBaseDir, visited });
+}
+async function resolveGitExtends(extendPath, visited) {
+    if (visited.has(extendPath)) {
+        throw new CircularDependencyError([...visited, extendPath]);
+    }
+    visited.add(extendPath);
+    const { dir } = await downloadTemplate(extendPath, {
+        force: false,
+        cwd: process.cwd(),
+    });
+    const configPath = resolve(dir, 'ai.json');
+    if (!existsSync(configPath)) {
+        throw new ConfigParseError(`No ai.json found in git repository: ${extendPath}`, configPath);
+    }
+    const content = readFileSync(configPath, 'utf-8'), parsed = parseConfigContent(content);
+    return resolveExtends(parsed, { baseDir: dir, visited });
+}
+async function resolveNpmExtends(packageName, visited) {
+    if (visited.has(packageName)) {
+        throw new CircularDependencyError([...visited, packageName]);
+    }
+    visited.add(packageName);
+    try {
+        // Use ESM-compatible import.meta.resolve to find the package
+        const resolvedUrl = import.meta.resolve(`${packageName}/ai.json`, `file://${process.cwd()}/`);
+        const packagePath = fileURLToPath(resolvedUrl);
+        const content = readFileSync(packagePath, 'utf-8'), parsed = parseConfigContent(content), baseDir = dirname(packagePath);
+        return resolveExtends(parsed, { baseDir, visited });
+    }
+    catch (_error) {
+        throw new ConfigParseError(`Failed to resolve npm package: ${packageName}. Make sure it's installed.`, packageName);
+    }
+}
+/**
+ * Merge resolver for ai.json inheritance. Skips the `extends` key since it's handled separately.
+ */
+function aiJsonMergeResolver({ key }) {
+    if (key === 'extends') {
+        return 'keep';
+    }
+    return undefined;
+}
+//# sourceMappingURL=inheritance.js.map

package/dist/inheritance.js.map

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

package/dist/json.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Strategy for how to handle a merge conflict at a specific key.
+ * - `merge`: Recursively merge objects, replace primitives/arrays (default behavior)
+ * - `replace`: Use the new value entirely, don't recurse into objects
+ * - `keep`: Keep the old value, ignore the new value
+ */
+export type MergeStrategy = 'merge' | 'replace' | 'keep';
+/**
+ * Context provided to the merge resolver function.
+ */
+export interface MergeContext {
+    /** The current key being merged */
+    key: string;
+    /** The path of keys leading to this value (not including current key) */
+    path: string[];
+    /** The existing value (may be undefined if key doesn't exist in base) */
+    oldValue: unknown;
+    /** The incoming value to merge */
+    newValue: unknown;
+}
+/**
+ * Function that determines the merge strategy for a specific key. Return undefined to use default
+ * behavior (merge objects, replace primitives/arrays).
+ */
+export type MergeResolver = (context: MergeContext) => MergeStrategy | undefined;
+/**
+ * Options for deepMergeJson.
+ */
+export interface DeepMergeOptions {
+    /** Custom resolver to determine merge strategy per-key */
+    resolver?: MergeResolver;
+}
+/**
+ * Deep merge two JSON objects. By default:
+ * - Objects are recursively merged
+ * - Arrays and primitives are replaced (new value wins)
+ *
+ * Use the `resolver` option to customize merge behavior per-key.
+ *
+ * @example
+ * ```ts
+ * // Default behavior
+ * deepMergeJson({ a: { x: 1 } }, { a: { y: 2 } })
+ * // => { a: { x: 1, y: 2 } }
+ *
+ * // With custom resolver - replace entire object at specific path
+ * deepMergeJson(base, override, {
+ *   resolver: ({ path }) => path[0] === 'servers' ? 'replace' : undefined
+ * })
+ * ```
+ */
+export declare function deepMergeJson(base: Record<string, unknown>, override: Record<string, unknown>, options?: DeepMergeOptions): Record<string, unknown>;
+/**
+ * Create a merge resolver that replaces values at specific paths. Paths are matched by joining with
+ * dots, e.g., `['mcpServers', '*']` matches any key under `mcpServers`.
+ *
+ * @example
+ * ```ts
+ * // Replace entire MCP server objects instead of merging them
+ * const resolver = createPathResolver({
+ *   'mcpServers.*': 'replace',
+ *   'context_servers.*': 'replace',
+ * });
+ * ```
+ */
+export declare function createPathResolver(rules: Record<string, MergeStrategy>): MergeResolver;
+/**
+ * Pre-built merge resolver for MCP config files. Replaces entire server objects instead of merging
+ * them, since a server definition from aix should completely override any existing definition with
+ * the same name.
+ *
+ * Works with both standard MCP format (`mcpServers.*`) and Zed format (`context_servers.*`).
+ */
+export declare const mcpConfigMergeResolver: MergeResolver;
+//# sourceMappingURL=json.d.ts.map

package/dist/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC1B,mCAAmC;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,yEAAyE;IACzE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,yEAAyE;IACzE,QAAQ,EAAE,OAAO,CAAC;IAClB,kCAAkC;IAClC,QAAQ,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,YAAY,KAAK,aAAa,GAAG,SAAS,CAAC;AAEjF;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC9B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,aAAa,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,GAAE,gBAAqB,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzB;AAoED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,aAAa,CAkBtF;AAkBD;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,EAAE,aAGnC,CAAC"}