@slats/claude-assets-sync 0.1.3 → 0.2.0

package/dist/core/sync.cjs

@@ -1,400 +0,0 @@
-'use strict';
-
-var logger = require('../utils/logger.cjs');
-var nameTransform = require('../utils/nameTransform.cjs');
-var _package = require('../utils/package.cjs');
-var packageName = require('../utils/packageName.cjs');
-var paths = require('../utils/paths.cjs');
-var constants = require('./constants.cjs');
-var filesystem = require('./filesystem.cjs');
-var github = require('./github.cjs');
-var localSource = require('./localSource.cjs');
-var syncMeta = require('./syncMeta.cjs');
-var assetStructure = require('./assetStructure.cjs');
-
-function groupEntriesIntoSkillUnits(entries, prefix) {
-    const dirGroups = new Map();
-    const singleFiles = [];
-    for (const entry of entries) {
-        const slashIndex = entry.name.indexOf('/');
-        if (slashIndex === -1) {
-            singleFiles.push({
-                name: entry.name,
-                isDirectory: false,
-                transformed: nameTransform.toFlatFileName(prefix, entry.name),
-            });
-        }
-        else {
-            const dirName = entry.name.substring(0, slashIndex);
-            const internalFile = entry.name.substring(slashIndex + 1);
-            if (!dirGroups.has(dirName)) {
-                dirGroups.set(dirName, []);
-            }
-            dirGroups.get(dirName).push(internalFile);
-        }
-    }
-    const dirSkillUnits = [];
-    for (const [dirName, internalFiles] of dirGroups.entries()) {
-        dirSkillUnits.push({
-            name: dirName,
-            isDirectory: true,
-            transformed: nameTransform.toFlatFileName(prefix, dirName),
-            internalFiles,
-        });
-    }
-    return [...singleFiles, ...dirSkillUnits];
-}
-const syncPackage = async (packageName$1, options, cwd = process.cwd(), exclusions, outputDir) => {
-    logger.logger.packageStart(packageName$1);
-    try {
-        const destDir = outputDir ?? _package.findGitRoot(cwd) ?? cwd;
-        const packageInfo = options.local
-            ? _package.readLocalPackageJson(packageName$1, cwd)
-            : _package.readPackageJson(packageName$1, cwd);
-        if (!packageInfo) {
-            const location = options.local ? 'workspace' : 'node_modules';
-            return {
-                packageName: packageName$1,
-                success: false,
-                skipped: true,
-                reason: `Package not found in ${location}`,
-            };
-        }
-        const claudeConfig = _package.resolveClaudeConfig(packageInfo.claude);
-        const repoInfo = _package.parseGitHubRepo(packageInfo.repository);
-        const useFlat = options.flat !== false;
-        if (useFlat) {
-            const prefix = packageName.packageNameToPrefix(packageName$1);
-            const unifiedMeta = syncMeta.readUnifiedSyncMeta(destDir) ?? syncMeta.createEmptyUnifiedMeta();
-            if (!options.force &&
-                !syncMeta.needsSyncUnified(unifiedMeta, prefix, packageInfo.version)) {
-                return {
-                    packageName: packageName$1,
-                    success: true,
-                    skipped: true,
-                    reason: `Already synced at version ${packageInfo.version}`,
-                };
-            }
-            const assetPath = _package.buildAssetPath(claudeConfig.assetPath);
-            const useLocalSource = options.ref
-                ? { available: false }
-                : localSource.canUseLocalSource(packageName$1, packageInfo.version, assetPath, cwd);
-            const assetTypes = _package.getAssetTypes(claudeConfig);
-            let assetFiles;
-            let isLocalSource;
-            if (useLocalSource.available && useLocalSource.docsPath) {
-                isLocalSource = true;
-                logger.logger.step('Using', 'local docs from node_modules');
-                assetFiles = await localSource.fetchLocalAssetFiles(useLocalSource.docsPath, assetTypes);
-            }
-            else {
-                if (!repoInfo) {
-                    return {
-                        packageName: packageName$1,
-                        success: false,
-                        skipped: true,
-                        reason: `Package ${packageName$1} has no valid GitHub repository URL for remote fetch`,
-                    };
-                }
-                isLocalSource = false;
-                const tag = options.ref ?? _package.buildVersionTag(packageName$1, packageInfo.version);
-                logger.logger.step('Fetching', `asset list from GitHub (ref: ${tag})`);
-                assetFiles = await github.fetchAssetFiles(repoInfo, assetPath, tag, assetTypes);
-            }
-            let totalFiles = 0;
-            for (const assetType of assetTypes) {
-                totalFiles += (assetFiles[assetType] || []).length;
-            }
-            if (totalFiles === 0)
-                return {
-                    packageName: packageName$1,
-                    success: false,
-                    skipped: true,
-                    reason: `No assets found in package (checked: ${assetTypes.join(', ')})`,
-                };
-            const foundSummary = assetTypes
-                .map((type) => `${(assetFiles[type] || []).length} ${type}`)
-                .join(', ');
-            logger.logger.step('Found', foundSummary);
-            const fileMappings = {};
-            for (const assetType of assetTypes) {
-                const entries = assetFiles[assetType] || [];
-                if (entries.length === 0)
-                    continue;
-                const filteredEntries = entries.filter((entry) => {
-                    if (!exclusions)
-                        return true;
-                    const excludedPath = `${assetType}/${entry.name}`;
-                    return !exclusions.files.includes(excludedPath);
-                });
-                if (filteredEntries.length === 0)
-                    continue;
-                const structure = assetStructure.getAssetStructure(assetType, claudeConfig);
-                if (structure === 'nested') {
-                    fileMappings[assetType] = filteredEntries.map((e) => ({
-                        name: e.name,
-                        isDirectory: false,
-                    }));
-                }
-                else {
-                    fileMappings[assetType] = groupEntriesIntoSkillUnits(filteredEntries, prefix);
-                }
-            }
-            if (options.dryRun) {
-                for (const assetType of assetTypes) {
-                    const units = fileMappings[assetType];
-                    if (!units || units.length === 0)
-                        continue;
-                    const structure = assetStructure.getAssetStructure(assetType, claudeConfig);
-                    if (structure === 'nested') {
-                        logger.logger.step(`Would sync ${assetType} to`, paths.getDestinationDir(destDir, packageName$1, assetType));
-                        units.forEach((unit) => {
-                            logger.logger.file('create', unit.name);
-                        });
-                    }
-                    else {
-                        logger.logger.step(`Would sync ${assetType} to`, paths.getFlatDestinationDir(destDir, assetType));
-                        units.forEach((unit) => {
-                            const displayName = unit.transformed ?? unit.name;
-                            logger.logger.file('create', displayName);
-                        });
-                    }
-                }
-                const syncedFiles = {};
-                for (const assetType of assetTypes) {
-                    const units = fileMappings[assetType];
-                    if (!units || units.length === 0)
-                        continue;
-                    syncedFiles[assetType] = units.map((u) => u.transformed ?? u.name);
-                }
-                return {
-                    packageName: packageName$1,
-                    success: true,
-                    skipped: false,
-                    syncedFiles,
-                };
-            }
-            for (const assetType of assetTypes) {
-                const structure = assetStructure.getAssetStructure(assetType, claudeConfig);
-                if (structure === 'nested') {
-                    filesystem.cleanAssetDir(destDir, packageName$1, assetType);
-                }
-                else {
-                    filesystem.cleanFlatAssetFiles(destDir, assetType, prefix, unifiedMeta);
-                }
-            }
-            for (const assetType of assetTypes) {
-                const entries = assetFiles[assetType] || [];
-                if (entries.length === 0)
-                    continue;
-                const filteredEntries = entries.filter((entry) => {
-                    if (!exclusions)
-                        return true;
-                    const excludedPath = `${assetType}/${entry.name}`;
-                    return !exclusions.files.includes(excludedPath);
-                });
-                if (filteredEntries.length === 0)
-                    continue;
-                const structure = assetStructure.getAssetStructure(assetType, claudeConfig);
-                logger.logger.step('Downloading', assetType);
-                let downloadedFiles;
-                if (isLocalSource && useLocalSource.docsPath) {
-                    downloadedFiles = await localSource.downloadLocalAssetFiles(useLocalSource.docsPath, assetType, filteredEntries);
-                }
-                else {
-                    const tag = options.ref ?? _package.buildVersionTag(packageName$1, packageInfo.version);
-                    downloadedFiles = await github.downloadAssetFiles(repoInfo, assetPath, assetType, filteredEntries, tag);
-                }
-                if (structure === 'nested') {
-                    for (const [fileName, content] of downloadedFiles) {
-                        filesystem.writeAssetFile(destDir, packageName$1, assetType, fileName, content);
-                        logger.logger.file('create', fileName);
-                    }
-                }
-                else {
-                    for (const [fileName, content] of downloadedFiles) {
-                        const flatName = nameTransform.toFlatFileName(prefix, fileName);
-                        filesystem.writeFlatAssetFile(destDir, assetType, flatName, content);
-                        logger.logger.file('create', flatName);
-                    }
-                }
-            }
-            const updatedMeta = syncMeta.updatePackageInMeta(unifiedMeta, prefix, {
-                originalName: packageName$1,
-                version: packageInfo.version,
-                local: options.local,
-                files: fileMappings,
-                exclusions: exclusions &&
-                    (exclusions.directories.length > 0 || exclusions.files.length > 0)
-                    ? exclusions
-                    : undefined,
-            });
-            updatedMeta.skillUnitFormat = constants.SCHEMA_VERSIONS.SKILL_UNIT_FORMAT;
-            syncMeta.writeUnifiedSyncMeta(destDir, updatedMeta);
-            const syncedFiles = {};
-            for (const assetType of assetTypes) {
-                const units = fileMappings[assetType];
-                if (!units || units.length === 0)
-                    continue;
-                syncedFiles[assetType] = units.map((u) => u.transformed ?? u.name);
-            }
-            return {
-                packageName: packageName$1,
-                success: true,
-                skipped: false,
-                syncedFiles,
-            };
-        }
-        else {
-            const assetPath = _package.buildAssetPath(claudeConfig.assetPath);
-            const useLocalSource = options.ref
-                ? { available: false }
-                : localSource.canUseLocalSource(packageName$1, packageInfo.version, assetPath, cwd);
-            const assetTypes = _package.getAssetTypes(claudeConfig);
-            let assetFiles;
-            let isLocalSource;
-            if (useLocalSource.available && useLocalSource.docsPath) {
-                isLocalSource = true;
-                logger.logger.step('Using', 'local docs from node_modules');
-                assetFiles = await localSource.fetchLocalAssetFiles(useLocalSource.docsPath, assetTypes);
-            }
-            else {
-                if (!repoInfo) {
-                    return {
-                        packageName: packageName$1,
-                        success: false,
-                        skipped: true,
-                        reason: `Package ${packageName$1} has no valid GitHub repository URL for remote fetch`,
-                    };
-                }
-                isLocalSource = false;
-                const tag = options.ref ?? _package.buildVersionTag(packageName$1, packageInfo.version);
-                logger.logger.step('Fetching', `asset list from GitHub (ref: ${tag})`);
-                assetFiles = await github.fetchAssetFiles(repoInfo, assetPath, tag, assetTypes);
-            }
-            let totalFiles = 0;
-            for (const assetType of assetTypes) {
-                totalFiles += (assetFiles[assetType] || []).length;
-            }
-            if (totalFiles === 0)
-                return {
-                    packageName: packageName$1,
-                    success: false,
-                    skipped: true,
-                    reason: `No assets found in package (checked: ${assetTypes.join(', ')})`,
-                };
-            const foundSummary = assetTypes
-                .map((type) => `${(assetFiles[type] || []).length} ${type}`)
-                .join(', ');
-            logger.logger.step('Found', foundSummary);
-            if (!options.force &&
-                !filesystem.needsSync(destDir, packageName$1, packageInfo.version, assetTypes)) {
-                return {
-                    packageName: packageName$1,
-                    success: true,
-                    skipped: true,
-                    reason: `Already synced at version ${packageInfo.version}`,
-                };
-            }
-            if (options.dryRun) {
-                const syncedFiles = {};
-                for (const assetType of assetTypes) {
-                    const entries = assetFiles[assetType] || [];
-                    if (entries.length === 0)
-                        continue;
-                    const filteredEntries = entries.filter((entry) => {
-                        if (!exclusions)
-                            return true;
-                        const excludedPath = `${assetType}/${entry.name}`;
-                        return !exclusions.files.includes(excludedPath);
-                    });
-                    if (filteredEntries.length === 0)
-                        continue;
-                    logger.logger.step(`Would sync ${assetType} to`, paths.getDestinationDir(destDir, packageName$1, assetType));
-                    filteredEntries.forEach((entry) => logger.logger.file('create', entry.name));
-                    syncedFiles[assetType] = filteredEntries.map((e) => e.name);
-                }
-                return {
-                    packageName: packageName$1,
-                    success: true,
-                    skipped: false,
-                    syncedFiles,
-                };
-            }
-            const syncedFiles = {};
-            for (const assetType of assetTypes) {
-                const entries = assetFiles[assetType] || [];
-                if (entries.length === 0)
-                    continue;
-                const filteredEntries = entries.filter((entry) => {
-                    if (!exclusions)
-                        return true;
-                    const excludedPath = `${assetType}/${entry.name}`;
-                    return !exclusions.files.includes(excludedPath);
-                });
-                if (filteredEntries.length === 0)
-                    continue;
-                logger.logger.step('Downloading', assetType);
-                let downloadedFiles;
-                if (isLocalSource && useLocalSource.docsPath) {
-                    downloadedFiles = await localSource.downloadLocalAssetFiles(useLocalSource.docsPath, assetType, filteredEntries);
-                }
-                else {
-                    const tag = options.ref ?? _package.buildVersionTag(packageName$1, packageInfo.version);
-                    downloadedFiles = await github.downloadAssetFiles(repoInfo, assetPath, assetType, filteredEntries, tag);
-                }
-                filesystem.cleanAssetDir(destDir, packageName$1, assetType);
-                syncedFiles[assetType] = [];
-                for (const [fileName, content] of downloadedFiles) {
-                    filesystem.writeAssetFile(destDir, packageName$1, assetType, fileName, content);
-                    logger.logger.file('create', fileName);
-                    syncedFiles[assetType].push(fileName);
-                }
-                filesystem.writeSyncMeta(destDir, packageName$1, assetType, filesystem.createSyncMeta(packageInfo.version, syncedFiles[assetType]));
-            }
-            return {
-                packageName: packageName$1,
-                success: true,
-                skipped: false,
-                syncedFiles,
-            };
-        }
-    }
-    catch (error) {
-        if (error instanceof github.RateLimitError)
-            return {
-                packageName: packageName$1,
-                success: false,
-                skipped: false,
-                reason: error.message,
-            };
-        const message = error instanceof Error ? error.message : 'Unknown error occurred';
-        return {
-            packageName: packageName$1,
-            success: false,
-            skipped: false,
-            reason: message,
-        };
-    }
-};
-const syncPackages = async (packages, options, cwd = process.cwd()) => {
-    const results = [];
-    const gitRoot = _package.findGitRoot(cwd);
-    if (gitRoot)
-        logger.logger.info(`[Output] ${gitRoot}/.claude\n`);
-    for (const packageName of packages) {
-        const result = await syncPackage(packageName, options, cwd, undefined, gitRoot ?? undefined);
-        logger.logger.packageEnd(packageName, result);
-        results.push(result);
-    }
-    const summary = {
-        success: results.filter((r) => r.success && !r.skipped).length,
-        skipped: results.filter((r) => r.skipped).length,
-        failed: results.filter((r) => !r.success && !r.skipped).length,
-    };
-    logger.logger.summary(summary);
-    return results;
-};
-
-exports.syncPackage = syncPackage;
-exports.syncPackages = syncPackages;

package/dist/core/sync.d.ts

@@ -1,21 +0,0 @@
-import type { CliOptions, SyncResult } from '../utils/types';
-/**
- * Sync Claude assets for a single package
- * @param packageName - Package name to sync
- * @param options - CLI options
- * @param cwd - Current working directory
- * @param exclusions - Optional exclusions for selective syncing
- * @returns Sync result
- */
-export declare const syncPackage: (packageName: string, options: Pick<CliOptions, "force" | "dryRun" | "local" | "ref" | "flat">, cwd?: string, exclusions?: {
-    directories: string[];
-    files: string[];
-}, outputDir?: string) => Promise<SyncResult>;
-/**
- * Sync Claude assets for multiple packages
- * @param packages - List of package names to sync
- * @param options - CLI options
- * @param cwd - Current working directory
- * @returns Array of sync results
- */
-export declare const syncPackages: (packages: string[], options: Pick<CliOptions, "force" | "dryRun" | "local" | "ref" | "flat">, cwd?: string) => Promise<SyncResult[]>;