airail 0.1.0 → 0.1.2

package/dist/cli/add.js

@@ -45,7 +45,7 @@ async function cmdAdd(arg) {
     const config = (0, utils_1.requireAirailJson)(claudeDir);
     if (!arg) {
         console.error((0, colors_1.err)('用法: airail add <包名[@版本]|路径>'));
-        process.exit(1);
+        throw new Error('');
     }
     if (config.pack) {
         console.log((0, colors_1.warn)(`当前已安装 pack: ${config.pack}`));
@@ -56,7 +56,7 @@ async function cmdAdd(arg) {
         const localPath = path.resolve(arg);
         if (!fs.existsSync(localPath)) {
             console.error((0, colors_1.err)(`路径不存在: ${localPath}`));
-            process.exit(1);
+            throw new Error('');
         }
         const packName = readPackName(localPath);
         (0, utils_1.installPackFromDir)(localPath, packName, claudeDir);
@@ -69,7 +69,7 @@ async function cmdAdd(arg) {
     const rc = (0, utils_1.readRc)();
     if (!rc.configServer) {
         console.error((0, colors_1.err)('未配置配置仓库，请先执行: airail config setup'));
-        process.exit(1);
+        throw new Error('');
     }
     await installPackFromConfigCenter(arg, claudeDir, config, rc);
     (0, utils_1.writeAirailJson)(claudeDir, config);
@@ -113,13 +113,13 @@ async function installPackFromConfigCenter(packNameWithVersion, claudeDir, confi
     }
     catch (e) {
         console.error((0, colors_1.err)(`获取规范包列表失败: ${e.message}`));
-        process.exit(1);
+        throw new Error('');
     }
     const pack = packs.find(p => p.name === packName);
     if (!pack) {
         console.error((0, colors_1.err)(`规范包 "${packName}" 不存在。`));
         console.log((0, colors_1.info)(`可用规范包: ${packs.map(p => p.name).join(', ')}`));
-        process.exit(1);
+        throw new Error('');
     }
     // 使用用户指定的版本，如果没有指定则使用配置仓库的版本
     const gitRef = userVersion || pack.gitRef;

package/dist/cli/config.js

@@ -89,7 +89,7 @@ async function setup() {
         validate: (v) => v.startsWith('http') || '请输入有效的 Git 仓库 URL',
     });
     const token = await (0, prompts_1.input)({
-        message: '访问 Token (私有仓库需要，留空跳过):',
+        message: '访问 Token (私有仓库需要，如果 Git 已存储凭据可留空):',
         default: rc.configToken,
     });
     // 清理旧的本地仓库（如果 URL 变了）
@@ -104,19 +104,19 @@ async function listConfigs() {
     const rc = (0, utils_1.readRc)();
     if (!rc.configServer) {
         console.error((0, colors_1.err)('未配置配置仓库，请先执行: airail config setup'));
-        process.exit(1);
+        throw new Error('');
     }
     try {
         ensureConfigRepo(rc.configServer, rc.configToken);
     }
     catch (e) {
         console.error((0, colors_1.err)(e.message));
-        process.exit(1);
+        throw new Error('');
     }
     const indexPath = path.join(CONFIG_REPO_DIR, 'settings', 'index.json');
     if (!fs.existsSync(indexPath)) {
         console.error((0, colors_1.err)('配置仓库中未找到 settings/index.json'));
-        process.exit(1);
+        throw new Error('');
     }
     let entries;
     try {
@@ -124,7 +124,7 @@ async function listConfigs() {
     }
     catch (e) {
         console.error((0, colors_1.err)(`读取配置列表失败: ${e.message}`));
-        process.exit(1);
+        throw new Error('');
     }
     if (entries.length === 0) {
         console.log((0, colors_1.warn)('暂无可用配置。'));
@@ -139,20 +139,20 @@ async function useConfig(name) {
     const rc = (0, utils_1.readRc)();
     if (!rc.configServer) {
         console.error((0, colors_1.err)('未配置配置仓库，请先执行: airail config setup'));
-        process.exit(1);
+        throw new Error('');
     }
     try {
         ensureConfigRepo(rc.configServer, rc.configToken);
     }
     catch (e) {
         console.error((0, colors_1.err)(e.message));
-        process.exit(1);
+        throw new Error('');
     }
     // 获取配置清单
     const indexPath = path.join(CONFIG_REPO_DIR, 'settings', 'index.json');
     if (!fs.existsSync(indexPath)) {
         console.error((0, colors_1.err)('配置仓库中未找到 settings/index.json'));
-        process.exit(1);
+        throw new Error('');
     }
     let entries;
     try {
@@ -160,7 +160,7 @@ async function useConfig(name) {
     }
     catch (e) {
         console.error((0, colors_1.err)(`读取配置列表失败: ${e.message}`));
-        process.exit(1);
+        throw new Error('');
     }
     if (entries.length === 0) {
         console.log((0, colors_1.warn)('暂无可用配置。'));
@@ -171,7 +171,7 @@ async function useConfig(name) {
     if (name) {
         if (!entries.find(e => e.name === name)) {
             console.error((0, colors_1.err)(`配置 "${name}" 不存在，可用: ${entries.map(e => e.name).join(', ')}`));
-            process.exit(1);
+            throw new Error('');
         }
         chosen = name;
     }
@@ -188,7 +188,7 @@ async function useConfig(name) {
     const settingsPath = path.join(CONFIG_REPO_DIR, 'settings', `${chosen}.json`);
     if (!fs.existsSync(settingsPath)) {
         console.error((0, colors_1.err)(`配置文件不存在: settings/${chosen}.json`));
-        process.exit(1);
+        throw new Error('');
     }
     let content;
     try {
@@ -197,7 +197,7 @@ async function useConfig(name) {
     }
     catch (e) {
         console.error((0, colors_1.err)(`读取配置失败: ${e.message}`));
-        process.exit(1);
+        throw new Error('');
     }
     const globalClaudeDir = path.join(os.homedir(), '.claude');
     if (!fs.existsSync(globalClaudeDir)) {

package/dist/cli/index.js

@@ -41,6 +41,7 @@ const clear_1 = require("./clear");
 const update_1 = require("./update");
 const status_1 = require("./status");
 const config_1 = require("./config");
+const install_1 = require("./install");
 function printBanner() {
     console.log([
         '',
@@ -59,6 +60,7 @@ function printHelp() {
     const cmds = [
         ['init', '在当前项目初始化 airail'],
         ['add <url|路径>', '安装规范包（git URL 或本地路径）'],
+        ['install [工具名]', '安装 CLI 工具（如 claude-code）'],
         ['clear', '清理 airail 相关内容'],
         ['update', '更新已安装的规范包'],
         ['config [子命令]', '管理团队配置仓库 (setup / list / use)'],
@@ -74,27 +76,31 @@ async function executeCommand(cmd, args) {
     const commands = {
         init: init_1.cmdInit,
         add: () => (0, add_1.cmdAdd)(args[0]),
+        install: () => (0, install_1.cmdInstall)(args[0]),
         clear: clear_1.cmdClear,
         update: update_1.cmdUpdate,
         status: status_1.cmdStatus,
         config: () => (0, config_1.cmdConfig)(args[0], ...args.slice(1)),
     };
     if (cmd === 'exit') {
-        return false;
+        return { shouldContinue: false, success: true };
     }
     const handler = commands[cmd];
     if (!handler) {
         console.log(`未知命令: ${cmd}`);
         printHelp();
-        return true;
+        return { shouldContinue: true, success: false };
     }
     try {
         await handler();
+        return { shouldContinue: true, success: true };
     }
     catch (e) {
-        console.error(e.message);
+        if (e.message) {
+            console.error(e.message);
+        }
+        return { shouldContinue: true, success: false };
     }
-    return true;
 }
 function startInteractiveMode() {
     printBanner();
@@ -113,7 +119,7 @@ function startInteractiveMode() {
             return;
         }
         const [cmd, ...args] = input.split(/\s+/);
-        const shouldContinue = await executeCommand(cmd, args);
+        const { shouldContinue } = await executeCommand(cmd, args);
         if (!shouldContinue) {
             rl.close();
             process.exit(0);
@@ -133,9 +139,9 @@ function runCLI() {
         return;
     }
     // 有参数：直接执行命令（不显示 banner）
-    executeCommand(cmd, args).then((shouldContinue) => {
-        if (!shouldContinue) {
-            process.exit(0);
+    executeCommand(cmd, args).then(({ shouldContinue, success }) => {
+        if (!shouldContinue || !success) {
+            process.exit(success ? 0 : 1);
         }
     }).catch((e) => {
         console.error(e.message);

package/dist/cli/install.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cmdInstall = cmdInstall;
+const child_process_1 = require("child_process");
+const prompts_1 = require("@inquirer/prompts");
+const CLI_TOOLS = {
+    'claude-code': {
+        name: 'Claude Code',
+        package: '@anthropic-ai/claude-code',
+        description: 'Anthropic 官方 Claude CLI 工具'
+    },
+    // 预留扩展
+    // 'codex': {
+    //   name: 'Codex',
+    //   package: 'codex-cli',
+    //   description: 'OpenAI Codex CLI 工具'
+    // }
+};
+async function cmdInstall(toolName) {
+    try {
+        let selectedTool = toolName;
+        if (!selectedTool) {
+            selectedTool = await (0, prompts_1.select)({
+                message: '选择要安装的 CLI 工具:',
+                choices: Object.entries(CLI_TOOLS).map(([key, tool]) => ({
+                    value: key,
+                    name: `${tool.name} - ${tool.description}`
+                }))
+            });
+        }
+        const tool = CLI_TOOLS[selectedTool];
+        if (!tool) {
+            console.log(`\x1b[31m✘ 未知工具: ${selectedTool}\x1b[0m`);
+            return;
+        }
+        console.log(`\n→ 安装 ${tool.name}...`);
+        (0, child_process_1.execSync)(`npm install -g ${tool.package}`, { stdio: 'inherit' });
+        console.log(`\x1b[32m✔ ${tool.name} 安装成功\x1b[0m\n`);
+    }
+    catch (e) {
+        console.error(`\x1b[31m✘ 安装失败: ${e.message}\x1b[0m`);
+    }
+}

package/dist/cli/update.js

@@ -42,10 +42,10 @@ async function cmdUpdate() {
     const config = (0, utils_1.requireAirailJson)(claudeDir);
     if (!config.pack) {
         console.error((0, colors_1.err)('未安装任何 pack，无需更新。'));
-        process.exit(1);
+        throw new Error('');
     }
     // 从 airail.json 读取 pack 来源信息（需要扩展 AirailJson 结构）
     // 暂时简化：提示用户重新 add
     console.error((0, colors_1.err)('update 功能开发中，请使用 airail add 重新安装。'));
-    process.exit(1);
+    throw new Error('');
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "airail",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "AI coding assistant framework - enforce coding standards via Claude hooks & skills",
   "bin": {
     "airail": "./bin/airail.js"

package/src/templates/CLAUDE.md

@@ -1,11 +1,9 @@
-# AI Coding Standards
+# 项目开发规范
 
-This project uses [airail](https://github.com/your-org/airail) to enforce coding standards.
+> 本项目使用 AIRail 管理编码规范，技能位于 `.claude/skills/`
 
-## Installed Skills
+## 项目约定
 
-Skills are located in `.claude/skills/`. The AI will automatically activate relevant skills before implementing code.
+[在此添加项目特定的开发规范、架构约定、命名规范等]
 
-## Adding Custom Rules
 
-Add project-specific rules to this file. They will be loaded at session start.

package/src/templates/hooks/stop.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+/**
+ * Stop Hook - Claude 回答结束时触发
+ * 功能: 清理误创建的 nul 文件（Windows 下 > nul 可能创建该文件）
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// 清理可能误创建的 nul 文件
+const findAndDeleteNul = (dir, depth = 0) => {
+  if (depth > 5) return;
+  try {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      const fullPath = path.join(dir, entry.name);
+      if (entry.isFile() && entry.name === 'nul') {
+        fs.unlinkSync(fullPath);
+        console.error(`🧹 已清理: ${fullPath}`);
+      } else if (entry.isDirectory() && !entry.name.startsWith('.') && entry.name !== 'node_modules') {
+        findAndDeleteNul(fullPath, depth + 1);
+      }
+    }
+  } catch {
+    // 访问失败时静默忽略
+  }
+};
+
+findAndDeleteNul(process.cwd());
+
+process.exit(0);

package/src/templates/settings.json

@@ -18,6 +18,12 @@
         "matcher": "Bash|Write",
         "hooks": [{ "type": "command", "command": "node .claude/hooks/guard.js", "timeout": 5000 }]
       }
+    ],
+    "Stop": [
+      {
+        "matcher": "",
+        "hooks": [{ "type": "command", "command": "node .claude/hooks/stop.js" }]
+      }
     ]
   },
   "mcpServers": {}