tools-cc 1.0.0 → 1.0.3

package/AGENTS.md

@@ -0,0 +1,164 @@
+# tools-cc 项目上下文
+
+## 项目概述
+
+tools-cc 是一个 CLI 工具，用于统一管理多个 AI 编程工具（iflow、claude、codebuddy、opencode 等）的 skills/commands/agents 配置。通过符号链接机制，避免在多个工具间重复配置。
+
+## 技术栈
+
+- **语言**: TypeScript (ES2020, strict mode)
+- **CLI 框架**: Commander.js
+- **文件操作**: fs-extra
+- **终端输出**: chalk
+- **交互式命令**: inquirer
+- **测试框架**: vitest
+- **运行时**: Node.js (CommonJS)
+
+## 项目结构
+
+```
+tools-cc/
+├── src/
+│   ├── index.ts          # CLI 入口，命令注册
+│   ├── commands/         # CLI 命令处理器
+│   │   ├── config.ts     # 配置管理命令
+│   │   ├── help.ts       # 帮助信息
+│   │   ├── source.ts     # 源管理命令
+│   │   └── use.ts        # 项目使用命令
+│   ├── core/             # 核心业务逻辑
+│   │   ├── config.ts     # 配置读写
+│   │   ├── manifest.ts   # manifest.json 解析
+│   │   ├── project.ts    # 项目管理
+│   │   ├── source.ts     # 源管理
+│   │   └── symlink.ts    # 符号链接创建
+│   ├── types/            # TypeScript 类型定义
+│   │   └── config.ts     # 核心接口定义
+│   └── utils/
+│       └── path.ts       # 路径常量和工具函数
+├── tests/                # 测试文件
+│   ├── core/             # 核心模块测试
+│   └── fixtures/         # 测试固件
+└── dist/                 # 编译输出
+```
+
+## 构建和运行
+
+```bash
+# 安装依赖
+npm install
+
+# 开发模式运行
+npm run dev
+
+# 编译 TypeScript
+npm run build
+
+# 运行编译后的代码
+npm start
+
+# 运行测试
+npm test
+
+# 运行测试（单次）
+npm run test:run
+
+# 全局安装（开发）
+npm link
+```
+
+## 核心命令
+
+### 全局配置源管理
+- `tools-cc -s add <name> <path-or-url>` - 添加配置源
+- `tools-cc -s list` - 列出所有配置源
+- `tools-cc -s remove <name>` - 移除配置源
+- `tools-cc -s update [name]` - git pull 更新源代码
+- `tools-cc -s scan` - 扫描目录发现新源
+
+### 项目配置
+- `tools-cc use [sources...] [-p tools...]` - 启用配置源并创建符号链接
+- `tools-cc update [sources...]` - 同步源内容到项目
+- `tools-cc list` - 列出已启用的配置源
+- `tools-cc rm <source>` - 禁用配置源
+- `tools-cc status` - 查看项目状态
+
+### 配置管理
+- `tools-cc config set <key> <value>` - 设置配置
+- `tools-cc config get <key>` - 获取配置
+- `tools-cc config list` - 查看完整配置
+
+## 支持的 AI 工具
+
+| 工具 | 链接名称 |
+|------|----------|
+| iflow | `.iflow` |
+| claude | `.claude` |
+| codebuddy | `.codebuddy` |
+| opencode | `.opencode` |
+
+## 配置文件位置
+
+- **全局配置**: `~/.tools-cc/config.json`
+- **项目配置**: `项目/.toolscc/config.json`
+- **源存储目录**: `~/.tools-cc/sources`（可配置）
+
+## 核心类型
+
+```typescript
+// 源配置
+interface SourceConfig {
+  type: 'git' | 'local';
+  url?: string;
+  path?: string;
+}
+
+// 全局配置
+interface GlobalConfig {
+  sourcesDir: string;
+  sources: Record<string, SourceConfig>;
+}
+
+// 项目配置
+interface ProjectConfig {
+  sources: string[];
+  links: string[];
+}
+
+// Manifest 文件
+interface Manifest {
+  name: string;
+  version: string;
+  skills?: string[];
+  commands?: string[];
+  agents?: string[];
+}
+```
+
+## 开发约定
+
+### 代码风格
+- 使用 TypeScript strict 模式
+- 异步函数使用 async/await
+- 文件操作使用 fs-extra
+- 命令处理函数命名：`handle*`
+
+### 测试
+- 测试文件放在 `tests/` 目录，镜像 `src/` 结构
+- 使用 vitest 框架
+- 测试固件放在 `tests/fixtures/`
+
+### 命令添加
+1. 在 `src/commands/` 创建或修改命令处理文件
+2. 在 `src/index.ts` 注册新命令
+3. 添加相应的测试
+
+### 文档更新 [CHANGELOG.md](CHANGELOG.md)[README.md](README.md)
+- 更新文档时，请确保命令描述清晰、准确，并使用一致的格式
+- 添加新命令时，请更新命令列表和描述
+- 修改现有命令时，请更新相关命令的描述
+
+## 注意事项
+
+- 此项目运行在 Windows 系统，注意路径分隔符兼容性
+- 符号链接在 Windows 上可能需要管理员权限
+- 全局配置目录位于用户主目录下的 `.tools-cc`

package/CHANGELOG.md

@@ -0,0 +1,63 @@
+# 变更日志
+
+本项目的所有重要变更都将记录在此文件中。
+
+## [1.0.3] - 2026-02-26
+
+### Changed
+- 项目配置文件位置从 `tools-cc.json` 改为 `.toolscc/config.json`
+- 优化文档命令描述，明确区分全局和项目命令
+
+## [1.0.2] - 2026-02-26
+
+### Added
+- 新增 `tools-cc -s scan` 命令：扫描 sourcesDir 目录，自动发现并添加配置源
+- 新增 `tools-cc -s upgrade [name]` 命令别名：执行 git pull 更新配置源代码
+- 新增 `tools-cc update [sources...]` 命令：同步配置源内容到项目 .toolscc 目录
+
+### Changed
+- 优化帮助文档，添加工作流说明和命令对比表
+
+## [1.0.1] - 2026-02-25
+
+### Added
+- 补充 package.json 仓库相关元数据（repository、bugs、homepage）
+
+## [1.0.0] - 2026-02-25
+
+### Added
+- 项目初始化，基于 TypeScript + Commander 构建 CLI 框架
+- 全局配置管理模块
+  - `tools-cc -c set <key> <value>` 设置配置
+  - `tools-cc -c get <key>` 查看配置
+  - `tools-cc config list` 查看完整配置
+- 配置源管理模块
+  - `tools-cc -s add <name> <path-or-url>` 添加配置源（支持 Git URL 和本地路径）
+  - `tools-cc -s list` 列出所有配置源
+  - `tools-cc -s remove <name>` 移除配置源
+  - `tools-cc -s update [name]` 更新配置源（git pull）
+- 项目管理模块
+  - `tools-cc use [sources...]` 启用配置源并创建符号链接
+  - `tools-cc list` 列出已启用的配置源
+  - `tools-cc rm <source>` 禁用配置源
+  - `tools-cc status` 查看项目状态
+- 符号链接管理模块（支持 Windows Junction）
+- Manifest 加载和扫描模块
+- 中英双语帮助信息 (`tools-cc help`)
+- 单元测试覆盖（vitest）
+
+### Supported Tools
+| 工具 | 链接名称 |
+|------|----------|
+| iflow | `.iflow` |
+| claude | `.claude` |
+| codebuddy | `.codebuddy` |
+| opencode | `.opencode` |
+
+---
+
+## 版本说明
+
+- **主版本号**: 不兼容的 API 变更
+- **次版本号**: 向后兼容的功能新增
+- **修订号**: 向后兼容的问题修复

package/{readme.md → README.md}

@@ -26,6 +26,9 @@ tools-cc -c set sourcesDir D:/skills-hub-sources
 tools-cc -s add my-skills https://github.com/user/my-skills.git
 tools-cc -s add local-skills D:/path/to/local-skills
 
+# 或者扫描源目录自动发现并添加配置
+tools-cc -s scan
+
 # 3. 查看已添加的配置源
 tools-cc -s list
 
@@ -39,32 +42,65 @@ tools-cc status
 # 6. 查看已启用的配置源
 tools-cc list
 
-# 7. 移除配置源
+# 7. 更新配置源（从源目录同步最新内容到项目）
+tools-cc update my-skills
+tools-cc update              # 更新全部
+
+# 8. 移除配置源
 tools-cc rm my-skills
 ```
 
+## 工作流说明
+
+### 全局配置源管理 vs 项目配置
+
+| 命令 | 作用域 | 说明 |
+|------|--------|------|
+| `tools-cc -s add/remove/list` | 全局 | 管理全局配置源 |
+| `tools-cc -s update/upgrade` | 全局 | git pull 更新源代码 |
+| `tools-cc -s scan` | 全局 | 扫描目录发现新源 |
+| `tools-cc use/rm` | 项目 | 在项目中启用/禁用源 |
+| `tools-cc update` | 项目 | 同步源内容到项目 |
+
+### 典型工作流
+
+```bash
+# 场景1: 配置源有更新，需要同步到项目
+tools-cc -s upgrade my-skills    # 1. git pull 更新源代码
+cd my-project
+tools-cc update my-skills        # 2. 同步到项目 .toolscc 目录
+
+# 场景2: 批量更新所有源
+tools-cc -s upgrade              # 1. 更新所有 git 源
+cd my-project
+tools-cc update                  # 2. 同步所有源到项目
+```
+
 ## 命令列表
 
 ### Source 管理
 
 ```bash
 # 快捷方式 (-s)
-tools-cc -s add <name> <path-or-url>     # 添加配置源
+tools-cc -s add <name> <path-or-url>     # 添加配置源（Git URL 或本地路径）
 tools-cc -s list                          # 列出所有配置源 (缩写: -s ls)
 tools-cc -s remove <name>                 # 移除配置源 (缩写: -s rm)
-tools-cc -s update [name]                 # 更新配置源 (缩写: -s up)
+tools-cc -s update [name]                 # git pull 更新配置源代码 (缩写: -s up, -s upgrade)
+tools-cc -s scan                          # 扫描 sourcesDir 目录，自动发现并添加配置源
 
 # 完整命令 (sources)
 tools-cc sources add <name> <path-or-url> # 添加配置源
 tools-cc sources list                     # 列出所有配置源 (缩写: sources ls)
 tools-cc sources remove <name>            # 移除配置源 (缩写: sources rm)
-tools-cc sources update [name]            # 更新配置源 (缩写: sources up)
+tools-cc sources update [name]            # git pull 更新配置源代码 (缩写: sources up, sources upgrade)
+tools-cc sources scan                     # 扫描 sourcesDir 目录，自动发现并添加配置源
 ```
 
 ### 项目配置
 
 ```bash
-tools-cc use [sources...] [-p tools...]   # 启用配置源并创建链接
+tools-cc use [sources...] [-p tools...]   # 启用配置源并创建符号链接
+tools-cc update [sources...]              # 同步配置源内容到项目 .toolscc 目录
 tools-cc list                             # 列出已启用的配置源
 tools-cc rm <source>                      # 禁用配置源
 tools-cc status                           # 查看项目状态
@@ -137,6 +173,7 @@ my-skills/
 ```
 my-project/
 ├── .toolscc/                     # 实际内容目录
+│   ├── config.json               # 项目配置
 │   ├── skills/                   # 扁平化，带来源前缀
 │   │   └── my-skills-my-skill/
 │   ├── commands/
@@ -144,8 +181,7 @@ my-project/
 │   └── agents/
 │       └── my-skills/
 ├── .iflow -> .toolscc            # 符号链接
-├── .claude -> .toolscc
-└── tools-cc.json                 # 项目配置
+└── .claude -> .toolscc
 ```
 
 ## 配置文件
@@ -168,7 +204,7 @@ my-project/
 }
 ```
 
-### 项目配置 `项目/tools-cc.json`
+### 项目配置 `项目/.toolscc/config.json`
 
 ```json
 {

package/dist/commands/source.d.ts

@@ -2,3 +2,4 @@ export declare function handleSourceAdd(name: string, pathOrUrl: string): Promis
 export declare function handleSourceList(): Promise<void>;
 export declare function handleSourceRemove(name: string): Promise<void>;
 export declare function handleSourceUpdate(name?: string): Promise<void>;
+export declare function handleSourceScan(): Promise<void>;

package/dist/commands/source.js

@@ -7,6 +7,7 @@ exports.handleSourceAdd = handleSourceAdd;
 exports.handleSourceList = handleSourceList;
 exports.handleSourceRemove = handleSourceRemove;
 exports.handleSourceUpdate = handleSourceUpdate;
+exports.handleSourceScan = handleSourceScan;
 const chalk_1 = __importDefault(require("chalk"));
 const source_1 = require("../core/source");
 const path_1 = require("../utils/path");
@@ -70,3 +71,31 @@ async function handleSourceUpdate(name) {
         console.log(chalk_1.default.red(`✗ ${error instanceof Error ? error.message : 'Unknown error'}`));
     }
 }
+async function handleSourceScan() {
+    try {
+        console.log(chalk_1.default.bold('Scanning sources directory...'));
+        const result = await (0, source_1.scanSources)(path_1.GLOBAL_CONFIG_DIR);
+        if (result.added.length > 0) {
+            console.log(chalk_1.default.green(`\n✓ Added ${result.added.length} source(s):`));
+            for (const name of result.added) {
+                console.log(chalk_1.default.gray(`  + ${name}`));
+            }
+        }
+        if (result.updated.length > 0) {
+            console.log(chalk_1.default.yellow(`\n⚡ Updated ${result.updated.length} source(s):`));
+            for (const name of result.updated) {
+                console.log(chalk_1.default.gray(`  ~ ${name}`));
+            }
+        }
+        if (result.skipped.length > 0) {
+            console.log(chalk_1.default.gray(`\n→ Skipped ${result.skipped.length} existing source(s)`));
+        }
+        if (result.added.length === 0 && result.updated.length === 0 && result.skipped.length === 0) {
+            console.log(chalk_1.default.gray('No sources found in sources directory.'));
+        }
+        console.log(chalk_1.default.green(`\n✓ Scan complete`));
+    }
+    catch (error) {
+        console.log(chalk_1.default.red(`✗ ${error instanceof Error ? error.message : 'Unknown error'}`));
+    }
+}

package/dist/commands/use.d.ts

@@ -4,3 +4,4 @@ export declare function handleUse(sourceNames: string[], options: {
 export declare function handleList(): Promise<void>;
 export declare function handleRemove(sourceName: string): Promise<void>;
 export declare function handleStatus(): Promise<void>;
+export declare function handleProjectUpdate(sourceNames?: string[]): Promise<void>;

package/dist/commands/use.js

@@ -7,6 +7,7 @@ exports.handleUse = handleUse;
 exports.handleList = handleList;
 exports.handleRemove = handleRemove;
 exports.handleStatus = handleStatus;
+exports.handleProjectUpdate = handleProjectUpdate;
 const chalk_1 = __importDefault(require("chalk"));
 const inquirer_1 = __importDefault(require("inquirer"));
 const project_1 = require("../core/project");
@@ -77,7 +78,7 @@ async function handleUse(sourceNames, options) {
         }
     }
     // 更新项目配置
-    const configFile = path_2.default.join(projectDir, 'tools-cc.json');
+    const configFile = (0, path_1.getProjectConfigPath)(projectDir);
     const config = await fs_extra_1.default.readJson(configFile);
     const existingLinks = config.links || [];
     config.links = [...new Set([...existingLinks, ...tools])];
@@ -116,7 +117,7 @@ async function handleStatus() {
     // 检查 sources
     console.log(`  Sources: ${sources.length > 0 ? sources.map(s => chalk_1.default.cyan(s)).join(', ') : chalk_1.default.gray('none')}`);
     // 检查 links
-    const configFile = path_2.default.join(projectDir, 'tools-cc.json');
+    const configFile = (0, path_1.getProjectConfigPath)(projectDir);
     if (await fs_extra_1.default.pathExists(configFile)) {
         const config = await fs_extra_1.default.readJson(configFile);
         console.log(`  Links:`);
@@ -131,3 +132,40 @@ async function handleStatus() {
     }
     console.log();
 }
+async function handleProjectUpdate(sourceNames) {
+    const projectDir = process.cwd();
+    const configFile = (0, path_1.getProjectConfigPath)(projectDir);
+    // 检查项目是否已初始化
+    if (!(await fs_extra_1.default.pathExists(configFile))) {
+        console.log(chalk_1.default.yellow('Project not initialized. Run `tools-cc use <source>` first.'));
+        return;
+    }
+    const config = await fs_extra_1.default.readJson(configFile);
+    let sourcesToUpdate = sourceNames && sourceNames.length > 0
+        ? sourceNames
+        : config.sources || [];
+    if (sourcesToUpdate.length === 0) {
+        console.log(chalk_1.default.gray('No sources to update.'));
+        return;
+    }
+    // 验证指定的源是否存在于项目配置中
+    if (sourceNames && sourceNames.length > 0) {
+        const invalidSources = sourceNames.filter((s) => !config.sources.includes(s));
+        if (invalidSources.length > 0) {
+            console.log(chalk_1.default.yellow(`Sources not in project: ${invalidSources.join(', ')}`));
+        }
+        sourcesToUpdate = sourcesToUpdate.filter((s) => config.sources.includes(s));
+    }
+    // 更新每个配置源
+    for (const sourceName of sourcesToUpdate) {
+        try {
+            const sourcePath = await (0, source_1.getSourcePath)(sourceName, path_1.GLOBAL_CONFIG_DIR);
+            await (0, project_1.useSource)(sourceName, sourcePath, projectDir);
+            console.log(chalk_1.default.green(`✓ Updated source: ${sourceName}`));
+        }
+        catch (error) {
+            console.log(chalk_1.default.red(`✗ Failed to update ${sourceName}: ${error instanceof Error ? error.message : 'Unknown error'}`));
+        }
+    }
+    console.log(chalk_1.default.green(`\n✓ Project update complete`));
+}

package/dist/core/source.d.ts

@@ -4,3 +4,9 @@ export declare function listSources(configDir: string): Promise<Record<string, S
 export declare function removeSource(name: string, configDir: string): Promise<void>;
 export declare function updateSource(name: string, configDir: string): Promise<void>;
 export declare function getSourcePath(name: string, configDir: string): Promise<string>;
+export interface ScanResult {
+    added: string[];
+    updated: string[];
+    skipped: string[];
+}
+export declare function scanSources(configDir: string): Promise<ScanResult>;

package/dist/core/source.js

@@ -8,6 +8,7 @@ exports.listSources = listSources;
 exports.removeSource = removeSource;
 exports.updateSource = updateSource;
 exports.getSourcePath = getSourcePath;
+exports.scanSources = scanSources;
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const path_1 = __importDefault(require("path"));
 const child_process_1 = require("child_process");
@@ -84,3 +85,80 @@ async function getSourcePath(name, configDir) {
     }
     return path_1.default.join(config.sourcesDir, name);
 }
+async function scanSources(configDir) {
+    const config = await (0, config_1.loadGlobalConfig)(configDir);
+    const result = { added: [], updated: [], skipped: [] };
+    // 确保 sourcesDir 存在
+    if (!(await fs_extra_1.default.pathExists(config.sourcesDir))) {
+        await fs_extra_1.default.ensureDir(config.sourcesDir);
+        return result;
+    }
+    // 获取 sourcesDir 下的所有文件夹
+    const entries = await fs_extra_1.default.readdir(config.sourcesDir, { withFileTypes: true });
+    const directories = entries
+        .filter(entry => entry.isDirectory())
+        .map(entry => entry.name);
+    // 检查每个 git source 的克隆目录是否还存在
+    for (const [name, source] of Object.entries(config.sources)) {
+        if (source.type === 'git') {
+            const cloneDir = path_1.default.join(config.sourcesDir, name);
+            if (!(await fs_extra_1.default.pathExists(cloneDir))) {
+                // 克隆目录不存在，从配置中移除
+                delete config.sources[name];
+                console.log(`Removed missing git source: ${name}`);
+            }
+        }
+    }
+    // 扫描目录并更新配置
+    for (const dirName of directories) {
+        const dirPath = path_1.default.join(config.sourcesDir, dirName);
+        const existingSource = config.sources[dirName];
+        // 检查是否是 git 仓库
+        const isGitRepo = await fs_extra_1.default.pathExists(path_1.default.join(dirPath, '.git'));
+        if (existingSource) {
+            // 已存在配置
+            if (existingSource.type === 'git' && isGitRepo) {
+                result.skipped.push(dirName);
+            }
+            else if (existingSource.type === 'local' && existingSource.path === dirPath) {
+                result.skipped.push(dirName);
+            }
+            else {
+                // 配置不一致，更新为当前状态
+                if (isGitRepo) {
+                    // 尝试获取远程 URL
+                    try {
+                        const remoteUrl = (0, child_process_1.execSync)(`git -C "${dirPath}" config --get remote.origin.url`, { encoding: 'utf-8' }).trim();
+                        config.sources[dirName] = { type: 'git', url: remoteUrl };
+                    }
+                    catch {
+                        config.sources[dirName] = { type: 'local', path: dirPath };
+                    }
+                }
+                else {
+                    config.sources[dirName] = { type: 'local', path: dirPath };
+                }
+                result.updated.push(dirName);
+            }
+        }
+        else {
+            // 新发现的目录，添加到配置
+            if (isGitRepo) {
+                // 尝试获取远程 URL
+                try {
+                    const remoteUrl = (0, child_process_1.execSync)(`git -C "${dirPath}" config --get remote.origin.url`, { encoding: 'utf-8' }).trim();
+                    config.sources[dirName] = { type: 'git', url: remoteUrl };
+                }
+                catch {
+                    config.sources[dirName] = { type: 'local', path: dirPath };
+                }
+            }
+            else {
+                config.sources[dirName] = { type: 'local', path: dirPath };
+            }
+            result.added.push(dirName);
+        }
+    }
+    await (0, config_1.saveGlobalConfig)(config, configDir);
+    return result;
+}

package/dist/index.js

@@ -42,10 +42,17 @@ sourceCmd
 sourceCmd
     .command('update [name]')
     .alias('up')
-    .description('Update source(s)')
+    .alias('upgrade')
+    .description('Update source(s) with git pull')
     .action(async (name) => {
     await (0, source_1.handleSourceUpdate)(name);
 });
+sourceCmd
+    .command('scan')
+    .description('Scan sources directory and update configuration')
+    .action(async () => {
+    await (0, source_1.handleSourceScan)();
+});
 // Config subcommands (full command version)
 const configCmd = program
     .command('config')
@@ -94,6 +101,12 @@ program
     .action(async () => {
     await (0, use_1.handleStatus)();
 });
+program
+    .command('update [sources...]')
+    .description('Update source(s) in current project')
+    .action(async (sources) => {
+    await (0, use_1.handleProjectUpdate)(sources);
+});
 // Help command
 program
     .command('help')
@@ -129,8 +142,12 @@ program
                 break;
             case 'update':
             case 'up':
+            case 'upgrade':
                 await (0, source_1.handleSourceUpdate)(args[0]);
                 break;
+            case 'scan':
+                await (0, source_1.handleSourceScan)();
+                break;
             default:
                 console.log(`Unknown source command: ${cmd}`);
         }

package/dist/utils/path.d.ts

@@ -4,5 +4,5 @@ export declare const DEFAULT_CONFIG: {
     sourcesDir: string;
     sources: {};
 };
-export declare function getProjectConfigPath(projectDir: string): string;
 export declare function getToolsccDir(projectDir: string): string;
+export declare function getProjectConfigPath(projectDir: string): string;

package/dist/utils/path.js

@@ -4,8 +4,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DEFAULT_CONFIG = exports.GLOBAL_CONFIG_FILE = exports.GLOBAL_CONFIG_DIR = void 0;
-exports.getProjectConfigPath = getProjectConfigPath;
 exports.getToolsccDir = getToolsccDir;
+exports.getProjectConfigPath = getProjectConfigPath;
 const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
 exports.GLOBAL_CONFIG_DIR = path_1.default.join(os_1.default.homedir(), '.tools-cc');
@@ -14,9 +14,9 @@ exports.DEFAULT_CONFIG = {
     sourcesDir: path_1.default.join(exports.GLOBAL_CONFIG_DIR, 'sources'),
     sources: {}
 };
-function getProjectConfigPath(projectDir) {
-    return path_1.default.join(projectDir, 'tools-cc.json');
-}
 function getToolsccDir(projectDir) {
     return path_1.default.join(projectDir, '.toolscc');
 }
+function getProjectConfigPath(projectDir) {
+    return path_1.default.join(getToolsccDir(projectDir), 'config.json');
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tools-cc",
-  "version": "1.0.0",
+  "version": "1.0.3",
   "description": "tools-cc [options] <command> [args]",
   "main": "index.js",
   "directories": {

package/src/commands/source.ts

@@ -1,5 +1,5 @@
 import chalk from 'chalk';
-import { addSource, listSources, removeSource, updateSource } from '../core/source';
+import { addSource, listSources, removeSource, updateSource, scanSources } from '../core/source';
 import { GLOBAL_CONFIG_DIR } from '../utils/path';
 
 export async function handleSourceAdd(name: string, pathOrUrl: string): Promise<void> {
@@ -61,3 +61,36 @@ export async function handleSourceUpdate(name?: string): Promise<void> {
     console.log(chalk.red(`✗ ${error instanceof Error ? error.message : 'Unknown error'}`));
   }
 }
+
+export async function handleSourceScan(): Promise<void> {
+  try {
+    console.log(chalk.bold('Scanning sources directory...'));
+    const result = await scanSources(GLOBAL_CONFIG_DIR);
+    
+    if (result.added.length > 0) {
+      console.log(chalk.green(`\n✓ Added ${result.added.length} source(s):`));
+      for (const name of result.added) {
+        console.log(chalk.gray(`  + ${name}`));
+      }
+    }
+    
+    if (result.updated.length > 0) {
+      console.log(chalk.yellow(`\n⚡ Updated ${result.updated.length} source(s):`));
+      for (const name of result.updated) {
+        console.log(chalk.gray(`  ~ ${name}`));
+      }
+    }
+    
+    if (result.skipped.length > 0) {
+      console.log(chalk.gray(`\n→ Skipped ${result.skipped.length} existing source(s)`));
+    }
+    
+    if (result.added.length === 0 && result.updated.length === 0 && result.skipped.length === 0) {
+      console.log(chalk.gray('No sources found in sources directory.'));
+    }
+    
+    console.log(chalk.green(`\n✓ Scan complete`));
+  } catch (error) {
+    console.log(chalk.red(`✗ ${error instanceof Error ? error.message : 'Unknown error'}`));
+  }
+}