@localsummer/incspec 0.0.6 → 0.0.8

package/lib/claude.mjs

@@ -0,0 +1,144 @@
+/**
+ * Claude Code integration utilities
+ * - Sync inc-spec-skill to global or project
+ */
+
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { fileURLToPath } from 'url';
+
+/** Claude skills directory name */
+const CLAUDE_SKILLS_DIR_NAME = 'skills';
+
+/** Skill name */
+const SKILL_NAME = 'inc-spec-skill';
+
+/** Global Claude skills directory */
+const GLOBAL_CLAUDE_SKILLS_DIR = path.join(os.homedir(), '.claude', CLAUDE_SKILLS_DIR_NAME);
+
+/** Project Claude skills directory (relative to project root) */
+const PROJECT_CLAUDE_SKILLS_DIR = path.join('.claude', CLAUDE_SKILLS_DIR_NAME);
+
+/** Skill template source directory */
+const SKILL_TEMPLATE_DIR = fileURLToPath(new URL('../templates/inc-spec-skill', import.meta.url));
+
+/**
+ * Copy directory recursively
+ * @param {string} src - Source directory
+ * @param {string} dest - Destination directory
+ */
+function copyDirRecursive(src, dest) {
+  if (!fs.existsSync(dest)) {
+    fs.mkdirSync(dest, { recursive: true });
+  }
+
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+
+    if (entry.isDirectory()) {
+      copyDirRecursive(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+/**
+ * Count files in directory recursively
+ * @param {string} dir - Directory path
+ * @returns {number} File count
+ */
+function countFiles(dir) {
+  let count = 0;
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+
+  for (const entry of entries) {
+    if (entry.isDirectory()) {
+      count += countFiles(path.join(dir, entry.name));
+    } else {
+      count++;
+    }
+  }
+
+  return count;
+}
+
+/**
+ * Sync skill to global Claude skills directory
+ * @returns {{count: number, targetDir: string}}
+ */
+export function syncToGlobalClaude() {
+  const targetDir = path.join(GLOBAL_CLAUDE_SKILLS_DIR, SKILL_NAME);
+
+  // Remove existing if present
+  if (fs.existsSync(targetDir)) {
+    fs.rmSync(targetDir, { recursive: true, force: true });
+  }
+
+  // Copy skill template
+  copyDirRecursive(SKILL_TEMPLATE_DIR, targetDir);
+
+  const count = countFiles(targetDir);
+
+  return { count, targetDir };
+}
+
+/**
+ * Sync skill to project Claude skills directory
+ * @param {string} projectRoot - Project root path
+ * @returns {{count: number, targetDir: string}}
+ */
+export function syncToProjectClaude(projectRoot) {
+  const targetDir = path.join(projectRoot, PROJECT_CLAUDE_SKILLS_DIR, SKILL_NAME);
+
+  // Remove existing if present
+  if (fs.existsSync(targetDir)) {
+    fs.rmSync(targetDir, { recursive: true, force: true });
+  }
+
+  // Copy skill template
+  copyDirRecursive(SKILL_TEMPLATE_DIR, targetDir);
+
+  const count = countFiles(targetDir);
+
+  return { count, targetDir };
+}
+
+/**
+ * Check if Claude skill exists
+ * @param {string} projectRoot - Optional project root
+ * @returns {{project: boolean, global: boolean}}
+ */
+export function checkClaudeSkill(projectRoot = null) {
+  const globalDir = path.join(GLOBAL_CLAUDE_SKILLS_DIR, SKILL_NAME);
+  const result = {
+    global: fs.existsSync(globalDir) && fs.readdirSync(globalDir).length > 0,
+    project: false,
+  };
+
+  if (projectRoot) {
+    const projectDir = path.join(projectRoot, PROJECT_CLAUDE_SKILLS_DIR, SKILL_NAME);
+    result.project = fs.existsSync(projectDir) && fs.readdirSync(projectDir).length > 0;
+  }
+
+  return result;
+}
+
+/**
+ * Get skill template info
+ * @returns {{fileCount: number, hasSkillMd: boolean, hasReferences: boolean}}
+ */
+export function getSkillTemplateInfo() {
+  const skillMdPath = path.join(SKILL_TEMPLATE_DIR, 'SKILL.md');
+  const referencesDir = path.join(SKILL_TEMPLATE_DIR, 'references');
+
+  return {
+    fileCount: countFiles(SKILL_TEMPLATE_DIR),
+    hasSkillMd: fs.existsSync(skillMdPath),
+    hasReferences: fs.existsSync(referencesDir) && fs.readdirSync(referencesDir).length > 0,
+  };
+}

package/lib/config.mjs

@@ -8,6 +8,7 @@
 import * as fs from 'fs';
 import * as path from 'path';
 import { fileURLToPath } from 'url';
+import { formatLocalDate } from './terminal.mjs';
 
 /** incspec directory name */
 export const INCSPEC_DIR = 'incspec';
@@ -51,7 +52,9 @@ export function findProjectRoot(startDir) {
 
   while (currentDir !== root) {
     const incspecPath = path.join(currentDir, INCSPEC_DIR);
-    if (fs.existsSync(incspecPath) && fs.statSync(incspecPath).isDirectory()) {
+    const projectFile = path.join(incspecPath, FILES.project);
+    // 检查 project.md 是否存在，避免 macOS 大小写不敏感导致的误判
+    if (fs.existsSync(projectFile)) {
       return currentDir;
     }
     currentDir = path.dirname(currentDir);
@@ -197,23 +200,23 @@ export function writeProjectConfig(projectRoot, config) {
  */
 function generateProjectContent(config) {
   const templatePath = path.join(getTemplatesDir(), 'project.md');
-  
+
   if (fs.existsSync(templatePath)) {
     let content = fs.readFileSync(templatePath, 'utf-8');
-    
+
     // Replace variables
     content = content.replace(/\{\{name\}\}/g, config.name || '');
     content = content.replace(/\{\{version\}\}/g, config.version || '1.0.0');
     content = content.replace(/\{\{source_dir\}\}/g, config.source_dir || 'src');
-    content = content.replace(/\{\{created_at\}\}/g, config.created_at || new Date().toISOString().split('T')[0]);
-    
+    content = content.replace(/\{\{created_at\}\}/g, config.created_at || formatLocalDate(new Date()));
+
     // Handle tech_stack array
     const techStackLines = (config.tech_stack || []).map(item => `  - ${item}`).join('\n');
     content = content.replace(/\{\{tech_stack\}\}/g, techStackLines);
-    
+
     return content;
   }
-  
+
   // Fallback to hardcoded content if template not found
   return generateFallbackProjectContent(config);
 }
@@ -234,7 +237,7 @@ function generateFallbackProjectContent(config) {
  * @returns {Object}
  */
 export function getDefaultConfig(options = {}) {
-  const now = new Date().toISOString().split('T')[0];
+  const now = formatLocalDate(new Date());
 
   return {
     name: options.name || path.basename(process.cwd()),
@@ -318,7 +321,7 @@ function writeAgentsFile(projectRoot) {
 ## 快速开始
 
 1. 运行 \`incspec status\` 查看当前工作流状态
-2. 按顺序执行6步工作流: analyze → collect-req → collect-dep → design → apply → merge
+2. 按顺序执行7步工作流: analyze → collect-req → collect-dep → design → apply → merge → archive
 3. 使用 \`incspec help\` 获取更多帮助
 `;
     fs.writeFileSync(agentsPath, fallbackContent, 'utf-8');
@@ -332,7 +335,7 @@ function writeAgentsFile(projectRoot) {
  */
 export function ensureInitialized(cwd) {
   const projectRoot = findProjectRoot(cwd);
-  
+
   if (!projectRoot || !isInitialized(projectRoot)) {
     throw new Error(
       `incspec 未初始化。请先运行 'incspec init' 初始化项目。`

package/lib/cursor.mjs

@@ -68,6 +68,13 @@ const COMMAND_MAP = [
     label: '步骤6: 合并到基线',
     description: '[incspec] 将增量融合为新的代码流基线快照',
   },
+  {
+    source: 'inc-archive.md',
+    target: 'inc-archive.md',
+    step: 7,
+    label: '步骤7: 归档工作流产出',
+    description: '[incspec] 归档工作流产出文件到历史记录目录',
+  },
 ];
 
 /**
@@ -174,16 +181,24 @@ description: [incspec] 显示帮助信息
 
 ## 工作流步骤
 
+**完整模式 (7步):**
 1. \`/incspec/inc-analyze\` - 分析代码流程,生成基线快照
 2. \`/incspec/inc-collect-req\` - 收集结构化需求
 3. \`/incspec/inc-collect-dep\` - 采集UI依赖
 4. \`/incspec/inc-design\` - 生成增量设计蓝图
 5. \`/incspec/inc-apply\` - 应用代码变更
 6. \`/incspec/inc-merge\` - 合并到新基线
+7. \`/incspec/inc-archive\` - 归档工作流产出
+
+**快速模式 (5步):**
+1. \`/incspec/inc-analyze --quick\` - 分析代码流程 (快速模式)
+2. \`/incspec/inc-collect-req\` - 收集结构化需求
+5. \`/incspec/inc-apply\` - 应用代码变更
+6. \`/incspec/inc-merge\` - 合并到新基线
+7. \`/incspec/inc-archive\` - 归档工作流产出
 
 ## 辅助命令
 
-- \`/incspec/inc-archive\` - 归档规范文件到 archives 目录
 - \`/incspec/inc-status\` - 查看当前工作流状态
 - \`/incspec/inc-help\` - 显示帮助信息
 
@@ -194,7 +209,7 @@ incspec init          # 初始化项目
 incspec status        # 查看工作流状态
 incspec list          # 列出规范文件
 incspec validate      # 验证规范完整性
-incspec cursor-sync   # 同步 Cursor 命令
+incspec sync          # 同步 IDE 命令
 incspec help          # 显示帮助
 \`\`\`
 
@@ -255,14 +270,14 @@ incspec archive <file-path> --keep --yes
  */
 export function syncToProject(projectRoot) {
   const targetDir = path.join(projectRoot, CURSOR_COMMANDS_DIR);
-  
+
   // Create directory
   if (!fs.existsSync(targetDir)) {
     fs.mkdirSync(targetDir, { recursive: true });
   }
 
   const commands = generateCursorCommands(projectRoot);
-  
+
   for (const cmd of commands) {
     const filePath = path.join(targetDir, cmd.name);
     fs.writeFileSync(filePath, cmd.content, 'utf-8');
@@ -282,7 +297,7 @@ export function syncToGlobal() {
   }
 
   const commands = generateCursorCommands();
-  
+
   for (const cmd of commands) {
     const filePath = path.join(GLOBAL_CURSOR_DIR, cmd.name);
     fs.writeFileSync(filePath, cmd.content, 'utf-8');

package/lib/terminal.mjs

@@ -241,6 +241,88 @@ export async function select({ message, choices }) {
   });
 }
 
+/**
+ * Interactive checkbox (multi-select) prompt
+ * @param {Object} options
+ * @param {string} options.message
+ * @param {Array<{name: string, value: any, checked?: boolean}>} options.choices
+ * @returns {Promise<any[]>}
+ */
+export async function checkbox({ message, choices }) {
+  return new Promise((resolve) => {
+    let cursor = 0;
+    const selected = choices.map(c => c.checked || false);
+
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+    });
+
+    if (process.stdin.isTTY) {
+      process.stdin.setRawMode(true);
+    }
+    readline.emitKeypressEvents(process.stdin, rl);
+
+    const render = () => {
+      process.stdout.write('\x1b[2J\x1b[H');
+
+      console.log(colorize(message, colors.bold, colors.cyan));
+      console.log(colorize('(space: toggle, a: toggle all, enter: confirm)', colors.dim));
+      console.log();
+
+      choices.forEach((choice, index) => {
+        const isCursor = cursor === index;
+        const isSelected = selected[index];
+        const pointer = isCursor ? colorize('>', colors.cyan) : ' ';
+        const check = isSelected ? colorize('[x]', colors.green) : '[ ]';
+        const name = isCursor ? colorize(choice.name, colors.bold) : choice.name;
+
+        console.log(`${pointer} ${check} ${name}`);
+      });
+    };
+
+    const cleanup = () => {
+      if (process.stdin.isTTY) {
+        process.stdin.setRawMode(false);
+      }
+      rl.close();
+    };
+
+    const handleKeypress = (str, key) => {
+      if (!key) return;
+
+      if (key.name === 'up' || key.name === 'k') {
+        cursor = cursor > 0 ? cursor - 1 : choices.length - 1;
+        render();
+      } else if (key.name === 'down' || key.name === 'j') {
+        cursor = cursor < choices.length - 1 ? cursor + 1 : 0;
+        render();
+      } else if (key.name === 'space') {
+        selected[cursor] = !selected[cursor];
+        render();
+      } else if (str === 'a') {
+        const allSelected = selected.every(s => s);
+        selected.fill(!allSelected);
+        render();
+      } else if (key.name === 'return') {
+        cleanup();
+        process.stdin.removeListener('keypress', handleKeypress);
+        process.stdout.write('\x1b[2J\x1b[H');
+        const result = choices.filter((_, i) => selected[i]).map(c => c.value);
+        resolve(result);
+      } else if (key.name === 'escape' || (key.ctrl && key.name === 'c')) {
+        cleanup();
+        process.stdin.removeListener('keypress', handleKeypress);
+        process.stdout.write('\x1b[2J\x1b[H');
+        process.exit(0);
+      }
+    };
+
+    process.stdin.on('keypress', handleKeypress);
+    render();
+  });
+}
+
 /**
  * Format a table for terminal output
  * @param {string[]} headers
@@ -290,3 +372,29 @@ export function spinner(message) {
     }
   };
 }
+
+/**
+ * Format date to local datetime string
+ * @param {Date} date - Date object
+ * @returns {string} Format: YYYY-MM-DD HH:mm
+ */
+export function formatLocalDateTime(date) {
+  const year = date.getFullYear();
+  const month = String(date.getMonth() + 1).padStart(2, '0');
+  const day = String(date.getDate()).padStart(2, '0');
+  const hours = String(date.getHours()).padStart(2, '0');
+  const minutes = String(date.getMinutes()).padStart(2, '0');
+  return `${year}-${month}-${day} ${hours}:${minutes}`;
+}
+
+/**
+ * Format date to local date string
+ * @param {Date} date - Date object
+ * @returns {string} Format: YYYY-MM-DD
+ */
+export function formatLocalDate(date) {
+  const year = date.getFullYear();
+  const month = String(date.getMonth() + 1).padStart(2, '0');
+  const day = String(date.getDate()).padStart(2, '0');
+  return `${year}-${month}-${day}`;
+}