kiro-spec-engine 1.45.13 → 1.46.0

package/CHANGELOG.md

@@ -7,6 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.46.0] - 2026-02-13
+
+### Added
+- **Spec bootstrap command**: Added `kse spec bootstrap` to generate `requirements.md`, `design.md`, and `tasks.md` drafts in one step.
+- **Spec pipeline command**: Added `kse spec pipeline run` for staged Spec workflow execution with structured progress output.
+- **Spec gate command**: Added `kse spec gate run` to standardize gate checks and produce machine-readable gate reports.
+- **Multi-spec orchestrate helper**: Added shared helper logic for parsing multi-spec targets and routing execution through orchestrate runtime.
+- **Coverage for new spec workflow**: Added unit tests for bootstrap/pipeline/gate commands and multi-spec orchestrate default behavior.
+
+### Changed
+- **Default multi-spec execution mode**: `kse spec bootstrap`, `kse spec pipeline run`, and `kse spec gate run` now default to orchestrate mode when `--specs` is provided.
+- **CLI spec command routing**: Improved `kse spec` command routing for new subcommands while preserving backward compatibility for legacy paths.
+- **Documentation alignment**: Updated EN/ZH docs to promote the new spec-first workflow and document multi-spec default orchestrate behavior.
+
 ## [1.45.13] - 2026-02-13
 
 ### Fixed

package/README.md

@@ -1,4 +1,4 @@
-# kse - Kiro Spec Engine
+# kse - Kiro Spec Engine
 
 [![npm version](https://badge.fury.io/js/kiro-spec-engine.svg)](https://badge.fury.io/js/kiro-spec-engine)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -354,6 +354,8 @@ kse orchestrate status
 kse orchestrate stop
 ```
 
+Tip: `kse spec bootstrap|pipeline run|gate run --specs ...` now defaults to this orchestrate mode automatically.
+
 **Recommended Codex-Orchestrator config (`.kiro/config/orchestrator.json`)**:
 ```json
 {
@@ -475,7 +477,15 @@ English and Chinese interfaces
 ```bash
 # Project setup
 kse adopt                          # Adopt kse in existing project
-kse create-spec <name>             # Create new Spec
+kse create-spec <name>             # Legacy: create empty Spec folder only
+
+# Spec workflow (recommended)
+kse spec bootstrap --name <spec> --non-interactive         # Generate requirements/design/tasks draft
+kse spec pipeline run --spec <spec>                         # Run staged workflow for one Spec
+kse spec gate run --spec <spec> --json                      # Run standardized Spec gate checks
+kse spec bootstrap --specs "<spec-a,spec-b>" --max-parallel <N>  # Multi-Spec defaults to orchestrate
+kse spec pipeline run --specs "<spec-a,spec-b>" --max-parallel <N> # Multi-Spec defaults to orchestrate
+kse spec gate run --specs "<spec-a,spec-b>" --max-parallel <N>     # Multi-Spec defaults to orchestrate
 
 # Context management
 kse context export <spec-name>     # Export context for AI tools
@@ -629,7 +639,7 @@ MIT License - see [LICENSE](LICENSE) file for details.
 ```bash
 npm install -g kiro-spec-engine
 kse adopt
-kse create-spec 01-00-my-first-feature
+kse spec bootstrap --name 01-00-my-first-feature --non-interactive
 ```
 
 ---
@@ -665,5 +675,6 @@ A deep conversation about AI development trends, Neo-Confucian philosophy, and s
 
 ---
 
-**Version**: 1.45.13  
+**Version**: 1.46.0  
 **Last Updated**: 2026-02-13
+

package/README.zh.md

@@ -394,7 +394,15 @@ kse orchestrate stop
 ```bash
 # 项目设置
 kse adopt                          # 在现有项目中采用 kse
-kse create-spec <name>             # 创建新 Spec
+kse create-spec <name>             # 兼容旧版：仅创建空 Spec 目录
+
+# Spec 工作流（推荐）
+kse spec bootstrap --name <spec> --non-interactive          # 生成 requirements/design/tasks 初稿
+kse spec pipeline run --spec <spec>                         # 对单个 Spec 执行分阶段流程
+kse spec gate run --spec <spec> --json                      # 执行标准化 Spec 闸口检查
+kse spec bootstrap --specs "<spec-a,spec-b>" --max-parallel <N>  # 多 Spec 默认转 orchestrate
+kse spec pipeline run --specs "<spec-a,spec-b>" --max-parallel <N> # 多 Spec 默认转 orchestrate
+kse spec gate run --specs "<spec-a,spec-b>" --max-parallel <N>     # 多 Spec 默认转 orchestrate
 
 # 上下文管理
 kse context export <spec-name>     # 为 AI 工具导出上下文
@@ -445,6 +453,8 @@ kse orchestrate run --specs "<spec列表>" --max-parallel <N>  # 启动多 Agent
 kse orchestrate status                         # 查看编排进度
 kse orchestrate stop                           # 停止所有子 Agent
 
+# 说明：当使用 --specs 调用 kse spec bootstrap/pipeline run/gate run 时，会默认转到 orchestrate 模式
+
 # DevOps 运维
 kse ops init <project-name>        # 初始化运维 specs
 kse ops validate [<project>]       # 验证运维完整性
@@ -523,10 +533,12 @@ MIT 许可证 - 详见 [LICENSE](LICENSE) 文件。
 ```bash
 npm install -g kiro-spec-engine
 kse adopt
-kse create-spec 01-00-my-first-feature
+kse spec bootstrap --name 01-00-my-first-feature --non-interactive
 ```
 
 ---
 
-**版本**：1.45.13  
+**版本**：1.46.0  
 **最后更新**：2026-02-13
+
+

package/bin/kiro-spec-engine.js

@@ -14,6 +14,9 @@ const rollbackCommand = require('../lib/commands/rollback');
 const watchCommands = require('../lib/commands/watch');
 const workflowsCommand = require('../lib/commands/workflows');
 const registerCollabCommands = require('../lib/commands/collab');
+const { registerSpecBootstrapCommand } = require('../lib/commands/spec-bootstrap');
+const { registerSpecPipelineCommand } = require('../lib/commands/spec-pipeline');
+const { registerSpecGateCommand } = require('../lib/commands/spec-gate');
 const VersionChecker = require('../lib/version/version-checker');
 
 const i18n = getI18n();
@@ -37,6 +40,76 @@ async function checkVersionBeforeCommand(options = {}) {
 
 const program = new Command();
 
+/**
+ * Normalize `kse spec ...` compatibility routes.
+ *
+ * Supported routes:
+ * - `kse spec bootstrap ...` -> `kse spec-bootstrap ...`
+ * - `kse spec pipeline ...` -> `kse spec-pipeline ...`
+ * - `kse spec gate ...` -> `kse spec-gate ...`
+ * - `kse spec create <name> ...` -> `kse create-spec <name> ...`
+ * - `kse spec <name> ...` -> `kse create-spec <name> ...` (legacy)
+ *
+ * @param {string[]} argv
+ * @returns {string[]}
+ */
+function normalizeSpecCommandArgs(argv) {
+  if (!Array.isArray(argv) || argv.length === 0) {
+    return argv;
+  }
+
+  const normalized = [...argv];
+  const commandIndex = findCommandIndex(normalized);
+  if (commandIndex < 0 || normalized[commandIndex] !== 'spec') {
+    return normalized;
+  }
+
+  const commandToken = normalized[commandIndex + 1];
+
+  if (commandToken === 'bootstrap') {
+    normalized.splice(commandIndex, 2, 'spec-bootstrap');
+    return normalized;
+  }
+
+  if (commandToken === 'pipeline') {
+    normalized.splice(commandIndex, 2, 'spec-pipeline');
+    return normalized;
+  }
+
+  if (commandToken === 'gate') {
+    normalized.splice(commandIndex, 2, 'spec-gate');
+    return normalized;
+  }
+
+  if (commandToken === 'create') {
+    normalized.splice(commandIndex, 2, 'create-spec');
+    return normalized;
+  }
+
+  normalized.splice(commandIndex, 1, 'create-spec');
+  return normalized;
+}
+
+/**
+ * Find command token index after global options.
+ * @param {string[]} args
+ * @returns {number}
+ */
+function findCommandIndex(args) {
+  for (let index = 0; index < args.length; index += 1) {
+    const token = args[index];
+    if (!token.startsWith('-')) {
+      return index;
+    }
+
+    if (token === '-l' || token === '--lang') {
+      index += 1;
+    }
+  }
+
+  return -1;
+}
+
 // 版本和基本信息
 program
   .name(t('cli.name'))
@@ -208,6 +281,15 @@ program
     }
   });
 
+// Spec bootstrap wizard command
+registerSpecBootstrapCommand(program);
+
+// Spec workflow pipeline command
+registerSpecPipelineCommand(program);
+
+// Spec gate command
+registerSpecGateCommand(program);
+
 // 系统诊断命令
 program
   .command('doctor')
@@ -687,6 +769,8 @@ async function updateProjectConfig(projectName) {
 // Run steering directory compliance check before parsing commands
 (async function() {
   const { runSteeringComplianceCheck } = require('../lib/steering');
+  const normalizedArgs = normalizeSpecCommandArgs(process.argv.slice(2));
+  process.argv = [process.argv[0], process.argv[1], ...normalizedArgs];
   
   // Check for bypass flags
   const args = process.argv.slice(2);

package/docs/adoption-guide.md

@@ -174,7 +174,7 @@ $ kse adopt
 No changes needed.
 
 💡 Next steps:
-   - Create a spec: kse create-spec 01-00-my-feature
+   - Create a spec: kse spec bootstrap --name 01-00-my-feature --non-interactive
    - Check status: kse status
 ```
 
@@ -585,7 +585,7 @@ After successful adoption:
 
 2. **Create your first spec**:
    ```bash
-   kse create-spec 01-00-my-feature
+   kse spec bootstrap --name 01-00-my-feature --non-interactive
    ```
 
 3. **Check project status**:
@@ -613,3 +613,4 @@ After successful adoption:
 ---
 
 **Happy adopting! 🔥**
+

package/docs/command-reference.md

@@ -2,7 +2,7 @@
 
 > Quick reference for all kse commands
 
-**Version**: 1.45.13  
+**Version**: 1.46.0  
 **Last Updated**: 2026-02-13
 
 ---
@@ -48,14 +48,25 @@ kse doctor
 ### Spec Management
 
 ```bash
-# Create new spec (interactive)
-kse create-spec
-
-# Create spec with name
+# Legacy low-level: create spec directory only
 kse create-spec 01-00-feature-name
 
-# List all specs
-kse list-specs
+# Bootstrap full Spec draft (requirements/design/tasks)
+kse spec bootstrap --name 01-00-feature-name --non-interactive
+
+# Run pipeline for one Spec
+kse spec pipeline run --spec 01-00-feature-name
+
+# Run gate for one Spec
+kse spec gate run --spec 01-00-feature-name --json
+
+# Multi-Spec mode defaults to orchestrate routing
+kse spec bootstrap --specs "spec-a,spec-b" --max-parallel 3
+kse spec pipeline run --specs "spec-a,spec-b" --max-parallel 3
+kse spec gate run --specs "spec-a,spec-b" --max-parallel 3
+
+# Show Spec progress
+kse status --verbose
 ```
 
 ### Task Management
@@ -211,6 +222,8 @@ kse orchestrate status [--json]
 kse orchestrate stop
 ```
 
+When you pass `--specs` to `kse spec bootstrap|pipeline run|gate run`, kse now defaults to this orchestrate mode automatically.
+
 Recommended `.kiro/config/orchestrator.json`:
 
 ```json
@@ -343,15 +356,18 @@ kse --version
 ### Starting a New Feature
 
 ```bash
-# 1. Create spec
-kse create-spec 01-00-my-feature
+# 1. Bootstrap spec draft
+kse spec bootstrap --name 01-00-my-feature --non-interactive
+
+# 2. Run spec pipeline
+kse spec pipeline run --spec 01-00-my-feature
 
-# 2. Export context
+# 3. Export context
 kse context export 01-00-my-feature
 
-# 3. Work on tasks...
+# 4. Work on tasks...
 
-# 4. Sync progress
+# 5. Sync progress
 kse workspace sync
 ```
 
@@ -662,3 +678,5 @@ Overall Health: 2 healthy, 1 unhealthy
 - Run `kse --help` for command reference
 - Check [GitHub Issues](https://github.com/heguangyong/kiro-spec-engine/issues)
 - Review [Documentation](../README.md)
+
+

package/docs/cross-tool-guide.md

@@ -75,7 +75,7 @@ kse adopt
 
 2. **Create spec**:
    ```bash
-   kse create-spec 01-00-user-authentication
+   kse spec bootstrap --name 01-00-user-authentication --non-interactive
    ```
 
 3. **Work with AI**:
@@ -552,3 +552,4 @@ For other tools: Manual coordination required
 
 **Version History**:
 - v1.0 (2026-01-23): Initial cross-tool guide
+

package/docs/document-governance.md

@@ -632,7 +632,7 @@ kse docs archive --spec your-spec
 **When creating a Spec:**
 ```bash
 # 1. Create Spec
-kse create-spec 01-00-new-feature
+kse spec bootstrap --name 01-00-new-feature --non-interactive
 
 # 2. Verify structure
 kse docs validate --spec 01-00-new-feature
@@ -862,3 +862,4 @@ kse docs diagnose
 
 **Version**: 1.42.0  
 **Last Updated**: 2026-01-24
+

package/docs/faq.md

@@ -143,7 +143,7 @@ See [Integration Modes Guide](integration-modes.md) for details.
 
 1. **Create Spec:**
 ```bash
-kse create-spec 01-00-user-login
+kse spec bootstrap --name 01-00-user-login --non-interactive
 # Edit requirements.md, design.md, tasks.md
 ```
 
@@ -356,7 +356,7 @@ Progress: 1/2 tasks complete (50%)
 **Yes!** Create a Spec for the bug:
 
 ```bash
-kse create-spec 01-01-fix-login-timeout
+kse spec bootstrap --name 01-01-fix-login-timeout --non-interactive
 ```
 
 **requirements.md:**
@@ -398,7 +398,7 @@ JWT token expiration set to 300 seconds instead of 1800 seconds
 **Absolutely!** Specs are great for refactoring:
 
 ```bash
-kse create-spec 02-00-refactor-auth-module
+kse spec bootstrap --name 02-00-refactor-auth-module --non-interactive
 ```
 
 **requirements.md:**
@@ -477,12 +477,12 @@ vim .kiro/templates/tasks.md
 # Project 1
 cd ~/projects/project1
 kse adopt
-kse create-spec 01-00-feature-a
+kse spec bootstrap --name 01-00-feature-a --non-interactive
 
 # Project 2
 cd ~/projects/project2
 kse adopt
-kse create-spec 01-00-feature-b
+kse spec bootstrap --name 01-00-feature-b --non-interactive
 ```
 
 **Each project has:**
@@ -526,13 +526,13 @@ kse context export 01-00-user-login
 
 ```bash
 # Main feature
-kse create-spec 01-00-user-management
+kse spec bootstrap --name 01-00-user-management --non-interactive
 
 # Sub-features
-kse create-spec 01-01-user-registration
-kse create-spec 01-02-user-login
-kse create-spec 01-03-user-profile
-kse create-spec 01-04-password-reset
+kse spec bootstrap --name 01-01-user-registration --non-interactive
+kse spec bootstrap --name 01-02-user-login --non-interactive
+kse spec bootstrap --name 01-03-user-profile --non-interactive
+kse spec bootstrap --name 01-04-password-reset --non-interactive
 ```
 
 **Or use phases in tasks.md:**
@@ -558,17 +558,17 @@ kse create-spec 01-04-password-reset
 
 **Documentation project:**
 ```bash
-kse create-spec 01-00-api-documentation
+kse spec bootstrap --name 01-00-api-documentation --non-interactive
 ```
 
 **Design project:**
 ```bash
-kse create-spec 02-00-ui-redesign
+kse spec bootstrap --name 02-00-ui-redesign --non-interactive
 ```
 
 **Process improvement:**
 ```bash
-kse create-spec 03-00-ci-cd-pipeline
+kse spec bootstrap --name 03-00-ci-cd-pipeline --non-interactive
 ```
 
 **Specs provide structure for any project** with requirements, design, and tasks.
@@ -694,3 +694,4 @@ kse create-spec 03-00-ci-cd-pipeline
 
 **Version**: 1.42.0  
 **Last Updated**: 2026-02-11
+

package/docs/manual-workflows-guide.md

@@ -351,7 +351,7 @@ done
 
 ### Spec Creation Checklist
 
-- [ ] Create spec: `kse create-spec <name>`
+- [ ] Create spec: `kse spec bootstrap --name <name> --non-interactive`
 - [ ] Write requirements.md
 - [ ] Write design.md
 - [ ] Generate tasks.md
@@ -415,3 +415,4 @@ done
 **Version:** 1.0  
 **Last Updated:** 2026-01-23  
 **Spec:** 05-00-agent-hooks-and-automation
+

package/docs/quick-start-with-ai-tools.md

@@ -95,7 +95,7 @@ kse adopt
 ### 步骤 3：创建你的第一个 Spec
 
 ```bash
-kse create-spec 01-00-user-login
+kse spec bootstrap --name 01-00-user-login --non-interactive
 ```
 
 然后编辑生成的文件：
@@ -157,7 +157,7 @@ kse context export 01-00-user-login
 ### 1. 创建 Spec
 
 ```bash
-kse create-spec 01-00-user-login
+kse spec bootstrap --name 01-00-user-login --non-interactive
 ```
 
 ### 2. 编写需求（requirements.md）
@@ -370,5 +370,6 @@ kse context export 01-00-user-login
 ```bash
 npm install -g kiro-spec-engine
 kse adopt
-kse create-spec 01-00-my-feature
+kse spec bootstrap --name 01-00-my-feature --non-interactive
 ```
+

package/docs/quick-start.md

@@ -63,11 +63,24 @@ I need a user login feature with email and password.
 ```
 
 **Your AI will:**
-1. Suggest creating a Spec first
-2. Help you define requirements
-3. Design the solution
-4. Break down into tasks
-5. Implement according to the Spec
+1. Bootstrap a Spec draft (`requirements/design/tasks`)
+2. Refine requirements and design with you
+3. Run the staged Spec workflow
+4. Implement according to the Spec
+
+**If you want to run commands manually:**
+
+```bash
+# Single-Spec recommended flow
+kse spec bootstrap --name 01-00-user-login --non-interactive
+kse spec pipeline run --spec 01-00-user-login
+kse spec gate run --spec 01-00-user-login --json
+
+# Multi-Spec flow (defaults to orchestrate mode)
+kse spec bootstrap --specs "01-00-user-login,01-01-user-session" --max-parallel 3
+kse spec pipeline run --specs "01-00-user-login,01-01-user-session" --max-parallel 3
+kse spec gate run --specs "01-00-user-login,01-01-user-session" --max-parallel 3
+```
 
 **The AI uses kse commands automatically** - you don't need to learn them.
 
@@ -89,5 +102,6 @@ You're now using Spec-driven development. Your AI understands the methodology an
 
 ---
 
-**Version**: 1.42.0  
-**Last Updated**: 2026-02-11
+**Version**: 1.46.0  
+**Last Updated**: 2026-02-13
+

package/docs/spec-workflow.md

@@ -251,7 +251,7 @@ Response: { ... }
 
 **1. Create the Spec:**
 ```bash
-kse create-spec 01-00-user-login
+kse spec bootstrap --name 01-00-user-login --non-interactive
 ```
 
 **2. Write Requirements** (`.kiro/specs/01-00-user-login/requirements.md`):
@@ -509,10 +509,11 @@ The Spec workflow is:
 
 **Start your next Spec:** 🚀
 ```bash
-kse create-spec 02-00-your-feature
+kse spec bootstrap --name 02-00-your-feature --non-interactive
 ```
 
 ---
 
 **Version**: 1.42.0  
 **Last Updated**: 2026-02-11
+

package/docs/tools/claude-guide.md

@@ -136,7 +136,7 @@ Please implement this task following the design document.
 
 **1. Create and prepare Spec**
 ```bash
-kse create-spec 01-00-user-login
+kse spec bootstrap --name 01-00-user-login --non-interactive
 # Edit requirements.md, design.md, tasks.md
 kse-clip 01-00-user-login
 ```
@@ -642,7 +642,7 @@ kse context export 01-00-user-login
 **Start using kse with Claude:** 🚀
 ```bash
 kse adopt
-kse create-spec 01-00-my-feature
+kse spec bootstrap --name 01-00-my-feature --non-interactive
 kse-clip 01-00-my-feature
 # Open Claude and paste context
 ```
@@ -651,3 +651,4 @@ kse-clip 01-00-my-feature
 
 **Version**: 1.42.0  
 **Last Updated**: 2026-02-11
+

package/docs/tools/cursor-guide.md

@@ -213,7 +213,7 @@ class AuthController {
 
 **1. Create and write Spec**
 ```bash
-kse create-spec 01-00-user-login
+kse spec bootstrap --name 01-00-user-login --non-interactive
 # Edit requirements.md, design.md, tasks.md
 ```
 
@@ -694,7 +694,7 @@ Please help debug and fix the issue.
 **Start using kse with Cursor:** 🚀
 ```bash
 kse adopt
-kse create-spec 01-00-my-feature
+kse spec bootstrap --name 01-00-my-feature --non-interactive
 kse context export 01-00-my-feature
 # Open Cursor Composer (Cmd+K) and paste context
 ```
@@ -703,3 +703,4 @@ kse context export 01-00-my-feature
 
 **Version**: 1.42.0  
 **Last Updated**: 2026-02-11
+

package/docs/tools/generic-guide.md

@@ -68,7 +68,7 @@ kse exports plain text that any AI can understand.
 ### Step 1: Create Your Spec
 
 ```bash
-kse create-spec 01-00-user-login
+kse spec bootstrap --name 01-00-user-login --non-interactive
 # Edit requirements.md, design.md, tasks.md
 ```
 
@@ -434,7 +434,7 @@ If you're building an AI coding tool, consider:
 **Start using:** 🚀
 ```bash
 kse adopt
-kse create-spec 01-00-my-feature
+kse spec bootstrap --name 01-00-my-feature --non-interactive
 kse context export 01-00-my-feature
 # Provide context to your AI tool
 ```
@@ -443,3 +443,4 @@ kse context export 01-00-my-feature
 
 **Version**: 1.42.0  
 **Last Updated**: 2026-02-11
+

package/docs/tools/vscode-guide.md

@@ -174,7 +174,7 @@ Please help me implement the AuthController.
 
 **1. Create Spec**
 ```bash
-kse create-spec 01-00-user-login
+kse spec bootstrap --name 01-00-user-login --non-interactive
 # Edit requirements.md, design.md, tasks.md
 ```
 
@@ -434,7 +434,7 @@ Copilot considers all referenced files.
 **Start using:** 🚀
 ```bash
 kse adopt
-kse create-spec 01-00-my-feature
+kse spec bootstrap --name 01-00-my-feature --non-interactive
 # Open VS Code and start coding with Spec references
 ```
 
@@ -442,3 +442,4 @@ kse create-spec 01-00-my-feature
 
 **Version**: 1.42.0  
 **Last Updated**: 2026-02-11
+

package/docs/tools/windsurf-guide.md

@@ -202,7 +202,7 @@ kse watch start
 
 **1. Create Spec**
 ```bash
-kse create-spec 01-00-user-login
+kse spec bootstrap --name 01-00-user-login --non-interactive
 # Edit requirements.md, design.md, tasks.md
 ```
 
@@ -380,7 +380,7 @@ to:
 **Start using:** 🚀
 ```bash
 kse adopt
-kse create-spec 01-00-my-feature
+kse spec bootstrap --name 01-00-my-feature --non-interactive
 # Tell Windsurf: "Use kse to implement 01-00-my-feature"
 ```
 
@@ -388,3 +388,4 @@ kse create-spec 01-00-my-feature
 
 **Version**: 1.42.0  
 **Last Updated**: 2026-02-11
+