@localsummer/incspec 0.0.1

package/commands/apply.mjs

@@ -0,0 +1,111 @@
+/**
+ * apply command - Step 5: Apply increment code
+ */
+
+import * as path from 'path';
+import {
+  ensureInitialized,
+  INCSPEC_DIR,
+  DIRS,
+  readProjectConfig,
+} from '../lib/config.mjs';
+import {
+  readWorkflow,
+  updateStep,
+  STATUS,
+} from '../lib/workflow.mjs';
+import { listSpecs } from '../lib/spec.mjs';
+import {
+  colors,
+  colorize,
+  print,
+  printSuccess,
+  printWarning,
+  printInfo,
+  prompt,
+} from '../lib/terminal.mjs';
+
+const STEP_NUMBER = 5;
+
+/**
+ * Execute apply command
+ * @param {Object} ctx - Command context
+ */
+export async function applyCommand(ctx) {
+  const { cwd, args, options } = ctx;
+
+  // Ensure initialized
+  const projectRoot = ensureInitialized(cwd);
+
+  // Get workflow state
+  const workflow = readWorkflow(projectRoot);
+
+  if (!workflow?.currentWorkflow) {
+    printWarning('没有活跃的工作流。请先运行 incspec analyze 开始新工作流。');
+    return;
+  }
+
+  // Get increment file
+  let incrementPath = args[0];
+  if (!incrementPath) {
+    const increments = listSpecs(projectRoot, 'increments');
+    if (increments.length > 0) {
+      const featureName = workflow.currentWorkflow.replace(/^analyze-/, '');
+      const matched = increments.find(spec => spec.name.startsWith(`${featureName}-increment-`));
+      if (matched) {
+        incrementPath = matched.path;
+      } else {
+        incrementPath = increments[0].path;
+        printWarning(`未找到与当前工作流匹配的增量文件，已使用最近文件: ${increments[0].name}`);
+      }
+    } else {
+      printWarning('未找到增量设计文件。请先运行步骤 4 (design)。');
+      return;
+    }
+  }
+
+  // Get source directory
+  const config = readProjectConfig(projectRoot);
+  const sourceDir = typeof options['source-dir'] === 'string'
+    ? options['source-dir']
+    : (config?.source_dir || 'src');
+
+  print('');
+  print(colorize('步骤 5: 应用代码变更', colors.bold, colors.cyan));
+  print(colorize('────────────────────', colors.dim));
+  print('');
+  print(colorize(`当前工作流: ${workflow.currentWorkflow}`, colors.dim));
+  print(colorize(`增量设计文件: ${incrementPath}`, colors.dim));
+  print(colorize(`源代码目录: ${sourceDir}`, colors.dim));
+  print('');
+
+  // Update workflow status
+  updateStep(projectRoot, STEP_NUMBER, STATUS.IN_PROGRESS);
+
+  print(colorize('使用说明:', colors.bold));
+  print('');
+  print(colorize('请在 Cursor 中运行以下命令:', colors.cyan));
+  print('');
+  print(colorize(`  /incspec/inc-apply ${incrementPath}`, colors.bold, colors.white));
+  print('');
+  print(colorize('或使用 Claude Code 命令:', colors.cyan));
+  print('');
+  print(colorize(`  /ai-increment:apply-increment-code ${incrementPath} ${path.join(projectRoot, sourceDir)}`, colors.bold, colors.white));
+  print('');
+  print(colorize('该命令将:', colors.dim));
+  print(colorize('  1. 解析增量设计文件中的变更计划', colors.dim));
+  print(colorize('  2. 按依赖顺序排序变更', colors.dim));
+  print(colorize('  3. 执行代码新建/修改/删除', colors.dim));
+  print(colorize('  4. 输出变更摘要', colors.dim));
+  print('');
+  printWarning('请在执行前仔细审查增量设计文件!');
+  print('');
+  printInfo(`完成后运行 'incspec status' 查看进度`);
+  print('');
+
+  // Handle --complete flag
+  if (options.complete) {
+    updateStep(projectRoot, STEP_NUMBER, STATUS.COMPLETED, '代码已应用');
+    printSuccess(`步骤 5 已标记为完成`);
+  }
+}

package/commands/archive.mjs

@@ -0,0 +1,340 @@
+/**
+ * archive command - Archive spec files
+ */
+
+import * as fs from 'fs';
+import * as path from 'path';
+import {
+  ensureInitialized,
+  INCSPEC_DIR,
+  DIRS,
+} from '../lib/config.mjs';
+import { archiveSpec, getSpecInfo } from '../lib/spec.mjs';
+import { archiveWorkflow, readWorkflow, STATUS } from '../lib/workflow.mjs';
+import {
+  colors,
+  colorize,
+  print,
+  printSuccess,
+  printWarning,
+  printError,
+  confirm,
+} from '../lib/terminal.mjs';
+
+const ARCHIVABLE_STEP_INDEXES = [0, 1, 2, 3, 5];
+
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+
+function normalizeOutputName(outputFile) {
+  if (!outputFile || typeof outputFile !== 'string') {
+    return outputFile;
+  }
+
+  if (!/[\\/]/.test(outputFile)) {
+    return outputFile;
+  }
+
+  const parts = outputFile.split(/[/\\]+/);
+  return parts[parts.length - 1] || outputFile;
+}
+
+function collectArchivedFiles(projectRoot) {
+  const archiveRoot = path.join(projectRoot, INCSPEC_DIR, DIRS.archives);
+  if (!fs.existsSync(archiveRoot)) {
+    return [];
+  }
+
+  const files = [];
+  
+  // Helper to collect .md files from a directory
+  const collectMdFiles = (dir) => {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    entries.forEach(entry => {
+      const entryPath = path.join(dir, entry.name);
+      if (entry.isFile() && entry.name.endsWith('.md')) {
+        files.push({ name: entry.name, mtime: fs.statSync(entryPath).mtime });
+      }
+    });
+  };
+  
+  // Traverse: archives/ -> YYYY-MM/ -> [module/] -> files
+  const topEntries = fs.readdirSync(archiveRoot, { withFileTypes: true });
+  topEntries.forEach(entry => {
+    const entryPath = path.join(archiveRoot, entry.name);
+    if (entry.isFile() && entry.name.endsWith('.md')) {
+      // Legacy: files directly in archives/
+      files.push({ name: entry.name, mtime: fs.statSync(entryPath).mtime });
+      return;
+    }
+
+    if (!entry.isDirectory()) {
+      return;
+    }
+
+    // Level 1: YYYY-MM directory
+    const subEntries = fs.readdirSync(entryPath, { withFileTypes: true });
+    subEntries.forEach(subEntry => {
+      const subPath = path.join(entryPath, subEntry.name);
+      if (subEntry.isFile() && subEntry.name.endsWith('.md')) {
+        // Legacy: files directly in YYYY-MM/
+        files.push({ name: subEntry.name, mtime: fs.statSync(subPath).mtime });
+        return;
+      }
+
+      if (subEntry.isDirectory()) {
+        // Level 2: module directory - collect files inside
+        collectMdFiles(subPath);
+      }
+    });
+  });
+
+  return files;
+}
+
+function parseWorkflowTime(value) {
+  if (!value || value === '-') {
+    return null;
+  }
+
+  const parsed = new Date(value.replace(' ', 'T'));
+  return Number.isNaN(parsed.getTime()) ? null : parsed;
+}
+
+function isOutputArchived(archivedFiles, outputFile, completedAt) {
+  const ext = path.extname(outputFile);
+  const base = path.basename(outputFile, ext);
+  const pattern = new RegExp(`^${escapeRegExp(base)}(-copy\\d+)?${escapeRegExp(ext)}$`);
+  return archivedFiles.some(file => pattern.test(file.name) && file.mtime >= completedAt);
+}
+
+function getArchivableOutputs(workflow) {
+  if (!workflow?.currentWorkflow || !workflow.steps?.length) {
+    return null;
+  }
+
+  const outputs = [];
+  for (const index of ARCHIVABLE_STEP_INDEXES) {
+    const step = workflow.steps[index];
+    if (!step || step.status !== STATUS.COMPLETED || !step.output || step.output === '-') {
+      return null;
+    }
+
+    const completedAt = parseWorkflowTime(step.completedAt);
+    if (!completedAt) {
+      return null;
+    }
+
+    outputs.push({ name: normalizeOutputName(step.output), completedAt, index });
+  }
+
+  return outputs;
+}
+
+function getOutputDirForStepIndex(stepIndex) {
+  if (stepIndex === 0 || stepIndex === 5) {
+    return DIRS.baselines;
+  }
+
+  if (stepIndex === 1 || stepIndex === 2) {
+    return DIRS.requirements;
+  }
+
+  if (stepIndex === 3) {
+    return DIRS.increments;
+  }
+
+  return null;
+}
+
+function getOutputPath(projectRoot, output) {
+  const dir = getOutputDirForStepIndex(output.index);
+  if (!dir) {
+    return null;
+  }
+
+  return path.join(projectRoot, INCSPEC_DIR, dir, output.name);
+}
+
+function shouldArchiveWorkflow(projectRoot, workflow) {
+  const outputs = getArchivableOutputs(workflow);
+  if (!outputs || outputs.length === 0) {
+    return false;
+  }
+
+  const archivedFiles = collectArchivedFiles(projectRoot);
+  if (archivedFiles.length === 0) {
+    return false;
+  }
+
+  return outputs.every(output => isOutputArchived(archivedFiles, output.name, output.completedAt));
+}
+
+/**
+ * Execute archive command
+ * @param {Object} ctx - Command context
+ */
+export async function archiveCommand(ctx) {
+  const { cwd, args, options } = ctx;
+
+  // Ensure initialized
+  const projectRoot = ensureInitialized(cwd);
+
+  print('');
+  print(colorize('  incspec 归档管理', colors.bold, colors.cyan));
+  print(colorize('  ────────────────', colors.dim));
+  print('');
+
+  const keepOriginal = options.keep || options.k;
+  const skipConfirm = options.yes || options.y;
+  const archiveCurrentWorkflow = options.workflow || !args[0];
+
+  if (archiveCurrentWorkflow) {
+    if (options.workflow && args[0]) {
+      printWarning('已忽略文件参数，按当前工作流归档。');
+    }
+
+    const workflow = readWorkflow(projectRoot);
+    if (!workflow?.currentWorkflow) {
+      printError('没有活跃工作流，无法归档当前工作流产出。');
+      print(colorize('如需归档单文件，请提供 file-path。', colors.dim));
+      return;
+    }
+
+    const outputs = getArchivableOutputs(workflow);
+    if (!outputs || outputs.length === 0) {
+      printError('当前工作流尚未产出完整的可归档文件。');
+      print(colorize('请先完成工作流产出，或使用 file-path 归档单文件。', colors.dim));
+      return;
+    }
+
+    const archivedFiles = collectArchivedFiles(projectRoot);
+    const targets = [];
+    const skipped = [];
+    const missing = [];
+
+    outputs.forEach(output => {
+      const outputPath = getOutputPath(projectRoot, output);
+      if (outputPath && fs.existsSync(outputPath)) {
+        targets.push({ path: outputPath, name: output.name });
+        return;
+      }
+
+      if (isOutputArchived(archivedFiles, output.name, output.completedAt)) {
+        skipped.push(output.name);
+        return;
+      }
+
+      missing.push(output.name);
+    });
+
+    if (missing.length > 0) {
+      printError(`以下产出文件未找到: ${missing.join(', ')}`);
+      return;
+    }
+
+    if (targets.length > 0) {
+      print(colorize('将归档以下文件:', colors.dim));
+      targets.forEach(target => print(colorize(`  - ${target.name}`, colors.dim)));
+      print('');
+    }
+
+    if (skipped.length > 0) {
+      printWarning(`以下文件已归档，跳过: ${skipped.join(', ')}`);
+    }
+
+    if (targets.length > 0 && !skipConfirm) {
+      const action = keepOriginal ? '复制' : '移动';
+      const shouldProceed = await confirm(`确认${action}当前工作流的 ${targets.length} 个文件到归档目录?`);
+      if (!shouldProceed) {
+        print(colorize('已取消。', colors.dim));
+        return;
+      }
+    }
+
+    try {
+      const workflowModule = workflow.currentWorkflow;
+      for (const target of targets) {
+        const archivePath = archiveSpec(projectRoot, target.path, !keepOriginal, workflowModule);
+        printSuccess(`文件已${keepOriginal ? '复制' : '移动'}到: ${archivePath}`);
+      }
+
+      const refreshed = readWorkflow(projectRoot);
+      if (refreshed?.currentWorkflow && shouldArchiveWorkflow(projectRoot, refreshed)) {
+        const workflowName = refreshed.currentWorkflow;
+        archiveWorkflow(projectRoot);
+        printSuccess(`工作流 "${workflowName}" 已记录为归档。`);
+      }
+    } catch (e) {
+      printError(`归档失败: ${e.message}`);
+    }
+
+    return;
+  }
+
+  // Get file to archive
+  let filePath = args[0];
+
+  if (!filePath) {
+    printError('请提供要归档的文件路径。');
+    return;
+  }
+
+  // Validate file exists
+  if (!fs.existsSync(filePath)) {
+    // Try to resolve relative path
+    const possiblePaths = [
+      path.join(projectRoot, filePath),
+      path.join(projectRoot, INCSPEC_DIR, filePath),
+      path.join(projectRoot, INCSPEC_DIR, DIRS.baselines, filePath),
+      path.join(projectRoot, INCSPEC_DIR, DIRS.increments, filePath),
+      path.join(projectRoot, INCSPEC_DIR, DIRS.requirements, filePath),
+    ];
+
+    const found = possiblePaths.find(p => fs.existsSync(p));
+    if (found) {
+      filePath = found;
+    } else {
+      printError(`文件不存在: ${filePath}`);
+      return;
+    }
+  }
+
+  const fileName = path.basename(filePath);
+  const info = getSpecInfo(filePath);
+
+  print(colorize(`文件: ${fileName}`, colors.bold));
+  print(colorize(`类型: ${info.type}`, colors.dim));
+  if (info.version) {
+    print(colorize(`版本: v${info.version}`, colors.dim));
+  }
+  print('');
+
+  // Confirm
+  const action = keepOriginal ? '复制' : '移动';
+
+  if (!skipConfirm) {
+    const shouldProceed = await confirm(`确认${action}文件到归档目录?`);
+    if (!shouldProceed) {
+      print(colorize('已取消。', colors.dim));
+      return;
+    }
+  }
+
+  // Archive (default: move, with --keep: copy)
+  try {
+    const workflow = readWorkflow(projectRoot);
+    const workflowModule = workflow?.currentWorkflow || null;
+    const archivePath = archiveSpec(projectRoot, filePath, !keepOriginal, workflowModule);
+    printSuccess(`文件已${action}到: ${archivePath}`);
+
+    if (workflow?.currentWorkflow && shouldArchiveWorkflow(projectRoot, workflow)) {
+      const workflowName = workflow.currentWorkflow;
+      archiveWorkflow(projectRoot);
+      printSuccess(`工作流 "${workflowName}" 已记录为归档。`);
+    }
+  } catch (e) {
+    printError(`归档失败: ${e.message}`);
+  }
+}

package/commands/collect-dep.mjs

@@ -0,0 +1,85 @@
+/**
+ * collect-dep command - Step 3: Collect UI dependencies
+ */
+
+import * as path from 'path';
+import {
+  ensureInitialized,
+  INCSPEC_DIR,
+  DIRS,
+} from '../lib/config.mjs';
+import {
+  readWorkflow,
+  updateStep,
+  STATUS,
+} from '../lib/workflow.mjs';
+import {
+  colors,
+  colorize,
+  print,
+  printSuccess,
+  printWarning,
+  printInfo,
+} from '../lib/terminal.mjs';
+
+const STEP_NUMBER = 3;
+const OUTPUT_FILE = 'ui-dependencies.md';
+
+/**
+ * Execute collect-dep command
+ * @param {Object} ctx - Command context
+ */
+export async function collectDepCommand(ctx) {
+  const { cwd, options } = ctx;
+
+  // Ensure initialized
+  const projectRoot = ensureInitialized(cwd);
+
+  // Get workflow state
+  const workflow = readWorkflow(projectRoot);
+
+  if (!workflow?.currentWorkflow) {
+    printWarning('没有活跃的工作流。请先运行 incspec analyze 开始新工作流。');
+    return;
+  }
+
+  const outputPath = path.join(INCSPEC_DIR, DIRS.requirements, OUTPUT_FILE);
+
+  print('');
+  print(colorize('步骤 3: UI 依赖采集', colors.bold, colors.cyan));
+  print(colorize('───────────────────', colors.dim));
+  print('');
+  print(colorize(`当前工作流: ${workflow.currentWorkflow}`, colors.dim));
+  print(colorize(`输出文件: ${outputPath}`, colors.dim));
+  print('');
+
+  // Update workflow status
+  updateStep(projectRoot, STEP_NUMBER, STATUS.IN_PROGRESS);
+
+  print(colorize('使用说明:', colors.bold));
+  print('');
+  print(colorize('请在 Cursor 中运行以下命令:', colors.cyan));
+  print('');
+  print(colorize(`  /incspec/inc-collect-dep`, colors.bold, colors.white));
+  print('');
+  print(colorize('或使用 Claude Code 命令:', colors.cyan));
+  print('');
+  print(colorize(`  /ai-increment:ui-dependency-collection ${path.join(projectRoot, INCSPEC_DIR, DIRS.requirements)}`, colors.bold, colors.white));
+  print('');
+  print(colorize('该命令将交互式采集 6 维度 UI 依赖:', colors.dim));
+  print(colorize('  - UI组件库 (Arco/Antd)', colors.dim));
+  print(colorize('  - 状态管理 (Store)', colors.dim));
+  print(colorize('  - API 交互', colors.dim));
+  print(colorize('  - 类型定义 (Type)', colors.dim));
+  print(colorize('  - 工具函数 (Utils)', colors.dim));
+  print(colorize('  - 定位上下文 (Context)', colors.dim));
+  print('');
+  printInfo(`完成后运行 'incspec status' 查看进度`);
+  print('');
+
+  // Handle --complete flag
+  if (options.complete) {
+    updateStep(projectRoot, STEP_NUMBER, STATUS.COMPLETED, OUTPUT_FILE);
+    printSuccess(`步骤 3 已标记为完成: ${OUTPUT_FILE}`);
+  }
+}

package/commands/collect-req.mjs

@@ -0,0 +1,80 @@
+/**
+ * collect-req command - Step 2: Collect structured requirements
+ */
+
+import * as path from 'path';
+import {
+  ensureInitialized,
+  INCSPEC_DIR,
+  DIRS,
+} from '../lib/config.mjs';
+import {
+  readWorkflow,
+  updateStep,
+  STATUS,
+} from '../lib/workflow.mjs';
+import {
+  colors,
+  colorize,
+  print,
+  printSuccess,
+  printWarning,
+  printInfo,
+} from '../lib/terminal.mjs';
+
+const STEP_NUMBER = 2;
+const OUTPUT_FILE = 'structured-requirements.md';
+
+/**
+ * Execute collect-req command
+ * @param {Object} ctx - Command context
+ */
+export async function collectReqCommand(ctx) {
+  const { cwd, options } = ctx;
+
+  // Ensure initialized
+  const projectRoot = ensureInitialized(cwd);
+
+  // Get workflow state
+  const workflow = readWorkflow(projectRoot);
+
+  if (!workflow?.currentWorkflow) {
+    printWarning('没有活跃的工作流。请先运行 incspec analyze 开始新工作流。');
+    return;
+  }
+
+  const outputPath = path.join(INCSPEC_DIR, DIRS.requirements, OUTPUT_FILE);
+
+  print('');
+  print(colorize('步骤 2: 结构化需求收集', colors.bold, colors.cyan));
+  print(colorize('─────────────────────────', colors.dim));
+  print('');
+  print(colorize(`当前工作流: ${workflow.currentWorkflow}`, colors.dim));
+  print(colorize(`输出文件: ${outputPath}`, colors.dim));
+  print('');
+
+  // Update workflow status
+  updateStep(projectRoot, STEP_NUMBER, STATUS.IN_PROGRESS);
+
+  print(colorize('使用说明:', colors.bold));
+  print('');
+  print(colorize('请在 Cursor 中运行以下命令:', colors.cyan));
+  print('');
+  print(colorize(`  /incspec/inc-collect-req`, colors.bold, colors.white));
+  print('');
+  print(colorize('或使用 Claude Code 命令:', colors.cyan));
+  print('');
+  print(colorize(`  /ai-increment:structured-requirements-collection ${path.join(projectRoot, INCSPEC_DIR, DIRS.requirements)}`, colors.bold, colors.white));
+  print('');
+  print(colorize('该命令将交互式收集需求，生成 5 列结构化表格:', colors.dim));
+  print(colorize('  | 新增/修改功能 | 涉及UI组件 | 触发条件 | 影响的核心状态 | 预期数据流向 |', colors.dim));
+  print('');
+  printInfo(`完成后运行 'incspec status' 查看进度`);
+  print('');
+
+  // Handle --complete flag
+  if (options.complete) {
+    updateStep(projectRoot, STEP_NUMBER, STATUS.COMPLETED, OUTPUT_FILE);
+    printSuccess(`步骤 2 已标记为完成: ${OUTPUT_FILE}`);
+  }
+}