@nick848/sf-cli 1.0.0 → 1.0.1

package/README.md

@@ -48,6 +48,20 @@ spfe
 /model
 ```
 
+## 命令行参数
+
+```bash
+# 查看版本号
+sf-cli -v
+# 或
+spfe -v
+
+# 查看帮助
+sf-cli -h
+# 或
+spfe -h
+```
+
 ## 命令
 
 ### 斜杠命令
@@ -59,6 +73,7 @@ spfe
 | `/model` | 配置AI模型 |
 | `/new` | 创建新需求 |
 | `/clear` | 清空对话历史 |
+| `/version` | 查看版本号 |
 | `/exit` | 退出CLI |
 | `/update` | 检查更新 |
 
@@ -87,6 +102,29 @@ spfe
 
 ## 工作流
 
+### 强制工作流机制
+
+CLI 强制执行 OpenSpec 工作流，任何代码修改需求都必须走工作流流程：
+
+1. **无工作流状态**：只允许执行基础命令
+   - `/help`, `/init`, `/model`, `/new`, `/exit`, `/clear`, `/update`, `/version`
+   - 其他操作会提示先启动工作流
+
+2. **有工作流状态**：根据当前阶段限制操作
+   - 各阶段有权限控制，只能执行该阶段允许的操作
+   - Agent 调用受阶段限制
+
+### 各阶段权限
+
+| 阶段 | 读文件 | 写文件 | Shell | 允许的 Agent |
+|------|--------|--------|-------|--------------|
+| explore | ✓ | ✗ | ✗ | architect |
+| new | ✓ | ✓ | ✗ | frontend-dev, architect |
+| continue | ✓ | ✓ | ✓ | frontend-dev, tester |
+| propose | ✓ | ✓ | ✓ | frontend-dev |
+| apply | ✓ | ✓ | ✓ | code-reviewer |
+| archive | ✓ | ✗ | ✗ | - |
+
 ### 复杂需求流程（复杂度 >= 6）
 
 ```
@@ -146,6 +184,29 @@ await norms.scanProject(projectPath);
 const result = await runAgent('frontend-dev', ['创建登录组件'], ctx);
 ```
 
+## Changelog
+
+### v1.0.1 (2026-03-21)
+
+**新增功能**
+
+- 🔒 强制工作流机制 - 所有代码修改必须走工作流流程
+- 📊 状态栏显示工作流阶段
+- 🔐 各阶段权限控制 - 读/写/Shell/Agent 受限
+
+### v1.0.0 (2026-03-21)
+
+**首次发布**
+
+- 🤖 AI驱动 - 支持 GLM-5、GPT-4o、Claude 等多种AI模型
+- 📋 标准化流程 - BDD+TDD+OpenSpec 规范支持
+- 📚 规范学习 - 自动从代码和对话中学习开发规范
+- 🔧 Sub Agent - 专业化 Agent 协作（前端开发、代码审核、架构师、测试）
+- 🔄 工作流控制 - 三阶段人工确认、回滚机制
+- 🔌 MCP集成 - 支持蓝湖、Figma 设计稿
+- 💻 双命令入口 - `sf-cli` 和 `spfe` 均可启动
+- 📝 交互式命令 - 支持 `/` 斜杠命令和命令行参数模式
+
 ## License
 
 [MIT](LICENSE)

package/dist/cli/index.js

@@ -15,6 +15,7 @@ require('@modelcontextprotocol/sdk/client/index.js');
 require('@modelcontextprotocol/sdk/client/stdio.js');
 var child_process = require('child_process');
 require('uuid');
+var module$1 = require('module');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
@@ -44,6 +45,10 @@ var fsSync__namespace = /*#__PURE__*/_interopNamespace(fsSync);
 var crypto__namespace = /*#__PURE__*/_interopNamespace(crypto);
 var os__namespace = /*#__PURE__*/_interopNamespace(os);
 
+// node_modules/tsup/assets/cjs_shims.js
+var getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.tagName.toUpperCase() === "SCRIPT" ? document.currentScript.src : new URL("main.js", document.baseURI).href;
+var importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
+
 // src/cli/parser.ts
 var CommandParser = class {
   slashCommands = [
@@ -3959,15 +3964,32 @@ var MAX_FILE_SIZE2 = 1024 * 1024;
 var COMPLEXITY_THRESHOLD = 6;
 async function handleNew(args, ctx) {
   const workingDir = ctx.options.workingDirectory;
+  const workflowEngine = ctx.workflowEngine;
+  if (workflowEngine) {
+    const existingState = workflowEngine.getState();
+    if (existingState && existingState.status === "running") {
+      return {
+        output: chalk9__default.default.yellow("\u5F53\u524D\u5DF2\u6709\u6D3B\u8DC3\u7684\u5DE5\u4F5C\u6D41") + chalk9__default.default.gray(`
+
+\u5DE5\u4F5C\u6D41: ${existingState.title}`) + chalk9__default.default.gray(`
+\u5F53\u524D\u9636\u6BB5: ${existingState.currentStep}`) + chalk9__default.default.gray(`
+
+\u9009\u9879:`) + chalk9__default.default.gray(`
+  1. \u7EE7\u7EED\u5F53\u524D\u5DE5\u4F5C\u6D41: /opsx:${existingState.currentStep}`) + chalk9__default.default.gray(`
+  2. \u53D6\u6D88\u5F53\u524D\u5DE5\u4F5C\u6D41: /opsx:cancel`) + chalk9__default.default.gray(`
+  3. \u67E5\u770B\u5DE5\u4F5C\u6D41\u72B6\u6001: /opsx:status`)
+      };
+    }
+  }
   const { requirement, forceComplexity } = parseArgs(args);
   if (!requirement) {
     return {
       output: chalk9__default.default.red("\u8BF7\u8F93\u5165\u9700\u6C42\u63CF\u8FF0") + chalk9__default.default.gray("\n\u7528\u6CD5: /new <\u9700\u6C42\u63CF\u8FF0>") + chalk9__default.default.gray("\n\u9009\u9879:") + chalk9__default.default.gray("\n  --simple   \u5F3A\u5236\u4F7F\u7528\u7B80\u5355\u6D41\u7A0B") + chalk9__default.default.gray("\n  --complex  \u5F3A\u5236\u4F7F\u7528\u590D\u6742\u6D41\u7A0B")
     };
   }
-  return newFeature({ requirement, forceComplexity }, workingDir);
+  return newFeature({ requirement, forceComplexity }, workingDir, workflowEngine);
 }
-async function newFeature(options, workingDir) {
+async function newFeature(options, workingDir, workflowEngine) {
   const cwd = workingDir || process.cwd();
   const { requirement, forceComplexity } = options;
   try {
@@ -3985,8 +4007,10 @@ async function newFeature(options, workingDir) {
   try {
     const context = await readProjectContext(cwd);
     const analysis = forceComplexity ? createForcedAnalysis(forceComplexity) : analyzeComplexity(requirement, context);
-    const workflow = new WorkflowEngine();
-    await workflow.initialize(cwd);
+    const workflow = workflowEngine || new WorkflowEngine();
+    if (!workflowEngine) {
+      await workflow.initialize(cwd);
+    }
     const state = await workflow.start(requirement, analysis.score, {
       title: extractTitle(requirement)
     });
@@ -5157,8 +5181,9 @@ ${generateConfirmationPrompt(e.point)}`) + chalk9__default.default.cyan(`
     throw e;
   }
 }
-
-// src/commands/runner.ts
+var require2 = module$1.createRequire(importMetaUrl);
+var packageJson = require2("../../package.json");
+var VERSION2 = packageJson.version;
 async function runSlashCommand(command, args, ctx) {
   const normalizedCommand = normalizeCommand(command);
   switch (normalizedCommand) {
@@ -5186,6 +5211,11 @@ async function runSlashCommand(command, args, ctx) {
     case "new":
     case "n":
       return handleNew(args, ctx);
+    case "version":
+    case "v":
+      return {
+        output: chalk9__default.default.cyan(`sf-cli v${VERSION2}`)
+      };
     default:
       if (normalizedCommand.startsWith("opsx:")) {
         return handleOpsx(normalizedCommand, args, ctx);
@@ -5296,12 +5326,75 @@ async function handleNaturalLanguage(input, ctx) {
 }
 
 // src/cli/executor.ts
+var ALLOWED_COMMANDS_WITHOUT_WORKFLOW = [
+  "help",
+  "h",
+  "?",
+  "init",
+  "i",
+  "model",
+  "m",
+  "new",
+  "n",
+  "exit",
+  "e",
+  "q",
+  "quit",
+  "clear",
+  "c",
+  "update",
+  "u",
+  "version",
+  "v"
+];
+var STAGE_PERMISSIONS = {
+  "explore": {
+    canRead: true,
+    canWrite: false,
+    canRunShell: false,
+    allowedAgents: ["architect"]
+  },
+  "new": {
+    canRead: true,
+    canWrite: true,
+    canRunShell: false,
+    allowedAgents: ["frontend-dev", "architect"]
+  },
+  "continue": {
+    canRead: true,
+    canWrite: true,
+    canRunShell: true,
+    allowedAgents: ["frontend-dev", "tester"]
+  },
+  "propose": {
+    canRead: true,
+    canWrite: true,
+    canRunShell: true,
+    allowedAgents: ["frontend-dev"]
+  },
+  "apply": {
+    canRead: true,
+    canWrite: true,
+    canRunShell: true,
+    allowedAgents: ["code-reviewer"]
+  },
+  "archive": {
+    canRead: true,
+    canWrite: false,
+    canRunShell: false,
+    allowedAgents: []
+  }
+};
 var CommandExecutor = class {
   async execute(parseResult, ctx) {
     if (!parseResult.success || !parseResult.command) {
       return { output: chalk9__default.default.red(`\u9519\u8BEF: ${parseResult.error}`) };
     }
     const { command } = parseResult;
+    const workflowCheck = this.checkWorkflowPermission(command, ctx);
+    if (!workflowCheck.allowed) {
+      return { output: workflowCheck.message };
+    }
     switch (command.type) {
       case "slash" /* SLASH */:
         return this.executeSlashCommand(command, ctx);
@@ -5319,13 +5412,75 @@ var CommandExecutor = class {
         return { output: chalk9__default.default.red("\u672A\u77E5\u7684\u547D\u4EE4\u7C7B\u578B") };
     }
   }
+  /**
+   * 检查工作流权限
+   */
+  checkWorkflowPermission(command, ctx) {
+    const workflowEngine = ctx.workflowEngine;
+    const workflowState = workflowEngine?.getState();
+    if (!workflowState) {
+      if (command.type === "slash" /* SLASH */) {
+        const cmd = command.command?.toLowerCase();
+        if (!ALLOWED_COMMANDS_WITHOUT_WORKFLOW.includes(cmd)) {
+          return {
+            allowed: false,
+            message: chalk9__default.default.yellow("\u5F53\u524D\u6CA1\u6709\u6D3B\u8DC3\u7684\u5DE5\u4F5C\u6D41") + chalk9__default.default.gray("\n\u8BF7\u5148\u4F7F\u7528 ") + chalk9__default.default.cyan("/new <\u9700\u6C42\u63CF\u8FF0>") + chalk9__default.default.gray(" \u542F\u52A8\u65B0\u5DE5\u4F5C\u6D41")
+          };
+        }
+      }
+      if (command.type === "natural" /* NATURAL */) {
+        return {
+          allowed: false,
+          message: chalk9__default.default.yellow("\u5F53\u524D\u6CA1\u6709\u6D3B\u8DC3\u7684\u5DE5\u4F5C\u6D41") + chalk9__default.default.gray("\n\u8BF7\u5148\u4F7F\u7528 ") + chalk9__default.default.cyan("/new <\u9700\u6C42\u63CF\u8FF0>") + chalk9__default.default.gray(" \u542F\u52A8\u65B0\u5DE5\u4F5C\u6D41")
+        };
+      }
+      if (command.type === "dollar" /* DOLLAR */) {
+        return {
+          allowed: false,
+          message: chalk9__default.default.yellow("\u5F53\u524D\u6CA1\u6709\u6D3B\u8DC3\u7684\u5DE5\u4F5C\u6D41\uFF0C\u65E0\u6CD5\u8C03\u7528 Agent") + chalk9__default.default.gray("\n\u8BF7\u5148\u4F7F\u7528 ") + chalk9__default.default.cyan("/new <\u9700\u6C42\u63CF\u8FF0>") + chalk9__default.default.gray(" \u542F\u52A8\u65B0\u5DE5\u4F5C\u6D41")
+        };
+      }
+      if (command.type === "shell" /* SHELL */) {
+        return {
+          allowed: false,
+          message: chalk9__default.default.yellow("\u5F53\u524D\u6CA1\u6709\u6D3B\u8DC3\u7684\u5DE5\u4F5C\u6D41\uFF0C\u65E0\u6CD5\u6267\u884C Shell \u547D\u4EE4") + chalk9__default.default.gray("\n\u8BF7\u5148\u4F7F\u7528 ") + chalk9__default.default.cyan("/new <\u9700\u6C42\u63CF\u8FF0>") + chalk9__default.default.gray(" \u542F\u52A8\u65B0\u5DE5\u4F5C\u6D41")
+        };
+      }
+      return { allowed: true };
+    }
+    const currentStep = workflowState.currentStep;
+    const permissions = STAGE_PERMISSIONS[currentStep];
+    if (command.type === "at" /* AT */ && !permissions.canRead) {
+      return {
+        allowed: false,
+        message: chalk9__default.default.yellow(`\u5F53\u524D\u9636\u6BB5 [${currentStep}] \u4E0D\u5141\u8BB8\u8BFB\u53D6\u6587\u4EF6`)
+      };
+    }
+    if (command.type === "dollar" /* DOLLAR */) {
+      const agentId = command.agent?.toLowerCase().replace("$", "");
+      if (!permissions.allowedAgents.includes(agentId)) {
+        return {
+          allowed: false,
+          message: chalk9__default.default.yellow(`\u5F53\u524D\u9636\u6BB5 [${currentStep}] \u4E0D\u5141\u8BB8\u8C03\u7528 $${agentId} Agent`) + chalk9__default.default.gray(`
+\u5F53\u524D\u9636\u6BB5\u5141\u8BB8\u7684 Agent: ${permissions.allowedAgents.map((a) => `$${a}`).join(", ") || "\u65E0"}`)
+        };
+      }
+    }
+    if (command.type === "shell" /* SHELL */ && !permissions.canRunShell) {
+      return {
+        allowed: false,
+        message: chalk9__default.default.yellow(`\u5F53\u524D\u9636\u6BB5 [${currentStep}] \u4E0D\u5141\u8BB8\u6267\u884C Shell \u547D\u4EE4`)
+      };
+    }
+    return { allowed: true };
+  }
   async executeSlashCommand(command, ctx) {
     const result = await runSlashCommand(
       command.command,
       command.args || [],
       ctx
     );
-    return { output: result.output };
+    return { output: result.output, exit: result.exit };
   }
   async executeFileReference(command, ctx) {
     const result = await handleFileReference(command.path, ctx);
@@ -5663,11 +5818,28 @@ ${summary}`,
     return tokens.toString();
   }
 };
+var STEP_DISPLAY_NAMES = {
+  "explore": "\u63A2\u7D22",
+  "new": "\u8BBE\u8BA1",
+  "continue": "\u5F00\u53D1",
+  "propose": "\u63D0\u6848",
+  "apply": "\u5BA1\u67E5",
+  "archive": "\u5F52\u6863"
+};
+var STEP_COLORS = {
+  "explore": chalk9__default.default.magenta,
+  "new": chalk9__default.default.blue,
+  "continue": chalk9__default.default.cyan,
+  "propose": chalk9__default.default.green,
+  "apply": chalk9__default.default.yellow,
+  "archive": chalk9__default.default.gray
+};
 function displayStatus(info) {
   const dirDisplay = info.directory.length > 30 ? "..." + info.directory.slice(-27) : info.directory;
   const contextKB = Math.round(info.contextLeft / 1024);
   const contextDisplay = contextKB > 100 ? chalk9__default.default.green(`${contextKB}KB`) : contextKB > 50 ? chalk9__default.default.yellow(`${contextKB}KB`) : chalk9__default.default.red(`${contextKB}KB`);
   const servicesDisplay = info.services.length > 0 ? info.services.map((s) => `${s.name}:${s.port}`).join(", ") : chalk9__default.default.gray("\u65E0");
+  const workflowDisplay = info.workflowStep ? STEP_COLORS[info.workflowStep](`[${STEP_DISPLAY_NAMES[info.workflowStep]}]`) : chalk9__default.default.gray("[\u65E0\u5DE5\u4F5C\u6D41]");
   console.log(chalk9__default.default.gray("\u2500".repeat(60)));
   console.log(
     chalk9__default.default.cyan("\u{1F4C1}"),
@@ -5677,7 +5849,10 @@ function displayStatus(info) {
     chalk9__default.default.white(info.model),
     chalk9__default.default.cyan("\u2502"),
     chalk9__default.default.cyan("\u{1F4CA}"),
-    contextDisplay
+    contextDisplay,
+    chalk9__default.default.cyan("\u2502"),
+    chalk9__default.default.cyan("\u{1F504}"),
+    workflowDisplay
   );
   console.log(
     chalk9__default.default.cyan("\u{1F50C}"),
@@ -5901,10 +6076,17 @@ async function startInteractiveMode(options) {
   const contextManager = new ContextManager();
   const configManager = new ConfigManager();
   const modelService = new ModelService(configManager);
+  const workflowEngine = new WorkflowEngine();
+  const normsManager = new NormsManager({
+    projectPath: options.workingDirectory,
+    normsDir: path5__namespace.join(options.workingDirectory, ".sf-cli", "norms")
+  });
   await configManager.load(options.workingDirectory);
   await contextManager.initialize(options.workingDirectory);
   const statsDir = path5__namespace.join(options.workingDirectory, ".sf-cli");
   await modelService.initialize(statsDir);
+  await workflowEngine.initialize(options.workingDirectory);
+  await normsManager.initialize();
   const state = {
     isRunning: true,
     currentTask: null,
@@ -5913,12 +6095,23 @@ async function startInteractiveMode(options) {
     // 512K
   };
   const currentModel = modelService.getCurrentModel() || "GLM-5";
+  const workflowState = workflowEngine.getState();
   displayStatus({
     directory: options.workingDirectory,
     model: currentModel,
     contextLeft: state.contextLimit - state.contextUsed,
-    services: []
+    services: [],
+    workflowStep: workflowState?.currentStep
   });
+  if (workflowState) {
+    console.log(chalk9__default.default.cyan(`
+\u{1F4CB} \u6D3B\u8DC3\u5DE5\u4F5C\u6D41: ${workflowState.title}`));
+    console.log(chalk9__default.default.gray(`   \u5F53\u524D\u9636\u6BB5: ${workflowState.currentStep} | \u72B6\u6001: ${workflowState.status}`));
+    console.log(chalk9__default.default.gray(`   \u8F93\u5165 /opsx:status \u67E5\u770B\u8BE6\u60C5
+`));
+  } else {
+    console.log(chalk9__default.default.gray("\n\u{1F4A1} \u4F7F\u7528 /new <\u9700\u6C42\u63CF\u8FF0> \u542F\u52A8\u65B0\u5DE5\u4F5C\u6D41\n"));
+  }
   const saveHistory = async () => {
     try {
       await fs5__namespace.mkdir(path5__namespace.dirname(historyFile), { recursive: true });
@@ -5963,6 +6156,8 @@ async function startInteractiveMode(options) {
         contextManager,
         configManager,
         modelService,
+        normsManager,
+        workflowEngine,
         state,
         options
       });
@@ -5981,23 +6176,25 @@ async function startInteractiveMode(options) {
       console.log(chalk9__default.default.red(`\u9519\u8BEF: ${error.message}`));
     }
     const currentModel2 = modelService.getCurrentModel() || "GLM-5";
+    const workflowState2 = workflowEngine.getState();
     displayStatus({
       directory: options.workingDirectory,
       model: currentModel2,
       contextLeft: state.contextLimit - state.contextUsed,
-      services: []
+      services: [],
+      workflowStep: workflowState2?.currentStep
     });
     rl.prompt();
   }
 }
-
-// src/cli/index.ts
-var VERSION2 = "1.0.0";
+var require3 = module$1.createRequire(importMetaUrl);
+var packageJson2 = require3("../../package.json");
+var VERSION3 = packageJson2.version;
 var NAME = "sf-cli";
-commander.program.name(NAME).description("\u4E13\u4E3A\u524D\u7AEF\u5F00\u53D1\u8BBE\u8BA1\u7684AI\u9A71\u52A8CLI\u5DE5\u5177").version(VERSION2);
+commander.program.name(NAME).description("\u4E13\u4E3A\u524D\u7AEF\u5F00\u53D1\u8BBE\u8BA1\u7684AI\u9A71\u52A8CLI\u5DE5\u5177").version(VERSION3, "-v, --version", "\u663E\u793A\u7248\u672C\u53F7");
 commander.program.argument("[directory]", "\u5DE5\u4F5C\u76EE\u5F55", process.cwd()).option("-m, --model <model>", "\u6307\u5B9AAI\u6A21\u578B").option("-y, --yolo", "\u81EA\u52A8\u786E\u8BA4\u6240\u6709\u64CD\u4F5C").action(async (directory, options) => {
   console.log(chalk9__default.default.cyan.bold(`
-\u{1F680} ${NAME} v${VERSION2}`));
+\u{1F680} ${NAME} v${VERSION3}`));
   console.log(chalk9__default.default.gray("\u4E13\u4E3A\u524D\u7AEF\u5F00\u53D1\u8BBE\u8BA1\u7684AI\u9A71\u52A8CLI\u5DE5\u5177\n"));
   await startInteractiveMode({
     workingDirectory: directory,