@slats/claude-assets-sync 0.0.3 → 0.0.4

package/dist/commands/remove.cjs

@@ -6,7 +6,7 @@ var readline = require('node:readline/promises');
 var pc = require('picocolors');
 var syncMeta = require('../core/syncMeta.cjs');
 var logger = require('../utils/logger.cjs');
-var nameTransform = require('../utils/nameTransform.cjs');
+var packageName = require('../utils/packageName.cjs');
 
 function _interopNamespaceDefault(e) {
     var n = Object.create(null);
@@ -30,17 +30,17 @@ var path__namespace = /*#__PURE__*/_interopNamespaceDefault(path);
 var readline__namespace = /*#__PURE__*/_interopNamespaceDefault(readline);
 
 const runRemoveCommand = async (options, cwd = process.cwd()) => {
-    const { package: packageName, yes, dryRun } = options;
-    const prefix = nameTransform.packageNameToPrefix(packageName);
+    const { package: packageName$1, yes, dryRun } = options;
+    const prefix = packageName.packageNameToPrefix(packageName$1);
     const meta = syncMeta.readUnifiedSyncMeta(cwd);
     if (!meta || !meta.packages || !meta.packages[prefix]) {
-        logger.logger.error(`Package ${packageName} is not synced.`);
+        logger.logger.error(`Package ${packageName$1} is not synced.`);
         process.exit(1);
         return;
     }
     const packageInfo = meta.packages[prefix];
     if (!packageInfo || !packageInfo.files) {
-        logger.logger.error(`Package ${packageName} has no files to remove.`);
+        logger.logger.error(`Package ${packageName$1} has no files to remove.`);
         process.exit(1);
         return;
     }
@@ -57,7 +57,7 @@ const runRemoveCommand = async (options, cwd = process.cwd()) => {
             }
         }
         else {
-            const dirPath = path__namespace.join(cwd, '.claude', assetType, packageName);
+            const dirPath = path__namespace.join(cwd, '.claude', assetType, packageName$1);
             filesToRemove.push({ assetType, path: dirPath });
         }
     }
@@ -103,7 +103,7 @@ const runRemoveCommand = async (options, cwd = process.cwd()) => {
     delete meta.packages[prefix];
     meta.syncedAt = new Date().toISOString();
     syncMeta.writeUnifiedSyncMeta(cwd, meta);
-    logger.logger.success(`\nRemoved package ${packageName}`);
+    logger.logger.success(`\nRemoved package ${packageName$1}`);
 };
 
 exports.runRemoveCommand = runRemoveCommand;

package/dist/commands/remove.mjs

@@ -4,7 +4,7 @@ import * as readline from 'node:readline/promises';
 import pc from 'picocolors';
 import { readUnifiedSyncMeta, writeUnifiedSyncMeta } from '../core/syncMeta.mjs';
 import { logger } from '../utils/logger.mjs';
-import { packageNameToPrefix } from '../utils/nameTransform.mjs';
+import { packageNameToPrefix } from '../utils/packageName.mjs';
 
 const runRemoveCommand = async (options, cwd = process.cwd()) => {
     const { package: packageName, yes, dryRun } = options;

package/dist/core/assetStructure.d.ts

@@ -1,4 +1,4 @@
-import type { AssetStructure, AssetsConfig } from '../utils/types';
+import type { AssetStructure, AssetsConfig } from '../utils/types.js';
 import { DEFAULT_ASSET_TYPES } from './constants';
 export { DEFAULT_ASSET_TYPES };
 /**

package/dist/core/constants.d.ts

@@ -22,7 +22,7 @@ export declare const META_FILES: {
  * Schema versions for metadata files
  */
 export declare const SCHEMA_VERSIONS: {
-    readonly UNIFIED_SYNC_META: "0.0.3";
+    readonly UNIFIED_SYNC_META: "0.0.4";
     readonly LEGACY_SYNC_META: "1.0.0";
 };
 /**

package/dist/core/filesystem.cjs

@@ -58,24 +58,36 @@ const cleanFlatAssetFiles = (cwd, assetType, prefix, existingMeta) => {
         const packageInfo = existingMeta.packages[prefix];
         const filesToRemove = packageInfo.files[assetType];
         if (Array.isArray(filesToRemove)) {
+            const skillDirs = new Set();
             for (const fileMapping of filesToRemove) {
                 const fileName = typeof fileMapping === 'string'
                     ? fileMapping
                     : fileMapping.transformed;
-                const filePath = path.join(destDir, fileName);
-                if (io.fileExists(filePath)) {
-                    fs.rmSync(filePath, { force: true });
+                if (fileName.includes('/')) {
+                    skillDirs.add(fileName.split('/')[0]);
+                }
+                else {
+                    const filePath = path.join(destDir, fileName);
+                    if (io.fileExists(filePath)) {
+                        fs.rmSync(filePath, { force: true });
+                    }
+                }
+            }
+            for (const dir of skillDirs) {
+                const dirPath = path.join(destDir, dir);
+                if (io.fileExists(dirPath)) {
+                    fs.rmSync(dirPath, { recursive: true, force: true });
                 }
             }
         }
     }
     else {
         const pattern = `${prefix}_`;
-        const files = io.listDirectory(destDir);
-        for (const file of files) {
-            if (file.startsWith(pattern) && file.endsWith('.md')) {
-                const filePath = path.join(destDir, file);
-                fs.rmSync(filePath, { force: true });
+        const entries = io.listDirectory(destDir);
+        for (const entry of entries) {
+            if (entry.startsWith(pattern)) {
+                const entryPath = path.join(destDir, entry);
+                fs.rmSync(entryPath, { recursive: true, force: true });
             }
         }
     }

package/dist/core/filesystem.d.ts

@@ -1,4 +1,4 @@
-import type { AssetType, SyncMeta, UnifiedSyncMeta } from '../utils/types';
+import type { AssetType, SyncMeta, UnifiedSyncMeta } from '../utils/types.js';
 import { ensureDirectory, writeTextFile } from './io';
 /**
  * Ensure directory exists (creates recursively if needed)
@@ -71,7 +71,8 @@ export declare const createSyncMeta: (version: string, files: string[]) => SyncM
 export declare const writeFlatAssetFile: (cwd: string, assetType: AssetType, flatFileName: string, content: string) => void;
 /**
  * Clean flat asset files with specific prefix
- * Removes only files belonging to the specified package, preserving others
+ * Removes only files belonging to the specified package, preserving others.
+ * Handles both single flat files (prefix_file.md) and directory-based skills (prefix_dir/).
  * @param cwd - Current working directory
  * @param assetType - Asset type (commands, skills, agents, or any custom string)
  * @param prefix - Package prefix (e.g., "canard-schemaForm")

package/dist/core/filesystem.mjs

@@ -56,24 +56,36 @@ const cleanFlatAssetFiles = (cwd, assetType, prefix, existingMeta) => {
         const packageInfo = existingMeta.packages[prefix];
         const filesToRemove = packageInfo.files[assetType];
         if (Array.isArray(filesToRemove)) {
+            const skillDirs = new Set();
             for (const fileMapping of filesToRemove) {
                 const fileName = typeof fileMapping === 'string'
                     ? fileMapping
                     : fileMapping.transformed;
-                const filePath = join(destDir, fileName);
-                if (fileExists(filePath)) {
-                    rmSync(filePath, { force: true });
+                if (fileName.includes('/')) {
+                    skillDirs.add(fileName.split('/')[0]);
+                }
+                else {
+                    const filePath = join(destDir, fileName);
+                    if (fileExists(filePath)) {
+                        rmSync(filePath, { force: true });
+                    }
+                }
+            }
+            for (const dir of skillDirs) {
+                const dirPath = join(destDir, dir);
+                if (fileExists(dirPath)) {
+                    rmSync(dirPath, { recursive: true, force: true });
                 }
             }
         }
     }
     else {
         const pattern = `${prefix}_`;
-        const files = listDirectory(destDir);
-        for (const file of files) {
-            if (file.startsWith(pattern) && file.endsWith('.md')) {
-                const filePath = join(destDir, file);
-                rmSync(filePath, { force: true });
+        const entries = listDirectory(destDir);
+        for (const entry of entries) {
+            if (entry.startsWith(pattern)) {
+                const entryPath = join(destDir, entry);
+                rmSync(entryPath, { recursive: true, force: true });
             }
         }
     }

package/dist/core/github.cjs

@@ -37,17 +37,44 @@ const fetchDirectoryContents = async (repoInfo, path, tag) => {
     if (!response.ok)
         throw new Error(`GitHub API error: ${response.status} ${response.statusText}`);
     const data = await response.json();
-    return data.filter((entry) => entry.type === 'file' && entry.name.endsWith('.md'));
+    return data.filter((entry) => (entry.type === 'file' && entry.name.endsWith('.md')) ||
+        entry.type === 'dir');
+};
+const expandDirectoryEntries = async (repoInfo, parentPath, entries, tag, prefix = '') => {
+    const result = [];
+    for (const entry of entries) {
+        const entryPrefix = prefix ? `${prefix}/${entry.name}` : entry.name;
+        if (entry.type === 'file') {
+            result.push({
+                ...entry,
+                name: prefix ? entryPrefix : entry.name,
+            });
+        }
+        else if (entry.type === 'dir') {
+            const subEntries = await fetchDirectoryContents(repoInfo, `${parentPath}/${entry.name}`, tag);
+            if (subEntries) {
+                const expanded = await expandDirectoryEntries(repoInfo, `${parentPath}/${entry.name}`, subEntries, tag, entryPrefix);
+                result.push(...expanded);
+            }
+        }
+    }
+    return result;
 };
 const fetchAssetFiles = async (repoInfo, assetPath, tag, assetTypes) => {
     const basePath = repoInfo.directory
         ? `${repoInfo.directory}/${assetPath}`
         : assetPath;
     const fetchPromises = assetTypes.map((assetType) => fetchDirectoryContents(repoInfo, `${basePath}/${assetType}`, tag));
-    const results = await Promise.all(fetchPromises);
+    const rawResults = await Promise.all(fetchPromises);
+    const expandedResults = await Promise.all(rawResults.map((entries, index) => {
+        if (!entries)
+            return Promise.resolve([]);
+        const assetDirPath = `${basePath}/${assetTypes[index]}`;
+        return expandDirectoryEntries(repoInfo, assetDirPath, entries, tag);
+    }));
     const assetFiles = {};
     assetTypes.forEach((assetType, index) => {
-        assetFiles[assetType] = results[index] || [];
+        assetFiles[assetType] = expandedResults[index] || [];
     });
     return assetFiles;
 };
@@ -83,5 +110,6 @@ exports.NotFoundError = NotFoundError;
 exports.RateLimitError = RateLimitError;
 exports.downloadAssetFiles = downloadAssetFiles;
 exports.downloadFile = downloadFile;
+exports.expandDirectoryEntries = expandDirectoryEntries;
 exports.fetchAssetFiles = fetchAssetFiles;
 exports.fetchDirectoryContents = fetchDirectoryContents;

package/dist/core/github.d.ts

@@ -1,4 +1,4 @@
-import type { AssetType, GitHubEntry, GitHubRepoInfo } from '../utils/types';
+import type { AssetType, GitHubEntry, GitHubRepoInfo } from '../utils/types.js';
 /**
  * Error thrown when GitHub API rate limit is exceeded
  */
@@ -19,6 +19,19 @@ export declare class NotFoundError extends Error {
  * @returns Array of GitHubEntry or null if directory doesn't exist
  */
 export declare const fetchDirectoryContents: (repoInfo: GitHubRepoInfo, path: string, tag: string) => Promise<GitHubEntry[] | null>;
+/**
+ * Expand directory entries into flat file entries with recursive traversal.
+ * Fetches contents of each directory and prefixes file names with the directory path.
+ * Recursively traverses subdirectories to collect all nested files.
+ *
+ * @param repoInfo - GitHub repository information
+ * @param parentPath - Parent directory path in the repository
+ * @param entries - Array of GitHubEntry (may contain both file and dir types)
+ * @param tag - Git tag or ref to fetch from
+ * @param prefix - Accumulated path prefix for nested entries
+ * @returns Flat array of file GitHubEntry with dir-prefixed names
+ */
+export declare const expandDirectoryEntries: (repoInfo: GitHubRepoInfo, parentPath: string, entries: GitHubEntry[], tag: string, prefix?: string) => Promise<GitHubEntry[]>;
 /**
  * Fetch asset files dynamically from GitHub
  * @param repoInfo - GitHub repository information

package/dist/core/github.mjs

@@ -35,17 +35,44 @@ const fetchDirectoryContents = async (repoInfo, path, tag) => {
     if (!response.ok)
         throw new Error(`GitHub API error: ${response.status} ${response.statusText}`);
     const data = await response.json();
-    return data.filter((entry) => entry.type === 'file' && entry.name.endsWith('.md'));
+    return data.filter((entry) => (entry.type === 'file' && entry.name.endsWith('.md')) ||
+        entry.type === 'dir');
+};
+const expandDirectoryEntries = async (repoInfo, parentPath, entries, tag, prefix = '') => {
+    const result = [];
+    for (const entry of entries) {
+        const entryPrefix = prefix ? `${prefix}/${entry.name}` : entry.name;
+        if (entry.type === 'file') {
+            result.push({
+                ...entry,
+                name: prefix ? entryPrefix : entry.name,
+            });
+        }
+        else if (entry.type === 'dir') {
+            const subEntries = await fetchDirectoryContents(repoInfo, `${parentPath}/${entry.name}`, tag);
+            if (subEntries) {
+                const expanded = await expandDirectoryEntries(repoInfo, `${parentPath}/${entry.name}`, subEntries, tag, entryPrefix);
+                result.push(...expanded);
+            }
+        }
+    }
+    return result;
 };
 const fetchAssetFiles = async (repoInfo, assetPath, tag, assetTypes) => {
     const basePath = repoInfo.directory
         ? `${repoInfo.directory}/${assetPath}`
         : assetPath;
     const fetchPromises = assetTypes.map((assetType) => fetchDirectoryContents(repoInfo, `${basePath}/${assetType}`, tag));
-    const results = await Promise.all(fetchPromises);
+    const rawResults = await Promise.all(fetchPromises);
+    const expandedResults = await Promise.all(rawResults.map((entries, index) => {
+        if (!entries)
+            return Promise.resolve([]);
+        const assetDirPath = `${basePath}/${assetTypes[index]}`;
+        return expandDirectoryEntries(repoInfo, assetDirPath, entries, tag);
+    }));
     const assetFiles = {};
     assetTypes.forEach((assetType, index) => {
-        assetFiles[assetType] = results[index] || [];
+        assetFiles[assetType] = expandedResults[index] || [];
     });
     return assetFiles;
 };
@@ -77,4 +104,4 @@ const downloadAssetFiles = async (repoInfo, assetPath, assetType, entries, tag)
     return results;
 };
 
-export { NotFoundError, RateLimitError, downloadAssetFiles, downloadFile, fetchAssetFiles, fetchDirectoryContents };
+export { NotFoundError, RateLimitError, downloadAssetFiles, downloadFile, expandDirectoryEntries, fetchAssetFiles, fetchDirectoryContents };

package/dist/core/migration.cjs

@@ -3,6 +3,7 @@
 var fs = require('node:fs');
 var path = require('node:path');
 var nameTransform = require('../utils/nameTransform.cjs');
+var packageName = require('../utils/packageName.cjs');
 var filesystem = require('./filesystem.cjs');
 var syncMeta = require('./syncMeta.cjs');
 
@@ -62,8 +63,8 @@ async function migrateToFlat(cwd, options = {}) {
                 });
                 for (const packageDir of packageDirs) {
                     const packagePath = path.join(scopePath, packageDir);
-                    const packageName = `${scopeDir}/${packageDir}`;
-                    console.log(`  📦 Processing ${packageName}...`);
+                    const packageName$1 = `${scopeDir}/${packageDir}`;
+                    console.log(`  📦 Processing ${packageName$1}...`);
                     try {
                         const metaPath = path.join(packagePath, '.sync-meta.json');
                         let legacyMeta = null;
@@ -75,7 +76,7 @@ async function migrateToFlat(cwd, options = {}) {
                             console.log(`    ⚠️  No .sync-meta.json found, skipping`);
                             continue;
                         }
-                        const prefix = nameTransform.packageNameToPrefix(packageName);
+                        const prefix = packageName.packageNameToPrefix(packageName$1);
                         const commandFiles = [];
                         const fileMappings = [];
                         for (const fileName of legacyMeta.files) {
@@ -112,7 +113,7 @@ async function migrateToFlat(cwd, options = {}) {
                             }
                         }
                         const packageInfo = {
-                            originalName: packageName,
+                            originalName: packageName$1,
                             version: legacyMeta.version,
                             files: {
                                 commands: assetType === 'commands' ? commandFiles : [],
@@ -136,11 +137,11 @@ async function migrateToFlat(cwd, options = {}) {
                             }
                         }
                         unifiedMeta = syncMeta.updatePackageInMeta(unifiedMeta, prefix, packageInfo);
-                        migratedPackages.push(packageName);
+                        migratedPackages.push(packageName$1);
                         legacyDirs.push(packagePath);
                     }
                     catch (error) {
-                        const errorMsg = `Failed to migrate ${packageName}: ${error}`;
+                        const errorMsg = `Failed to migrate ${packageName$1}: ${error}`;
                         console.error(`    ❌ ${errorMsg}`);
                         errors.push(errorMsg);
                     }

package/dist/core/migration.mjs

@@ -1,6 +1,7 @@
 import { existsSync, readdirSync, statSync, readFileSync, rmSync } from 'node:fs';
 import { join } from 'node:path';
-import { packageNameToPrefix, toFlatFileName } from '../utils/nameTransform.mjs';
+import { toFlatFileName } from '../utils/nameTransform.mjs';
+import { packageNameToPrefix } from '../utils/packageName.mjs';
 import { writeFlatAssetFile } from './filesystem.mjs';
 import { readUnifiedSyncMeta, createEmptyUnifiedMeta, updatePackageInMeta, writeUnifiedSyncMeta } from './syncMeta.mjs';
 

package/dist/core/packageScanner.cjs

@@ -72,15 +72,25 @@ async function scanRemoteAssets(packageName, ref) {
         throw new Error(`Invalid GitHub repository URL in package ${packageName}`);
     }
     const assetBasePath = pkgInfo.claude.assetPath;
+    const tag = ref ?? 'HEAD';
     const trees = [];
     for (const assetType of constants.DEFAULT_ASSET_TYPES) {
         const assetPath = repoInfo.directory
             ? `${repoInfo.directory}/${assetBasePath}/${assetType}`
             : `${assetBasePath}/${assetType}`;
         try {
-            const entries = await github.fetchDirectoryContents(repoInfo, assetPath, ref ?? 'HEAD');
+            const entries = await github.fetchDirectoryContents(repoInfo, assetPath, tag);
             if (entries && entries.length > 0) {
-                const tree = buildTreeFromGitHubEntries(assetType, entries, assetType);
+                const dirContentsMap = new Map();
+                for (const entry of entries) {
+                    if (entry.type === 'dir') {
+                        const dirEntries = await github.fetchDirectoryContents(repoInfo, `${assetPath}/${entry.name}`, tag);
+                        if (dirEntries) {
+                            dirContentsMap.set(entry.name, dirEntries);
+                        }
+                    }
+                }
+                const tree = buildTreeFromGitHubEntries(assetType, entries, assetType, dirContentsMap);
                 if (tree.children && tree.children.length > 0) {
                     trees.push(tree);
                 }
@@ -100,7 +110,8 @@ function buildTreeFromLocalDir(label, dirPath, basePath) {
         const stat = fs.statSync(fullPath);
         const relativePath = path.join(basePath, entry);
         if (stat.isDirectory()) {
-            const isSkill = fs.existsSync(path.join(fullPath, 'Skill.md'));
+            const isSkill = fs.existsSync(path.join(fullPath, 'SKILL.md')) ||
+                fs.existsSync(path.join(fullPath, 'Skill.md'));
             if (isSkill) {
                 children.push({
                     id: relativePath,
@@ -139,36 +150,37 @@ function buildTreeFromLocalDir(label, dirPath, basePath) {
         expanded: true,
     };
 }
-function buildTreeFromGitHubEntries(label, entries, basePath) {
+function buildTreeFromGitHubEntries(label, entries, basePath, dirContentsMap) {
     const children = [];
-    const grouped = groupByTopLevel(entries);
-    for (const [name, items] of Object.entries(grouped)) {
-        if (items.length === 1 && items[0].type === 'file') {
-            const filePath = items[0].path;
+    for (const entry of entries) {
+        if (entry.type === 'file') {
             children.push({
-                id: filePath,
-                label: name,
-                path: filePath,
+                id: entry.path,
+                label: entry.name,
+                path: entry.path,
                 type: 'file',
                 selected: true,
                 expanded: false,
             });
         }
-        else {
-            const isSkill = items.some((item) => item.type === 'file' && item.name === 'Skill.md');
-            if (isSkill) {
-                const skillPath = `${basePath}/${name}`;
+        else if (entry.type === 'dir') {
+            const dirEntries = dirContentsMap?.get(entry.name);
+            const hasSkillMd = dirEntries
+                ? isDirectorySkill(dirEntries)
+                : false;
+            if (hasSkillMd) {
+                const skillPath = `${basePath}/${entry.name}`;
                 children.push({
                     id: skillPath,
-                    label: name,
+                    label: entry.name,
                     path: skillPath,
                     type: 'skill-directory',
                     selected: true,
                     expanded: false,
                 });
             }
-            else {
-                const subTree = buildTreeFromGitHubEntries(name, items, `${basePath}/${name}`);
+            else if (dirEntries && dirEntries.length > 0) {
+                const subTree = buildTreeFromGitHubEntries(entry.name, dirEntries, `${basePath}/${entry.name}`);
                 if (subTree.children && subTree.children.length > 0) {
                     children.push(subTree);
                 }
@@ -185,17 +197,9 @@ function buildTreeFromGitHubEntries(label, entries, basePath) {
         expanded: true,
     };
 }
-function groupByTopLevel(entries) {
-    const groups = {};
-    for (const entry of entries) {
-        const parts = entry.path.split('/');
-        const topLevel = parts[parts.length - (entry.type === 'file' ? 1 : 0)];
-        if (!groups[topLevel]) {
-            groups[topLevel] = [];
-        }
-        groups[topLevel].push(entry);
-    }
-    return groups;
+function isDirectorySkill(entries) {
+    return entries.some((entry) => entry.type === 'file' &&
+        (entry.name === 'SKILL.md' || entry.name === 'Skill.md'));
 }
 function findLocalPackage(packageName, cwd) {
     const monorepoRoot = findMonorepoRoot(cwd);
@@ -256,4 +260,5 @@ function searchPackagesRecursively(dir, packageName) {
     return null;
 }
 
+exports.isDirectorySkill = isDirectorySkill;
 exports.scanPackageAssets = scanPackageAssets;

package/dist/core/packageScanner.mjs

@@ -70,15 +70,25 @@ async function scanRemoteAssets(packageName, ref) {
         throw new Error(`Invalid GitHub repository URL in package ${packageName}`);
     }
     const assetBasePath = pkgInfo.claude.assetPath;
+    const tag = ref ?? 'HEAD';
     const trees = [];
     for (const assetType of DEFAULT_ASSET_TYPES) {
         const assetPath = repoInfo.directory
             ? `${repoInfo.directory}/${assetBasePath}/${assetType}`
             : `${assetBasePath}/${assetType}`;
         try {
-            const entries = await fetchDirectoryContents(repoInfo, assetPath, ref ?? 'HEAD');
+            const entries = await fetchDirectoryContents(repoInfo, assetPath, tag);
             if (entries && entries.length > 0) {
-                const tree = buildTreeFromGitHubEntries(assetType, entries, assetType);
+                const dirContentsMap = new Map();
+                for (const entry of entries) {
+                    if (entry.type === 'dir') {
+                        const dirEntries = await fetchDirectoryContents(repoInfo, `${assetPath}/${entry.name}`, tag);
+                        if (dirEntries) {
+                            dirContentsMap.set(entry.name, dirEntries);
+                        }
+                    }
+                }
+                const tree = buildTreeFromGitHubEntries(assetType, entries, assetType, dirContentsMap);
                 if (tree.children && tree.children.length > 0) {
                     trees.push(tree);
                 }
@@ -98,7 +108,8 @@ function buildTreeFromLocalDir(label, dirPath, basePath) {
         const stat = statSync(fullPath);
         const relativePath = join(basePath, entry);
         if (stat.isDirectory()) {
-            const isSkill = existsSync(join(fullPath, 'Skill.md'));
+            const isSkill = existsSync(join(fullPath, 'SKILL.md')) ||
+                existsSync(join(fullPath, 'Skill.md'));
             if (isSkill) {
                 children.push({
                     id: relativePath,
@@ -137,36 +148,37 @@ function buildTreeFromLocalDir(label, dirPath, basePath) {
         expanded: true,
     };
 }
-function buildTreeFromGitHubEntries(label, entries, basePath) {
+function buildTreeFromGitHubEntries(label, entries, basePath, dirContentsMap) {
     const children = [];
-    const grouped = groupByTopLevel(entries);
-    for (const [name, items] of Object.entries(grouped)) {
-        if (items.length === 1 && items[0].type === 'file') {
-            const filePath = items[0].path;
+    for (const entry of entries) {
+        if (entry.type === 'file') {
             children.push({
-                id: filePath,
-                label: name,
-                path: filePath,
+                id: entry.path,
+                label: entry.name,
+                path: entry.path,
                 type: 'file',
                 selected: true,
                 expanded: false,
             });
         }
-        else {
-            const isSkill = items.some((item) => item.type === 'file' && item.name === 'Skill.md');
-            if (isSkill) {
-                const skillPath = `${basePath}/${name}`;
+        else if (entry.type === 'dir') {
+            const dirEntries = dirContentsMap?.get(entry.name);
+            const hasSkillMd = dirEntries
+                ? isDirectorySkill(dirEntries)
+                : false;
+            if (hasSkillMd) {
+                const skillPath = `${basePath}/${entry.name}`;
                 children.push({
                     id: skillPath,
-                    label: name,
+                    label: entry.name,
                     path: skillPath,
                     type: 'skill-directory',
                     selected: true,
                     expanded: false,
                 });
             }
-            else {
-                const subTree = buildTreeFromGitHubEntries(name, items, `${basePath}/${name}`);
+            else if (dirEntries && dirEntries.length > 0) {
+                const subTree = buildTreeFromGitHubEntries(entry.name, dirEntries, `${basePath}/${entry.name}`);
                 if (subTree.children && subTree.children.length > 0) {
                     children.push(subTree);
                 }
@@ -183,17 +195,9 @@ function buildTreeFromGitHubEntries(label, entries, basePath) {
         expanded: true,
     };
 }
-function groupByTopLevel(entries) {
-    const groups = {};
-    for (const entry of entries) {
-        const parts = entry.path.split('/');
-        const topLevel = parts[parts.length - (entry.type === 'file' ? 1 : 0)];
-        if (!groups[topLevel]) {
-            groups[topLevel] = [];
-        }
-        groups[topLevel].push(entry);
-    }
-    return groups;
+function isDirectorySkill(entries) {
+    return entries.some((entry) => entry.type === 'file' &&
+        (entry.name === 'SKILL.md' || entry.name === 'Skill.md'));
 }
 function findLocalPackage(packageName, cwd) {
     const monorepoRoot = findMonorepoRoot(cwd);
@@ -254,4 +258,4 @@ function searchPackagesRecursively(dir, packageName) {
     return null;
 }
 
-export { scanPackageAssets };
+export { isDirectorySkill, scanPackageAssets };

package/dist/core/sync.cjs

@@ -3,23 +3,24 @@
 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 filesystem = require('./filesystem.cjs');
 var github = require('./github.cjs');
 var syncMeta = require('./syncMeta.cjs');
 var assetStructure = require('./assetStructure.cjs');
 
-const syncPackage = async (packageName, options, cwd = process.cwd(), exclusions, outputDir) => {
-    logger.logger.packageStart(packageName);
+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, cwd)
-            : _package.readPackageJson(packageName, cwd);
+            ? _package.readLocalPackageJson(packageName$1, cwd)
+            : _package.readPackageJson(packageName$1, cwd);
         if (!packageInfo) {
             const location = options.local ? 'workspace' : 'node_modules';
             return {
-                packageName,
+                packageName: packageName$1,
                 success: false,
                 skipped: true,
                 reason: `Package not found in ${location}`,
@@ -27,7 +28,7 @@ const syncPackage = async (packageName, options, cwd = process.cwd(), exclusions
         }
         if (!packageInfo.claude?.assetPath)
             return {
-                packageName,
+                packageName: packageName$1,
                 success: false,
                 skipped: true,
                 reason: 'Package does not have claude.assetPath in package.json',
@@ -35,7 +36,7 @@ const syncPackage = async (packageName, options, cwd = process.cwd(), exclusions
         const repoInfo = _package.parseGitHubRepo(packageInfo.repository);
         if (!repoInfo) {
             return {
-                packageName,
+                packageName: packageName$1,
                 success: false,
                 skipped: true,
                 reason: 'Unable to parse GitHub repository URL',
@@ -43,18 +44,18 @@ const syncPackage = async (packageName, options, cwd = process.cwd(), exclusions
         }
         const useFlat = options.flat !== false;
         if (useFlat) {
-            const prefix = nameTransform.packageNameToPrefix(packageName);
+            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: packageName$1,
                     success: true,
                     skipped: true,
                     reason: `Already synced at version ${packageInfo.version}`,
                 };
             }
-            const tag = options.ref ?? _package.buildVersionTag(packageName, packageInfo.version);
+            const tag = options.ref ?? _package.buildVersionTag(packageName$1, packageInfo.version);
             const assetPath = _package.buildAssetPath(packageInfo.claude.assetPath);
             logger.logger.step('Fetching', `asset list from GitHub (ref: ${tag})`);
             const assetTypes = _package.getAssetTypes(packageInfo.claude);
@@ -65,7 +66,7 @@ const syncPackage = async (packageName, options, cwd = process.cwd(), exclusions
             }
             if (totalFiles === 0)
                 return {
-                    packageName,
+                    packageName: packageName$1,
                     success: false,
                     skipped: true,
                     reason: `No assets found in package (checked: ${assetTypes.join(', ')})`,
@@ -105,7 +106,7 @@ const syncPackage = async (packageName, options, cwd = process.cwd(), exclusions
                         continue;
                     const structure = assetStructure.getAssetStructure(assetType, packageInfo.claude);
                     if (structure === 'nested') {
-                        logger.logger.step(`Would sync ${assetType} to`, paths.getDestinationDir(destDir, packageName, assetType));
+                        logger.logger.step(`Would sync ${assetType} to`, paths.getDestinationDir(destDir, packageName$1, assetType));
                         mappings.forEach((fileName) => {
                             logger.logger.file('create', fileName);
                         });
@@ -130,7 +131,7 @@ const syncPackage = async (packageName, options, cwd = process.cwd(), exclusions
                     }
                 }
                 return {
-                    packageName,
+                    packageName: packageName$1,
                     success: true,
                     skipped: false,
                     syncedFiles,
@@ -139,7 +140,7 @@ const syncPackage = async (packageName, options, cwd = process.cwd(), exclusions
             for (const assetType of assetTypes) {
                 const structure = assetStructure.getAssetStructure(assetType, packageInfo.claude);
                 if (structure === 'nested') {
-                    filesystem.cleanAssetDir(destDir, packageName, assetType);
+                    filesystem.cleanAssetDir(destDir, packageName$1, assetType);
                 }
                 else {
                     filesystem.cleanFlatAssetFiles(destDir, assetType, prefix, unifiedMeta);
@@ -162,7 +163,7 @@ const syncPackage = async (packageName, options, cwd = process.cwd(), exclusions
                 const downloadedFiles = await github.downloadAssetFiles(repoInfo, assetPath, assetType, filteredEntries, tag);
                 if (structure === 'nested') {
                     for (const [fileName, content] of downloadedFiles) {
-                        filesystem.writeAssetFile(destDir, packageName, assetType, fileName, content);
+                        filesystem.writeAssetFile(destDir, packageName$1, assetType, fileName, content);
                         logger.logger.file('create', fileName);
                     }
                 }
@@ -177,7 +178,7 @@ const syncPackage = async (packageName, options, cwd = process.cwd(), exclusions
                 }
             }
             const updatedMeta = syncMeta.updatePackageInMeta(unifiedMeta, prefix, {
-                originalName: packageName,
+                originalName: packageName$1,
                 version: packageInfo.version,
                 local: options.local,
                 files: fileMappings,
@@ -200,14 +201,14 @@ const syncPackage = async (packageName, options, cwd = process.cwd(), exclusions
                 }
             }
             return {
-                packageName,
+                packageName: packageName$1,
                 success: true,
                 skipped: false,
                 syncedFiles,
             };
         }
         else {
-            const tag = options.ref ?? _package.buildVersionTag(packageName, packageInfo.version);
+            const tag = options.ref ?? _package.buildVersionTag(packageName$1, packageInfo.version);
             const assetPath = _package.buildAssetPath(packageInfo.claude.assetPath);
             logger.logger.step('Fetching', `asset list from GitHub (ref: ${tag})`);
             const assetTypes = _package.getAssetTypes(packageInfo.claude);
@@ -218,7 +219,7 @@ const syncPackage = async (packageName, options, cwd = process.cwd(), exclusions
             }
             if (totalFiles === 0)
                 return {
-                    packageName,
+                    packageName: packageName$1,
                     success: false,
                     skipped: true,
                     reason: `No assets found in package (checked: ${assetTypes.join(', ')})`,
@@ -228,9 +229,9 @@ const syncPackage = async (packageName, options, cwd = process.cwd(), exclusions
                 .join(', ');
             logger.logger.step('Found', foundSummary);
             if (!options.force &&
-                !filesystem.needsSync(destDir, packageName, packageInfo.version, assetTypes)) {
+                !filesystem.needsSync(destDir, packageName$1, packageInfo.version, assetTypes)) {
                 return {
-                    packageName,
+                    packageName: packageName$1,
                     success: true,
                     skipped: true,
                     reason: `Already synced at version ${packageInfo.version}`,
@@ -250,12 +251,12 @@ const syncPackage = async (packageName, options, cwd = process.cwd(), exclusions
                     });
                     if (filteredEntries.length === 0)
                         continue;
-                    logger.logger.step(`Would sync ${assetType} to`, paths.getDestinationDir(destDir, packageName, assetType));
+                    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: packageName$1,
                     success: true,
                     skipped: false,
                     syncedFiles,
@@ -276,17 +277,17 @@ const syncPackage = async (packageName, options, cwd = process.cwd(), exclusions
                     continue;
                 logger.logger.step('Downloading', assetType);
                 const downloadedFiles = await github.downloadAssetFiles(repoInfo, assetPath, assetType, filteredEntries, tag);
-                filesystem.cleanAssetDir(destDir, packageName, assetType);
+                filesystem.cleanAssetDir(destDir, packageName$1, assetType);
                 syncedFiles[assetType] = [];
                 for (const [fileName, content] of downloadedFiles) {
-                    filesystem.writeAssetFile(destDir, packageName, assetType, fileName, content);
+                    filesystem.writeAssetFile(destDir, packageName$1, assetType, fileName, content);
                     logger.logger.file('create', fileName);
                     syncedFiles[assetType].push(fileName);
                 }
-                filesystem.writeSyncMeta(destDir, packageName, assetType, filesystem.createSyncMeta(packageInfo.version, syncedFiles[assetType]));
+                filesystem.writeSyncMeta(destDir, packageName$1, assetType, filesystem.createSyncMeta(packageInfo.version, syncedFiles[assetType]));
             }
             return {
-                packageName,
+                packageName: packageName$1,
                 success: true,
                 skipped: false,
                 syncedFiles,
@@ -296,14 +297,14 @@ const syncPackage = async (packageName, options, cwd = process.cwd(), exclusions
     catch (error) {
         if (error instanceof github.RateLimitError)
             return {
-                packageName,
+                packageName: packageName$1,
                 success: false,
                 skipped: false,
                 reason: error.message,
             };
         const message = error instanceof Error ? error.message : 'Unknown error occurred';
         return {
-            packageName,
+            packageName: packageName$1,
             success: false,
             skipped: false,
             reason: message,

package/dist/core/sync.mjs

@@ -1,6 +1,7 @@
 import { logger } from '../utils/logger.mjs';
-import { packageNameToPrefix, toFlatFileName } from '../utils/nameTransform.mjs';
+import { toFlatFileName } from '../utils/nameTransform.mjs';
 import { findGitRoot, readLocalPackageJson, readPackageJson, parseGitHubRepo, buildVersionTag, buildAssetPath, getAssetTypes } from '../utils/package.mjs';
+import { packageNameToPrefix } from '../utils/packageName.mjs';
 import { getDestinationDir, getFlatDestinationDir } from '../utils/paths.mjs';
 import { cleanAssetDir, cleanFlatAssetFiles, writeAssetFile, writeFlatAssetFile, needsSync, writeSyncMeta, createSyncMeta } from './filesystem.mjs';
 import { fetchAssetFiles, downloadAssetFiles, RateLimitError } from './github.mjs';

package/dist/core/syncMeta.d.ts

@@ -2,7 +2,7 @@ import type { PackageSyncInfo, UnifiedSyncMeta } from '../utils/types.js';
 /**
  * Schema version for the unified metadata format
  */
-export declare const SCHEMA_VERSION: "0.0.3";
+export declare const SCHEMA_VERSION: "0.0.4";
 /**
  * Read unified sync metadata from .claude/.sync-meta.json
  *

package/dist/utils/nameTransform.cjs

@@ -1,12 +1,13 @@
 'use strict';
 
-var packageName = require('./packageName.cjs');
-
-const packageNameToPrefix = packageName.packageNameToPrefix;
 function toFlatFileName(prefix, fileName) {
-    const flatFileName = fileName.replace(/[/\\]/g, '_');
-    return `${prefix}_${flatFileName}`;
+    const slashIndex = fileName.indexOf('/');
+    if (slashIndex === -1) {
+        return `${prefix}_${fileName}`;
+    }
+    const dirName = fileName.substring(0, slashIndex);
+    const rest = fileName.substring(slashIndex);
+    return `${prefix}_${dirName}${rest}`;
 }
 
-exports.packageNameToPrefix = packageNameToPrefix;
 exports.toFlatFileName = toFlatFileName;

package/dist/utils/nameTransform.d.ts

@@ -1,8 +1,3 @@
-/**
- * Name transformation utilities for Claude assets synchronization
- * Handles conversion between package names and flat file naming conventions
- */
-import { packageNameToPrefix as packageNameToPrefixUtil } from './packageName';
 /**
  * Converts kebab-case string to camelCase
  * All hyphens are removed and the following character is capitalized
@@ -19,40 +14,34 @@ import { packageNameToPrefix as packageNameToPrefixUtil } from './packageName';
  */
 export declare function kebabToCamel(str: string): string;
 /**
- * Converts a scoped package name to a flat prefix
- * @deprecated Import from './packageName' instead
- * @param packageName - Scoped package name (e.g., '@canard/schema-form')
- * @returns Flat prefix (e.g., 'canard-schemaForm')
- *
- * @example
- * ```ts
- * packageNameToPrefix('@canard/schema-form') // 'canard-schemaForm'
- * packageNameToPrefix('@canard/schema-form-plugin') // 'canard-schemaFormPlugin'
- * packageNameToPrefix('@winglet/react-utils') // 'winglet-reactUtils'
- * packageNameToPrefix('@lerx/promise-modal') // 'lerx-promiseModal'
- * ```
- */
-export declare const packageNameToPrefix: typeof packageNameToPrefixUtil;
-/**
- * Creates a flat file name by combining prefix and original file name
+ * Creates a flat file name by combining prefix and original file name.
+ * For single files (no path separator), creates prefix_filename.
+ * For directory-based entries (with path separator), applies prefix only
+ * to the top-level directory name, preserving internal path structure.
  *
  * @param prefix - Package prefix (e.g., 'canard-schemaForm')
- * @param fileName - Original file name (e.g., 'guide.md')
- * @returns Flat file name (e.g., 'canard-schemaForm_guide.md')
+ * @param fileName - Original file name (e.g., 'guide.md' or 'expert/SKILL.md')
+ * @returns Flat file name with prefix
  *
  * @example
  * ```ts
- * toFlatFileName('canard-schemaForm', 'guide.md') // 'canard-schemaForm_guide.md'
- * toFlatFileName('winglet-reactUtils', 'README.md') // 'winglet-reactUtils_README.md'
- * toFlatFileName('lerx-promiseModal', 'api/types.md') // 'lerx-promiseModal_api_types.md'
+ * toFlatFileName('canard-schemaForm', 'guide.md')
+ * // 'canard-schemaForm_guide.md'
+ *
+ * toFlatFileName('canard-schemaForm', 'expert/SKILL.md')
+ * // 'canard-schemaForm_expert/SKILL.md'
+ *
+ * toFlatFileName('canard-schemaForm', 'expert/knowledge/api.md')
+ * // 'canard-schemaForm_expert/knowledge/api.md'
  * ```
  */
 export declare function toFlatFileName(prefix: string, fileName: string): string;
 /**
- * Parses a flat file name back into prefix and original file name
- * Returns null if the file name doesn't match the expected pattern
+ * Parses a flat file name back into prefix and original file name.
+ * Reverses the transformation done by toFlatFileName.
+ * Returns null if the file name doesn't match the expected pattern.
  *
- * @param flatName - Flat file name (e.g., 'canard-schemaForm_guide.md')
+ * @param flatName - Flat file name (e.g., 'canard-schemaForm_guide.md' or 'canard-schemaForm_expert/SKILL.md')
  * @returns Object with prefix and original name, or null if invalid
  *
  * @example
@@ -60,11 +49,11 @@ export declare function toFlatFileName(prefix: string, fileName: string): string
  * parseFlatFileName('canard-schemaForm_guide.md')
  * // { prefix: 'canard-schemaForm', original: 'guide.md' }
  *
- * parseFlatFileName('winglet-reactUtils_README.md')
- * // { prefix: 'winglet-reactUtils', original: 'README.md' }
+ * parseFlatFileName('canard-schemaForm_expert/SKILL.md')
+ * // { prefix: 'canard-schemaForm', original: 'expert/SKILL.md' }
  *
- * parseFlatFileName('lerx-promiseModal_api_types.md')
- * // { prefix: 'lerx-promiseModal', original: 'api/types.md' }
+ * parseFlatFileName('canard-schemaForm_expert/knowledge/api.md')
+ * // { prefix: 'canard-schemaForm', original: 'expert/knowledge/api.md' }
  *
  * parseFlatFileName('invalid-name.md')
  * // null (no underscore separator)

package/dist/utils/nameTransform.mjs

@@ -1,9 +1,11 @@
-import { packageNameToPrefix as packageNameToPrefix$1 } from './packageName.mjs';
-
-const packageNameToPrefix = packageNameToPrefix$1;
 function toFlatFileName(prefix, fileName) {
-    const flatFileName = fileName.replace(/[/\\]/g, '_');
-    return `${prefix}_${flatFileName}`;
+    const slashIndex = fileName.indexOf('/');
+    if (slashIndex === -1) {
+        return `${prefix}_${fileName}`;
+    }
+    const dirName = fileName.substring(0, slashIndex);
+    const rest = fileName.substring(slashIndex);
+    return `${prefix}_${dirName}${rest}`;
 }
 
-export { packageNameToPrefix, toFlatFileName };
+export { toFlatFileName };

package/dist/version.cjs

@@ -1,5 +1,5 @@
 'use strict';
 
-const VERSION = '0.0.3';
+const VERSION = '0.0.4';
 
 exports.VERSION = VERSION;

package/dist/version.d.ts

@@ -2,4 +2,4 @@
  * Current package version from package.json
  * Automatically synchronized during build process
  */
-export declare const VERSION = "0.0.3";
+export declare const VERSION = "0.0.4";

package/dist/version.mjs

@@ -1,3 +1,3 @@
-const VERSION = '0.0.3';
+const VERSION = '0.0.4';
 
 export { VERSION };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@slats/claude-assets-sync",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "description": "CLI tool to sync Claude commands and skills from npm packages to your project's .claude directory",
   "keywords": [
     "claude",
@@ -43,7 +43,7 @@
     "build": "node scripts/inject-version.js && rollup -c && yarn build:types",
     "build:publish:npm": "yarn build && yarn publish:npm",
     "build:types": "tsc -p ./tsconfig.declarations.json && tsc-alias -p ./tsconfig.declarations.json",
-    "dev": "node scripts/inject-version.js && tsx src/index.ts",
+    "dev": "node scripts/inject-version.js && tsx src/cli.ts",
     "format": "prettier --write \"src/**/*.ts\"",
     "lint": "eslint \"src/**/*.ts\"",
     "publish:npm": "yarn npm publish --access public",

package/CHANGELOG.md

@@ -1,189 +0,0 @@
-# Changelog
-
-All notable changes to @slats/claude-assets-sync will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [0.0.1] - 2025-02-05
-
-### Added
-
-#### Phase 1: Version Management Unification
-- Unified version management system across all packages
-- Single `.sync-meta.json` file replacing per-package metadata
-- Comprehensive package tracking with original names and file mappings
-- Timestamp tracking for all sync operations
-- Version comparison logic to skip unnecessary syncs
-
-#### Phase 2: Code Consolidation & Architecture
-- Modular command architecture with pluggable command system
-- New `src/commands/` directory for command implementations
-- Command registry system (`COMMANDS` export) with metadata
-- Centralized command types in `src/commands/types.ts`
-- Unified CLI structure using Commander.js
-- Better separation of concerns between CLI and command logic
-
-#### Phase 3: Flat Directory Structure Support
-- Modern flat file organization with prefixed filenames
-- Name transformation system for scoped packages
-- Support for both flat and nested directory structures
-- `--no-flat` flag to maintain backward compatibility with legacy structure
-- Smart detection of directory structure type during sync operations
-
-#### Phase 4: Package Management Features
-- **list command**: List all synced packages with asset details
-  - Human-readable output with package names, versions, and asset counts
-  - JSON output support for scripting and automation
-  - Asset breakdown by type (commands, skills, etc.)
-  - Sort by package name for consistency
-
-- **remove command**: Remove synced packages safely
-  - Support for both flat and nested structures
-  - Confirmation prompts (skip with `-y/--yes`)
-  - Dry-run mode for preview
-  - Automatic metadata cleanup after removal
-  - Graceful error handling for missing files
-
-- **status command**: Monitor sync status and check for updates
-  - Real-time remote version checking via npm registry
-  - Version mismatch detection with visual indicators
-  - Cached remote version checks (5-minute TTL)
-  - `--no-remote` flag to skip remote checks
-  - Summary statistics of sync status
-
-- **migrate command**: Migrate from legacy to flat structure
-  - Automatic conversion of nested directories to flat naming
-  - Comprehensive dry-run support
-  - Metadata preservation during migration
-  - Safe multi-run operation
-
-#### Phase 5: Interactive UI Infrastructure
-- Ink + React configuration for interactive CLI components
-- TypeScript JSX support (jsx: "react-jsx")
-- UI component infrastructure with fallback to plain text
-- ink (^4.4.1), ink-spinner (^5.0.0), react (^18.2.0) dependencies
-- Type definitions for React components (@types/react)
-- ESM compatibility maintained with interactive UI support
-
-#### Phase 6: Testing & Documentation
-- Comprehensive README documentation for all commands
-- Korean translation (README-ko_kr.md) with all features
-- Detailed command usage examples and workflows
-- Environment variable documentation
-- Troubleshooting guide with common issues and solutions
-- Architecture documentation explaining data flow
-- CI/CD integration examples
-- Rate limit documentation with mitigation strategies
-
-### Enhanced
-
-- **Sync Logic**: Extended to support both flat and nested structures
-- **Error Handling**: Improved error messages with context-aware suggestions
-- **Logging**: Color-coded output with picocolors for better visibility
-- **GitHub Integration**: Support for custom git refs (branches, tags, commits)
-- **Local Workspace Support**: Option to read packages from local workspace
-- **File System Operations**: Safe handling of both file and directory removal
-
-### Changed
-
-- CLI structure: Main sync is now default command with sub-commands (list, remove, status, migrate)
-- Version checking: Now compares against unified metadata instead of per-package files
-- Directory organization: Flat structure is now default (use `--no-flat` for legacy)
-- Metadata format: Unified schema with package prefixes as keys
-- File naming: Scoped packages now use hyphen-separated prefixes (e.g., @scope-package-file.md)
-
-### Fixed
-
-- Version comparison for flat structure packages
-- Metadata update timing during removal operations
-- Directory creation for deeply nested legacy structures
-- File path handling for Windows compatibility
-
-### Technical Details
-
-#### New File Mappings
-Each file is now tracked with original and transformed names:
-```json
-{
-  "original": "my-command.md",
-  "transformed": "@scope-package-my-command.md"
-}
-```
-
-#### Updated Metadata Structure
-```json
-{
-  "version": "0.0.1",
-  "syncedAt": "2025-02-05T10:30:00.000Z",
-  "packages": {
-    "@scope-package": {
-      "originalName": "@scope/package",
-      "version": "1.0.0",
-      "files": {
-        "commands": [...],
-        "skills": [...]
-      }
-    }
-  }
-}
-```
-
-#### Command Dependencies
-- **sync**: Core functionality, no command dependencies
-- **list**: Depends on unified metadata reading
-- **remove**: Depends on unified metadata, file system operations
-- **status**: Depends on npm registry API, version caching
-- **migrate**: Depends on legacy structure detection, transformation logic
-
-### Dependencies Added
-
-- **ink** (^4.4.1): React renderer for terminal UIs
-- **ink-spinner** (^5.0.0): Loading spinner component for ink
-- **react** (^18.2.0): UI component framework
-- **@types/react** (^18.2.0): TypeScript types for React
-
-### Dependencies Unchanged
-
-- **commander** (^12.1.0): CLI argument parsing
-- **picocolors** (^1.1.1): Terminal color output
-
-### Breaking Changes
-
-None. The tool maintains backward compatibility:
-- `--no-flat` flag allows using legacy nested structure
-- Existing metadata files are automatically migrated
-- All previous commands and options continue to work
-
-### Security
-
-- No security vulnerabilities introduced
-- Confirmation prompts for destructive operations
-- Dry-run mode for all write operations
-- Safe file system operations with error handling
-
-### Performance
-
-- Efficient metadata reading and writing
-- Cached remote version checks reduce API calls
-- Parallel package processing capability ready (infrastructure in place)
-- Minimal memory overhead for large package lists
-
-### Compatibility
-
-- Node.js: Compatible with modern Node versions supporting ES modules
-- Operating Systems: Windows, macOS, Linux
-- npm Packages: Works with all npm packages providing claude assets
-
-## [Unreleased]
-
-### Planned
-
-- Interactive UI components for progress visualization
-- Batch operations with progress indication
-- Configuration file support (.claude-sync.json)
-- Pre/post sync hooks
-- Asset validation and schema checking
-- Custom asset type support
-- Asset versioning and conflict resolution
-- Cloud storage integration (optional)