agent-config-sync 0.1.0

package/dist/project-discovery.js

@@ -0,0 +1,129 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+// ============================================================================
+// Constants
+// ============================================================================
+/** Native config file paths for each target relative to project root */
+const TARGET_CONFIG_PATHS = {
+    claude: '.mcp.json',
+    codex: path.join('.codex', 'config.toml'),
+    gemini: path.join('.gemini', 'settings.json'),
+};
+/** Skills directory paths for each target relative to project root */
+const TARGET_SKILLS_PATHS = {
+    claude: path.join('.claude', 'skills'),
+    codex: path.join('.codex', 'skills'),
+    gemini: path.join('.gemini', 'antigravity', 'skills'),
+};
+// ============================================================================
+// Project Discovery
+// ============================================================================
+/**
+ * Discover the active project from the current working directory.
+ *
+ * Priority:
+ * 1. Nearest ancestor that is a Git repository root
+ * 2. Nearest ancestor containing any supported native config file
+ * 3. Fail with clear error
+ */
+export async function discoverProject(cwd = process.cwd()) {
+    const gitRoot = await findGitRoot(cwd);
+    const projectRoot = gitRoot ?? (await findNativeConfigRoot(cwd));
+    if (!projectRoot) {
+        throw new Error('Not inside a managed project. ' +
+            'Navigate to a Git repository or a directory with native agent config files.');
+    }
+    const targets = await resolveNativeConfigPaths(projectRoot);
+    return { root: projectRoot, targets };
+}
+/**
+ * Find the nearest Git repository root by traversing upwards.
+ */
+async function findGitRoot(cwd) {
+    let current = path.resolve(cwd);
+    while (true) {
+        const gitDir = path.join(current, '.git');
+        try {
+            const stat = await fs.stat(gitDir);
+            if (stat.isDirectory()) {
+                return current;
+            }
+        }
+        catch {
+            // .git doesn't exist, continue
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            // Reached root
+            return null;
+        }
+        current = parent;
+    }
+}
+/**
+ * Find the nearest ancestor containing any supported native config file.
+ */
+async function findNativeConfigRoot(cwd) {
+    let current = path.resolve(cwd);
+    while (true) {
+        for (const targetPath of Object.values(TARGET_CONFIG_PATHS)) {
+            const fullPath = path.join(current, targetPath);
+            try {
+                await fs.access(fullPath);
+                return current;
+            }
+            catch {
+                // File doesn't exist, try next
+            }
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            // Reached root
+            return null;
+        }
+        current = parent;
+    }
+}
+/**
+ * Resolve native config paths for all targets relative to the project root.
+ */
+async function resolveNativeConfigPaths(projectRoot) {
+    const targets = new Map();
+    for (const [target, relativePath] of Object.entries(TARGET_CONFIG_PATHS)) {
+        const fullPath = path.join(projectRoot, relativePath);
+        let exists = false;
+        try {
+            await fs.access(fullPath);
+            exists = true;
+        }
+        catch {
+            // File doesn't exist
+        }
+        targets.set(target, {
+            target,
+            path: fullPath,
+            exists,
+        });
+    }
+    return targets;
+}
+// ============================================================================
+// Utilities
+// ============================================================================
+/**
+ * Get the relative path from project root to a config file.
+ */
+export function getRelativeConfigPath(projectRoot, target) {
+    return TARGET_CONFIG_PATHS[target];
+}
+/**
+ * Get the relative path from project root to the skills directory.
+ */
+export function getSkillsPath(projectRoot, target) {
+    return path.join(projectRoot, TARGET_SKILLS_PATHS[target]);
+}
+/**
+ * Get the skills directory paths constant.
+ */
+export { TARGET_SKILLS_PATHS };
+//# sourceMappingURL=project-discovery.js.map

package/dist/project-discovery.js.map

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

package/dist/registry.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Search the skills.directory registry for skills.
+ */
+export declare function searchSkills(query: string): Promise<RegistrySkill[]>;
+/**
+ * Get detailed information about a skill from the registry.
+ */
+export declare function getSkillInfo(skillName: string): Promise<RegistrySkillInfo | null>;
+/**
+ * Download a skill's SKILL.md content from GitHub.
+ */
+export declare function downloadSkillContent(githubUrl: string): Promise<string>;
+/**
+ * Install a skill from GitHub URL.
+ */
+export declare function installFromGitHub(githubUrl: string, skillName?: string): Promise<{
+    name: string;
+    content: string;
+}>;
+export interface RegistrySkill {
+    name: string;
+    description: string;
+    version: string;
+    author: string;
+    verticals: string[];
+    stars: number;
+    installs: number;
+    repo: string;
+    skill_md: string;
+}
+export interface RegistrySkillInfo {
+    name: string;
+    description: string;
+    author: string;
+    verticals: string[];
+    updated: string;
+    stars: number;
+    installs: number;
+    repo: string;
+    skill_md: string;
+    installation: {
+        local: boolean;
+        global: string;
+    };
+    links: {
+        repo: string;
+        skill_md: string;
+    };
+}

package/dist/registry.js

@@ -0,0 +1,121 @@
+// ============================================================================
+// Skills Directory Registry Client
+// ============================================================================
+/** Maximum size for skill content (1MB) */
+const MAX_SKILL_SIZE = 1024 * 1024;
+/**
+ * Validate that a URL is from GitHub.
+ */
+function validateGitHubUrl(inputUrl) {
+    try {
+        const url = new URL(inputUrl);
+        const allowedHosts = ['github.com', 'raw.githubusercontent.com', 'www.github.com'];
+        return allowedHosts.includes(url.hostname);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Search the skills.directory registry for skills.
+ */
+export async function searchSkills(query) {
+    const url = `https://api.skills-directory.com/v1/search?q=${encodeURIComponent(query)}`;
+    try {
+        const response = await fetch(url);
+        if (!response.ok) {
+            throw new Error('Registry search failed');
+        }
+        const data = await response.json();
+        return data.skills || [];
+    }
+    catch (error) {
+        console.error('Failed to search registry. Please try again later.');
+        return [];
+    }
+}
+/**
+ * Get detailed information about a skill from the registry.
+ */
+export async function getSkillInfo(skillName) {
+    const url = `https://api.skills-directory.com/v1/skills/${encodeURIComponent(skillName)}`;
+    try {
+        const response = await fetch(url);
+        if (!response.ok) {
+            if (response.status === 404) {
+                return null;
+            }
+            throw new Error('Registry fetch failed');
+        }
+        const data = await response.json();
+        return data;
+    }
+    catch (error) {
+        console.error('Failed to fetch skill info. Please try again later.');
+        return null;
+    }
+}
+/**
+ * Download a skill's SKILL.md content from GitHub.
+ */
+export async function downloadSkillContent(githubUrl) {
+    // Validate URL is from GitHub
+    if (!validateGitHubUrl(githubUrl)) {
+        throw new Error('Only GitHub URLs are allowed');
+    }
+    // Parse GitHub URL to extract raw content URL
+    const rawUrl = githubUrl.replace('github.com', 'raw.githubusercontent.com')
+        .replace('/blob/', '/')
+        .replace('/tree/', '/');
+    // Ensure we point to SKILL.md
+    const skillUrl = rawUrl.endsWith('SKILL.md') ? rawUrl : `${rawUrl}/SKILL.md`;
+    // Validate final URL is still from GitHub
+    if (!validateGitHubUrl(skillUrl)) {
+        throw new Error('Invalid GitHub URL structure');
+    }
+    try {
+        const response = await fetch(skillUrl);
+        if (!response.ok) {
+            throw new Error(`Download failed: ${response.status}`);
+        }
+        // Check content length
+        const contentLength = response.headers.get('content-length');
+        if (contentLength && parseInt(contentLength, 10) > MAX_SKILL_SIZE) {
+            throw new Error('Skill file too large');
+        }
+        const content = await response.text();
+        // Double-check actual content size
+        if (content.length > MAX_SKILL_SIZE) {
+            throw new Error('Skill file too large');
+        }
+        return content;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        if (message.includes('Only GitHub') || message.includes('Invalid GitHub')) {
+            throw new Error(message);
+        }
+        throw new Error(`Failed to download skill. Check the URL and try again.`);
+    }
+}
+/**
+ * Install a skill from GitHub URL.
+ */
+export async function installFromGitHub(githubUrl, skillName) {
+    // Fetch the repository info to get the default branch if needed
+    const content = await downloadSkillContent(githubUrl);
+    // Parse the skill name from the content if not provided
+    if (!skillName) {
+        const nameMatch = content.match(/^name:\s*(.+)$/m);
+        if (nameMatch) {
+            skillName = nameMatch[1].trim().replace(/^["']|["']$/g, '');
+        }
+        else {
+            // Extract from GitHub URL
+            const urlMatch = githubUrl.match(/\/skills\/([^\/]+)/);
+            skillName = urlMatch ? urlMatch[1] : 'unknown-skill';
+        }
+    }
+    return { name: skillName, content };
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/skill-adapters.d.ts

@@ -0,0 +1,53 @@
+import type { TargetName } from './types.js';
+/**
+ * Validate a skill name to prevent path traversal and injection.
+ */
+export declare function validateSkillName(skillName: string): void;
+/**
+ * Get the skills directory path for a target.
+ * - Claude: <project>/.claude/skills/
+ * - Codex: <project>/.codex/skills/
+ * - Gemini: <project>/.gemini/antigravity/skills/
+ */
+export declare function getSkillsDir(projectRoot: string, target: TargetName): string;
+/**
+ * Get the skill directory path for a specific skill.
+ */
+export declare function getSkillDir(projectRoot: string, target: TargetName, skillName: string): string;
+/**
+ * Get the SKILL.md file path for a specific skill.
+ */
+export declare function getSkillFilePath(projectRoot: string, target: TargetName, skillName: string): string;
+/**
+ * Read a skill file from disk.
+ */
+export declare function readSkill(projectRoot: string, target: TargetName, skillName: string): Promise<{
+    exists: boolean;
+    content: string | null;
+}>;
+/**
+ * Write a skill file to disk atomically.
+ */
+export declare function writeSkill(projectRoot: string, target: TargetName, skillName: string, content: string): Promise<void>;
+/**
+ * Remove a skill directory.
+ */
+export declare function removeSkill(projectRoot: string, target: TargetName, skillName: string): Promise<boolean>;
+/**
+ * Add a skill to a project.
+ */
+export declare function addSkillToConfig(projectRoot: string, target: TargetName, skillId: string, content: string): Promise<void>;
+/**
+ * Remove a skill from a project.
+ */
+export declare function removeSkillFromConfig(projectRoot: string, target: TargetName, skillName: string): Promise<void>;
+/**
+ * Get all skills from a project's native config directories.
+ */
+export declare function getSkills(projectRoot: string, target: TargetName): Promise<Record<string, {
+    enabled: boolean;
+}>>;
+/**
+ * Check if a skill is enabled for a target.
+ */
+export declare function isSkillEnabled(projectRoot: string, target: TargetName, skillName: string): Promise<boolean>;

package/dist/skill-adapters.js

@@ -0,0 +1,183 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+// ============================================================================
+// Constants
+// ============================================================================
+/** Maximum size for skill files (1MB) */
+const MAX_SKILL_SIZE = 1024 * 1024;
+/** Valid skill name pattern: alphanumeric, hyphens, underscores, dots */
+const SKILL_NAME_PATTERN = /^[a-zA-Z0-9._-]+$/;
+// ============================================================================
+// Validation
+// ============================================================================
+/**
+ * Validate a skill name to prevent path traversal and injection.
+ */
+export function validateSkillName(skillName) {
+    if (!skillName || skillName.length === 0) {
+        throw new Error('Skill name cannot be empty');
+    }
+    if (skillName.length > 100) {
+        throw new Error('Skill name too long (max 100 characters)');
+    }
+    if (!SKILL_NAME_PATTERN.test(skillName)) {
+        throw new Error('Skill name must contain only alphanumeric characters, hyphens, underscores, and dots');
+    }
+    // Prevent path traversal
+    if (skillName.includes('..') || skillName.includes('/') || skillName.includes('\\')) {
+        throw new Error('Skill name cannot contain path traversal characters');
+    }
+    // Prevent leading/trailing dots and dashes (security issues)
+    if (skillName.startsWith('.') || skillName.startsWith('-') ||
+        skillName.endsWith('.') || skillName.endsWith('-')) {
+        throw new Error('Skill name cannot start or end with a dot or dash');
+    }
+}
+// ============================================================================
+// Skill Path Resolution
+// ============================================================================
+/**
+ * Get the skills directory path for a target.
+ * - Claude: <project>/.claude/skills/
+ * - Codex: <project>/.codex/skills/
+ * - Gemini: <project>/.gemini/antigravity/skills/
+ */
+export function getSkillsDir(projectRoot, target) {
+    switch (target) {
+        case 'claude':
+            return path.join(projectRoot, '.claude', 'skills');
+        case 'codex':
+            return path.join(projectRoot, '.codex', 'skills');
+        case 'gemini':
+            return path.join(projectRoot, '.gemini', 'antigravity', 'skills');
+    }
+}
+/**
+ * Get the skill directory path for a specific skill.
+ */
+export function getSkillDir(projectRoot, target, skillName) {
+    const skillsDir = getSkillsDir(projectRoot, target);
+    return path.join(skillsDir, skillName);
+}
+/**
+ * Get the SKILL.md file path for a specific skill.
+ */
+export function getSkillFilePath(projectRoot, target, skillName) {
+    const skillDir = getSkillDir(projectRoot, target, skillName);
+    return path.join(skillDir, 'SKILL.md');
+}
+// ============================================================================
+// Skill File Operations
+// ============================================================================
+/**
+ * Read a skill file from disk.
+ */
+export async function readSkill(projectRoot, target, skillName) {
+    validateSkillName(skillName);
+    const skillPath = getSkillFilePath(projectRoot, target, skillName);
+    try {
+        await fs.access(skillPath);
+        const content = await fs.readFile(skillPath, 'utf8');
+        // Check content size
+        if (content.length > MAX_SKILL_SIZE) {
+            throw new Error('Skill file too large');
+        }
+        return { exists: true, content };
+    }
+    catch {
+        return { exists: false, content: null };
+    }
+}
+/**
+ * Write a skill file to disk atomically.
+ */
+export async function writeSkill(projectRoot, target, skillName, content) {
+    validateSkillName(skillName);
+    // Check content size before writing
+    if (content.length > MAX_SKILL_SIZE) {
+        throw new Error(`Skill content too large (${content.length} bytes, max ${MAX_SKILL_SIZE})`);
+    }
+    const skillDir = getSkillDir(projectRoot, target, skillName);
+    const skillPath = getSkillFilePath(projectRoot, target, skillName);
+    // Create skill directory if it doesn't exist
+    await fs.mkdir(skillDir, { recursive: true });
+    // Write atomically
+    const tempPath = `${skillPath}.tmp`;
+    await fs.writeFile(tempPath, content, 'utf8');
+    await fs.rename(tempPath, skillPath);
+}
+/**
+ * Remove a skill directory.
+ */
+export async function removeSkill(projectRoot, target, skillName) {
+    validateSkillName(skillName);
+    const skillDir = getSkillDir(projectRoot, target, skillName);
+    try {
+        await fs.access(skillDir);
+    }
+    catch {
+        return false; // Doesn't exist
+    }
+    await fs.rm(skillDir, { recursive: true, force: true });
+    return true;
+}
+/**
+ * Add a skill to a project.
+ */
+export async function addSkillToConfig(projectRoot, target, skillId, content) {
+    await writeSkill(projectRoot, target, skillId, content);
+}
+/**
+ * Remove a skill from a project.
+ */
+export async function removeSkillFromConfig(projectRoot, target, skillName) {
+    await removeSkill(projectRoot, target, skillName);
+}
+// ============================================================================
+// Skill Status Queries
+// ============================================================================
+/**
+ * Get all skills from a project's native config directories.
+ */
+export async function getSkills(projectRoot, target) {
+    const skillsDir = getSkillsDir(projectRoot, target);
+    const skills = {};
+    try {
+        await fs.access(skillsDir);
+    }
+    catch {
+        return skills; // Directory doesn't exist
+    }
+    const entries = await fs.readdir(skillsDir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const skillName = entry.name;
+        // Validate skill name to skip invalid entries
+        try {
+            validateSkillName(skillName);
+        }
+        catch {
+            // Skip invalid skill names
+            continue;
+        }
+        const skillPath = path.join(skillsDir, skillName, 'SKILL.md');
+        try {
+            await fs.access(skillPath);
+            // All skills are considered "enabled" if the SKILL.md file exists
+            skills[skillName] = { enabled: true };
+        }
+        catch {
+            // SKILL.md doesn't exist, skip
+        }
+    }
+    return skills;
+}
+/**
+ * Check if a skill is enabled for a target.
+ */
+export async function isSkillEnabled(projectRoot, target, skillName) {
+    const { exists } = await readSkill(projectRoot, target, skillName);
+    return exists;
+}
+//# sourceMappingURL=skill-adapters.js.map

package/dist/skill-adapters.js.map

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