@localsummer/incspec 0.0.1

package/commands/list.mjs

@@ -0,0 +1,111 @@
+/**
+ * list command - List spec files
+ */
+
+import * as path from 'path';
+import {
+  ensureInitialized,
+  INCSPEC_DIR,
+  DIRS,
+} from '../lib/config.mjs';
+import { listSpecs, getSpecInfo } from '../lib/spec.mjs';
+import {
+  colors,
+  colorize,
+  print,
+  printTable,
+  printWarning,
+} from '../lib/terminal.mjs';
+
+/**
+ * Execute list command
+ * @param {Object} ctx - Command context
+ */
+export async function listCommand(ctx) {
+  const { cwd, args, options } = ctx;
+
+  // Ensure initialized
+  const projectRoot = ensureInitialized(cwd);
+
+  // Get type filter
+  const type = args[0]; // baselines | requirements | increments | archives
+
+  print('');
+  print(colorize('  incspec 规范文件列表', colors.bold, colors.cyan));
+  print(colorize('  ───────────────────', colors.dim));
+  print('');
+
+  const types = type ? [type] : ['baselines', 'requirements', 'increments'];
+
+  for (const t of types) {
+    const specs = listSpecs(projectRoot, t);
+
+    print(colorize(`${DIRS[t] || t}/`, colors.bold, colors.yellow));
+
+    if (specs.length === 0) {
+      print(colorize('  (空)', colors.dim));
+    } else {
+      specs.forEach(spec => {
+        const info = getSpecInfo(spec.path);
+        const mtime = spec.mtime.toISOString().replace('T', ' ').slice(0, 16);
+        const versionStr = info.version ? colorize(`v${info.version}`, colors.cyan) : '';
+        
+        print(`  ${colorize(spec.name, colors.white)} ${versionStr}`);
+        if (options.long || options.l) {
+          print(colorize(`    修改时间: ${mtime}`, colors.dim));
+          print(colorize(`    路径: ${spec.path}`, colors.dim));
+        }
+      });
+    }
+    print('');
+  }
+
+  // Show archives if requested
+  if (type === 'archives' || options.all || options.a) {
+    const archivePath = path.join(projectRoot, INCSPEC_DIR, DIRS.archives);
+    print(colorize(`${DIRS.archives}/`, colors.bold, colors.yellow));
+    
+    try {
+      const fs = await import('fs');
+      if (fs.existsSync(archivePath)) {
+        const months = fs.readdirSync(archivePath).filter(f => 
+          fs.statSync(path.join(archivePath, f)).isDirectory()
+        );
+        
+        if (months.length === 0) {
+          print(colorize('  (空)', colors.dim));
+        } else {
+          months.sort().reverse().forEach(month => {
+            print(colorize(`  ${month}/`, colors.cyan));
+            const monthPath = path.join(archivePath, month);
+            const entries = fs.readdirSync(monthPath, { withFileTypes: true });
+            
+            // Collect direct .md files (legacy) and module subdirectories
+            const directFiles = entries.filter(e => e.isFile() && e.name.endsWith('.md'));
+            const moduleDirs = entries.filter(e => e.isDirectory());
+            
+            // Show direct files (legacy structure)
+            directFiles.forEach(f => {
+              print(colorize(`    ${f.name}`, colors.dim));
+            });
+            
+            // Show module subdirectories and their files
+            moduleDirs.forEach(moduleDir => {
+              print(colorize(`    ${moduleDir.name}/`, colors.white));
+              const modulePath = path.join(monthPath, moduleDir.name);
+              const moduleFiles = fs.readdirSync(modulePath).filter(f => f.endsWith('.md'));
+              moduleFiles.forEach(f => {
+                print(colorize(`      ${f}`, colors.dim));
+              });
+            });
+          });
+        }
+      } else {
+        print(colorize('  (空)', colors.dim));
+      }
+    } catch (e) {
+      print(colorize('  (空)', colors.dim));
+    }
+    print('');
+  }
+}

package/commands/merge.mjs

@@ -0,0 +1,112 @@
+/**
+ * merge command - Step 6: Merge to baseline
+ */
+
+import * as path from 'path';
+import {
+  ensureInitialized,
+  INCSPEC_DIR,
+  DIRS,
+} from '../lib/config.mjs';
+import {
+  readWorkflow,
+  updateStep,
+  STATUS,
+} from '../lib/workflow.mjs';
+import { listSpecs, getNextVersion } from '../lib/spec.mjs';
+import {
+  colors,
+  colorize,
+  print,
+  printSuccess,
+  printWarning,
+  printInfo,
+} from '../lib/terminal.mjs';
+
+const STEP_NUMBER = 6;
+
+/**
+ * Execute merge command
+ * @param {Object} ctx - Command context
+ */
+export async function mergeCommand(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;
+    }
+  }
+
+  // Calculate output file
+  const moduleName = workflow.currentWorkflow.replace(/^analyze-/, '');
+  const version = getNextVersion(projectRoot, 'baselines', moduleName);
+  const defaultOutputFile = `${moduleName}-baseline-v${version}.md`;
+  const outputOverride = typeof options.output === 'string' ? options.output : '';
+  const outputFile = outputOverride || defaultOutputFile;
+  const outputPath = path.join(INCSPEC_DIR, DIRS.baselines, outputFile);
+
+  print('');
+  print(colorize('步骤 6: 合并到基线', colors.bold, colors.cyan));
+  print(colorize('─────────────────', colors.dim));
+  print('');
+  print(colorize(`当前工作流: ${workflow.currentWorkflow}`, colors.dim));
+  print(colorize(`增量设计文件: ${incrementPath}`, 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-merge ${incrementPath}`, colors.bold, colors.white));
+  print('');
+  print(colorize('或使用 Claude Code 命令:', colors.cyan));
+  print('');
+  const outDir = path.join(projectRoot, INCSPEC_DIR, DIRS.baselines);
+  print(colorize(`  /ai-increment:merge-to-baseline ${incrementPath} ${outDir}`, colors.bold, colors.white));
+  print('');
+  print(colorize('该命令将:', colors.dim));
+  print(colorize('  1. 解析增量设计文件中的时序图和依赖图', colors.dim));
+  print(colorize('  2. 清理增量标记 (🆕/✏️/❌)', colors.dim));
+  print(colorize('  3. 重新编号为 S1-Sxx, D1-Dxx', colors.dim));
+  print(colorize('  4. 生成新的基线快照', colors.dim));
+  print('');
+  print(colorize('新基线将作为下一轮增量开发的起点。', colors.dim));
+  print('');
+  printInfo(`完成后运行 'incspec status' 查看进度`);
+  print('');
+
+  // Handle --complete flag
+  if (options.complete) {
+    updateStep(projectRoot, STEP_NUMBER, STATUS.COMPLETED, outputFile);
+    printSuccess(`步骤 6 已标记为完成: ${outputFile}`);
+  }
+}

package/commands/status.mjs

@@ -0,0 +1,117 @@
+/**
+ * status command - Display workflow status
+ */
+
+import {
+  ensureInitialized,
+  readProjectConfig,
+} from '../lib/config.mjs';
+import {
+  readWorkflow,
+  STEPS,
+  STATUS,
+} from '../lib/workflow.mjs';
+import {
+  colors,
+  colorize,
+  print,
+  printHeader,
+  printStep,
+  printWarning,
+} from '../lib/terminal.mjs';
+
+/**
+ * Execute status command
+ * @param {Object} ctx - Command context
+ */
+export async function statusCommand(ctx) {
+  const { cwd } = ctx;
+
+  // Ensure initialized
+  const projectRoot = ensureInitialized(cwd);
+
+  // Read config and workflow
+  const config = readProjectConfig(projectRoot);
+  const workflow = readWorkflow(projectRoot);
+
+  print('');
+  print(colorize('  incspec 工作流状态', colors.bold, colors.cyan));
+  print(colorize('  ─────────────────', colors.dim));
+  print('');
+
+  // Project info
+  const techStack = Array.isArray(config?.tech_stack)
+    ? config.tech_stack
+    : (config?.tech_stack ? [config.tech_stack] : []);
+  print(colorize(`项目: ${config.name}`, colors.bold));
+  print(colorize(`技术栈: ${techStack.join(', ') || '-'}`, colors.dim));
+  print('');
+
+  // Current workflow
+  if (workflow?.currentWorkflow) {
+    print(colorize(`当前工作流: `, colors.bold) + colorize(workflow.currentWorkflow, colors.cyan));
+    print(colorize(`开始时间: ${workflow.startTime || '-'}`, colors.dim));
+    print(colorize(`最后更新: ${workflow.lastUpdate || '-'}`, colors.dim));
+    print('');
+
+    // Steps progress
+    print(colorize('步骤进度:', colors.bold));
+    print('');
+
+    STEPS.forEach((step, index) => {
+      const stepData = workflow.steps[index] || {};
+      const status = stepData.status || STATUS.PENDING;
+      const isCurrent = workflow.currentStep === step.id;
+
+      // Determine display status
+      let displayStatus = status;
+      if (isCurrent && status === STATUS.PENDING) {
+        displayStatus = STATUS.IN_PROGRESS;
+      }
+
+      printStep(step.id, step.label, displayStatus);
+
+      // Show output file if completed
+      if (stepData.output && status === STATUS.COMPLETED) {
+        print(colorize(`     → ${stepData.output}`, colors.dim));
+      }
+    });
+
+    print('');
+
+    // Next step hint
+    const nextStepIndex = workflow.steps.findIndex(
+      step => (step?.status || STATUS.PENDING) !== STATUS.COMPLETED
+    );
+    if (nextStepIndex >= 0) {
+      const nextStep = STEPS[nextStepIndex];
+      print(colorize('下一步:', colors.bold));
+      print(colorize(`  运行 'incspec ${nextStep.command}' 或使用 /incspec/inc-${nextStep.command}`, colors.cyan));
+    } else {
+      print(colorize('当前工作流步骤已全部完成。', colors.dim));
+    }
+  } else {
+    printWarning('当前没有活跃的工作流');
+    print('');
+    print(colorize('开始新工作流:', colors.bold));
+    print(colorize(`  1. 运行 'incspec analyze <source-path>' 分析代码`, colors.dim));
+    print(colorize(`  2. 或使用 Cursor 命令 /incspec/inc-analyze`, colors.dim));
+  }
+
+  print('');
+
+  // Recent history
+  if (workflow?.history && workflow.history.length > 0) {
+    print(colorize('最近的工作流:', colors.bold));
+    print('');
+
+    const recentHistory = workflow.history.slice(0, 5);
+    recentHistory.forEach(item => {
+      const statusIcon = item.status === 'completed' 
+        ? colorize('✓', colors.green) 
+        : colorize('○', colors.dim);
+      print(`  ${statusIcon} ${item.name} (${item.startTime || '-'})`);
+    });
+    print('');
+  }
+}

package/commands/update.mjs

@@ -0,0 +1,189 @@
+/**
+ * update command - Update template files to latest version
+ * Updates AGENTS.md, WORKFLOW.md in incspec/ and managed block in project AGENTS.md
+ */
+
+import * as fs from 'fs';
+import * as path from 'path';
+import {
+  ensureInitialized,
+  getIncspecDir,
+  getTemplatesDir,
+  FILES,
+} from '../lib/config.mjs';
+import { updateProjectAgentsFile, getProjectAgentsFilePath } from '../lib/agents.mjs';
+import {
+  colors,
+  colorize,
+  print,
+  printSuccess,
+  printWarning,
+  printInfo,
+  confirm,
+} from '../lib/terminal.mjs';
+
+/**
+ * Update incspec/AGENTS.md from template
+ * @param {string} projectRoot
+ * @returns {{updated: boolean, path: string}}
+ */
+function updateIncspecAgents(projectRoot) {
+  const targetPath = path.join(getIncspecDir(projectRoot), FILES.agents);
+  const templatePath = path.join(getTemplatesDir(), 'AGENTS.md');
+
+  if (!fs.existsSync(templatePath)) {
+    return { updated: false, path: targetPath, error: '模板文件不存在' };
+  }
+
+  const templateContent = fs.readFileSync(templatePath, 'utf-8');
+  
+  // Check if content is different
+  let currentContent = '';
+  if (fs.existsSync(targetPath)) {
+    currentContent = fs.readFileSync(targetPath, 'utf-8');
+  }
+
+  if (currentContent === templateContent) {
+    return { updated: false, path: targetPath, reason: '内容相同' };
+  }
+
+  fs.writeFileSync(targetPath, templateContent, 'utf-8');
+  return { updated: true, path: targetPath };
+}
+
+/**
+ * Update incspec/WORKFLOW.md template structure while preserving user data
+ * @param {string} projectRoot
+ * @returns {{updated: boolean, path: string}}
+ */
+function updateIncspecWorkflow(projectRoot) {
+  const targetPath = path.join(getIncspecDir(projectRoot), FILES.workflow);
+  const templatePath = path.join(getTemplatesDir(), 'WORKFLOW.md');
+
+  if (!fs.existsSync(templatePath)) {
+    return { updated: false, path: targetPath, error: '模板文件不存在' };
+  }
+
+  // For WORKFLOW.md, we only update if file doesn't exist
+  // Because it contains dynamic user data that we don't want to overwrite
+  // The template is only used for initial structure
+  if (fs.existsSync(targetPath)) {
+    return { updated: false, path: targetPath, reason: '保留用户工作流数据' };
+  }
+
+  const now = new Date().toISOString().replace('T', ' ').slice(0, 16);
+  let templateContent = fs.readFileSync(templatePath, 'utf-8');
+  templateContent = templateContent.replace(/\{\{last_update\}\}/g, now);
+
+  fs.writeFileSync(targetPath, templateContent, 'utf-8');
+  return { updated: true, path: targetPath };
+}
+
+/**
+ * Execute update command
+ * @param {Object} ctx - Command context
+ */
+export async function updateCommand(ctx) {
+  const { cwd, options } = ctx;
+
+  // Ensure project is initialized
+  let projectRoot;
+  try {
+    projectRoot = ensureInitialized(cwd);
+  } catch (error) {
+    printWarning(error.message);
+    return;
+  }
+
+  print('');
+  print(colorize('  incspec 模板更新', colors.bold, colors.cyan));
+  print(colorize('  ────────────────', colors.dim));
+  print('');
+
+  // List what will be updated
+  print(colorize('将更新以下模板文件:', colors.bold));
+  print(colorize('  - incspec/AGENTS.md (incspec 使用指南)', colors.dim));
+  print(colorize('  - incspec/WORKFLOW.md (工作流模板，保留用户数据)', colors.dim));
+  print(colorize('  - AGENTS.md (项目根目录 incspec 指令块)', colors.dim));
+  print('');
+
+  // Confirm unless --yes flag
+  if (!options.yes && !options.y) {
+    const shouldProceed = await confirm('确认更新模板文件?');
+    if (!shouldProceed) {
+      print(colorize('已取消更新。', colors.dim));
+      return;
+    }
+  }
+
+  print('');
+
+  const results = [];
+
+  // Update incspec/AGENTS.md
+  const agentsResult = updateIncspecAgents(projectRoot);
+  results.push({
+    file: 'incspec/AGENTS.md',
+    ...agentsResult,
+  });
+
+  // Update incspec/WORKFLOW.md
+  const workflowResult = updateIncspecWorkflow(projectRoot);
+  results.push({
+    file: 'incspec/WORKFLOW.md',
+    ...workflowResult,
+  });
+
+  // Update project AGENTS.md (managed block)
+  const projectAgentsResult = updateProjectAgentsFile(projectRoot);
+  results.push({
+    file: 'AGENTS.md',
+    path: getProjectAgentsFilePath(projectRoot),
+    updated: projectAgentsResult.created || projectAgentsResult.updated,
+    created: projectAgentsResult.created,
+    blockUpdated: projectAgentsResult.updated,
+  });
+
+  // Print results
+  print(colorize('更新结果:', colors.bold));
+  print('');
+
+  let updatedCount = 0;
+  let skippedCount = 0;
+
+  for (const result of results) {
+    if (result.error) {
+      print(`  ${colorize('x', colors.red)} ${result.file}`);
+      print(colorize(`    错误: ${result.error}`, colors.red));
+    } else if (result.updated) {
+      updatedCount++;
+      if (result.created) {
+        print(`  ${colorize('+', colors.green)} ${result.file} ${colorize('(新建)', colors.green)}`);
+      } else if (result.blockUpdated) {
+        print(`  ${colorize('~', colors.yellow)} ${result.file} ${colorize('(更新指令块)', colors.yellow)}`);
+      } else {
+        print(`  ${colorize('~', colors.yellow)} ${result.file} ${colorize('(已更新)', colors.yellow)}`);
+      }
+    } else {
+      skippedCount++;
+      const reasonText = result.reason ? ` (${result.reason})` : '';
+      print(`  ${colorize('-', colors.dim)} ${result.file} ${colorize(`跳过${reasonText}`, colors.dim)}`);
+    }
+  }
+
+  print('');
+
+  if (updatedCount > 0) {
+    printSuccess(`已更新 ${updatedCount} 个文件。`);
+  } else {
+    printInfo('所有模板文件已是最新版本。');
+  }
+
+  if (skippedCount > 0) {
+    printInfo(`跳过 ${skippedCount} 个文件。`);
+  }
+
+  print('');
+}
+
+export default updateCommand;