tools-cc 1.0.7 → 1.0.9

package/dist/types/config.d.ts

@@ -8,12 +8,13 @@ export interface GlobalConfig {
     sources: Record<string, SourceConfig>;
 }
 /**
- * 源选择配置 - 指定从源中导入哪些 skills/commands/agents
+ * 源选择配置 - 指定从源中导入哪些 skills/commands/agents/rules
  */
 export interface SourceSelection {
     skills: string[];
     commands: string[];
     agents: string[];
+    rules: string[];
 }
 /**
  * 新版项目配置 - sources 使用 Record 格式支持部分导入
@@ -44,6 +45,7 @@ export interface Manifest {
     skills?: string[];
     commands?: string[];
     agents?: string[];
+    rules?: string[];
 }
 export interface ToolConfig {
     linkName: string;
@@ -66,3 +68,13 @@ export interface GlobalExportConfig {
     config: GlobalConfig;
     exportedAt: string;
 }
+/**
+ * 模板配置格式
+ */
+export interface TemplateConfig {
+    version: string;
+    name: string;
+    sourceProject: string;
+    savedAt: string;
+    config: ProjectConfig;
+}

package/dist/types/config.js

@@ -11,7 +11,8 @@ function isSourceSelection(value) {
     const obj = value;
     return (Array.isArray(obj.skills) &&
         Array.isArray(obj.commands) &&
-        Array.isArray(obj.agents));
+        Array.isArray(obj.agents) &&
+        Array.isArray(obj.rules));
 }
 /**
  * 将旧版项目配置转换为新版格式
@@ -25,7 +26,8 @@ function normalizeProjectConfig(config) {
             newSources[sourceName] = {
                 skills: ['*'],
                 commands: ['*'],
-                agents: ['*']
+                agents: ['*'],
+                rules: ['*']
             };
         }
         return { sources: newSources, links: config.links };

package/dist/utils/parsePath.d.ts

@@ -4,7 +4,7 @@ import { SourceSelection } from '../types/config';
  */
 export interface ParsedSourcePath {
     sourceName: string;
-    type?: 'skills' | 'commands' | 'agents';
+    type?: 'skills' | 'commands' | 'agents' | 'rules';
     itemName?: string;
 }
 /**

package/dist/utils/parsePath.js

@@ -25,7 +25,7 @@ function parseSourcePath(input) {
         return { sourceName };
     }
     // 检查第二部分是否为有效类型
-    const validTypes = ['skills', 'commands', 'agents'];
+    const validTypes = ['skills', 'commands', 'agents', 'rules'];
     const type = parts[1];
     if (!validTypes.includes(type)) {
         return { sourceName };
@@ -63,7 +63,8 @@ function buildSelectionFromPaths(paths) {
             result[sourceName] = {
                 skills: [],
                 commands: [],
-                agents: []
+                agents: [],
+                rules: []
             };
         }
         // 如果没有指定类型和项目名称，表示整个源
@@ -71,7 +72,8 @@ function buildSelectionFromPaths(paths) {
             result[sourceName] = {
                 skills: ['*'],
                 commands: ['*'],
-                agents: ['*']
+                agents: ['*'],
+                rules: ['*']
             };
             continue;
         }

package/dist/utils/path.d.ts

@@ -1,8 +1,10 @@
 export declare const GLOBAL_CONFIG_DIR: string;
 export declare const GLOBAL_CONFIG_FILE: string;
+export declare const TEMPLATES_DIR: string;
 export declare const DEFAULT_CONFIG: {
     sourcesDir: string;
     sources: {};
 };
+export declare function getTemplatePath(templateName: string): string;
 export declare function getToolsccDir(projectDir: string): string;
 export declare function getProjectConfigPath(projectDir: string): string;

package/dist/utils/path.js

@@ -3,17 +3,22 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_CONFIG = exports.GLOBAL_CONFIG_FILE = exports.GLOBAL_CONFIG_DIR = void 0;
+exports.DEFAULT_CONFIG = exports.TEMPLATES_DIR = exports.GLOBAL_CONFIG_FILE = exports.GLOBAL_CONFIG_DIR = void 0;
+exports.getTemplatePath = getTemplatePath;
 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');
 exports.GLOBAL_CONFIG_FILE = path_1.default.join(exports.GLOBAL_CONFIG_DIR, 'config.json');
+exports.TEMPLATES_DIR = path_1.default.join(exports.GLOBAL_CONFIG_DIR, 'templates');
 exports.DEFAULT_CONFIG = {
     sourcesDir: path_1.default.join(exports.GLOBAL_CONFIG_DIR, 'sources'),
     sources: {}
 };
+function getTemplatePath(templateName) {
+    return path_1.default.join(exports.TEMPLATES_DIR, `${templateName}.json`);
+}
 function getToolsccDir(projectDir) {
     return path_1.default.join(projectDir, '.toolscc');
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tools-cc",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "tools-cc [options] <command> [args]",
   "main": "index.js",
   "directories": {
@@ -18,14 +18,14 @@
     "release": "npm run tag:create && npm run publish:npm && npm run release:gh"
   },
   "bin": {
-    "tools-cc": "./dist/index.js"
+    "tools-cc": "dist/index.js"
   },
   "keywords": [],
   "author": "",
   "license": "ISC",
   "repository": {
     "type": "git",
-    "url": "https://github.com/q759410559/tools-cc.git"
+    "url": "git+https://github.com/q759410559/tools-cc.git"
   },
   "bugs": {
     "url": "https://github.com/q759410559/tools-cc/issues"

package/src/commands/help.ts

@@ -23,7 +23,7 @@ ${chalk.bold('COMMANDS / 命令')}
     tools-cc sources add <name> <path-or-url>    Add a source / 添加配置源
     tools-cc sources list, ls                    List all sources / 列出所有配置源
     tools-cc sources remove, rm <name>           Remove a source / 移除配置源
-    tools-cc sources update, up [name]           git pull update / 更新源代码
+    tools-cc sources update, up, upgrade [name]  git pull update / 更新源代码
     tools-cc sources scan                        Scan dir for sources / 扫描发现新源
     
     ${chalk.gray('Shortcut: -s')}  e.g., tools-cc -s add my-skills https://github.com/user/skills.git
@@ -43,6 +43,14 @@ ${chalk.bold('COMMANDS / 命令')}
     tools-cc status                              Show project status / 显示项目状态
     tools-cc export [options]                    Export config / 导出配置
 
+  ${chalk.cyan('Template Management / 模板管理')}
+    tools-cc template save [-n <name>]           Save project config as template / 保存项目配置为模板
+    tools-cc template list, ls                   List all templates / 列出所有模板
+    tools-cc template rm <name>                  Delete template / 删除模板
+    tools-cc template use [name]                 Apply template to project / 应用模板到项目
+    
+    ${chalk.gray('Shortcut: tpl')}  e.g., tools-cc tpl save, tools-cc tpl list
+
   ${chalk.cyan('Help / 帮助')}
     tools-cc help                                Show this help / 显示此帮助信息
     tools-cc --help, -h                          Show command help / 显示命令帮助
@@ -95,6 +103,15 @@ ${chalk.bold('EXAMPLES / 示例')}
   ${chalk.gray('# Export project config / 导出项目配置')}
   tools-cc export -o my-config.json
 
+  ${chalk.gray('# Save project config as template / 保存项目配置为模板')}
+  tools-cc template save -n my-template
+
+  ${chalk.gray('# List all templates / 列出所有模板')}
+  tools-cc template list
+
+  ${chalk.gray('# Apply template to project / 应用模板到项目')}
+  tools-cc template use my-template
+
   ${chalk.gray('# Show full configuration / 显示完整配置')}
   tools-cc config list
 

package/src/commands/template.ts

@@ -0,0 +1,160 @@
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import path from 'path';
+import { saveTemplate, listTemplates, removeTemplate, getTemplate } from '../core/template';
+import { loadProjectConfig } from '../core/config';
+import { importProjectConfig } from '../core/project';
+import { getSourcePath } from '../core/source';
+import { TEMPLATES_DIR, getProjectConfigPath, GLOBAL_CONFIG_DIR } from '../utils/path';
+import fs from 'fs-extra';
+
+/**
+ * 处理 template save 命令
+ */
+export async function handleTemplateSave(options: { name?: string }): Promise<void> {
+  const projectDir = process.cwd();
+  const configFile = getProjectConfigPath(projectDir);
+
+  // 检查项目配置是否存在
+  if (!(await fs.pathExists(configFile))) {
+    console.log(chalk.yellow('Project not initialized. Run `tools-cc use <source>` first.'));
+    return;
+  }
+
+  try {
+    // 读取项目配置
+    const config = await loadProjectConfig(projectDir);
+    if (!config) {
+      console.log(chalk.yellow('No project configuration found.'));
+      return;
+    }
+
+    // 确定模板名称
+    let templateName = options.name;
+    if (!templateName) {
+      templateName = path.basename(projectDir);
+    }
+
+    // 检查是否已存在
+    const existing = await getTemplate(templateName, TEMPLATES_DIR);
+    if (existing) {
+      const answers = await inquirer.prompt([
+        {
+          type: 'confirm',
+          name: 'overwrite',
+          message: `Template "${templateName}" already exists. Overwrite?`,
+          default: false
+        }
+      ]);
+      if (!answers.overwrite) {
+        console.log(chalk.gray('Cancelled.'));
+        return;
+      }
+    }
+
+    // 保存模板
+    const template = await saveTemplate(templateName, projectDir, config, TEMPLATES_DIR);
+    console.log(chalk.green(`✓ Template saved: ${template.name}`));
+  } catch (error) {
+    console.log(chalk.red(`✗ Failed to save template: ${error instanceof Error ? error.message : 'Unknown error'}`));
+  }
+}
+
+/**
+ * 处理 template list 命令
+ */
+export async function handleTemplateList(): Promise<void> {
+  const templates = await listTemplates(TEMPLATES_DIR);
+
+  if (templates.length === 0) {
+    console.log(chalk.gray('No templates saved.'));
+    return;
+  }
+
+  console.log(chalk.bold('Saved templates:'));
+  for (const template of templates) {
+    const date = new Date(template.savedAt).toLocaleDateString();
+    console.log(`  ${chalk.cyan(template.name.padEnd(20))} (saved: ${date})`);
+  }
+}
+
+/**
+ * 处理 template rm 命令
+ */
+export async function handleTemplateRemove(name: string): Promise<void> {
+  try {
+    await removeTemplate(name, TEMPLATES_DIR);
+    console.log(chalk.green(`✓ Template removed: ${name}`));
+  } catch (error) {
+    console.log(chalk.red(`✗ Failed to remove template: ${error instanceof Error ? error.message : 'Unknown error'}`));
+  }
+}
+
+/**
+ * 处理 template use 命令
+ */
+export async function handleTemplateUse(name?: string): Promise<void> {
+  const projectDir = process.cwd();
+  const configFile = getProjectConfigPath(projectDir);
+
+  // 检查项目是否已初始化
+  if (!(await fs.pathExists(configFile))) {
+    console.log(chalk.yellow('Project not initialized. Run `tools-cc use <source>` first.'));
+    return;
+  }
+
+  // 如果没有指定名称，显示选择列表
+  if (!name) {
+    const templates = await listTemplates(TEMPLATES_DIR);
+
+    if (templates.length === 0) {
+      console.log(chalk.gray('No templates saved.'));
+      return;
+    }
+
+    const answers = await inquirer.prompt([
+      {
+        type: 'list',
+        name: 'selectedTemplate',
+        message: 'Select a template to use:',
+        choices: templates.map(t => ({
+          name: `${t.name} (from: ${path.basename(t.sourceProject)})`,
+          value: t.name
+        }))
+      }
+    ]);
+    name = answers.selectedTemplate as string;
+  }
+
+  // 获取模板
+  const template = await getTemplate(name as string, TEMPLATES_DIR);
+  if (!template) {
+    console.log(chalk.red(`✗ Template not found: ${name}`));
+    return;
+  }
+
+  // 定义源路径解析函数
+  const resolveSourcePath = async (sourceName: string): Promise<string> => {
+    return await getSourcePath(sourceName, GLOBAL_CONFIG_DIR);
+  };
+
+  // 创建临时配置文件
+  const tempConfigPath = path.join(projectDir, '.toolscc-template-temp.json');
+  const exportConfig = {
+    version: '1.0',
+    type: 'project' as const,
+    config: template.config,
+    exportedAt: new Date().toISOString()
+  };
+
+  // 导入配置
+  try {
+    await fs.writeJson(tempConfigPath, exportConfig, { spaces: 2 });
+    await importProjectConfig(tempConfigPath, projectDir, resolveSourcePath);
+    console.log(chalk.green(`✓ Applied template: ${name}`));
+  } catch (error) {
+    console.log(chalk.red(`✗ Failed to apply template: ${error instanceof Error ? error.message : 'Unknown error'}`));
+  } finally {
+    await fs.remove(tempConfigPath);
+  }
+}

package/src/commands/use.ts

@@ -195,6 +195,14 @@ async function handleInteractiveMode(
       }
     }
 
+    // Rules 区
+    if (manifest.rules && manifest.rules.length > 0) {
+      choices.push(new inquirer.Separator(`--- Rules (${manifest.rules.length}) ---`));
+      for (const rule of manifest.rules) {
+        choices.push({ name: rule, value: `rules/${rule}` });
+      }
+    }
+
     if (choices.length === 0) {
       console.log(chalk.yellow(`No items found in source: ${sourceName}`));
       return;
@@ -220,7 +228,8 @@ async function handleInteractiveMode(
     const selection: SourceSelection = {
       skills: [],
       commands: [],
-      agents: []
+      agents: [],
+      rules: []
     };
 
     for (const item of answers.selectedItems) {
@@ -228,6 +237,7 @@ async function handleInteractiveMode(
       if (type === 'skills') selection.skills.push(name);
       else if (type === 'commands') selection.commands.push(name);
       else if (type === 'agents') selection.agents.push(name);
+      else if (type === 'rules') selection.rules.push(name);
     }
 
     // 初始化项目并应用选择

package/src/core/manifest.ts

@@ -1,57 +1,67 @@
-import fs from 'fs-extra';
-import path from 'path';
-import { Manifest } from '../types';
-
-export async function loadManifest(sourceDir: string): Promise<Manifest> {
-  const manifestPath = path.join(sourceDir, 'manifest.json');
-  
-  if (await fs.pathExists(manifestPath)) {
-    try {
-      return await fs.readJson(manifestPath);
-    } catch (error) {
-      throw new Error(`Failed to parse manifest.json: ${error instanceof Error ? error.message : 'Invalid JSON'}`);
-    }
-  }
-  
-  return scanSource(sourceDir);
-}
-
-export async function scanSource(sourceDir: string): Promise<Manifest> {
-  const name = path.basename(sourceDir);
-  const manifest: Manifest = {
-    name,
-    version: '0.0.0',
-    skills: [],
-    commands: [],
-    agents: []
-  };
-  
-  // Scan skills
-  const skillsDir = path.join(sourceDir, 'skills');
-  if (await fs.pathExists(skillsDir)) {
-    const entries = await fs.readdir(skillsDir, { withFileTypes: true });
-    manifest.skills = entries
-      .filter(e => e.isDirectory())
-      .map(e => e.name);
-  }
-  
-  // Scan commands
-  const commandsDir = path.join(sourceDir, 'commands');
-  if (await fs.pathExists(commandsDir)) {
-    const entries = await fs.readdir(commandsDir, { withFileTypes: true });
-    manifest.commands = entries
-      .filter(e => e.isFile() && e.name.endsWith('.md'))
-      .map(e => e.name.replace('.md', ''));
-  }
-  
-  // Scan agents
-  const agentsDir = path.join(sourceDir, 'agents');
-  if (await fs.pathExists(agentsDir)) {
-    const entries = await fs.readdir(agentsDir, { withFileTypes: true });
-    manifest.agents = entries
-      .filter(e => e.isFile() && e.name.endsWith('.md'))
-      .map(e => e.name.replace('.md', ''));
-  }
-  
-  return manifest;
-}
+import fs from 'fs-extra';
+import path from 'path';
+import { Manifest } from '../types';
+
+export async function loadManifest(sourceDir: string): Promise<Manifest> {
+  const manifestPath = path.join(sourceDir, 'manifest.json');
+  
+  if (await fs.pathExists(manifestPath)) {
+    try {
+      return await fs.readJson(manifestPath);
+    } catch (error) {
+      throw new Error(`Failed to parse manifest.json: ${error instanceof Error ? error.message : 'Invalid JSON'}`);
+    }
+  }
+  
+  return scanSource(sourceDir);
+}
+
+export async function scanSource(sourceDir: string): Promise<Manifest> {
+  const name = path.basename(sourceDir);
+  const manifest: Manifest = {
+    name,
+    version: '0.0.0',
+    skills: [],
+    commands: [],
+    agents: [],
+    rules: []
+  };
+  
+  // Scan skills
+  const skillsDir = path.join(sourceDir, 'skills');
+  if (await fs.pathExists(skillsDir)) {
+    const entries = await fs.readdir(skillsDir, { withFileTypes: true });
+    manifest.skills = entries
+      .filter(e => e.isDirectory())
+      .map(e => e.name);
+  }
+  
+  // Scan commands
+  const commandsDir = path.join(sourceDir, 'commands');
+  if (await fs.pathExists(commandsDir)) {
+    const entries = await fs.readdir(commandsDir, { withFileTypes: true });
+    manifest.commands = entries
+      .filter(e => e.isFile() && e.name.endsWith('.md'))
+      .map(e => e.name.replace('.md', ''));
+  }
+  
+  // Scan agents
+  const agentsDir = path.join(sourceDir, 'agents');
+  if (await fs.pathExists(agentsDir)) {
+    const entries = await fs.readdir(agentsDir, { withFileTypes: true });
+    manifest.agents = entries
+      .filter(e => e.isFile() && e.name.endsWith('.md'))
+      .map(e => e.name.replace('.md', ''));
+  }
+  
+  // Scan rules
+  const rulesDir = path.join(sourceDir, 'rules');
+  if (await fs.pathExists(rulesDir)) {
+    const entries = await fs.readdir(rulesDir, { withFileTypes: true });
+    manifest.rules = entries
+      .filter(e => e.isDirectory())
+      .map(e => e.name);
+  }
+  
+  return manifest;
+}