@agpm/core 0.0.1

package/dist/config.d.ts

@@ -0,0 +1,32 @@
+export interface TargetConfig {
+}
+export interface AgpmConfig {
+    $schema?: string;
+    targets: Record<string, TargetConfig>;
+    sources: string[];
+    artifacts: string[];
+}
+export interface LockedArtifact {
+    sha: string;
+    integrity: string;
+    path: string;
+    metadata: {
+        name: string;
+        description?: string;
+        [key: string]: unknown;
+    };
+}
+export interface AgpmLock {
+    $schema?: string;
+    version: number;
+    artifacts: Record<string, LockedArtifact>;
+}
+export declare const CONFIG_SCHEMA_URL = "https://agpm.dev/schemas/agpm.json";
+export declare const LOCK_SCHEMA_URL = "https://agpm.dev/schemas/agpm-lock.json";
+export declare const DEFAULT_CONFIG: AgpmConfig;
+export declare const DEFAULT_LOCK: AgpmLock;
+export declare function loadConfig(dir: string): Promise<AgpmConfig>;
+export declare function saveConfig(dir: string, config: AgpmConfig): Promise<void>;
+export declare function loadLock(dir: string): Promise<AgpmLock>;
+export declare function saveLock(dir: string, lock: AgpmLock): Promise<void>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,YAAY;CAE5B;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACtC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC3C;AAMD,eAAO,MAAM,iBAAiB,uCAAuC,CAAC;AACtE,eAAO,MAAM,eAAe,4CAA4C,CAAC;AAMzE,eAAO,MAAM,cAAc,EAAE,UAK5B,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,QAI1B,CAAC;AASF,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAqBjE;AAED,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAM/E;AAED,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAqB7D;AAED,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAMzE"}

package/dist/config.js

@@ -0,0 +1,80 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { validateConfig, validateLock, formatValidationErrors } from "./validate.js";
+// ============================================================================
+// Schema URLs
+// ============================================================================
+export const CONFIG_SCHEMA_URL = "https://agpm.dev/schemas/agpm.json";
+export const LOCK_SCHEMA_URL = "https://agpm.dev/schemas/agpm-lock.json";
+// ============================================================================
+// Defaults
+// ============================================================================
+export const DEFAULT_CONFIG = {
+    $schema: CONFIG_SCHEMA_URL,
+    targets: {},
+    sources: [],
+    artifacts: [],
+};
+export const DEFAULT_LOCK = {
+    $schema: LOCK_SCHEMA_URL,
+    version: 1,
+    artifacts: {},
+};
+// ============================================================================
+// File I/O
+// ============================================================================
+const CONFIG_FILE = "agpm.json";
+const LOCK_FILE = "agpm-lock.json";
+export async function loadConfig(dir) {
+    const path = join(dir, CONFIG_FILE);
+    try {
+        const content = await readFile(path, "utf-8");
+        const config = JSON.parse(content);
+        // Validate against schema
+        const result = await validateConfig(config);
+        if (!result.valid) {
+            throw new Error(`Invalid ${CONFIG_FILE}:\n${formatValidationErrors(result.errors)}`);
+        }
+        return config;
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return { ...DEFAULT_CONFIG };
+        }
+        throw error;
+    }
+}
+export async function saveConfig(dir, config) {
+    const path = join(dir, CONFIG_FILE);
+    // Ensure $schema is always included
+    const configWithSchema = { $schema: CONFIG_SCHEMA_URL, ...config };
+    const content = JSON.stringify(configWithSchema, null, 2) + "\n";
+    await writeFile(path, content, "utf-8");
+}
+export async function loadLock(dir) {
+    const path = join(dir, LOCK_FILE);
+    try {
+        const content = await readFile(path, "utf-8");
+        const lock = JSON.parse(content);
+        // Validate against schema
+        const result = await validateLock(lock);
+        if (!result.valid) {
+            throw new Error(`Invalid ${LOCK_FILE}:\n${formatValidationErrors(result.errors)}`);
+        }
+        return lock;
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return { ...DEFAULT_LOCK };
+        }
+        throw error;
+    }
+}
+export async function saveLock(dir, lock) {
+    const path = join(dir, LOCK_FILE);
+    // Ensure $schema is always included
+    const lockWithSchema = { $schema: LOCK_SCHEMA_URL, ...lock };
+    const content = JSON.stringify(lockWithSchema, null, 2) + "\n";
+    await writeFile(path, content, "utf-8");
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/discovery.d.ts

@@ -0,0 +1,48 @@
+export interface DiscoveredArtifact {
+    /** Artifact name */
+    name: string;
+    /** Description */
+    description?: string;
+    /** Artifact type */
+    type: "skill" | "command" | "hook";
+    /** Path relative to repo root */
+    path: string;
+    /** Full absolute path */
+    absolutePath: string;
+    /** Source format that was detected */
+    format: "claude-marketplace" | "simple";
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+export interface ClaudePluginManifest {
+    name: string;
+    owner?: {
+        name: string;
+        email?: string;
+    };
+    metadata?: {
+        description?: string;
+        version?: string;
+    };
+    plugins: Array<{
+        name: string;
+        description?: string;
+        source?: string;
+        skills?: string[];
+    }>;
+}
+export interface SkillMetadata {
+    name: string;
+    description?: string;
+    [key: string]: unknown;
+}
+export type RepoFormat = "claude-marketplace" | "simple" | "unknown";
+/**
+ * Detect the format of a repository.
+ */
+export declare function detectFormat(repoPath: string): Promise<RepoFormat>;
+/**
+ * Discover all artifacts in a repository.
+ */
+export declare function discoverArtifacts(repoPath: string, subpath?: string): Promise<DiscoveredArtifact[]>;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,kBAAkB;IACjC,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB;IACpB,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACnC,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,MAAM,EAAE,oBAAoB,GAAG,QAAQ,CAAC;IACxC,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,MAAM,UAAU,GAAG,oBAAoB,GAAG,QAAQ,GAAG,SAAS,CAAC;AAMrE;;GAEG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAoBxE;AAMD;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAa/B"}

package/dist/discovery.js

@@ -0,0 +1,197 @@
+import { readFile, readdir, stat } from "node:fs/promises";
+import { join, relative, basename } from "node:path";
+import { parse as parseYaml } from "yaml";
+// ============================================================================
+// Format Detection
+// ============================================================================
+/**
+ * Detect the format of a repository.
+ */
+export async function detectFormat(repoPath) {
+    // Check for Claude marketplace format (.claude-plugin/marketplace.json)
+    try {
+        await stat(join(repoPath, ".claude-plugin", "marketplace.json"));
+        return "claude-marketplace";
+    }
+    catch {
+        // Not claude-marketplace format
+    }
+    // Check for simple format (skills/ directory)
+    try {
+        const skillsStat = await stat(join(repoPath, "skills"));
+        if (skillsStat.isDirectory()) {
+            return "simple";
+        }
+    }
+    catch {
+        // No skills directory
+    }
+    return "unknown";
+}
+// ============================================================================
+// Discovery
+// ============================================================================
+/**
+ * Discover all artifacts in a repository.
+ */
+export async function discoverArtifacts(repoPath, subpath) {
+    const searchPath = subpath ? join(repoPath, subpath) : repoPath;
+    const format = await detectFormat(searchPath);
+    switch (format) {
+        case "claude-marketplace":
+            return discoverClaudeMarketplace(searchPath);
+        case "simple":
+            return discoverSimpleFormat(searchPath);
+        default:
+            // Try simple format from the root anyway
+            return discoverSimpleFormat(searchPath);
+    }
+}
+/**
+ * Discover artifacts from Claude plugin manifest.
+ *
+ * Claude marketplace format:
+ * - .claude-marketplace/marketplace.json contains plugins array
+ * - Each plugin has `source` pointing to a directory
+ * - That directory contains a `skills/` subdirectory with skill folders
+ * - Each skill folder has SKILL.md
+ *
+ * Some repos (like Anthropic's) also include explicit `skills` arrays
+ * as a convenience, which we support as a fallback.
+ */
+async function discoverClaudeMarketplace(repoPath) {
+    const manifestPath = join(repoPath, ".claude-plugin", "marketplace.json");
+    const artifacts = [];
+    const seenPaths = new Set();
+    const content = await readFile(manifestPath, "utf-8");
+    const manifest = JSON.parse(content);
+    for (const plugin of manifest.plugins) {
+        // Primary method: source points to plugin directory with skills/ inside
+        if (plugin.source) {
+            const sourcePath = plugin.source.replace(/^\.\//, "");
+            const pluginDir = sourcePath ? join(repoPath, sourcePath) : repoPath;
+            const skillsDir = join(pluginDir, "skills");
+            try {
+                const entries = await readdir(skillsDir, { withFileTypes: true });
+                for (const entry of entries) {
+                    if (!entry.isDirectory() || entry.name.startsWith("."))
+                        continue;
+                    const skillPath = join(skillsDir, entry.name);
+                    const relativePath = relative(repoPath, skillPath);
+                    // Skip duplicates (multiple plugins may point to same skills dir)
+                    if (seenPaths.has(relativePath))
+                        continue;
+                    seenPaths.add(relativePath);
+                    const metadata = await parseSkillMd(skillPath);
+                    artifacts.push({
+                        name: metadata?.name ?? entry.name,
+                        description: metadata?.description ?? plugin.description,
+                        type: "skill",
+                        path: relativePath,
+                        absolutePath: skillPath,
+                        format: "claude-marketplace",
+                        metadata: metadata,
+                    });
+                }
+            }
+            catch {
+                // skills/ directory doesn't exist in plugin source dir
+            }
+        }
+        // Fallback: explicit skills array (convenience format used by some repos)
+        if (plugin.skills && plugin.skills.length > 0) {
+            for (const skillPath of plugin.skills) {
+                const normalizedPath = skillPath.replace(/^\.\//, "");
+                // Skip duplicates
+                if (seenPaths.has(normalizedPath))
+                    continue;
+                seenPaths.add(normalizedPath);
+                const absolutePath = join(repoPath, normalizedPath);
+                const metadata = await parseSkillMd(absolutePath);
+                artifacts.push({
+                    name: metadata?.name ?? basename(normalizedPath),
+                    description: metadata?.description ?? plugin.description,
+                    type: "skill",
+                    path: normalizedPath,
+                    absolutePath,
+                    format: "claude-marketplace",
+                    metadata: metadata,
+                });
+            }
+        }
+    }
+    return artifacts;
+}
+/**
+ * Discover artifacts from simple format (skills/ directory).
+ */
+async function discoverSimpleFormat(repoPath) {
+    const skillsDir = join(repoPath, "skills");
+    const artifacts = [];
+    try {
+        const entries = await readdir(skillsDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            if (entry.name.startsWith("."))
+                continue;
+            const skillPath = join(skillsDir, entry.name);
+            const metadata = await parseSkillMd(skillPath);
+            // Also try metadata.json
+            let jsonMetadata = null;
+            try {
+                const metadataContent = await readFile(join(skillPath, "metadata.json"), "utf-8");
+                jsonMetadata = JSON.parse(metadataContent);
+            }
+            catch {
+                // No metadata.json
+            }
+            const name = metadata?.name ?? jsonMetadata?.name ?? entry.name;
+            const description = metadata?.description ??
+                jsonMetadata?.abstract ??
+                jsonMetadata?.description;
+            artifacts.push({
+                name,
+                description,
+                type: "skill",
+                path: relative(repoPath, skillPath),
+                absolutePath: skillPath,
+                format: "simple",
+                metadata: { ...jsonMetadata, ...metadata },
+            });
+        }
+    }
+    catch {
+        // skills/ directory doesn't exist or can't be read
+    }
+    return artifacts;
+}
+/**
+ * Parse SKILL.md or AGENTS.md YAML frontmatter.
+ */
+async function parseSkillMd(dirPath) {
+    for (const filename of ["SKILL.md", "AGENTS.md"]) {
+        try {
+            const content = await readFile(join(dirPath, filename), "utf-8");
+            // Extract YAML frontmatter
+            const match = content.match(/^---\n([\s\S]*?)\n---/);
+            if (match) {
+                const yaml = parseYaml(match[1]);
+                return {
+                    name: yaml.name ?? basename(dirPath),
+                    description: yaml.description,
+                    ...yaml,
+                };
+            }
+            // No frontmatter, use directory name
+            return {
+                name: basename(dirPath),
+            };
+        }
+        catch {
+            // File doesn't exist
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=discovery.js.map

package/dist/discovery.js.map

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

package/dist/git.d.ts

@@ -0,0 +1,53 @@
+export interface ParsedSource {
+    /** Full git URL for cloning */
+    url: string;
+    /** GitHub owner (if GitHub) */
+    owner?: string;
+    /** Repository name */
+    repo?: string;
+    /** Git ref (branch, tag, SHA) */
+    ref?: string;
+    /** Subpath within repo (after #) */
+    subpath?: string;
+    /** Original source string */
+    original: string;
+}
+export interface RepoInfo {
+    /** Path to the cloned repo */
+    path: string;
+    /** Current HEAD SHA */
+    sha: string;
+}
+/**
+ * Parse a source string into its components.
+ *
+ * Supported formats:
+ * - owner/repo
+ * - owner/repo#subpath
+ * - https://github.com/owner/repo
+ * - https://github.com/owner/repo#subpath
+ * - ./local/path
+ */
+export declare function parseSource(source: string): ParsedSource;
+/**
+ * Get the global agpm directory path.
+ */
+export declare function getAgpmDir(): string;
+/**
+ * Get the path where a repo should be stored.
+ */
+export declare function getRepoPath(source: ParsedSource): string;
+/**
+ * Clone or fetch a repository.
+ * Returns the path to the repo and the current HEAD SHA.
+ */
+export declare function ensureRepo(source: ParsedSource): Promise<RepoInfo>;
+/**
+ * Checkout a specific ref (branch, tag, or SHA) in a repo.
+ */
+export declare function checkoutRef(repoPath: string, ref: string): Promise<string>;
+/**
+ * Resolve a ref to a full SHA.
+ */
+export declare function resolveRef(repoPath: string, ref?: string): Promise<string>;
+//# sourceMappingURL=git.d.ts.map

package/dist/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,YAAY;IAC3B,+BAA+B;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,GAAG,EAAE,MAAM,CAAC;CACb;AAMD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAiDxD;AAMD;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAcxD;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CA0BxE;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMhF;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAE,MAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAIxF"}

package/dist/git.js

@@ -0,0 +1,130 @@
+import { simpleGit } from "simple-git";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { mkdir } from "node:fs/promises";
+// ============================================================================
+// Source Parsing
+// ============================================================================
+/**
+ * Parse a source string into its components.
+ *
+ * Supported formats:
+ * - owner/repo
+ * - owner/repo#subpath
+ * - https://github.com/owner/repo
+ * - https://github.com/owner/repo#subpath
+ * - ./local/path
+ */
+export function parseSource(source) {
+    const original = source;
+    // Local path
+    if (source.startsWith("./") || source.startsWith("/") || source.startsWith("~")) {
+        return {
+            url: source,
+            original,
+        };
+    }
+    // Split on # for subpath
+    let subpath;
+    const hashIndex = source.indexOf("#");
+    if (hashIndex !== -1) {
+        subpath = source.slice(hashIndex + 1);
+        source = source.slice(0, hashIndex);
+    }
+    // Full URL
+    if (source.startsWith("https://") || source.startsWith("git@")) {
+        const match = source.match(/github\.com[/:]([\w.-]+)\/([\w.-]+)/);
+        if (match) {
+            return {
+                url: source.endsWith(".git") ? source : `${source}.git`,
+                owner: match[1],
+                repo: match[2].replace(/\.git$/, ""),
+                subpath,
+                original,
+            };
+        }
+        return { url: source, subpath, original };
+    }
+    // owner/repo shorthand
+    const parts = source.split("/");
+    if (parts.length >= 2) {
+        const owner = parts[0];
+        const repo = parts[1];
+        return {
+            url: `https://github.com/${owner}/${repo}.git`,
+            owner,
+            repo,
+            subpath,
+            original,
+        };
+    }
+    throw new Error(`Invalid source format: ${original}`);
+}
+// ============================================================================
+// Repository Management
+// ============================================================================
+/**
+ * Get the global agpm directory path.
+ */
+export function getAgpmDir() {
+    return join(homedir(), ".agpm");
+}
+/**
+ * Get the path where a repo should be stored.
+ */
+export function getRepoPath(source) {
+    const apmDir = getAgpmDir();
+    if (source.owner && source.repo) {
+        return join(apmDir, "repos", "github.com", source.owner, source.repo);
+    }
+    // For non-GitHub URLs, use a sanitized version
+    const sanitized = source.url
+        .replace(/^https?:\/\//, "")
+        .replace(/\.git$/, "")
+        .replace(/[^a-zA-Z0-9.-]/g, "_");
+    return join(apmDir, "repos", sanitized);
+}
+/**
+ * Clone or fetch a repository.
+ * Returns the path to the repo and the current HEAD SHA.
+ */
+export async function ensureRepo(source) {
+    const repoPath = getRepoPath(source);
+    // Ensure parent directory exists
+    await mkdir(join(repoPath, ".."), { recursive: true });
+    const git = simpleGit();
+    try {
+        // Check if repo exists
+        const repoGit = simpleGit(repoPath);
+        await repoGit.status();
+        // Repo exists, fetch latest
+        await repoGit.fetch(["--all"]);
+    }
+    catch {
+        // Repo doesn't exist, clone it
+        await git.clone(source.url, repoPath);
+    }
+    // Get current SHA
+    const repoGit = simpleGit(repoPath);
+    const log = await repoGit.log({ maxCount: 1 });
+    const sha = log.latest?.hash ?? "";
+    return { path: repoPath, sha };
+}
+/**
+ * Checkout a specific ref (branch, tag, or SHA) in a repo.
+ */
+export async function checkoutRef(repoPath, ref) {
+    const git = simpleGit(repoPath);
+    await git.checkout(ref);
+    const log = await git.log({ maxCount: 1 });
+    return log.latest?.hash ?? "";
+}
+/**
+ * Resolve a ref to a full SHA.
+ */
+export async function resolveRef(repoPath, ref = "HEAD") {
+    const git = simpleGit(repoPath);
+    const result = await git.revparse([ref]);
+    return result.trim();
+}
+//# sourceMappingURL=git.js.map

package/dist/git.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { type AgpmConfig, type AgpmLock, type TargetConfig, type LockedArtifact, DEFAULT_CONFIG, DEFAULT_LOCK, CONFIG_SCHEMA_URL, LOCK_SCHEMA_URL, loadConfig, saveConfig, loadLock, saveLock, } from "./config.js";
+export { type ValidationError, type ValidationResult, validateConfig, validateLock, formatValidationErrors, } from "./validate.js";
+export { type ParsedSource, type RepoInfo, parseSource, getAgpmDir, getRepoPath, ensureRepo, checkoutRef, resolveRef, } from "./git.js";
+export { type DiscoveredArtifact, type ClaudePluginManifest, type SkillMetadata, type RepoFormat, detectFormat, discoverArtifacts, } from "./discovery.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,UAAU,EACV,QAAQ,EACR,QAAQ,GACT,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,cAAc,EACd,YAAY,EACZ,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,WAAW,EACX,UAAU,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,UAAU,GACX,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,YAAY,EACZ,iBAAiB,GAClB,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+// Config types and I/O
+export { DEFAULT_CONFIG, DEFAULT_LOCK, CONFIG_SCHEMA_URL, LOCK_SCHEMA_URL, loadConfig, saveConfig, loadLock, saveLock, } from "./config.js";
+// Validation
+export { validateConfig, validateLock, formatValidationErrors, } from "./validate.js";
+// Git operations
+export { parseSource, getAgpmDir, getRepoPath, ensureRepo, checkoutRef, resolveRef, } from "./git.js";
+// Discovery
+export { detectFormat, discoverArtifacts, } from "./discovery.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,OAAO,EAKL,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,UAAU,EACV,QAAQ,EACR,QAAQ,GACT,MAAM,aAAa,CAAC;AAErB,aAAa;AACb,OAAO,EAGL,cAAc,EACd,YAAY,EACZ,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAEvB,iBAAiB;AACjB,OAAO,EAGL,WAAW,EACX,UAAU,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,UAAU,GACX,MAAM,UAAU,CAAC;AAElB,YAAY;AACZ,OAAO,EAKL,YAAY,EACZ,iBAAiB,GAClB,MAAM,gBAAgB,CAAC"}

package/dist/validate.d.ts

@@ -0,0 +1,21 @@
+export interface ValidationError {
+    path: string;
+    message: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+}
+/**
+ * Validate an APM config against the schema.
+ */
+export declare function validateConfig(config: unknown): Promise<ValidationResult>;
+/**
+ * Validate an APM lock file against the schema.
+ */
+export declare function validateLock(lock: unknown): Promise<ValidationResult>;
+/**
+ * Format validation errors for display.
+ */
+export declare function formatValidationErrors(errors: ValidationError[]): string;
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAyCA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAe/E;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAe3E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,CAExE"}

package/dist/validate.js

@@ -0,0 +1,74 @@
+import Ajv from "ajv";
+import { readFile } from "node:fs/promises";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+// Get the schemas directory path
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const SCHEMAS_DIR = join(__dirname, "../../../schemas");
+// Create Ajv instance
+const ajv = new Ajv.default({
+    allErrors: true,
+    verbose: true,
+});
+// Schema cache
+let configSchema;
+let lockSchema;
+/**
+ * Load and cache the config schema.
+ */
+async function getConfigSchema() {
+    if (!configSchema) {
+        const content = await readFile(join(SCHEMAS_DIR, "agpm.json"), "utf-8");
+        configSchema = JSON.parse(content);
+    }
+    return configSchema;
+}
+/**
+ * Load and cache the lock schema.
+ */
+async function getLockSchema() {
+    if (!lockSchema) {
+        const content = await readFile(join(SCHEMAS_DIR, "agpm-lock.json"), "utf-8");
+        lockSchema = JSON.parse(content);
+    }
+    return lockSchema;
+}
+/**
+ * Validate an APM config against the schema.
+ */
+export async function validateConfig(config) {
+    const schema = await getConfigSchema();
+    const validate = ajv.compile(schema);
+    const valid = validate(config);
+    if (valid) {
+        return { valid: true, errors: [] };
+    }
+    const errors = (validate.errors || []).map((err) => ({
+        path: err.instancePath || "/",
+        message: err.message || "Unknown validation error",
+    }));
+    return { valid: false, errors };
+}
+/**
+ * Validate an APM lock file against the schema.
+ */
+export async function validateLock(lock) {
+    const schema = await getLockSchema();
+    const validate = ajv.compile(schema);
+    const valid = validate(lock);
+    if (valid) {
+        return { valid: true, errors: [] };
+    }
+    const errors = (validate.errors || []).map((err) => ({
+        path: err.instancePath || "/",
+        message: err.message || "Unknown validation error",
+    }));
+    return { valid: false, errors };
+}
+/**
+ * Format validation errors for display.
+ */
+export function formatValidationErrors(errors) {
+    return errors.map((e) => `  ${e.path}: ${e.message}`).join("\n");
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

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

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@agpm/core",
+  "version": "0.0.1",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "ajv": "^8.17.1",
+    "fast-glob": "^3.3.3",
+    "simple-git": "^3.27.0",
+    "yaml": "^2.7.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0"
+  }
+}