@localsummer/incspec 0.3.2 → 0.3.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@localsummer/incspec",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "面向 AI 编程助手的增量规范驱动开发工具",
   "bin": {
     "incspec": "src/index.mjs"

package/src/CLAUDE.md

@@ -0,0 +1,7 @@
+<claude-mem-context>
+# Recent Activity
+
+<!-- This section is auto-generated by claude-mem. Edit content outside the tags. -->
+
+*No recent activity*
+</claude-mem-context>

package/src/commands/CLAUDE.md

@@ -0,0 +1,14 @@
+<claude-mem-context>
+# Recent Activity
+
+<!-- This section is auto-generated by claude-mem. Edit content outside the tags. -->
+
+### Jan 8, 2026
+
+| ID | Time | T | Title | Read |
+|----|------|---|-------|------|
+| #118 | 3:14 PM | 🔵 | 纠正对 IncSpec 工作流模式参数的错误理解 | ~113 |
+| #101 | 2:43 PM | 🔵 | 完成了 IncSpec 极简模式的深度分析 | ~95 |
+| #100 | " | 🔵 | 发现 IncSpec 三种工作流模式的完整实现 | ~110 |
+| #99 | " | 🔵 | 发现 IncSpec 极简模式的完整实现 | ~97 |
+</claude-mem-context>

package/src/commands/init.mjs

@@ -13,6 +13,12 @@ import {
 } from '../lib/config.mjs';
 import { initWorkflow } from '../lib/workflow.mjs';
 import { updateProjectAgentsFile } from '../lib/agents.mjs';
+import {
+  syncToProject,
+  syncToGlobal,
+  getSupportedIDEs,
+  getIDEConfig,
+} from '../lib/ide-sync.mjs';
 import {
   colors,
   colorize,
@@ -22,8 +28,82 @@ import {
   printInfo,
   prompt,
   confirm,
+  select,
 } from '../lib/terminal.mjs';
 
+/**
+ * Sync IDE commands helper
+ * @param {string} cwd - Current working directory
+ */
+async function syncIDECommands(cwd) {
+  print('');
+  print(colorize('IDE 命令同步', colors.bold, colors.cyan));
+  print(colorize('─────────────', colors.dim));
+  print('');
+
+  // Ask which IDE to sync
+  const ideChoice = await select({
+    message: '选择要同步的 IDE',
+    choices: [
+      { name: 'Cursor', value: 'cursor' },
+      { name: 'Claude Code', value: 'claude' },
+      { name: '全部 (Cursor + Claude Code)', value: 'all' },
+    ]
+  });
+
+  // Ask for sync scope
+  const scopeChoice = await select({
+    message: '选择同步范围',
+    choices: [
+      { name: '项目级 (仅当前项目)', value: 'project' },
+      { name: '全局级 (所有项目)', value: 'global' },
+    ]
+  });
+
+  const isGlobal = scopeChoice === 'global';
+
+  // Determine which IDEs to sync
+  const idesToSync = ideChoice === 'all' ? getSupportedIDEs() : [ideChoice];
+  let syncCount = 0;
+
+  for (const ide of idesToSync) {
+    const config = getIDEConfig(ide);
+    try {
+      let count;
+      if (isGlobal) {
+        count = syncToGlobal(ide);
+      } else {
+        count = syncToProject(ide, cwd);
+      }
+      
+      syncCount += count;
+      const targetDir = isGlobal ? config.globalDir : path.join(cwd, config.projectDir);
+      printInfo(`已同步 ${count} 个命令到 ${config.name}: ${targetDir}`);
+    } catch (error) {
+      printWarning(`同步 ${config.name} 命令失败: ${error.message}`);
+    }
+  }
+
+  print('');
+  printSuccess(`IDE 命令同步完成! 共同步 ${syncCount} 个命令文件`);
+  print('');
+  print(colorize('可用的 IDE 命令:', colors.bold));
+  print(colorize(`  /incspec/inc-analyze    - 步骤1: 分析代码流程`, colors.dim));
+  print(colorize(`  /incspec/inc-collect-req - 步骤2: 收集结构化需求`, colors.dim));
+  print(colorize(`  /incspec/inc-collect-dep - 步骤3: 采集UI依赖`, colors.dim));
+  print(colorize(`  /incspec/inc-design      - 步骤4: 增量设计`, colors.dim));
+  print(colorize(`  /incspec/inc-apply       - 步骤5: 应用代码变更`, colors.dim));
+  print(colorize(`  /incspec/inc-merge       - 步骤6: 合并到基线`, colors.dim));
+  print(colorize(`  /incspec/inc-archive     - 步骤7: 归档产出`, colors.dim));
+  print(colorize(`  /incspec/inc-status      - 查看工作流状态`, colors.dim));
+  print(colorize(`  /incspec/inc-help        - 显示帮助信息`, colors.dim));
+  print('');
+  print(colorize('下一步:', colors.bold));
+  print(colorize(`  1. 运行 'incspec status' 查看工作流状态`, colors.dim));
+  print(colorize(`  2. 使用 /incspec/inc-analyze 开始第一个工作流`, colors.dim));
+  print('');
+}
+
 /**
  * Execute init command
  * @param {Object} ctx - Command context
@@ -119,9 +199,18 @@ export async function initCommand(ctx) {
   print(colorize(`  AGENTS.md (项目根目录)`, colors.cyan));
   print(colorize(`  └── incspec 指令块已添加`, colors.dim));
   print('');
-  print(colorize('下一步:', colors.bold));
-  print(colorize(`  1. 运行 'incspec status' 查看工作流状态`, colors.dim));
-  print(colorize(`  2. 运行 'incspec sync' 同步 Cursor 命令`, colors.dim));
-  print(colorize(`  3. 使用 /incspec/inc-analyze 开始第一个工作流`, colors.dim));
-  print('');
+
+  // Ask user if they want to sync IDE commands
+  const shouldSync = await confirm('是否立即同步 IDE 命令?');
+
+  if (shouldSync) {
+    await syncIDECommands(cwd);
+  } else {
+    print('');
+    print(colorize('下一步:', colors.bold));
+    print(colorize(`  1. 运行 'incspec status' 查看工作流状态`, colors.dim));
+    print(colorize(`  2. 运行 'incspec sync' 同步 IDE 命令`, colors.dim));
+    print(colorize(`  3. 使用 /incspec/inc-analyze 开始第一个工作流`, colors.dim));
+    print('');
+  }
 }

package/src/lib/CLAUDE.md

@@ -0,0 +1,7 @@
+<claude-mem-context>
+# Recent Activity
+
+<!-- This section is auto-generated by claude-mem. Edit content outside the tags. -->
+
+*No recent activity*
+</claude-mem-context>

package/src/lib/ide-sync.mjs

@@ -9,6 +9,7 @@ import * as path from 'path';
 import * as os from 'os';
 import { fileURLToPath } from 'url';
 import { INCSPEC_DIR } from './config.mjs';
+import { MODE_CONFIG, MODE_UPGRADE_ORDER } from './mode-utils.mjs';
 
 /** Built-in templates directory */
 const TEMPLATES_DIR = fileURLToPath(new URL('../templates/commands', import.meta.url));
@@ -114,35 +115,59 @@ function getSourcePath(fileName, fallbackDirs = []) {
 }
 
 /**
- * Generate utility commands content
- * @returns {Array<{name: string, content: string}>}
+ * Generate mode sections for help content
+ * Shows all 7 workflow steps with their mode indicators
+ * @returns {string}
  */
-function generateUtilityCommands() {
-  return [
-    {
-      name: 'inc-status.md',
-      content: `---
-description: [incspec] 查看当前工作流状态
----
+function generateModeSections() {
+  const lines = [];
+
+  // Step info: command, description, and which modes support it
+  const steps = [
+    { cmd: 'inc-analyze', desc: '分析代码流程,生成基线快照', modes: ['full', 'quick', 'minimal'] },
+    { cmd: 'inc-collect-req', desc: '收集结构化需求', modes: ['full', 'quick'] },
+    { cmd: 'inc-collect-dep', desc: '采集UI依赖', modes: ['full'] },
+    { cmd: 'inc-design', desc: '生成增量设计蓝图', modes: ['full'] },
+    { cmd: 'inc-apply', desc: '应用代码变更', modes: ['full', 'quick', 'minimal'] },
+    { cmd: 'inc-merge', desc: '合并到新基线', modes: ['full', 'quick'] },
+    { cmd: 'inc-archive', desc: '归档工作流产出', modes: ['full', 'quick', 'minimal'] }
+  ];
 
-# 查看工作流状态
+  // Generate all 7 steps with mode indicators
+  for (let i = 0; i < steps.length; i++) {
+    const step = steps[i];
+    const stepNum = i + 1;
 
-请运行以下命令查看当前工作流状态:
+    let cmdLine;
+    if (step.modes.length === 3) {
+      cmdLine = `\`/incspec/${step.cmd}\``;
+    } else if (step.modes.includes('full') && step.modes.includes('quick')) {
+      cmdLine = `\`/incspec/${step.cmd}\` (完整/快速)`;
+    } else {
+      cmdLine = `\`/incspec/${step.cmd}\` (完整)`;
+    }
 
-\`\`\`bash
-incspec status
-\`\`\`
+    lines.push(`${stepNum}. ${cmdLine} - ${step.desc}`);
+  }
 
-或直接读取状态文件:
+  return lines.join('\n');
+}
 
-\`\`\`bash
-cat ${INCSPEC_DIR}/workflow.json
-\`\`\`
-`,
-    },
-    {
-      name: 'inc-help.md',
-      content: `---
+/**
+ * Generate utility commands content
+ * @returns {Array<{name: string, content: string}>}
+ */
+function generateUtilityCommands() {
+  // Generate help content from template
+  const helpTemplatePath = path.join(TEMPLATES_DIR, 'inc-help.md');
+  let helpContent;
+
+  if (fs.existsSync(helpTemplatePath)) {
+    const template = fs.readFileSync(helpTemplatePath, 'utf-8');
+    helpContent = template.replace('<!-- MODE_SECTIONS -->', generateModeSections());
+  } else {
+    // Fallback: generate complete content inline
+    helpContent = `---
 description: [incspec] 显示帮助信息
 ---
 
@@ -150,22 +175,7 @@ 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\` - 归档工作流产出
-
+${generateModeSections()}
 ## 辅助命令
 
 - \`/incspec/inc-status\` - 查看当前工作流状态
@@ -193,8 +203,35 @@ ${INCSPEC_DIR}/
 ├── increments/       # 增量设计
 └── archives/         # 历史归档 (YYYY-MM/{module}/)
 \`\`\`
+`;
+  }
+
+  return [
+    {
+      name: 'inc-status.md',
+      content: `---
+description: [incspec] 查看当前工作流状态
+---
+
+# 查看工作流状态
+
+请运行以下命令查看当前工作流状态:
+
+\`\`\`bash
+incspec status
+\`\`\`
+
+或直接读取状态文件:
+
+\`\`\`bash
+cat ${INCSPEC_DIR}/workflow.json
+\`\`\`
 `,
     },
+    {
+      name: 'inc-help.md',
+      content: helpContent,
+    },
   ];
 }
 

package/src/templates/CLAUDE.md

@@ -0,0 +1,12 @@
+<claude-mem-context>
+# Recent Activity
+
+<!-- This section is auto-generated by claude-mem. Edit content outside the tags. -->
+
+### Jan 8, 2026
+
+| ID | Time | T | Title | Read |
+|----|------|---|-------|------|
+| #105 | 2:48 PM | 🔵 | 发现模板文件目录结构 | ~96 |
+| #94 | 2:40 PM | 🔵 | 发现 IncSpec 模板文件结构 | ~62 |
+</claude-mem-context>

package/src/templates/commands/CLAUDE.md

@@ -0,0 +1,11 @@
+<claude-mem-context>
+# Recent Activity
+
+<!-- This section is auto-generated by claude-mem. Edit content outside the tags. -->
+
+### Jan 8, 2026
+
+| ID | Time | T | Title | Read |
+|----|------|---|-------|------|
+| #106 | 3:07 PM | 🔵 | 完成对 inc-help.md 写入机制的深度分析 | ~130 |
+</claude-mem-context>

package/src/templates/commands/inc-help.md

@@ -0,0 +1,37 @@
+---
+description: [incspec] 显示帮助信息
+---
+
+# incspec 帮助
+
+## 工作流步骤
+
+<!-- MODE_SECTIONS -->
+
+## 辅助命令
+
+- `/incspec/inc-status` - 查看当前工作流状态
+- `/incspec/inc-help` - 显示帮助信息
+
+## CLI 命令
+
+```bash
+incspec init          # 初始化项目
+incspec status        # 查看工作流状态
+incspec list          # 列出规范文件
+incspec validate      # 验证规范完整性
+incspec sync          # 同步 IDE 命令
+incspec help          # 显示帮助
+```
+
+## 目录结构
+
+```
+incspec/
+├── project.md        # 项目配置
+├── workflow.json     # 工作流状态
+├── baselines/        # 基线快照
+├── requirements/     # 需求文档
+├── increments/       # 增量设计
+└── archives/         # 历史归档 (YYYY-MM/{module}/)
+```