@a1st/aix-core 0.0.3 → 0.0.6

package/dist/editors/types.d.ts

@@ -86,6 +86,13 @@ export interface ApplyOptions {
      * This ensures the folder contents exactly match what ai.json declares.
      */
     clean?: boolean;
+    /**
+     * Base directory/URL for resolving relative paths in the config (skills, rules, etc.). When
+     * installing from a remote URL, this is the remote URL directory. When installing from a local
+     * config, this defaults to the directory containing the config file. If not provided, falls back
+     * to projectRoot.
+     */
+    configBaseDir?: string;
 }
 /**
  * Category of a file change for display grouping.
@@ -144,6 +151,11 @@ export interface ApplyResult {
 export interface EditorAdapter {
     readonly name: EditorName;
     readonly configDir: string;
+    /**
+     * Get the global data/config paths for this editor by platform. Used to detect if the editor is
+     * installed globally on the system. Paths are relative to the user's home directory.
+     */
+    getGlobalDataPaths(): Partial<Record<NodeJS.Platform, string[]>>;
     /**
      * Check if this editor's config directory exists in the project.
      */

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

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

package/dist/frontmatter-parser.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Auto-detecting frontmatter parser that uses editor-specific strategies to parse frontmatter.
+ * Uses ordered priority for detection: Windsurf → Cursor → Claude Code → VS Code.
+ */
+import type { ParsedRuleFrontmatter, ParsedPromptFrontmatter, RulesStrategy, PromptsStrategy } from './editors/strategies/types.js';
+/**
+ * Parse rule frontmatter using auto-detection. Tries each strategy in priority order and uses the
+ * first one that detects its format. Falls back to generic parsing if no strategy matches.
+ *
+ * @param rawContent - Raw markdown content potentially containing front-matter
+ * @param strategy - Optional specific strategy to use (skips auto-detection)
+ * @returns Parsed frontmatter with unified metadata
+ */
+export declare function parseRuleFrontmatter(rawContent: string, strategy?: RulesStrategy): ParsedRuleFrontmatter;
+/**
+ * Parse prompt frontmatter using auto-detection. Tries each strategy in priority order and uses
+ * the first one that detects its format. Falls back to generic parsing if no strategy matches.
+ *
+ * @param rawContent - Raw markdown content potentially containing front-matter
+ * @param strategy - Optional specific strategy to use (skips auto-detection)
+ * @returns Parsed frontmatter with unified fields
+ */
+export declare function parsePromptFrontmatter(rawContent: string, strategy?: PromptsStrategy): ParsedPromptFrontmatter;
+//# sourceMappingURL=frontmatter-parser.d.ts.map

package/dist/frontmatter-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-parser.d.ts","sourceRoot":"","sources":["../src/frontmatter-parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAyBpI;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CACjC,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,aAAa,GACxB,qBAAqB,CAevB;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACnC,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,eAAe,GAC1B,uBAAuB,CAezB"}

package/dist/frontmatter-parser.js

@@ -0,0 +1,137 @@
+/**
+ * Auto-detecting frontmatter parser that uses editor-specific strategies to parse frontmatter.
+ * Uses ordered priority for detection: Windsurf → Cursor → Claude Code → VS Code.
+ */
+import { WindsurfRulesStrategy } from './editors/strategies/windsurf/rules.js';
+import { WindsurfPromptsStrategy } from './editors/strategies/windsurf/prompts.js';
+import { CursorRulesStrategy } from './editors/strategies/cursor/rules.js';
+import { ClaudeCodeRulesStrategy } from './editors/strategies/claude-code/rules.js';
+import { ClaudeCodePromptsStrategy } from './editors/strategies/claude-code/prompts.js';
+import { VSCodePromptsStrategy } from './editors/strategies/vscode/prompts.js';
+import { CodexPromptsStrategy } from './editors/strategies/codex/prompts.js';
+import { extractFrontmatter, parseYamlValue } from './frontmatter-utils.js';
+/** Ordered list of rules strategies for auto-detection (priority order) */
+const RULES_STRATEGIES = [
+    new WindsurfRulesStrategy(),
+    new CursorRulesStrategy(),
+    new ClaudeCodeRulesStrategy(),
+];
+/** Ordered list of prompts strategies for auto-detection (priority order) */
+const PROMPTS_STRATEGIES = [
+    new WindsurfPromptsStrategy(),
+    new ClaudeCodePromptsStrategy(),
+    new VSCodePromptsStrategy(),
+    new CodexPromptsStrategy(),
+];
+/**
+ * Parse rule frontmatter using auto-detection. Tries each strategy in priority order and uses the
+ * first one that detects its format. Falls back to generic parsing if no strategy matches.
+ *
+ * @param rawContent - Raw markdown content potentially containing front-matter
+ * @param strategy - Optional specific strategy to use (skips auto-detection)
+ * @returns Parsed frontmatter with unified metadata
+ */
+export function parseRuleFrontmatter(rawContent, strategy) {
+    // Use provided strategy if given
+    if (strategy?.parseFrontmatter) {
+        return strategy.parseFrontmatter(rawContent);
+    }
+    // Try auto-detection with priority order
+    for (const strat of RULES_STRATEGIES) {
+        if (strat.detectFormat?.(rawContent)) {
+            return strat.parseFrontmatter(rawContent);
+        }
+    }
+    // Fall back to generic parsing
+    return parseGenericRuleFrontmatter(rawContent);
+}
+/**
+ * Parse prompt frontmatter using auto-detection. Tries each strategy in priority order and uses
+ * the first one that detects its format. Falls back to generic parsing if no strategy matches.
+ *
+ * @param rawContent - Raw markdown content potentially containing front-matter
+ * @param strategy - Optional specific strategy to use (skips auto-detection)
+ * @returns Parsed frontmatter with unified fields
+ */
+export function parsePromptFrontmatter(rawContent, strategy) {
+    // Use provided strategy if given
+    if (strategy?.parseFrontmatter) {
+        return strategy.parseFrontmatter(rawContent);
+    }
+    // Try auto-detection with priority order
+    for (const strat of PROMPTS_STRATEGIES) {
+        if (strat.detectFormat?.(rawContent)) {
+            return strat.parseFrontmatter(rawContent);
+        }
+    }
+    // Fall back to generic parsing
+    return parseGenericPromptFrontmatter(rawContent);
+}
+/**
+ * Generic rule frontmatter parsing that handles common fields across editors.
+ * Used as fallback when no editor-specific format is detected.
+ */
+function parseGenericRuleFrontmatter(rawContent) {
+    const { frontmatter, content, hasFrontmatter } = extractFrontmatter(rawContent);
+    if (!hasFrontmatter) {
+        return { content: rawContent, metadata: {} };
+    }
+    const lines = frontmatter.split('\n'), description = parseYamlValue(lines, 'description'), globs = parseYamlValue(lines, 'globs'), paths = parseYamlValue(lines, 'paths'), trigger = parseYamlValue(lines, 'trigger'), alwaysApply = parseYamlValue(lines, 'alwaysApply');
+    // Parse globs from various sources
+    let globsArray;
+    if (typeof globs === 'string') {
+        globsArray = globs.split(',').map((g) => g.trim());
+    }
+    else if (Array.isArray(globs)) {
+        globsArray = globs;
+    }
+    else if (Array.isArray(paths)) {
+        globsArray = paths;
+    }
+    // Determine activation mode from various editor formats
+    let activation;
+    // Windsurf trigger values
+    const triggerToActivation = {
+        always_on: 'always',
+        model_decision: 'auto',
+        glob: 'glob',
+        manual: 'manual',
+    };
+    if (trigger && triggerToActivation[trigger]) {
+        activation = triggerToActivation[trigger];
+    }
+    else if (alwaysApply === true) {
+        activation = 'always';
+    }
+    else if (globsArray && globsArray.length > 0) {
+        activation = 'glob';
+    }
+    else if (alwaysApply === false) {
+        activation = description ? 'auto' : 'manual';
+    }
+    return {
+        content,
+        metadata: {
+            activation,
+            description,
+            globs: globsArray,
+        },
+    };
+}
+/**
+ * Generic prompt frontmatter parsing that handles common fields across editors.
+ * Used as fallback when no editor-specific format is detected.
+ */
+function parseGenericPromptFrontmatter(rawContent) {
+    const { frontmatter, content, hasFrontmatter } = extractFrontmatter(rawContent);
+    if (!hasFrontmatter) {
+        return { content: rawContent };
+    }
+    const lines = frontmatter.split('\n'), description = parseYamlValue(lines, 'description'), argumentHint = parseYamlValue(lines, 'argument-hint');
+    return {
+        content,
+        description,
+        argumentHint,
+    };
+}
+//# sourceMappingURL=frontmatter-parser.js.map

package/dist/frontmatter-parser.js.map

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

package/dist/frontmatter-utils.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Shared utilities for parsing YAML front-matter from markdown files. These low-level utilities are
+ * used by editor-specific strategies to implement their own frontmatter parsing.
+ */
+/**
+ * Result of extracting frontmatter from content.
+ */
+export interface ExtractedFrontmatter {
+    /** The frontmatter content (without delimiters) */
+    frontmatter: string;
+    /** The content after the frontmatter */
+    content: string;
+    /** Whether frontmatter was found */
+    hasFrontmatter: boolean;
+}
+/**
+ * Extract YAML frontmatter from markdown content.
+ * @param rawContent - Raw markdown content potentially containing front-matter
+ * @returns Extracted frontmatter and remaining content
+ */
+export declare function extractFrontmatter(rawContent: string): ExtractedFrontmatter;
+/**
+ * Parse a YAML value from frontmatter by key.
+ * @param lines - Array of frontmatter lines (joined back for YAML parsing)
+ * @param key - The key to look for
+ * @returns The parsed value, or undefined if not found
+ */
+export declare function parseYamlValue(lines: string[], key: string): string | boolean | string[] | undefined;
+/**
+ * Parse all key-value pairs from frontmatter into a raw object using the yaml library.
+ * Falls back to simple line-based parsing if YAML parsing fails (e.g., for unquoted glob patterns).
+ * @param frontmatter - The frontmatter content (without delimiters)
+ * @returns Object with all parsed key-value pairs
+ */
+export declare function parseAllFrontmatter(frontmatter: string): Record<string, unknown>;
+//# sourceMappingURL=frontmatter-utils.d.ts.map

package/dist/frontmatter-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-utils.d.ts","sourceRoot":"","sources":["../src/frontmatter-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IAClC,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,cAAc,EAAE,OAAO,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,oBAAoB,CAY3E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CAgBpG;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAahF"}

package/dist/frontmatter-utils.js

@@ -0,0 +1,109 @@
+/**
+ * Shared utilities for parsing YAML front-matter from markdown files. These low-level utilities are
+ * used by editor-specific strategies to implement their own frontmatter parsing.
+ */
+import { parse as parseYaml } from 'yaml';
+/**
+ * Extract YAML frontmatter from markdown content.
+ * @param rawContent - Raw markdown content potentially containing front-matter
+ * @returns Extracted frontmatter and remaining content
+ */
+export function extractFrontmatter(rawContent) {
+    const frontmatterMatch = rawContent.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?/);
+    if (!frontmatterMatch) {
+        return { frontmatter: '', content: rawContent, hasFrontmatter: false };
+    }
+    return {
+        frontmatter: frontmatterMatch[1],
+        content: rawContent.slice(frontmatterMatch[0].length).trim(),
+        hasFrontmatter: true,
+    };
+}
+/**
+ * Parse a YAML value from frontmatter by key.
+ * @param lines - Array of frontmatter lines (joined back for YAML parsing)
+ * @param key - The key to look for
+ * @returns The parsed value, or undefined if not found
+ */
+export function parseYamlValue(lines, key) {
+    const frontmatter = lines.join('\n'), parsed = parseAllFrontmatter(frontmatter), value = parsed[key];
+    if (value === undefined) {
+        return undefined;
+    }
+    // Return primitives and arrays directly
+    if (typeof value === 'string' || typeof value === 'boolean' || Array.isArray(value)) {
+        return value;
+    }
+    // Convert other types to string
+    return String(value);
+}
+/**
+ * Parse all key-value pairs from frontmatter into a raw object using the yaml library.
+ * Falls back to simple line-based parsing if YAML parsing fails (e.g., for unquoted glob patterns).
+ * @param frontmatter - The frontmatter content (without delimiters)
+ * @returns Object with all parsed key-value pairs
+ */
+export function parseAllFrontmatter(frontmatter) {
+    if (!frontmatter.trim()) {
+        return {};
+    }
+    try {
+        const parsed = parseYaml(frontmatter);
+        return parsed ?? {};
+    }
+    catch {
+        // Fall back to simple line-based parsing for edge cases like unquoted glob patterns
+        return parseSimpleFrontmatter(frontmatter);
+    }
+}
+/**
+ * Simple line-based frontmatter parser for cases where YAML parsing fails.
+ * Handles basic key: value pairs and YAML arrays.
+ */
+function parseSimpleFrontmatter(frontmatter) {
+    const result = {}, lines = frontmatter.split('\n');
+    let currentKey = null, arrayValues = [];
+    for (const line of lines) {
+        // Check for array item (indented with -)
+        const arrayItemMatch = line.match(/^\s+-\s+(.+)$/);
+        if (arrayItemMatch && currentKey) {
+            arrayValues.push(arrayItemMatch[1].trim());
+            continue;
+        }
+        // If we were collecting array values, store them
+        if (currentKey && arrayValues.length > 0) {
+            result[currentKey] = arrayValues;
+            arrayValues = [];
+            currentKey = null;
+        }
+        // Check for key: value pair
+        const keyValueMatch = line.match(/^([\w-]+):\s*(.*)$/);
+        if (!keyValueMatch) {
+            continue;
+        }
+        const key = keyValueMatch[1], rawValue = keyValueMatch[2].trim();
+        // Empty value means array starts on next line
+        if (!rawValue) {
+            currentKey = key;
+            arrayValues = [];
+            continue;
+        }
+        // Boolean values
+        if (rawValue === 'true') {
+            result[key] = true;
+        }
+        else if (rawValue === 'false') {
+            result[key] = false;
+        }
+        else {
+            // Remove surrounding quotes if present
+            result[key] = rawValue.replace(/^["']|["']$/g, '');
+        }
+    }
+    // Handle any remaining array values
+    if (currentKey && arrayValues.length > 0) {
+        result[currentKey] = arrayValues;
+    }
+    return result;
+}
+//# sourceMappingURL=frontmatter-utils.js.map

package/dist/frontmatter-utils.js.map

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

package/dist/git-download.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Create a unique directory name from a git template string. Includes the ref to avoid collisions
+ * between different branches/tags.
+ *
+ * @example "github:org/repo#main" → "org-repo-main-a1b2c3d4"
+ */
+export declare function createDownloadKey(template: string): string;
+/**
+ * Download a git template, run an operation, then clean up. Always cleans up after use - no
+ * persistent caching. This ensures the cache doesn't grow indefinitely and prevents stale data.
+ *
+ * @param template - Git template string (e.g., "github:org/repo#main")
+ * @param projectRoot - Project root for determining temp directory location
+ * @param operation - Async operation to run with the downloaded directory
+ * @returns Result of the operation
+ */
+export declare function withGitDownload<T>(template: string, projectRoot: string, operation: (dir: string) => Promise<T>): Promise<T>;
+//# sourceMappingURL=git-download.d.ts.map

package/dist/git-download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-download.d.ts","sourceRoot":"","sources":["../src/git-download.ts"],"names":[],"mappings":"AAQA;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAe1D;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,CAAC,EACpC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GACtC,OAAO,CAAC,CAAC,CAAC,CAgBZ"}

package/dist/git-download.js

@@ -0,0 +1,49 @@
+/**
+ * Safe git download utility with automatic cleanup.
+ */
+import { join } from 'pathe';
+import { downloadTemplate } from 'giget';
+import { safeRm } from './fs/safe-rm.js';
+import { getGitDownloadsDir } from './cache/paths.js';
+/**
+ * Create a unique directory name from a git template string. Includes the ref to avoid collisions
+ * between different branches/tags.
+ *
+ * @example "github:org/repo#main" → "org-repo-main-a1b2c3d4"
+ */
+export function createDownloadKey(template) {
+    // Parse template to extract components
+    // Format: "provider:user/repo/path#ref" or "provider:user/repo#ref"
+    const match = template.match(/^(?:github|gitlab|bitbucket):([^#]+)(?:#(.+))?$/);
+    if (match) {
+        const [, repoPath, ref = 'HEAD'] = match, safePath = repoPath.replace(/\//g, '-'), hash = Buffer.from(template).toString('base64url').slice(0, 8);
+        return `${safePath}-${ref}-${hash}`;
+    }
+    // Fallback for other formats (e.g., https URLs)
+    return Buffer.from(template).toString('base64url').slice(0, 32);
+}
+/**
+ * Download a git template, run an operation, then clean up. Always cleans up after use - no
+ * persistent caching. This ensures the cache doesn't grow indefinitely and prevents stale data.
+ *
+ * @param template - Git template string (e.g., "github:org/repo#main")
+ * @param projectRoot - Project root for determining temp directory location
+ * @param operation - Async operation to run with the downloaded directory
+ * @returns Result of the operation
+ */
+export async function withGitDownload(template, projectRoot, operation) {
+    const downloadKey = createDownloadKey(template), targetDir = join(getGitDownloadsDir(projectRoot), downloadKey);
+    try {
+        const { dir } = await downloadTemplate(template, {
+            dir: targetDir,
+            force: true,
+            forceClean: true,
+        });
+        return await operation(dir);
+    }
+    finally {
+        // Always clean up - no persistent cache
+        await safeRm(targetDir, { force: true }).catch(() => { });
+    }
+}
+//# sourceMappingURL=git-download.js.map

package/dist/git-download.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-download.js","sourceRoot":"","sources":["../src/git-download.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAC/C,uCAAuC;IACvC,oEAAoE;IACpE,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;IAEhF,IAAI,KAAK,EAAE,CAAC;QACT,MAAM,CAAC,EAAE,QAAQ,EAAE,GAAG,GAAG,MAAM,CAAC,GAAG,KAAK,EAClC,QAAQ,GAAG,QAAS,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,EACxC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAErE,OAAO,GAAG,QAAQ,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;IACvC,CAAC;IAED,gDAAgD;IAChD,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACnE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAClC,QAAgB,EAChB,WAAmB,EACnB,SAAsC;IAEtC,MAAM,WAAW,GAAG,iBAAiB,CAAC,QAAQ,CAAC,EACzC,SAAS,GAAG,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,CAAC;IAErE,IAAI,CAAC;QACF,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,gBAAgB,CAAC,QAAQ,EAAE;YAC9C,GAAG,EAAE,SAAS;YACd,KAAK,EAAE,IAAI;YACX,UAAU,EAAE,IAAI;SAClB,CAAC,CAAC;QAEH,OAAO,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;YAAS,CAAC;QACR,wCAAwC;QACxC,MAAM,MAAM,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC5D,CAAC;AACJ,CAAC"}

package/dist/import-writer.d.ts

@@ -1,37 +1,81 @@
-import type { EditorName } from './editors/types.js';
+import type { AiJsonConfig } from '@a1st/aix-schema';
+import type { GitSourceInfo } from './remote-loader.js';
 export interface WrittenImports {
     rules: Record<string, string>;
     prompts: Record<string, string>;
 }
+/** A rule with a suggested name for the output file. */
+export interface NamedRule {
+    content: string;
+    name: string;
+}
 export interface ImportContent {
-    rules: string[];
+    rules: NamedRule[];
     prompts: Record<string, string>;
 }
+export interface LocalizedConfig {
+    /** The config with paths updated to point to local copies */
+    config: Partial<AiJsonConfig>;
+    /** Number of files that were copied */
+    filesCopied: number;
+    /** Warnings about files that couldn't be copied */
+    warnings: 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>/`.
+ * Files are written to `.aix/.tmp/import-staging/` and path references
+ * point to the final location `.aix/imported/`.
  *
  * @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>;
+export declare function writeImportedContent(projectRoot: string, 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>;
+export declare function commitImport(projectRoot: string): 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>;
+export declare function rollbackImport(projectRoot: string): Promise<void>;
+/**
+ * Localize a remote config by copying referenced files to .aix/imported/ and updating paths.
+ * This handles rules, prompts, and skills that have relative path references.
+ *
+ * @param config - The remote config to localize
+ * @param configBaseDir - The base directory where the remote config's files are located
+ * @param projectRoot - The local project root where files should be copied to
+ * @returns The localized config with updated paths
+ */
+export declare function localizeRemoteConfig(config: Partial<AiJsonConfig>, configBaseDir: string, projectRoot: string): Promise<LocalizedConfig>;
+/** Result of converting relative paths to git references */
+export interface GitRefsConversionResult {
+    /** The config with relative paths converted to git references */
+    config: Partial<AiJsonConfig>;
+    /** Number of items converted to git references */
+    convertedCount: number;
+    /** Details of each converted reference for display */
+    converted: Array<{
+        name: string;
+        type: 'rule' | 'prompt' | 'skill';
+        gitRef: string;
+    }>;
+}
+/**
+ * Convert a config with relative paths to use git references instead.
+ * This is used when saving a remote git config with --save to preserve
+ * the git source rather than copying files locally.
+ *
+ * @param config - The config with relative paths
+ * @param gitSource - Git source metadata from the remote loader
+ * @returns The config with git references and conversion details
+ */
+export declare function convertToGitReferences(config: Partial<AiJsonConfig>, gitSource: GitSourceInfo): GitRefsConversionResult;
 //# sourceMappingURL=import-writer.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"import-writer.d.ts","sourceRoot":"","sources":["../src/import-writer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAOrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,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,wDAAwD;AACxD,MAAM,WAAW,SAAS;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC3B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC7B,6DAA6D;IAC7D,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC9B,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,QAAQ,EAAE,MAAM,EAAE,CAAC;CACrB;AAyBD;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACvC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,aAAa,GACtB,OAAO,CAAC,cAAc,CAAC,CA6CzB;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBrE;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAevE;AAsJD;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACvC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,EAC7B,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,GACnB,OAAO,CAAC,eAAe,CAAC,CAmC1B;AAyBD,4DAA4D;AAC5D,MAAM,WAAW,uBAAuB;IACrC,iEAAiE;IACjE,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC9B,kDAAkD;IAClD,cAAc,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxF;AAmCD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACnC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,EAC7B,SAAS,EAAE,aAAa,GACxB,uBAAuB,CA2GzB"}