@a1st/aix-core 0.0.3

package/dist/merge.js

@@ -0,0 +1,154 @@
+import { deepMergeJson } from './json.js';
+/**
+ * Filter a config to only include the specified scopes.
+ * @param config - Full config
+ * @param scopes - Scopes to include (if empty, returns empty partial)
+ * @returns Partial config with only specified sections
+ */
+export function filterConfigByScopes(config, scopes) {
+    if (scopes.length === 0) {
+        return {};
+    }
+    const result = {};
+    for (const scope of scopes) {
+        switch (scope) {
+            case 'rules':
+                if (config.rules) {
+                    result.rules = config.rules;
+                }
+                break;
+            case 'prompts':
+                if (config.prompts) {
+                    result.prompts = config.prompts;
+                }
+                break;
+            case 'mcp':
+                if (config.mcp) {
+                    result.mcp = config.mcp;
+                }
+                break;
+            case 'skills':
+                if (config.skills) {
+                    result.skills = config.skills;
+                }
+                break;
+            case 'editors':
+                if (config.editors) {
+                    result.editors = config.editors;
+                }
+                break;
+        }
+    }
+    return result;
+}
+/**
+ * Remove entries set to false from an object.
+ */
+function filterFalseValues(obj) {
+    const result = { ...obj };
+    for (const key of Object.keys(result)) {
+        if (result[key] === false) {
+            delete result[key];
+        }
+    }
+    return result;
+}
+/**
+ * Merge two object configs with key-level replacement and false-value support.
+ * - Keys are merged, but if same key exists in both, remote value replaces local entirely
+ * - If remote has `false`, the key is removed (disables the entry)
+ * - If local has `false` and remote has an object, the object wins (re-enables)
+ * - Final result has all `false` values filtered out
+ */
+function mergeWithFalseSupport(local, remote) {
+    if (!remote) {
+        return filterFalseValues((local ?? {}));
+    }
+    if (!local) {
+        return filterFalseValues(remote);
+    }
+    const merged = { ...local };
+    for (const [key, remoteValue] of Object.entries(remote)) {
+        if (remoteValue === false) {
+            // Remote wants to disable - remove the entry
+            delete merged[key];
+        }
+        else {
+            // Remote has a value - it wins (including over local false)
+            merged[key] = remoteValue;
+        }
+    }
+    return filterFalseValues(merged);
+}
+/**
+ * Merge two AiJsonConfig objects. Remote config wins on conflicts.
+ *
+ * Merge strategy:
+ * - `skills`: Object merge by key, replace entire value on key conflict
+ * - `rules`: Object merge by key, replace entire value on key conflict
+ * - `prompts`: Object merge by key, replace entire value on key conflict
+ * - `mcp`: Object merge by key, replace entire value on key conflict
+ * - `editors`: Object merge by key, deep merge on key conflict
+ * - `$schema`, `extends`: Remote wins
+ *
+ * @param local - Existing local config
+ * @param remote - Remote config to merge in (may be partial if scope-filtered)
+ * @returns Merged config
+ */
+export function mergeConfigs(local, remote) {
+    // Start with local as base
+    const result = { ...local };
+    // Merge skills (key-level replacement with false support)
+    if (remote.skills !== undefined) {
+        result.skills = mergeWithFalseSupport(local.skills, remote.skills);
+    }
+    // Merge rules (key-level replacement with false support)
+    if (remote.rules !== undefined) {
+        result.rules = mergeWithFalseSupport(local.rules, remote.rules);
+    }
+    // Merge prompts (key-level replacement with false support)
+    if (remote.prompts !== undefined) {
+        result.prompts = mergeWithFalseSupport(local.prompts, remote.prompts);
+    }
+    // Merge mcp (with false support for disabling servers)
+    if (remote.mcp !== undefined) {
+        result.mcp = mergeWithFalseSupport(local.mcp, remote.mcp);
+    }
+    // Merge editors (deep merge, remote wins on key conflict)
+    if (remote.editors !== undefined) {
+        // Handle both array and object forms - normalize to object for merging
+        const localEditors = normalizeEditors(local.editors), remoteEditors = normalizeEditors(remote.editors);
+        result.editors = deepMergeJson(localEditors, remoteEditors);
+    }
+    // Metadata fields: remote wins
+    if (remote.$schema !== undefined) {
+        result.$schema = remote.$schema;
+    }
+    if (remote.extends !== undefined) {
+        result.extends = remote.extends;
+    }
+    return result;
+}
+/**
+ * Normalize editors config to object form for merging.
+ * Array form: ["windsurf", { "cursor": {...} }] → { windsurf: { enabled: true }, cursor: {...} }
+ */
+function normalizeEditors(editors) {
+    if (!editors) {
+        return {};
+    }
+    if (Array.isArray(editors)) {
+        const result = {};
+        for (const item of editors) {
+            if (typeof item === 'string') {
+                result[item] = { enabled: true };
+            }
+            else {
+                Object.assign(result, item);
+            }
+        }
+        return result;
+    }
+    return editors;
+}
+//# sourceMappingURL=merge.js.map

package/dist/merge.js.map

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

package/dist/npm/index.d.ts

@@ -0,0 +1,2 @@
+export { resolveNpmPath, type NpmResolveOptions } from './resolve.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/npm/index.js

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

package/dist/npm/index.js.map

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

package/dist/npm/resolve.d.ts

@@ -0,0 +1,16 @@
+export interface NpmResolveOptions {
+    packageName: string;
+    subpath?: string;
+    version?: string;
+    projectRoot: string;
+}
+/**
+ * Resolve a path within an npm package.
+ * Returns the absolute filesystem path.
+ *
+ * Resolution modes:
+ * - No version: Resolve from project's node_modules only (error if not found)
+ * - With version: Auto-install to .aix/.tmp/node_modules cache
+ */
+export declare function resolveNpmPath(options: NpmResolveOptions): Promise<string>;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/npm/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/npm/resolve.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,iBAAiB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBhF"}

package/dist/npm/resolve.js

@@ -0,0 +1,42 @@
+import { dirname, join } from 'pathe';
+import { fileURLToPath } from 'node:url';
+import { ensureDependencyInstalled } from 'nypm';
+import { getAixDir, getNpmCacheDir } from '../cache/paths.js';
+/**
+ * Resolve a path within an npm package.
+ * Returns the absolute filesystem path.
+ *
+ * Resolution modes:
+ * - No version: Resolve from project's node_modules only (error if not found)
+ * - With version: Auto-install to .aix/.tmp/node_modules cache
+ */
+export async function resolveNpmPath(options) {
+    const { packageName, subpath, version, projectRoot } = options;
+    if (version) {
+        // Auto-install mode: install specific version to cache
+        const aixDir = getAixDir(projectRoot), packageSpec = `${packageName}@${version}`;
+        await ensureDependencyInstalled(packageSpec, { cwd: aixDir });
+        const cachedRoot = join(getNpmCacheDir(projectRoot), packageName);
+        return subpath ? join(cachedRoot, subpath) : cachedRoot;
+    }
+    // Node modules mode: require package to be installed
+    const packageRoot = await tryFindPackageRoot(packageName, projectRoot);
+    if (!packageRoot) {
+        throw new Error(`Package "${packageName}" not found in node_modules. ` +
+            'Either install it via npm/yarn/pnpm, or add a "version" field to auto-install.');
+    }
+    return subpath ? join(packageRoot, subpath) : packageRoot;
+}
+/**
+ * Find package root by resolving package.json
+ */
+async function tryFindPackageRoot(packageName, projectRoot) {
+    try {
+        const pkgJsonPath = import.meta.resolve(`${packageName}/package.json`, `file://${projectRoot}/`);
+        return dirname(fileURLToPath(pkgJsonPath));
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=resolve.js.map

package/dist/npm/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/npm/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,yBAAyB,EAAE,MAAM,MAAM,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAS9D;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAA0B;IAC5D,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAE/D,IAAI,OAAO,EAAE,CAAC;QACX,uDAAuD;QACvD,MAAM,MAAM,GAAG,SAAS,CAAC,WAAW,CAAC,EAC/B,WAAW,GAAG,GAAG,WAAW,IAAI,OAAO,EAAE,CAAC;QAEhD,MAAM,yBAAyB,CAAC,WAAW,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;QAE9D,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,CAAC;QAElE,OAAO,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;IAC3D,CAAC;IAED,qDAAqD;IACrD,MAAM,WAAW,GAAG,MAAM,kBAAkB,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IAEvE,IAAI,CAAC,WAAW,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CACZ,YAAY,WAAW,+BAA+B;YACnD,gFAAgF,CACrF,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,kBAAkB,CAC9B,WAAmB,EACnB,WAAmB;IAEnB,IAAI,CAAC;QACF,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,WAAW,eAAe,EAAE,UAAU,WAAW,GAAG,CAAC,CAAC;QAEjG,OAAO,OAAO,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACN,OAAO,SAAS,CAAC;IACpB,CAAC;AACJ,CAAC"}

package/dist/prompts/index.d.ts

@@ -0,0 +1,2 @@
+export { loadPrompt, loadPrompts, type LoadedPrompt } from './loader.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/prompts/index.js

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

package/dist/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAqB,MAAM,aAAa,CAAC"}

package/dist/prompts/loader.d.ts

@@ -0,0 +1,23 @@
+import type { PromptValue, PromptsConfig } from '@a1st/aix-schema';
+export interface LoadedPrompt {
+    name: string;
+    content: string;
+    description?: string;
+    argumentHint?: string;
+    sourcePath?: string;
+}
+/**
+ * Load a single prompt from any source.
+ * @param name - The prompt name (key from the prompts object)
+ * @param value - The prompt value (string shorthand or object)
+ * @param basePath - Base path for resolving relative paths
+ */
+export declare function loadPrompt(name: string, value: PromptValue, basePath: string): Promise<LoadedPrompt>;
+/**
+ * Load all prompts from a prompts config object.
+ * @param prompts - Prompts config object (keyed by name)
+ * @param basePath - Base path for resolving relative paths
+ * @returns Record of loaded prompts keyed by name
+ */
+export declare function loadPrompts(prompts: PromptsConfig, basePath: string): Promise<Record<string, LoadedPrompt>>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/prompts/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/prompts/loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAgB,WAAW,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAkCjF,MAAM,WAAW,YAAY;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC7B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,MAAM,GAChB,OAAO,CAAC,YAAY,CAAC,CAuEvB;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAC9B,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAavC"}

package/dist/prompts/loader.js

@@ -0,0 +1,115 @@
+import { readFile } from 'node:fs/promises';
+import { resolve, dirname } from 'pathe';
+import { tmpdir } from 'node:os';
+import { normalizeSourceRef } from '@a1st/aix-schema';
+import { getPromptsCacheDir } from '../cache/paths.js';
+import { loadFromGit } from '../git-loader.js';
+import { resolveNpmPath } from '../npm/resolve.js';
+/**
+ * Strip YAML frontmatter from markdown content and optionally extract metadata.
+ * Returns the content without frontmatter and any extracted metadata.
+ */
+function stripFrontmatter(content) {
+    const frontmatterMatch = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n/);
+    if (!frontmatterMatch) {
+        return { content };
+    }
+    const frontmatterContent = frontmatterMatch[1];
+    const contentWithoutFrontmatter = content.slice(frontmatterMatch[0].length);
+    // Parse simple key: value pairs from frontmatter
+    const metadata = {};
+    for (const line of frontmatterContent.split('\n')) {
+        const match = line.match(/^([\w-]+):\s*["']?([^"']*)["']?\s*$/);
+        if (match) {
+            metadata[match[1]] = match[2];
+        }
+    }
+    return { content: contentWithoutFrontmatter.trim(), metadata };
+}
+/**
+ * Load a single prompt from any source.
+ * @param name - The prompt name (key from the prompts object)
+ * @param value - The prompt value (string shorthand or object)
+ * @param basePath - Base path for resolving relative paths
+ */
+export async function loadPrompt(name, value, basePath) {
+    // Normalize string shorthand transparently
+    const promptObj = typeof value === 'string' ? normalizeSourceRef(value) : value;
+    const base = {
+        name,
+        description: promptObj.description,
+        argumentHint: promptObj.argumentHint,
+    };
+    // Inline content
+    if (promptObj.content) {
+        return {
+            ...base,
+            content: promptObj.content,
+        };
+    }
+    // Local file
+    if (promptObj.path) {
+        const fullPath = resolve(dirname(basePath), promptObj.path);
+        const rawContent = await readFile(fullPath, 'utf-8');
+        const { content, metadata } = stripFrontmatter(rawContent.trim());
+        return {
+            ...base,
+            // Use frontmatter description if not explicitly provided
+            description: base.description ?? metadata?.description,
+            content,
+            sourcePath: fullPath,
+        };
+    }
+    // Git repository
+    if (promptObj.git) {
+        const baseDir = dirname(basePath) || tmpdir();
+        const result = await loadFromGit({
+            git: promptObj.git,
+            cacheDir: getPromptsCacheDir(baseDir),
+            defaultFilePath: 'prompt.md',
+        });
+        const { content, metadata } = stripFrontmatter(result.content);
+        return {
+            ...base,
+            // Use frontmatter description if not explicitly provided
+            description: base.description ?? metadata?.description,
+            content,
+            sourcePath: result.sourcePath,
+        };
+    }
+    // NPM package
+    if (promptObj.npm) {
+        const filePath = await resolveNpmPath({
+            packageName: promptObj.npm.npm,
+            subpath: promptObj.npm.path,
+            version: promptObj.npm.version,
+            projectRoot: dirname(basePath),
+        });
+        const rawContent = await readFile(filePath, 'utf-8');
+        const { content, metadata } = stripFrontmatter(rawContent.trim());
+        return {
+            ...base,
+            description: base.description ?? metadata?.description,
+            content,
+            sourcePath: filePath,
+        };
+    }
+    throw new Error(`Invalid prompt "${name}": no content source found`);
+}
+/**
+ * Load all prompts from a prompts config object.
+ * @param prompts - Prompts config object (keyed by name)
+ * @param basePath - Base path for resolving relative paths
+ * @returns Record of loaded prompts keyed by name
+ */
+export async function loadPrompts(prompts, basePath) {
+    // Filter out false values (disabled prompts)
+    const entries = Object.entries(prompts).filter(([, value]) => value !== false);
+    const loadedEntries = await Promise.all(entries.map(async ([name, value]) => {
+        // Type assertion safe because we filtered out false above
+        const loaded = await loadPrompt(name, value, basePath);
+        return [name, loaded];
+    }));
+    return Object.fromEntries(loadedEntries);
+}
+//# sourceMappingURL=loader.js.map

package/dist/prompts/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/prompts/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;;GAGG;AACH,SAAS,gBAAgB,CAAC,OAAe;IACtC,MAAM,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;IAE3E,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACrB,OAAO,EAAE,OAAO,EAAE,CAAC;IACtB,CAAC;IAED,MAAM,kBAAkB,GAAG,gBAAgB,CAAC,CAAC,CAAE,CAAC;IAChD,MAAM,yBAAyB,GAAG,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAE5E,iDAAiD;IACjD,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAE5C,KAAK,MAAM,IAAI,IAAI,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACjD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;QAEhE,IAAI,KAAK,EAAE,CAAC;YACT,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACnC,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,yBAAyB,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC;AAClE,CAAC;AAUD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC7B,IAAY,EACZ,KAAkB,EAClB,QAAgB;IAEhB,2CAA2C;IAC3C,MAAM,SAAS,GAAiB,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC9F,MAAM,IAAI,GAAG;QACV,IAAI;QACJ,WAAW,EAAE,SAAS,CAAC,WAAW;QAClC,YAAY,EAAE,SAAS,CAAC,YAAY;KACtC,CAAC;IAEF,iBAAiB;IACjB,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;QACrB,OAAO;YACJ,GAAG,IAAI;YACP,OAAO,EAAE,SAAS,CAAC,OAAO;SAC5B,CAAC;IACL,CAAC;IAED,aAAa;IACb,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC;QAClB,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QAC5D,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,gBAAgB,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;QAElE,OAAO;YACJ,GAAG,IAAI;YACP,yDAAyD;YACzD,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,QAAQ,EAAE,WAAW;YACtD,OAAO;YACP,UAAU,EAAE,QAAQ;SACtB,CAAC;IACL,CAAC;IAED,iBAAiB;IACjB,IAAI,SAAS,CAAC,GAAG,EAAE,CAAC;QACjB,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,MAAM,EAAE,CAAC;QAC9C,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC;YAC9B,GAAG,EAAE,SAAS,CAAC,GAAG;YAClB,QAAQ,EAAE,kBAAkB,CAAC,OAAO,CAAC;YACrC,eAAe,EAAE,WAAW;SAC9B,CAAC,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAE/D,OAAO;YACJ,GAAG,IAAI;YACP,yDAAyD;YACzD,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,QAAQ,EAAE,WAAW;YACtD,OAAO;YACP,UAAU,EAAE,MAAM,CAAC,UAAU;SAC/B,CAAC;IACL,CAAC;IAED,cAAc;IACd,IAAI,SAAS,CAAC,GAAG,EAAE,CAAC;QACjB,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC;YACnC,WAAW,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG;YAC9B,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,IAAI;YAC3B,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,OAAO;YAC9B,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC;SAChC,CAAC,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,gBAAgB,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;QAElE,OAAO;YACJ,GAAG,IAAI;YACP,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,QAAQ,EAAE,WAAW;YACtD,OAAO;YACP,UAAU,EAAE,QAAQ;SACtB,CAAC;IACL,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,4BAA4B,CAAC,CAAC;AACxE,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC9B,OAAsB,EACtB,QAAgB;IAEhB,6CAA6C;IAC7C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;IAC/E,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,GAAG,CACpC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE;QACjC,0DAA0D;QAC1D,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,KAAqC,EAAE,QAAQ,CAAC,CAAC;QAEvF,OAAO,CAAC,IAAI,EAAE,MAAM,CAAU,CAAC;IAClC,CAAC,CAAC,CACJ,CAAC;IAEF,OAAO,MAAM,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;AAC5C,CAAC"}

package/dist/remote-loader.d.ts

@@ -0,0 +1,29 @@
+export type RemoteSourceType = 'url' | 'git' | 'local';
+export interface RemoteLoadResult {
+    /** Parsed config content */
+    content: Record<string, unknown>;
+    /** Base path/URL for resolving relative extends */
+    baseUrl: string;
+    /** Source type */
+    source: RemoteSourceType;
+    /** Whether the base is a remote URL (for extends resolution) */
+    isRemote: boolean;
+}
+/**
+ * Load config from a remote URL (direct or blob URL).
+ */
+export declare function loadFromUrl(url: string): Promise<RemoteLoadResult>;
+/**
+ * Load config from git shorthand (github:org/repo, github:org/repo/path#ref, etc.).
+ * If no path is specified, looks for ai.json at repo root.
+ */
+export declare function loadFromGitShorthand(input: string): Promise<RemoteLoadResult>;
+/**
+ * Load config from a local file path.
+ */
+export declare function loadFromLocalPath(path: string, cwd?: string): RemoteLoadResult;
+/**
+ * Classify and load config from any source type.
+ */
+export declare function loadFromSource(source: string, cwd?: string): Promise<RemoteLoadResult>;
+//# sourceMappingURL=remote-loader.d.ts.map

package/dist/remote-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-loader.d.ts","sourceRoot":"","sources":["../src/remote-loader.ts"],"names":[],"mappings":"AAuBA,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,CAAC;AAEvD,MAAM,WAAW,gBAAgB;IAC9B,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,MAAM,EAAE,gBAAgB,CAAC;IACzB,gEAAgE;IAChE,QAAQ,EAAE,OAAO,CAAC;CACpB;AA4BD;;GAEG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA4BxE;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAwDnF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,gBAAgB,CAoB7F;AA+DD;;GAEG;AACH,wBAAsB,cAAc,CACjC,MAAM,EAAE,MAAM,EACd,GAAG,GAAE,MAAsB,GAC3B,OAAO,CAAC,gBAAgB,CAAC,CAiC3B"}

package/dist/remote-loader.js

@@ -0,0 +1,208 @@
+/**
+ * Remote config loading utilities for fetching ai.json from URLs, git repos, and local paths.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve, dirname } from 'pathe';
+import { downloadTemplate } from 'giget';
+import { parseJsonc } from '@a1st/aix-schema';
+import { convertBlobToRawUrl, parseGitShorthand, parseGitHubRepoUrl, parseGitHubBlobUrl, parseGitLabBlobUrl, parseBitbucketBlobUrl, isLocalPath, } from './url-parsing.js';
+import { ConfigNotFoundError, ConfigParseError, RemoteFetchError, UnsupportedUrlError, } from './errors.js';
+const FETCH_TIMEOUT_MS = 30000;
+/**
+ * Fetch content from a URL with timeout.
+ */
+async function fetchWithTimeout(url, timeoutMs = FETCH_TIMEOUT_MS) {
+    const controller = new AbortController(), timeout = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetch(url, { signal: controller.signal });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        return response.text();
+    }
+    catch (error) {
+        if (error instanceof Error && error.name === 'AbortError') {
+            throw new Error(`Request timed out after ${timeoutMs}ms`, { cause: error });
+        }
+        throw error;
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+/**
+ * Load config from a remote URL (direct or blob URL).
+ */
+export async function loadFromUrl(url) {
+    const rawUrl = convertBlobToRawUrl(url);
+    let content;
+    try {
+        content = await fetchWithTimeout(rawUrl);
+    }
+    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);
+    }
+    // Compute base URL for relative extends (directory containing the file)
+    const baseUrl = rawUrl.substring(0, rawUrl.lastIndexOf('/') + 1);
+    return {
+        content: result.data,
+        baseUrl,
+        source: 'url',
+        isRemote: true,
+    };
+}
+/**
+ * Load config from git shorthand (github:org/repo, github:org/repo/path#ref, etc.).
+ * If no path is specified, looks for ai.json at repo root.
+ */
+export async function loadFromGitShorthand(input) {
+    const parsed = parseGitShorthand(input);
+    if (!parsed) {
+        throw new ConfigParseError(`Invalid git shorthand: ${input}`, input);
+    }
+    // Build the giget template string
+    let template = `${parsed.provider}:${parsed.user}/${parsed.repo}`;
+    if (parsed.subpath) {
+        template += `/${parsed.subpath}`;
+    }
+    if (parsed.ref) {
+        template += `#${parsed.ref}`;
+    }
+    let dir;
+    try {
+        const result = await downloadTemplate(template, { force: true, cwd: process.cwd() });
+        dir = result.dir;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new RemoteFetchError(input, message);
+    }
+    // Look for ai.json - if subpath ends with .json, use it directly; otherwise look for ai.json in dir
+    let configPath;
+    if (parsed.subpath?.endsWith('.json')) {
+        // The subpath itself is the config file
+        configPath = resolve(dir, parsed.subpath.split('/').pop());
+    }
+    else {
+        configPath = resolve(dir, 'ai.json');
+    }
+    if (!existsSync(configPath)) {
+        throw new ConfigNotFoundError(configPath);
+    }
+    const content = readFileSync(configPath, 'utf-8'), result = parseJsonc(content);
+    if (result.errors.length > 0) {
+        throw new ConfigParseError(`Parse error: ${result.errors[0]?.message}`, configPath);
+    }
+    return {
+        content: result.data,
+        baseUrl: dirname(configPath),
+        source: 'git',
+        isRemote: false, // Local filesystem after download
+    };
+}
+/**
+ * Load config from a local file path.
+ */
+export function loadFromLocalPath(path, cwd = process.cwd()) {
+    const absolutePath = resolve(cwd, path);
+    if (!existsSync(absolutePath)) {
+        throw new ConfigNotFoundError(absolutePath);
+    }
+    const content = readFileSync(absolutePath, 'utf-8'), result = parseJsonc(content);
+    if (result.errors.length > 0) {
+        throw new ConfigParseError(`Parse error: ${result.errors[0]?.message}`, absolutePath);
+    }
+    return {
+        content: result.data,
+        baseUrl: dirname(absolutePath),
+        source: 'local',
+        isRemote: false,
+    };
+}
+/**
+ * Check if a URL points directly to a file (blob URL or direct file URL).
+ */
+function isDirectFileUrl(url) {
+    // Check for blob URLs
+    if (parseGitHubBlobUrl(url) || parseGitLabBlobUrl(url) || parseBitbucketBlobUrl(url)) {
+        return true;
+    }
+    // Check for direct file URLs (ending in .json)
+    if (url.endsWith('.json')) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Load config from a GitHub/GitLab/Bitbucket repo URL (not a blob URL).
+ * Downloads the repo and looks for ai.json at the root.
+ */
+async function loadFromRepoUrl(url) {
+    // Try to parse as GitHub repo URL
+    const ghRepo = parseGitHubRepoUrl(url);
+    if (ghRepo) {
+        return loadFromGitShorthand(`github:${ghRepo.owner}/${ghRepo.repo}`);
+    }
+    // For other repo URLs, try using giget directly
+    let dir;
+    try {
+        const result = await downloadTemplate(url, { force: true, cwd: process.cwd() });
+        dir = result.dir;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new RemoteFetchError(url, message);
+    }
+    const configPath = resolve(dir, 'ai.json');
+    if (!existsSync(configPath)) {
+        throw new ConfigNotFoundError(configPath);
+    }
+    const content = readFileSync(configPath, 'utf-8'), result = parseJsonc(content);
+    if (result.errors.length > 0) {
+        throw new ConfigParseError(`Parse error: ${result.errors[0]?.message}`, configPath);
+    }
+    return {
+        content: result.data,
+        baseUrl: dirname(configPath),
+        source: 'git',
+        isRemote: false,
+    };
+}
+/**
+ * Classify and load config from any source type.
+ */
+export async function loadFromSource(source, cwd = process.cwd()) {
+    // Git shorthand: github:org/repo, gitlab:org/repo, bitbucket:org/repo
+    if (source.startsWith('github:') || source.startsWith('gitlab:') || source.startsWith('bitbucket:')) {
+        return loadFromGitShorthand(source);
+    }
+    // HTTPS URL
+    if (source.startsWith('https://')) {
+        // If it's a direct file URL (blob or .json), fetch it
+        if (isDirectFileUrl(source)) {
+            return loadFromUrl(source);
+        }
+        // Otherwise, treat as repo URL and clone it
+        return loadFromRepoUrl(source);
+    }
+    // HTTP URL (reject for security)
+    if (source.startsWith('http://')) {
+        throw new UnsupportedUrlError(source);
+    }
+    // Local path (relative or absolute)
+    if (isLocalPath(source)) {
+        return loadFromLocalPath(source, cwd);
+    }
+    // If it looks like a file path without ./ prefix, try it as local
+    if (source.includes('/') || source.endsWith('.json')) {
+        return loadFromLocalPath(source, cwd);
+    }
+    // Unknown format
+    throw new UnsupportedUrlError(source);
+}
+//# sourceMappingURL=remote-loader.js.map