speccore 5.15.0 → 5.18.0

package/README.en.md

@@ -8,7 +8,7 @@
 
 SpecCore is a specification-driven development framework for AI-native teams. It decouples deterministic operations (file creation, directory management, format validation, status statistics) from AI, executing them directly through code to improve efficiency and reduce Token consumption.
 
-> 💡 **v5.6.3** | 49 Commands | 35 Intent Types | Multi-Platform
+> 💡 **v5.18.0** | 68 Commands | 38 Intent Types | Multi-Platform
 
 ---
 
@@ -21,7 +21,7 @@ SpecCore has two distinct parts:
 | **Where** | Terminal | AI coding tools (WorkBuddy / Cursor / Claude) |
 | **How** | `speccore init` | Type `/spec-xxx` |
 | **Mechanism** | TypeScript, direct file ops | Markdown prompts, AI reads & executes |
-| **Count** | 39 CLI commands | 39 Slash Commands |
+| **Count** | 68 CLI commands | 54 Slash Commands |
 | **When** | Init, validation, batch ops | Daily dev: iteration, execution, review, archive |
 
 > 💡 **Remember**: `speccore` prefix → Terminal; `/spec` prefix → AI tool.
@@ -64,7 +64,7 @@ speccore spec "How's the progress?"
 
 - **🚀 Quick Init**: One command initializes the full project structure, auto-integrates WorkBuddy
 - **📱 Multi-Platform**: `--platforms=web,h5,miniapp` per-platform Task management, dynamic platform types
-- **🧠 Intent Recognition**: 35 intent types, 200+ keywords, natural language → command matching
+- **🧠 Intent Recognition**: 38 intent types, 200+ keywords, natural language → command matching
 - **🌐 Global Layer**: Cross-project requirement indexing via GLOBAL/ architecture
 - **📊 Progress Tracking**: Auto-detect active iteration, per-platform/per-assignee stats
 - **✅ Auto Compliance**: Scan all Spec files, check required fields and format
@@ -105,7 +105,7 @@ User Input (Natural Language / Slash Command)
 
 ---
 
-## 🔧 CLI Commands Quick Reference (39 total)
+## 🔧 CLI Commands Quick Reference (68 total)
 
 > Run in terminal. All commands start with `speccore`.
 
@@ -141,7 +141,7 @@ User Input (Natural Language / Slash Command)
 | `speccore audit` | `/spec-ai-audit` | AI smart audit |
 | `speccore spec "query"` | `/spec query` | Natural language intent |
 
-> 📋 Full command reference: [Command Reference](docs/commands.en.md) | 🧠 Intent mapping: [Intent Map](docs/commands.en.md#natural-language-intent-mapping-35-types)
+> 📋 Full command reference: [Command Reference](docs/commands.en.md) | 🧠 Intent mapping: [Intent Map](docs/commands.en.md#natural-language-intent-mapping-38-types)
 
 ---
 
@@ -179,12 +179,12 @@ SpecCore natively integrates WorkBuddy.
 | [SDD Methodology](docs/sdd-methodology.en.md) | What is SDD, why, how |
 | [Quick Reference](docs/quick-reference.en.md) | One-page: commands + safety + CI |
 | [Quick Start](docs/quick-start.en.md) | Install → Init → Import → Multi-platform → Scenarios |
-| [Command Reference](docs/commands.en.md) | 49 commands full params + 35 intents |
+| [Command Reference](docs/commands.en.md) | 68 commands full params + 38 intents |
 | [Tool Adaptation](docs/tool-adaptation.en.md) | WorkBuddy integration + workflow + security |
 | [Usage Guide](docs/usage-guide.en.md) | File safety: manual edit vs CLI command |
 | [Workspace Layout](docs/workspace-organization.en.md) | Recommended directory structure |
 | [Migration Guide](docs/migration-guide.en.md) | Shell v3.x → CLI v5.x |
-| [CHANGELOG](CHANGELOG.en.md) | Version history (v1.0.0 → v5.6.1) |
+| [CHANGELOG](CHANGELOG.en.md) | Version history (v1.0.0 → v5.18.0) |
 | [Example](examples/task-management/README.md) | Full demo: req→Spec→generated code |
 | [README.md](README.md) | 中文项目概述 |
 
@@ -231,7 +231,7 @@ bash verify.sh          # Run tests
 
 ## Version
 
-v5.6.3 | 🔧 CLI Commands: 49 | 🧠 Intents: 35
+v5.18.0 | 🔧 CLI Commands: 68 | 🧠 Intents: 38
 
 Changelog: [CHANGELOG.en.md](CHANGELOG.en.md)
 

package/README.md

@@ -19,7 +19,7 @@ SpecCore 由两部分组成，**职责明确，互不混淆**：
 | **在哪里执行** | 终端 / Terminal | AI 编程工具（WorkBuddy / Cursor / Claude 等） |
 | **怎么用** | `speccore init` | 输入 `/spec-xxx` |
 | **什么原理** | TypeScript 编译，直接操作文件 | Markdown 指令，AI 读取后执行 |
-| **数量** | 54 个 CLI 命令 | 54 个 Slash Command |
+| **数量** | 68 个 CLI 命令 | 54 个 Slash Command |
 | **何时用** | 项目初始化、文件校验、批量操作 | 日常开发：需求管理、开发执行、审查归档 |
 
 > 💡 **简单记忆**：`speccore` 开头 → 终端执行；`/spec` 开头 → AI 工具中执行。
@@ -62,7 +62,7 @@ speccore spec "进度怎么样了"
 
 - **🚀 快速初始化**：一行命令初始化完整 SpecCore 项目结构，自动集成 WorkBuddy
 - **📱 多平台支持**：`--platforms=web,h5,miniapp` 按端管理 Task，动态添加平台类型
-- **🧠 意图识别引擎**：36 种意图类型，200+ 关键词，自然语言自动匹配命令
+- **🧠 意图识别引擎**：38 种意图类型，200+ 关键词，自然语言自动匹配命令
 - **🌐 多项目全量层**：GLOBAL/ 统一管理跨项目需求索引、架构和技术栈
 - **📊 实时进度追踪**：自动识别活跃期次，统计任务完成率，按平台/人员/类型统计
 - **✅ 自动合规检查**：扫描所有 Spec 文件，检查必填项和格式
@@ -104,7 +104,7 @@ SpecCore 采用**确定性逻辑与智能逻辑解耦**的架构：
 
 ---
 
-## 🔧 终端命令速查（54 个 CLI 命令）
+## 🔧 终端命令速查（68 个 CLI 命令）
 
 > 在终端中执行，所有命令以 `speccore` 开头。
 
@@ -126,7 +126,7 @@ SpecCore 采用**确定性逻辑与智能逻辑解耦**的架构：
 
 ## 🤖 AI 命令（Slash Command）对应关系
 
-> 在 AI 工具（WorkBuddy / Cursor / Claude Code 等）中输入 `/` + 命令。AI 命令在底层调用对应的 CLI 命令执行。54 个 CLI 命令都有对应的 `/spec-*` 形式。
+> 在 AI 工具（WorkBuddy / Cursor / Claude Code 等）中输入 `/` + 命令。AI 命令在底层调用对应的 CLI 命令执行。68 个 CLI 命令都有对应的 `/spec-*` 形式。
 
 | CLI 终端命令 | AI Slash Command | 用途 |
 | :--- | :--- | :--- |
@@ -146,7 +146,7 @@ SpecCore 采用**确定性逻辑与智能逻辑解耦**的架构：
 | `speccore audit` | `/spec-ai-audit` | AI 智能审计 |
 | `speccore spec "查询"` | `/spec 查询` | 自然语言智能入口 |
 
-> 📋 完整命令参数见 [命令参考手册](docs/命令参考.md) | 🧠 36 种意图映射见 [意图映射表](docs/命令参考.md#自然语言意图映射36-种)
+> 📋 完整命令参数见 [命令参考手册](docs/命令参考.md) | 🧠 38 种意图映射见 [意图映射表](docs/命令参考.md#自然语言意图映射36-种)
 
 ---
 
@@ -180,19 +180,18 @@ SpecCore 原生集成 WorkBuddy（`speccore init` 自动创建 `.workbuddy/` ski
 
 | 文档 | 内容 |
 | :--- | :--- |
-| [场景实战](docs/场景实战.md) | 25 个真实场景：从零启动→日常开发→CI/CD→变更处理等 |
+| 📊 [**总览**](docs/总览.md) | **命令地图 + 工作流全景 + 理念图解 + 8框架横评** |
+| [快速开始指南](docs/快速开始.md) | 安装 → 7 步核心流程 → 命令速查 |
+| [场景实战](docs/场景实战.md) | 37 个真实场景：从零启动→PR→回滚→选型 |
+| [命令参考手册](docs/命令参考.md) | 全部命令完整参数 |
 | [SDD 方法论](docs/SDD方法论.md) | SDD 是什么、为什么、怎么做 |
-| [速查卡](docs/速查卡.md) | 一页掌握：常用命令 + 安全口诀 + CI 模板 |
-| [快速开始指南](docs/快速开始.md) | 安装 → 初始化 → 导入 → 多端 Task → 场景速查 |
-| [命令参考手册](docs/命令参考.md) | 54 个命令完整参数 + 36 种意图映射 |
-| [工具适配说明](docs/工具适配说明.md) | WorkBuddy 集成原理 + 工作流程 + 安全检查 |
-| [使用指南](docs/使用指南.md) | 完整使用方式：💬 自然语言对话 + ⌨️ CLI 命令对照 |
+| [工具适配说明](docs/工具适配说明.md) | WorkBuddy 集成原理 + 安全检查 |
 | [工作空间组织](docs/工作空间组织.md) | 推荐目录结构 + 多工程协作 |
-| [迁移指南](docs/migration-guide.md) | Shell v3.x → CLI v5.x 迁移步骤 |
-| [CI/CD 集成](docs/CI-CD与spec注释集成指南.md) | @spec 注释 + GitHub Actions + 工作流 |
-| [Spec 加载机制](docs/Spec三层加载机制.md) | 三层 Spec 协同：全局约束 → 期次上下文 → Task 执行 |
+| [迁移指南](docs/migration-guide.md) | Shell v3.x → CLI v5.x 迁移 |
+| [CI/CD 集成](docs/CI-CD与spec注释集成指南.md) | @spec 注释 + GitHub Actions |
+| [Spec 加载机制](docs/Spec三层加载机制.md) | 三层 Spec 协同 |
 | [示例项目](examples/task-management/README.md) | 完整演示：需求→Spec→生成代码 |
-| [CHANGELOG](CHANGELOG.md) | 版本历史与更新日志（v1.0.0 → v5.11.0） |
+| [CHANGELOG](CHANGELOG.md) | 版本历史（v1.0.0 → v5.18.0） |
 | [README.en.md](README.en.md) | English project overview |
 
 ---
@@ -247,7 +246,7 @@ SpecCore 不禁止手动编辑文件，但不同文件的安全级别不同。
 | `GLOBAL/REQUIREMENT.md` | 改完立即 `speccore sync-global` |
 | `CHANGELOG.md` | 建议用 `speccore change` 自动追加 |
 
-> 📚 完整指南见 [使用指南](docs/使用指南.md)
+
 
 ---
 
@@ -275,7 +274,7 @@ bash verify.sh
 
 ## 版本
 
-v5.11.0 | 🔧 CLI 命令 54 个 | 🧠 意图识别 36 种
+v5.18.0 | 🔧 CLI 命令 68 个 | 🧠 意图识别 38 种
 
 版本历史见 [CHANGELOG.md](CHANGELOG.md)
 

package/dist/cli.js

@@ -1,4 +1,37 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
 const package_json_1 = require("../package.json");
@@ -20,7 +53,7 @@ const execute_1 = require("./commands/execute");
 const spec_1 = require("./commands/spec");
 const goal_1 = require("./commands/goal");
 const bugfix_1 = require("./commands/bugfix");
-const research_1 = require("./commands/research");
+const new_task_1 = require("./commands/new-task");
 const change_1 = require("./commands/change");
 const sync_1 = require("./commands/sync");
 const pattern_1 = require("./commands/pattern");
@@ -29,6 +62,8 @@ const handover_1 = require("./commands/handover");
 const retro_1 = require("./commands/retro");
 const template_add_1 = require("./commands/template-add");
 const help_1 = require("./commands/help");
+const dev_1 = require("./commands/dev");
+const status_panel_1 = require("./commands/status-panel");
 const demo_1 = require("./commands/demo");
 const welcome_1 = require("./commands/welcome");
 const word2spec_1 = require("./commands/word2spec");
@@ -44,27 +79,30 @@ const dashboard_1 = require("./commands/dashboard");
 const audit_1 = require("./commands/audit");
 const analyze_1 = require("./commands/analyze");
 const lifecycle_1 = require("./commands/lifecycle");
+const pr_1 = require("./commands/pr");
+const constitution_builder_1 = require("./core/constitution-builder");
+const context_output_1 = require("./commands/context-output");
 const done_1 = require("./commands/done");
 // rename 命令
 const rename_1 = require("./commands/rename");
 // v4.0.0 新增命令
-const new_task_1 = require("./commands/new-task");
 const platform_add_1 = require("./commands/platform-add");
 const index_update_1 = require("./commands/index-update");
-const context_1 = require("./commands/context");
 // v4.6.0 迁移命令
 const migrate_1 = require("./commands/migrate");
 // v4.7.0 体验增强
 const completion_1 = require("./commands/completion");
 const backup_1 = require("./commands/backup");
 // v4.8.0 高级功能
-const hooks_1 = require("./commands/hooks");
 const current_1 = require("./commands/current");
 // v4.9.0 完善
 const update_1 = require("./commands/update");
 // v5.3.0 新增
 const diff_1 = require("./commands/diff");
 const trace_1 = require("./commands/trace");
+const merge_check_1 = require("./commands/merge-check");
+const history_2 = require("./commands/history");
+const tracker_1 = require("./commands/tracker");
 // v5.5.0 新增
 const delete_1 = require("./commands/delete");
 // v5.6.0 新增
@@ -98,6 +136,54 @@ commander_1.program
     .description('First-time setup guide (interactive)')
     .option('--force', 'Force re-initialization')
     .action(welcome_1.welcomeCommand);
+commander_1.program
+    .command('status-panel')
+    .alias('sp')
+    .description('IDE-style status panel: phase + tasks + progress + next action')
+    .action(status_panel_1.statusPanelCommand);
+commander_1.program
+    .command('open')
+    .alias('opn')
+    .description('Open task files in editor')
+    .option('-t, --task <task>', 'Task to open')
+    .option('-i, --iteration <iteration>', 'Target iteration')
+    .action(async (options) => {
+    const { getDefaultIteration } = await Promise.resolve().then(() => __importStar(require('./core/context')));
+    const it = await getDefaultIteration(options.iteration);
+    if (!it)
+        return;
+    const fs = require('fs');
+    const iterDir = `期次-${it}`;
+    const entries = fs.readdirSync(iterDir, { withFileTypes: true });
+    const task = entries.find((e) => e.isDirectory() && e.name.startsWith(options.task || ''));
+    if (task) {
+        const { logger } = require('./utils/logger');
+        logger.info(`\n📂 ${task.name}:`);
+        const files = ['REQ.md', 'TECH.md', 'TASK.md', 'TEST.md', 'API_CONTRACT.yaml'];
+        for (const f of files) {
+            const path = require('path').join(iterDir, task.name, f.startsWith('API') ? '_shared' : 'backend', f);
+            if (fs.existsSync(path))
+                logger.info(`  ${path}`);
+        }
+    }
+});
+commander_1.program;
+commander_1.program
+    .command('dev')
+    .alias('d')
+    .description('Smart dev entry: auto-detect phase and suggest next step')
+    .option('-i, --iteration <iteration>', 'Target iteration')
+    .option('--force', 'Auto-execute the next step')
+    .action(dev_1.devCommand);
+commander_1.program;
+commander_1.program;
+commander_1.program
+    .command('dev')
+    .alias('d')
+    .description('Smart dev entry: auto-detect phase and suggest next step')
+    .option('-i, --iteration <iteration>', 'Target iteration')
+    .option('--force', 'Auto-execute the next step')
+    .action(dev_1.devCommand);
 commander_1.program
     .command('demo')
     .alias('dm')
@@ -214,16 +300,30 @@ commander_1.program
     .command('research')
     .alias('rs')
     .description('Technical research: evaluate solutions and compare options')
-    .option('-n, --name <name>', 'Research topic')
-    .option('-d, --desc <desc>', 'Research description')
-    .option('-t, --topic <topic>', 'Research topic (alias for --name)')
-    .option('--options <options>', 'Comparison options (comma-separated)')
-    .option('--task-id <id>', 'Task ID')
-    .option('-i, --iteration <iteration>', 'Target iteration')
-    .action(research_1.researchCommand);
+    .option('-n, --name <name>', 'Research topic');
 // ================================================================
 // ⚡ 执行与调度
 // ================================================================
+commander_1.program
+    .command('pr')
+    .alias('mr')
+    .description('Create Pull Request with task summary')
+    .option('-t, --task <task>', 'Target task (auto-detect from branch if omitted)')
+    .option('-i, --iteration <iteration>', 'Target iteration')
+    .option('--base <branch>', 'Base branch', 'main')
+    .option('--draft', 'Create as draft PR')
+    .option('--title <title>', 'Custom PR title')
+    .action(pr_1.prCommand);
+commander_1.program
+    .command('pr')
+    .alias('mr')
+    .description('Create Pull Request with task summary')
+    .option('-t, --task <task>', 'Target task (auto-detect from branch if omitted)')
+    .option('-i, --iteration <iteration>', 'Target iteration')
+    .option('--base <branch>', 'Base branch', 'main')
+    .option('--draft', 'Create as draft PR')
+    .option('--title <title>', 'Custom PR title')
+    .action(pr_1.prCommand);
 commander_1.program
     .command('plan')
     .alias('pl')
@@ -260,6 +360,9 @@ commander_1.program
     .option('--force', 'Skip preview and execute directly')
     .option('--strict', 'Pre-flight check: review req/tech/test before code gen')
     .option('--base <branch>', 'Base branch for task branching (default: current)')
+    .option('--skip <tasks>', 'Comma-separated task IDs to skip')
+    .option('--only <tasks>', 'Comma-separated task IDs to execute exclusively (whitelist)')
+    .option('--agent <tool>', 'External AI: copilot/claude/cursor/trae/qoder/windsurf/codebuddy')
     .option('--hotfix', 'Emergency fix: skip reverse sync (30min grace, 24h mandatory)')
     .action(execute_1.executeCommand);
 // ================================================================
@@ -368,6 +471,44 @@ commander_1.program
 // ================================================================
 // ⚙️ 配置与工具
 // ================================================================
+commander_1.program
+    .command('context')
+    .alias('ctx')
+    .description('Output task context for any AI tool (Copilot/Claude/GPT)')
+    .option('-t, --task <task>', 'Target task')
+    .option('-i, --iteration <iteration>', 'Target iteration')
+    .action(context_output_1.contextCommand);
+commander_1.program
+    .command('context')
+    .alias('ctx')
+    .description('Output task context for any AI tool (Copilot/Claude/GPT)')
+    .option('-t, --task <task>', 'Target task')
+    .option('-i, --iteration <iteration>', 'Target iteration')
+    .action(context_output_1.contextCommand);
+commander_1.program
+    .command('constitution')
+    .alias('cn')
+    .description('Auto-detect tech stack and generate CONSTITUTION.md rules')
+    .action(async () => { await (0, constitution_builder_1.buildConstitution)(process.cwd()); });
+commander_1.program
+    .command('context')
+    .alias('ctx')
+    .description('Output task context for any AI tool (Copilot/Claude/GPT)')
+    .option('-t, --task <task>', 'Target task')
+    .option('-i, --iteration <iteration>', 'Target iteration')
+    .action(context_output_1.contextCommand);
+commander_1.program
+    .command('context')
+    .alias('ctx')
+    .description('Output task context for any AI tool (Copilot/Claude/GPT)')
+    .option('-t, --task <task>', 'Target task')
+    .option('-i, --iteration <iteration>', 'Target iteration')
+    .action(context_output_1.contextCommand);
+commander_1.program
+    .command('constitution')
+    .alias('cn')
+    .description('Auto-detect tech stack and generate CONSTITUTION.md rules')
+    .action(async () => { await (0, constitution_builder_1.buildConstitution)(process.cwd()); });
 commander_1.program
     .command('config')
     .alias('cf')
@@ -471,6 +612,11 @@ commander_1.program
     .description('View global layer status: all projects, requirements, architecture')
     .option('--project <name>', 'Filter by project name')
     .action(global_status_1.globalStatusCommand);
+commander_1.program
+    .command('ops')
+    .alias('op')
+    .description('View operation history (command log)')
+    .action(history_2.opsCommand);
 commander_1.program
     .command('history')
     .alias('hs')
@@ -569,7 +715,7 @@ commander_1.program
     .description('View task context loading status and dependency chain (v4.0)')
     .option('--req <req>')
     .option('--task <task>', 'Target task (default: current task)')
-    .action(context_1.contextCommand);
+    .action(context_output_1.contextCommand);
 // ================================================================
 // 快捷别名（顶层别名）
 // ================================================================
@@ -606,6 +752,8 @@ commander_1.program
     .action(done_1.doneCommand);
 commander_1.program
     .command('completion [shell]')
+    .alias('cmp')
+    .alias('cmp')
     .description('Generate shell completion script (bash/zsh)')
     .action(completion_1.completionCommand);
 commander_1.program
@@ -618,8 +766,7 @@ commander_1.program
 // v4.8.0 高级功能
 commander_1.program
     .command('hooks')
-    .description('Install Git hooks (pre-commit + pre-push)')
-    .action(hooks_1.hooksCommand);
+    .description('Install Git hooks (pre-commit + pre-push)');
 commander_1.program
     .command('current')
     .alias('cr')
@@ -648,6 +795,61 @@ commander_1.program
     .requiredOption('--source <name>', 'Source iteration/baseline')
     .requiredOption('--target <name>', 'Target iteration/baseline')
     .action(diff_1.diffCommand);
+commander_1.program
+    .command('tracker')
+    .alias('tr')
+    .description('View global requirement change tracker')
+    .action(tracker_1.trackerCommand);
+commander_1.program
+    .command('merge-check')
+    .alias('mc')
+    .description('Predict merge conflicts across task branches')
+    .option('-i, --iteration <iteration>', 'Target iteration')
+    .action(async (options) => { const { getDefaultIteration } = await Promise.resolve().then(() => __importStar(require('./core/context'))); const it = await getDefaultIteration(options.iteration); if (it)
+    await (0, merge_check_1.mergeCheck)(it); });
+commander_1.program
+    .command('rollback')
+    .alias('rb')
+    .description('Rollback a task: revert branch + archive spec')
+    .option('-t, --task <task>', 'Task to rollback')
+    .option('-i, --iteration <iteration>', 'Target iteration')
+    .option('--reason <reason>', 'Rollback reason')
+    .action(async (options) => { const it = await require('../core/context').getDefaultIteration(options.iteration); if (it && options.task)
+    await (0, merge_check_1.rollbackTask)(options.task, it, options.reason); });
+commander_1.program
+    .command('arch-update')
+    .alias('au')
+    .description('Auto-update ARCHITECTURE.md with new APIs/tables')
+    .option('-i, --iteration <iteration>', 'Source iteration')
+    .option('--apis <apis>', 'Comma-separated API paths')
+    .option('--tables <tables>', 'Comma-separated table names')
+    .action(async (options) => { const it = await require('../core/context').getDefaultIteration(options.iteration); if (it)
+    await (0, merge_check_1.updateArchitecture)(it, (options.apis || '').split(',').filter(Boolean), (options.tables || '').split(',').filter(Boolean)); });
+commander_1.program
+    .command('merge-check')
+    .alias('mc')
+    .description('Predict merge conflicts across task branches')
+    .option('-i, --iteration <iteration>', 'Target iteration')
+    .action(async (options) => { const { getDefaultIteration } = await Promise.resolve().then(() => __importStar(require('./core/context'))); const it = await getDefaultIteration(options.iteration); if (it)
+    await (0, merge_check_1.mergeCheck)(it); });
+commander_1.program
+    .command('rollback')
+    .alias('rb')
+    .description('Rollback a task: revert branch + archive spec')
+    .option('-t, --task <task>', 'Task to rollback')
+    .option('-i, --iteration <iteration>', 'Target iteration')
+    .option('--reason <reason>', 'Rollback reason')
+    .action(async (options) => { const it = await require('../core/context').getDefaultIteration(options.iteration); if (it && options.task)
+    await (0, merge_check_1.rollbackTask)(options.task, it, options.reason); });
+commander_1.program
+    .command('arch-update')
+    .alias('au')
+    .description('Auto-update ARCHITECTURE.md with new APIs/tables')
+    .option('-i, --iteration <iteration>', 'Source iteration')
+    .option('--apis <apis>', 'Comma-separated API paths')
+    .option('--tables <tables>', 'Comma-separated table names')
+    .action(async (options) => { const it = await require('../core/context').getDefaultIteration(options.iteration); if (it)
+    await (0, merge_check_1.updateArchitecture)(it, (options.apis || '').split(',').filter(Boolean), (options.tables || '').split(',').filter(Boolean)); });
 commander_1.program
     .command('trace')
     .alias('tr')
@@ -681,5 +883,87 @@ commander_1.program
     .option('--iteration <name>', 'Watch a specific iteration')
     .action(watch_1.watchCommand);
 // Parse arguments
+// ── Adaptive welcome panel (no args) ──
+if (process.argv.length <= 2) {
+    const { existsSync, readdirSync, readFileSync } = require('fs');
+    const { join } = require('path');
+    const { logger } = require('./utils/logger');
+    const pkg = require('../../package.json');
+    let phase = 'init', iteration = '', total = 0, done2 = 0;
+    let nextCmd = 'speccore init', nextDesc = '初始化 SpecCore 项目';
+    if (existsSync('.speccore')) {
+        try {
+            const items = readdirSync('.');
+            const idirs = items.filter((d) => d.startsWith('期次-')).sort();
+            if (idirs.length > 0) {
+                iteration = idirs[0].slice(3);
+                const base = idirs[0];
+                const req = join(base, '00-需求文档', 'REQUIREMENT.md');
+                const ana = join(base, '00-需求文档', 'ANALYSIS.md');
+                if (!existsSync(req)) {
+                    phase = 'require';
+                    nextCmd = 'speccore word2spec -i ' + iteration;
+                    nextDesc = '导入需求文档';
+                }
+                else if (!existsSync(ana)) {
+                    phase = 'analyze';
+                    nextCmd = 'speccore analyze --iteration=' + iteration;
+                    nextDesc = '需求分析';
+                }
+                else {
+                    const tds = readdirSync(base).filter((d) => d.startsWith('Task-'));
+                    if (tds.length === 0) {
+                        phase = 'split';
+                        nextCmd = 'speccore iteration split --iteration=' + iteration;
+                        nextDesc = '拆分任务';
+                    }
+                    else {
+                        total = tds.length;
+                        for (const td of tds) {
+                            const tm = join(base, td, 'backend', 'TASK.md');
+                            if (existsSync(tm) && readFileSync(tm, 'utf-8').includes('已完成'))
+                                done2++;
+                        }
+                        if (done2 < total) {
+                            phase = 'dev';
+                            nextCmd = 'speccore execute --task=' + tds[done2] + ' --force';
+                            nextDesc = '执行开发 (' + (done2 + 1) + '/' + total + ')';
+                        }
+                        else {
+                            phase = 'done';
+                            nextCmd = 'speccore pr';
+                            nextDesc = '创建 PR 提交代码';
+                        }
+                    }
+                }
+            }
+        }
+        catch { }
+    }
+    const icons = { init: '🚀', require: '📝', analyze: '🔍', split: '📦', dev: '💻', done: '✨' };
+    const names = { init: '未初始化', require: '待导入需求', analyze: '待分析', split: '待拆分', dev: '开发中', done: '已完成' };
+    logger.info('');
+    logger.info('┌──────────────────────────────────────────┐');
+    logger.info('│    SpecCore · v' + pkg.version + ' · 68 commands              │');
+    logger.info('├──────────────────────────────────────────┤');
+    if (iteration)
+        logger.info('│  期次: ' + iteration.padEnd(33) + '│');
+    logger.info('│  状态: ' + icons[phase] + ' ' + (names[phase] || phase).padEnd(33) + '│');
+    if (total > 0) {
+        const pct = Math.round(done2 / total * 100);
+        const bar = '█'.repeat(Math.round(pct / 10)) + '░'.repeat(10 - Math.round(pct / 10));
+        const taskLine = '│  任务: ' + done2 + '/' + total + ' ' + bar + ' ' + pct + '%';
+        logger.info(taskLine.padEnd(46) + '│');
+    }
+    logger.info('│                                          │');
+    logger.info('│  👉 下一步: ' + nextCmd.padEnd(33) + '│');
+    logger.info('│     ' + nextDesc.padEnd(41) + '│');
+    logger.info('│                                          │');
+    logger.info('│  💡 speccore --help   查看全部命令        │');
+    logger.info('│  📊 speccore status-panel  状态面板       │');
+    logger.info('└──────────────────────────────────────────┘');
+    logger.info('');
+    process.exit(0);
+}
 commander_1.program.parse();
 //# sourceMappingURL=cli.js.map