@a1st/aix-core 0.0.3

package/dist/skills/cache.js

@@ -0,0 +1,20 @@
+import { mkdir } from 'node:fs/promises';
+import { getNpmCacheDir } from '../cache/paths.js';
+import { safeRm } from '../fs/safe-rm.js';
+/**
+ * Ensure the npm cache directory exists.
+ */
+export async function ensureNpmCacheDir(projectRoot) {
+    const path = getNpmCacheDir(projectRoot);
+    await mkdir(path, { recursive: true });
+    return path;
+}
+/**
+ * Clear the npm skills cache.
+ * Note: Git skills cache is managed by giget and not cleared here.
+ */
+export async function clearNpmCache(projectRoot) {
+    const cacheDir = getNpmCacheDir(projectRoot);
+    await safeRm(cacheDir, { force: true });
+}
+//# sourceMappingURL=cache.js.map

package/dist/skills/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/skills/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,WAAmB;IACxD,MAAM,IAAI,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IAEzC,MAAM,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,OAAO,IAAI,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,WAAmB;IACpD,MAAM,QAAQ,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IAE7C,MAAM,MAAM,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAC3C,CAAC"}

package/dist/skills/index.d.ts

@@ -0,0 +1,9 @@
+export { parseSkillMd } from './parser.js';
+export { parseSkillRef, type LocalRef, type GitRef, type NpmRef, type SkillRef, } from './reference-parser.js';
+export { resolveLocal } from './resolvers/local.js';
+export { resolveGit } from './resolvers/git.js';
+export { resolveNpm } from './resolvers/npm.js';
+export { resolveSkill, resolveSkillRef, resolveAllSkills, type SkillResolveOptions } from './resolve.js';
+export { validateSkill, type ValidationResult } from './validate.js';
+export { ensureNpmCacheDir, clearNpmCache } from './cache.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EACJ,aAAa,EACb,KAAK,QAAQ,EACb,KAAK,MAAM,EACX,KAAK,MAAM,EACX,KAAK,QAAQ,GACf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACzG,OAAO,EAAE,aAAa,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/skills/index.js

@@ -0,0 +1,9 @@
+export { parseSkillMd } from './parser.js';
+export { parseSkillRef, } from './reference-parser.js';
+export { resolveLocal } from './resolvers/local.js';
+export { resolveGit } from './resolvers/git.js';
+export { resolveNpm } from './resolvers/npm.js';
+export { resolveSkill, resolveSkillRef, resolveAllSkills } from './resolve.js';
+export { validateSkill } from './validate.js';
+export { ensureNpmCacheDir, clearNpmCache } from './cache.js';
+//# sourceMappingURL=index.js.map

package/dist/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EACJ,aAAa,GAKf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAA4B,MAAM,cAAc,CAAC;AACzG,OAAO,EAAE,aAAa,EAAyB,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/skills/parser.d.ts

@@ -0,0 +1,6 @@
+import { type ParsedSkill } from '@a1st/aix-schema';
+/**
+ * Parse a SKILL.md file from a skill directory
+ */
+export declare function parseSkillMd(skillPath: string, source: ParsedSkill['source']): Promise<ParsedSkill>;
+//# sourceMappingURL=parser.d.ts.map

package/dist/skills/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/skills/parser.ts"],"names":[],"mappings":"AAGA,OAAO,EAA0B,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAI5E;;GAEG;AACH,wBAAsB,YAAY,CAC/B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,GAC7B,OAAO,CAAC,WAAW,CAAC,CA0BtB"}

package/dist/skills/parser.js

@@ -0,0 +1,28 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'pathe';
+import { parse as parseYaml } from 'yaml';
+import { skillFrontmatterSchema } from '@a1st/aix-schema';
+const FRONTMATTER_REGEX = /^---\n([\s\S]*?)\n---\n([\s\S]*)$/;
+/**
+ * Parse a SKILL.md file from a skill directory
+ */
+export async function parseSkillMd(skillPath, source) {
+    const skillMdPath = join(skillPath, 'SKILL.md');
+    const content = await readFile(skillMdPath, 'utf-8');
+    const match = content.match(FRONTMATTER_REGEX);
+    if (!match) {
+        throw new Error(`Invalid SKILL.md format: missing frontmatter in ${skillMdPath}`);
+    }
+    const yamlContent = match[1], body = match[2];
+    if (!yamlContent || body === undefined) {
+        throw new Error(`Invalid SKILL.md format: could not parse frontmatter in ${skillMdPath}`);
+    }
+    const rawFrontmatter = parseYaml(yamlContent), frontmatter = skillFrontmatterSchema.parse(rawFrontmatter);
+    return {
+        frontmatter,
+        body: body.trim(),
+        basePath: skillPath,
+        source,
+    };
+}
+//# sourceMappingURL=parser.js.map

package/dist/skills/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../src/skills/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAC7B,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EAAE,sBAAsB,EAAoB,MAAM,kBAAkB,CAAC;AAE5E,MAAM,iBAAiB,GAAG,mCAAmC,CAAC;AAE9D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAC/B,SAAiB,EACjB,MAA6B;IAE7B,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAErD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAE/C,IAAI,CAAC,KAAK,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,mDAAmD,WAAW,EAAE,CAAC,CAAC;IACrF,CAAC;IAED,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,EACtB,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAEtB,IAAI,CAAC,WAAW,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,2DAA2D,WAAW,EAAE,CAAC,CAAC;IAC7F,CAAC;IAED,MAAM,cAAc,GAAG,SAAS,CAAC,WAAW,CAAY,EAClD,WAAW,GAAG,sBAAsB,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAEjE,OAAO;QACJ,WAAW;QACX,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;QACjB,QAAQ,EAAE,SAAS;QACnB,MAAM;KACR,CAAC;AACL,CAAC"}

package/dist/skills/reference-parser.d.ts

@@ -0,0 +1,23 @@
+export type LocalRef = {
+    type: 'local';
+    path: string;
+};
+export type GitRef = {
+    type: 'git';
+    url: string;
+    ref?: string;
+    path?: string;
+};
+export type NpmRef = {
+    type: 'npm';
+    packageName: string;
+    path?: string;
+    version?: string;
+};
+export type SkillRef = LocalRef | GitRef | NpmRef;
+/**
+ * Parse a skill reference into a structured object.
+ * Supports local paths, git shorthand, git objects, and npm package names.
+ */
+export declare function parseSkillRef(name: string, input: unknown): SkillRef;
+//# sourceMappingURL=reference-parser.d.ts.map

package/dist/skills/reference-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-parser.d.ts","sourceRoot":"","sources":["../../src/skills/reference-parser.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AACvD,MAAM,MAAM,MAAM,GAAG;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAC/E,MAAM,MAAM,MAAM,GAAG;IAClB,IAAI,EAAE,KAAK,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AACF,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AA8HlD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,QAAQ,CAgEpE"}

package/dist/skills/reference-parser.js

@@ -0,0 +1,162 @@
+/**
+ * Check if a string looks like an npm package name (without subpath).
+ * Matches: aix-skill-*, @scope/aix-skill-*, or any scoped/unscoped package
+ */
+function isNpmPackageName(str) {
+    // Scoped package: @scope/package (exactly two parts)
+    if (str.startsWith('@')) {
+        const parts = str.split('/');
+        return parts.length === 2;
+    }
+    // aix-skill- prefix (our convention)
+    if (str.startsWith('aix-skill-')) {
+        return true;
+    }
+    // Any other package name (no path separators, no git prefixes)
+    return !str.includes('/') && !str.includes(':') && !str.startsWith('.');
+}
+/**
+ * Parse npm package reference with optional subpath.
+ * Requires file extension to distinguish from plain package names.
+ *
+ * Examples:
+ * - "@scope/pkg/rules/style.md" → { packageName: "@scope/pkg", path: "rules/style.md" }
+ * - "pkg/prompts/review.md" → { packageName: "pkg", path: "prompts/review.md" }
+ * - "@scope/pkg" → { packageName: "@scope/pkg" } (no subpath)
+ */
+function parseNpmWithSubpath(str) {
+    // Must have a file extension to be treated as having a subpath
+    const hasExtension = /\.[a-z0-9]+$/i.test(str);
+    if (str.startsWith('@')) {
+        // Scoped: @scope/package or @scope/package/subpath
+        const parts = str.split('/');
+        if (parts.length < 2) {
+            return undefined;
+        }
+        const packageName = `${parts[0]}/${parts[1]}`;
+        if (parts.length === 2) {
+            return { packageName };
+        }
+        // Has subpath - only valid if has extension
+        if (!hasExtension) {
+            return undefined;
+        }
+        return { packageName, path: parts.slice(2).join('/') };
+    }
+    // Unscoped: package or package/subpath
+    const slashIdx = str.indexOf('/');
+    if (slashIdx === -1) {
+        return { packageName: str };
+    }
+    // Has subpath - only valid if has extension
+    if (!hasExtension) {
+        return undefined;
+    }
+    return {
+        packageName: str.slice(0, slashIdx),
+        path: str.slice(slashIdx + 1),
+    };
+}
+/**
+ * Parse git shorthand format: github:user/repo/path#ref or github:user/repo#ref:path
+ * Supported providers: github, gitlab
+ *
+ * Two path formats are supported:
+ * 1. Path in repo portion: github:user/repo/subdir/path#ref
+ * 2. Path after ref: github:user/repo#ref:subdir/path
+ */
+function parseGitShorthand(input) {
+    // Match: github:user/repo or gitlab:user/repo with optional /path and #ref
+    const match = input.match(/^(github|gitlab):([^#]+)(?:#(.+))?$/);
+    if (!match) {
+        return undefined;
+    }
+    const [, provider, repoPath, refAndPath] = match;
+    // Split repo path: user/repo/optional/subpath
+    const parts = repoPath?.split('/') ?? [];
+    if (parts.length < 2) {
+        return undefined;
+    }
+    const user = parts[0], repo = parts[1], subpathFromRepo = parts.length > 2 ? parts.slice(2).join('/') : undefined;
+    // Parse ref and path - supports both #ref and #ref:path formats
+    let ref, subpathFromRef;
+    if (refAndPath) {
+        const colonIdx = refAndPath.indexOf(':');
+        if (colonIdx !== -1) {
+            // Format: #ref:path
+            ref = refAndPath.slice(0, colonIdx);
+            subpathFromRef = refAndPath.slice(colonIdx + 1);
+        }
+        else {
+            // Format: #ref (no path)
+            ref = refAndPath;
+        }
+    }
+    // Use path from ref portion if present, otherwise from repo portion
+    const path = subpathFromRef ?? subpathFromRepo;
+    return {
+        type: 'git',
+        url: `https://${provider}.com/${user}/${repo}`,
+        ref,
+        path,
+    };
+}
+/**
+ * Parse a skill reference into a structured object.
+ * Supports local paths, git shorthand, git objects, and npm package names.
+ */
+export function parseSkillRef(name, input) {
+    // Handle false/disabled skills
+    if (input === false) {
+        throw new Error(`Skill "${name}" is disabled`);
+    }
+    if (typeof input === 'string') {
+        // Local path
+        if (input.startsWith('./') || input.startsWith('/') || input.startsWith('../')) {
+            return { type: 'local', path: input };
+        }
+        // Git shorthand (github:user/repo, gitlab:user/repo)
+        const gitRef = parseGitShorthand(input);
+        if (gitRef) {
+            return gitRef;
+        }
+        // NPM package (possibly with subpath)
+        const npmParsed = parseNpmWithSubpath(input);
+        if (npmParsed &&
+            (isNpmPackageName(npmParsed.packageName) || npmParsed.packageName.startsWith('@'))) {
+            return { type: 'npm', ...npmParsed };
+        }
+        throw new Error(`Cannot determine skill reference type for "${name}": ${input}`);
+    }
+    if (typeof input === 'object' && input !== null) {
+        const obj = input;
+        // Check git first (git objects may also have a path property for subdirectory)
+        if ('git' in obj && typeof obj.git === 'string') {
+            return {
+                type: 'git',
+                url: obj.git,
+                ref: typeof obj.ref === 'string' ? obj.ref : undefined,
+                path: typeof obj.path === 'string' ? obj.path : undefined,
+            };
+        }
+        // NPM package (check before path since npm objects may also have a path property)
+        if ('npm' in obj && typeof obj.npm === 'string') {
+            return {
+                type: 'npm',
+                packageName: obj.npm,
+                path: typeof obj.path === 'string' ? obj.path : undefined,
+                version: typeof obj.version === 'string' ? obj.version : undefined,
+            };
+        }
+        // Local path (only if no git or npm property)
+        if ('path' in obj && typeof obj.path === 'string') {
+            return { type: 'local', path: obj.path };
+        }
+        // Handle source wrapper object
+        if ('source' in obj) {
+            return parseSkillRef(name, obj.source);
+        }
+    }
+    throw new Error(`Invalid skill reference for "${name}": ${JSON.stringify(input)}`);
+}
+//# sourceMappingURL=reference-parser.js.map

package/dist/skills/reference-parser.js.map

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

package/dist/skills/resolve.d.ts

@@ -0,0 +1,21 @@
+import type { ParsedSkill } from '@a1st/aix-schema';
+import { type SkillRef } from './reference-parser.js';
+export interface SkillResolveOptions {
+    /** Base directory for resolving relative paths */
+    baseDir: string;
+    /** Project root for npm resolution */
+    projectRoot?: string;
+}
+/**
+ * Resolve a skill reference to a parsed skill
+ */
+export declare function resolveSkill(name: string, ref: unknown, options: SkillResolveOptions): Promise<ParsedSkill>;
+/**
+ * Resolve a parsed skill reference
+ */
+export declare function resolveSkillRef(ref: SkillRef, baseDir: string, projectRoot: string): Promise<ParsedSkill>;
+/**
+ * Resolve all skills from a config's skills map
+ */
+export declare function resolveAllSkills(skills: Record<string, unknown>, options: SkillResolveOptions): Promise<Map<string, ParsedSkill>>;
+//# sourceMappingURL=resolve.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/skills/resolve.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAiB,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAKrE,MAAM,WAAW,mBAAmB;IACjC,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAC/B,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,mBAAmB,GAC5B,OAAO,CAAC,WAAW,CAAC,CAKtB;AAED;;GAEG;AACH,wBAAsB,eAAe,CAClC,GAAG,EAAE,QAAQ,EACb,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GACnB,OAAO,CAAC,WAAW,CAAC,CAStB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,mBAAmB,GAC5B,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAoBnC"}

package/dist/skills/resolve.js

@@ -0,0 +1,43 @@
+import pMap from 'p-map';
+import { parseSkillRef } from './reference-parser.js';
+import { resolveLocal } from './resolvers/local.js';
+import { resolveGit } from './resolvers/git.js';
+import { resolveNpm } from './resolvers/npm.js';
+/**
+ * Resolve a skill reference to a parsed skill
+ */
+export async function resolveSkill(name, ref, options) {
+    const parsed = parseSkillRef(name, ref), projectRoot = options.projectRoot ?? options.baseDir;
+    return resolveSkillRef(parsed, options.baseDir, projectRoot);
+}
+/**
+ * Resolve a parsed skill reference
+ */
+export async function resolveSkillRef(ref, baseDir, projectRoot) {
+    switch (ref.type) {
+        case 'local':
+            return resolveLocal(ref, baseDir);
+        case 'git':
+            return resolveGit(ref);
+        case 'npm':
+            return resolveNpm(ref, projectRoot);
+    }
+}
+/**
+ * Resolve all skills from a config's skills map
+ */
+export async function resolveAllSkills(skills, options) {
+    const entries = Object.entries(skills).filter(([, ref]) => ref !== false);
+    const resolved = await pMap(entries, async ([name, ref]) => {
+        try {
+            const skill = await resolveSkill(name, ref, options);
+            return { name, skill };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            throw new Error(`Failed to resolve skill "${name}": ${message}`, { cause: error });
+        }
+    }, { concurrency: 5 });
+    return new Map(resolved.map(({ name, skill }) => [name, skill]));
+}
+//# sourceMappingURL=resolve.js.map

package/dist/skills/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/skills/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,OAAO,CAAC;AAEzB,OAAO,EAAE,aAAa,EAAiB,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAShD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAC/B,IAAY,EACZ,GAAY,EACZ,OAA4B;IAE5B,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,GAAG,CAAC,EACjC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAE3D,OAAO,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;AAChE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAClC,GAAa,EACb,OAAe,EACf,WAAmB;IAEnB,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,OAAO;YACT,OAAO,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACrC,KAAK,KAAK;YACP,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC;QAC1B,KAAK,KAAK;YACP,OAAO,UAAU,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IACvC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACnC,MAA+B,EAC/B,OAA4B;IAE5B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC;IAE1E,MAAM,QAAQ,GAAG,MAAM,IAAI,CACxB,OAAO,EACP,KAAK,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE;QACnB,IAAI,CAAC;YACF,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;YAErD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACd,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAEvE,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,MAAM,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QACtF,CAAC;IACJ,CAAC,EACD,EAAE,WAAW,EAAE,CAAC,EAAE,CACpB,CAAC;IAEF,OAAO,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;AACpE,CAAC"}

package/dist/skills/resolvers/git.d.ts

@@ -0,0 +1,8 @@
+import type { GitRef } from '../reference-parser.js';
+import type { ParsedSkill } from '@a1st/aix-schema';
+/**
+ * Resolve a skill from a git repository.
+ * Uses giget for downloading which handles caching internally.
+ */
+export declare function resolveGit(ref: GitRef): Promise<ParsedSkill>;
+//# sourceMappingURL=git.d.ts.map

package/dist/skills/resolvers/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../../src/skills/resolvers/git.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;GAGG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAgClE"}

package/dist/skills/resolvers/git.js

@@ -0,0 +1,43 @@
+import { downloadTemplate } from 'giget';
+import { join } from 'pathe';
+import { tmpdir } from 'node:os';
+import { parseSkillMd } from '../parser.js';
+/**
+ * Resolve a skill from a git repository.
+ * Uses giget for downloading which handles caching internally.
+ */
+export async function resolveGit(ref) {
+    const cacheKey = createCacheKey(ref), cachePath = join(tmpdir(), 'aix-skills', 'git', cacheKey);
+    // Build giget source string
+    // giget supports: gh:user/repo, gitlab:user/repo, https://...
+    let source = ref.url;
+    // Convert https URLs to giget format if needed
+    if (source.startsWith('https://github.com/')) {
+        source = source.replace('https://github.com/', 'gh:');
+    }
+    else if (source.startsWith('https://gitlab.com/')) {
+        source = source.replace('https://gitlab.com/', 'gitlab:');
+    }
+    // Add subdirectory path if specified
+    if (ref.path) {
+        source = `${source}/${ref.path}`;
+    }
+    // Add ref (branch/tag/commit) if specified
+    if (ref.ref) {
+        source = `${source}#${ref.ref}`;
+    }
+    // Download using giget
+    await downloadTemplate(source, {
+        dir: cachePath,
+        force: true,
+    });
+    return parseSkillMd(cachePath, 'git');
+}
+/**
+ * Create a cache key for a git reference
+ */
+function createCacheKey(ref) {
+    const urlHash = Buffer.from(ref.url).toString('base64url').slice(0, 16), refPart = ref.ref ?? 'default', pathPart = ref.path ? `-${ref.path.replace(/\//g, '-')}` : '';
+    return `${urlHash}-${refPart}${pathPart}`;
+}
+//# sourceMappingURL=git.js.map

package/dist/skills/resolvers/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../../src/skills/resolvers/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAI5C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAW;IACzC,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,EAC9B,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IAEhE,4BAA4B;IAC5B,8DAA8D;IAC9D,IAAI,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC;IAErB,+CAA+C;IAC/C,IAAI,MAAM,CAAC,UAAU,CAAC,qBAAqB,CAAC,EAAE,CAAC;QAC5C,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;IACzD,CAAC;SAAM,IAAI,MAAM,CAAC,UAAU,CAAC,qBAAqB,CAAC,EAAE,CAAC;QACnD,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,qBAAqB,EAAE,SAAS,CAAC,CAAC;IAC7D,CAAC;IAED,qCAAqC;IACrC,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;QACZ,MAAM,GAAG,GAAG,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;IACpC,CAAC;IAED,2CAA2C;IAC3C,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;QACX,MAAM,GAAG,GAAG,MAAM,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;IACnC,CAAC;IAED,uBAAuB;IACvB,MAAM,gBAAgB,CAAC,MAAM,EAAE;QAC5B,GAAG,EAAE,SAAS;QACd,KAAK,EAAE,IAAI;KACb,CAAC,CAAC;IAEH,OAAO,YAAY,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,GAAW;IAChC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EACjE,OAAO,GAAG,GAAG,CAAC,GAAG,IAAI,SAAS,EAC9B,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAEpE,OAAO,GAAG,OAAO,IAAI,OAAO,GAAG,QAAQ,EAAE,CAAC;AAC7C,CAAC"}

package/dist/skills/resolvers/local.d.ts

@@ -0,0 +1,7 @@
+import type { LocalRef } from '../reference-parser.js';
+import type { ParsedSkill } from '@a1st/aix-schema';
+/**
+ * Resolve a skill from a local file path
+ */
+export declare function resolveLocal(ref: LocalRef, baseDir: string): Promise<ParsedSkill>;
+//# sourceMappingURL=local.d.ts.map

package/dist/skills/resolvers/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../../src/skills/resolvers/local.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;GAEG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAWvF"}

package/dist/skills/resolvers/local.js

@@ -0,0 +1,16 @@
+import { stat } from 'node:fs/promises';
+import { resolve } from 'pathe';
+import { parseSkillMd } from '../parser.js';
+/**
+ * Resolve a skill from a local file path
+ */
+export async function resolveLocal(ref, baseDir) {
+    const skillPath = resolve(baseDir, ref.path);
+    // Check if path exists and is a directory
+    const stats = await stat(skillPath);
+    if (!stats.isDirectory()) {
+        throw new Error(`Skill path is not a directory: ${skillPath}`);
+    }
+    return parseSkillMd(skillPath, 'local');
+}
+//# sourceMappingURL=local.js.map

package/dist/skills/resolvers/local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.js","sourceRoot":"","sources":["../../../src/skills/resolvers/local.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAI5C;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAa,EAAE,OAAe;IAC9D,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IAE7C,0CAA0C;IAC1C,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC;IAEpC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,kCAAkC,SAAS,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AAC3C,CAAC"}

package/dist/skills/resolvers/npm.d.ts

@@ -0,0 +1,12 @@
+import type { NpmRef } from '../reference-parser.js';
+import type { ParsedSkill } from '@a1st/aix-schema';
+/**
+ * Resolve an npm skill package.
+ * Skills are directories containing SKILL.md and supporting files.
+ *
+ * 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 resolveNpm(ref: NpmRef, projectRoot: string): Promise<ParsedSkill>;
+//# sourceMappingURL=npm.d.ts.map

package/dist/skills/resolvers/npm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm.d.ts","sourceRoot":"","sources":["../../../src/skills/resolvers/npm.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpD;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAmBvF"}

package/dist/skills/resolvers/npm.js

@@ -0,0 +1,28 @@
+import { existsSync } from 'node:fs';
+import { join } from 'pathe';
+import { parseSkillMd } from '../parser.js';
+import { resolveNpmPath } from '../../npm/resolve.js';
+/**
+ * Resolve an npm skill package.
+ * Skills are directories containing SKILL.md and supporting files.
+ *
+ * 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 resolveNpm(ref, projectRoot) {
+    const skillDir = await resolveNpmPath({
+        packageName: ref.packageName,
+        subpath: ref.path,
+        version: ref.version,
+        projectRoot,
+    });
+    // Verify SKILL.md exists in the resolved directory
+    const skillMdPath = join(skillDir, 'SKILL.md');
+    if (!existsSync(skillMdPath)) {
+        throw new Error(`SKILL.md not found in ${skillDir}. ` +
+            `Ensure the package exports a skill directory at "${ref.path || '(root)'}".`);
+    }
+    return parseSkillMd(skillDir, 'npm');
+}
+//# sourceMappingURL=npm.js.map

package/dist/skills/resolvers/npm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm.js","sourceRoot":"","sources":["../../../src/skills/resolvers/npm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAW,EAAE,WAAmB;IAC9D,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC;QACnC,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,OAAO,EAAE,GAAG,CAAC,IAAI;QACjB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,WAAW;KACb,CAAC,CAAC;IAEH,mDAAmD;IACnD,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAE/C,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACZ,yBAAyB,QAAQ,IAAI;YAClC,oDAAoD,GAAG,CAAC,IAAI,IAAI,QAAQ,IAAI,CACjF,CAAC;IACL,CAAC;IAED,OAAO,YAAY,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AACxC,CAAC"}

package/dist/skills/validate.d.ts

@@ -0,0 +1,11 @@
+import type { ParsedSkill } from '@a1st/aix-schema';
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Validate a parsed skill for completeness and correctness
+ */
+export declare function validateSkill(skill: ParsedSkill): Promise<ValidationResult>;
+//# sourceMappingURL=validate.d.ts.map

package/dist/skills/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/skills/validate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,WAAW,gBAAgB;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACrB;AAID;;GAEG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA8CjF"}

package/dist/skills/validate.js

@@ -0,0 +1,43 @@
+import { access, constants, readdir } from 'node:fs/promises';
+import { join, basename } from 'pathe';
+const OPTIONAL_DIRS = ['scripts', 'references', 'assets'];
+/**
+ * Validate a parsed skill for completeness and correctness
+ */
+export async function validateSkill(skill) {
+    const errors = [], warnings = [];
+    // Validate SKILL.md exists (should already be parsed, but double-check)
+    const skillMdPath = join(skill.basePath, 'SKILL.md');
+    try {
+        await access(skillMdPath, constants.R_OK);
+    }
+    catch {
+        errors.push('SKILL.md not found');
+    }
+    // Validate name matches directory name (warning only)
+    const dirName = basename(skill.basePath);
+    if (dirName && dirName !== skill.frontmatter.name) {
+        warnings.push(`Skill name "${skill.frontmatter.name}" does not match directory name "${dirName}"`);
+    }
+    // Check optional directories exist if present
+    const files = await readdir(skill.basePath), dirsToCheck = OPTIONAL_DIRS.filter((dir) => files.includes(dir)), accessResults = await Promise.all(dirsToCheck.map(async (dir) => {
+        try {
+            await access(join(skill.basePath, dir), constants.R_OK);
+            return null;
+        }
+        catch {
+            return `Cannot access ${dir}/ directory`;
+        }
+    }));
+    errors.push(...accessResults.filter((e) => e !== null));
+    // Check description quality
+    if (skill.frontmatter.description.length < 50) {
+        warnings.push('Description is short - consider adding more detail for better AI discovery');
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+//# sourceMappingURL=validate.js.map

package/dist/skills/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/skills/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AASvC,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;AAE1D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAkB;IACnD,MAAM,MAAM,GAAa,EAAE,EACrB,QAAQ,GAAa,EAAE,CAAC;IAE9B,wEAAwE;IACxE,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAErD,IAAI,CAAC;QACF,MAAM,MAAM,CAAC,WAAW,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACN,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACrC,CAAC;IAED,sDAAsD;IACtD,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAEzC,IAAI,OAAO,IAAI,OAAO,KAAK,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QACjD,QAAQ,CAAC,IAAI,CAAC,eAAe,KAAK,CAAC,WAAW,CAAC,IAAI,oCAAoC,OAAO,GAAG,CAAC,CAAC;IACtG,CAAC;IAED,8CAA8C;IAC9C,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,EACrC,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAChE,aAAa,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QAC3B,IAAI,CAAC;YACF,MAAM,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;YACxD,OAAO,IAAI,CAAC;QACf,CAAC;QAAC,MAAM,CAAC;YACN,OAAO,iBAAiB,GAAG,aAAa,CAAC;QAC5C,CAAC;IACJ,CAAC,CAAC,CACJ,CAAC;IAER,MAAM,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;IAErE,4BAA4B;IAC5B,IAAI,KAAK,CAAC,WAAW,CAAC,WAAW,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QAC7C,QAAQ,CAAC,IAAI,CAAC,4EAA4E,CAAC,CAAC;IAC/F,CAAC;IAED,OAAO;QACJ,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QAC1B,MAAM;QACN,QAAQ;KACV,CAAC;AACL,CAAC"}

package/dist/updater.d.ts

@@ -0,0 +1,23 @@
+import { type AiJsonConfig } from '@a1st/aix-schema';
+export type ConfigUpdater = (config: AiJsonConfig) => AiJsonConfig | Promise<AiJsonConfig>;
+export type LocalConfigUpdater = (config: Partial<AiJsonConfig>) => Partial<AiJsonConfig> | Promise<Partial<AiJsonConfig>>;
+export interface UpdateOptions {
+    /** Create a backup before updating (default: true) */
+    backup?: boolean;
+}
+export declare function updateConfig(configPath: string, updater: ConfigUpdater, options?: UpdateOptions): Promise<void>;
+/**
+ * Update the local config file (ai.local.json).
+ * Creates the file if it doesn't exist.
+ * @param localPath - Path to ai.local.json (or directory containing it)
+ * @param updater - Function to update the config
+ * @param options - Update options
+ */
+export declare function updateLocalConfig(localPath: string, updater: LocalConfigUpdater, options?: UpdateOptions): Promise<void>;
+/**
+ * Get the path to ai.local.json given a base config path.
+ * @param configPath - Path to ai.json or directory
+ * @returns Path to ai.local.json
+ */
+export declare function getLocalConfigPath(configPath: string): string;
+//# sourceMappingURL=updater.d.ts.map

package/dist/updater.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updater.d.ts","sourceRoot":"","sources":["../src/updater.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiC,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAQpF,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,YAAY,KAAK,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;AAC3F,MAAM,MAAM,kBAAkB,GAAG,CAC9B,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,KAC3B,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;AAE5D,MAAM,WAAW,aAAa;IAC3B,sDAAsD;IACtD,MAAM,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAsB,YAAY,CAC/B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,aAAa,EACtB,OAAO,GAAE,aAAkB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAyCf;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACpC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,kBAAkB,EAC3B,OAAO,GAAE,aAAkB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAyCf;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAU7D"}