speccore 8.3.182 → 8.3.188

package/.agents/skills/spec-task-create/SKILL.md

@@ -8,155 +8,6 @@ allowed-tools: ["Bash", "Read"]
 disable-model-invocation: false
 ---
 
-# spec-task-create — 创建开发任务（专属逻辑）
+直接执行: execute_command("speccore ask '用户原话'")
 
-> **定位**：`/task-create` 快捷入口的专属预处理层
-> **原则**：不影响 `speccore ask` 的意图识别能力
-
----
-
-## 调用方式
-
-```
-/task-create [参数]
-/task-create -n "用户登录" --topic user-login -i Q1 -t feature
-/task-create --batch "登录页,注册页,首页" -i Q1 -t feature
-```
-
----
-
-## 执行流程
-
-```
-用户输入 /task-create [参数]
-        │
-        ▼
-┌───────────────────────────────────────┐
-│ Step 1: 参数提取                        │
-│ 从用户输入提取 name/topic/iteration/type │
-└───────────────┬───────────────────────┘
-                │
-        参数缺失？
-                │
-        是 ──► 输出交互式提示
-                │
-        否 ──► 继续
-                │
-                ▼
-┌───────────────────────────────────────┐
-│ Step 2: 参数补全                        │
-│ topic 缺失 → AI 从中文名提取英文主题词     │
-│ iteration 缺失 → 读 context.json         │
-└───────────────┬───────────────────────┘
-                │
-                ▼
-┌───────────────────────────────────────┐
-│ Step 3: 前置校验                        │
-│ - 迭代是否存在？                        │
-│ - 主题词是否有效？                      │
-│ - 是否命名冲突？                        │
-└───────────────┬───────────────────────┘
-                │
-                ▼
-┌───────────────────────────────────────┐
-│ Step 4: 调用 speccore ask               │
-└───────────────────────────────────────┘
-```
-
----
-
-## Step 1: 参数提取
-
-| 参数 | 短名 | 长名 | 必填 | 说明 |
-|:---|:---|:---|:---|:---|
-| name | -n | --name | 是 | 任务中文名称 |
-| topic | - | --topic | 否 | 英文主题词（用于目录命名）|
-| iteration | -i | --iteration | 否 | 目标迭代名 |
-| type | -t | --type | 否 | 任务类型: feature / bugfix / research / refactor |
-| batch | -b | --batch | 否 | 批量创建（逗号分隔的名称列表）|
-| owner | -o | --owner | 否 | 任务负责人 |
-
----
-
-## Step 2: 参数缺失 → 交互式提示
-
-```
-📋 speccore task-create — 创建开发任务
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-📋 当前环境
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-迭代: Iteration-001-meeting-system（从 context.json 读取）
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-📖 可用参数
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-  -n, --name <name>         任务中文名称（必填）
-      --topic <topic>       英文主题词（如 user-login, payment）
-                            用于生成目录名，缺失时 AI 自动提取
-  -i, --iteration <name>    目标迭代（默认: 当前迭代）
-  -t, --type <type>         任务类型: feature | bugfix | research | refactor
-                            默认: feature
-  -b, --batch <names>       批量创建（逗号分隔，如 "登录,注册,首页"）
-  -o, --owner <name>        任务负责人
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-💡 使用示例
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-  /task-create -n "用户登录" --topic user-login    # 创建单个任务
-  /task-create -n "支付接口" -t feature            # AI 自动提取主题词
-  /task-create --batch "登录页,注册页,首页"        # 批量创建 3 个任务
-  /task-create -n "订单退款" -i Q1 -t bugfix       # 指定迭代和类型
-
-请补充 --name 参数后重新调用。
-```
-
----
-
-## Step 3: 前置校验
-
-### 3.1 检查迭代是否存在
-```bash
-# 检查迭代目录是否存在
-# 如果不存在 → 提示用户先创建迭代
-```
-
-### 3.2 提取英文主题词
-```bash
-# 如果用户未提供 --topic，从 --name 提取英文主题词
-# "用户登录" → "user-login"
-# "支付接口修复" → "payment-fix"
-# "批量创建"时不单独提取，每个名称各自提取
-```
-
-### 3.3 检查命名冲突
-```bash
-# 检查 030-tasks/ 下是否已有同名 Task
-# 如果冲突 → 提示用户是否覆盖或改名
-```
-
-### 3.4 检查任务类型
-```bash
-# 有效类型: feature, bugfix, research, refactor
-# 如果无效 → 提示可用类型
-```
-
----
-
-## Step 4: 调用 speccore ask
-
-```bash
-execute_command("speccore ask '创建 Task-XXX 任务...'")
-```
-
-> ⚠️ 最终仍然调用 `speccore ask`，不要绕过 ask 引擎。
-
----
-
-## 批量创建模式
-
-当使用 `--batch` 时：
-1. 解析逗号分隔的名称列表
-2. 为每个名称提取英文主题词
-3. 逐个创建 Task 目录
-4. 输出批量创建结果汇总
+不要输出命令文本，不要分析意图，一切交给 speccore ask。

package/.agents/skills/spec-verify/SKILL.md

@@ -9,218 +9,6 @@ allowed-tools: ["Bash", "Read"]
 disable-model-invocation: false
 ---
 
-# spec-verify — 测试验证（专属逻辑）
+直接执行: execute_command("speccore ask '用户原话'")
 
-> **定位**：`/verify` 快捷入口的专属预处理层
-> **覆盖命令**：`speccore verify`
-> **原则**：不影响 `speccore ask` 的意图识别能力
-
----
-
-## 调用方式
-
-```
-/verify [自然语言或参数]
-/verify 跑一下冒烟测试
-/verify --stage pr
-/verify --config ./tests/smoke.yaml --env-file test
-/verify --project-dir ~/projects/other-app --stage deploy
-```
-
----
-
-## 执行流程
-
-```
-用户输入 /verify [输入]
-        │
-        ▼
-┌───────────────────────────────────────┐
-│ Step 1: 意图识别                        │
-│ 判断测试类型、阶段、目标项目              │
-│ 从自然语言或显式参数提取参数              │
-└───────────────┬───────────────────────┘
-                │
-        参数缺失？
-                │
-        是 ──► 输出交互式提示
-                │
-        否 ──► 继续
-                │
-                ▼
-┌───────────────────────────────────────┐
-│ Step 2: 前置校验                        │
-│ - 测试配置文件是否存在？                  │
-│ - 环境配置是否存在？                     │
-│ - 外部项目目录是否有效？                 │
-└───────────────┬───────────────────────┘
-                │
-        校验失败？
-                │
-        是 ──► 输出问题 + 修复建议
-                │
-        否 ──► 继续
-                │
-                ▼
-┌───────────────────────────────────────┐
-│ Step 3: 执行                            │
-│ 直接 execute_command 执行 CLI 命令      │
-└───────────────────────────────────────┘
-```
-
----
-
-## Step 1: 意图识别与参数提取
-
-### 双模式支持
-
-**模式 A — 自然语言（默认）**：
-```
-/verify 跑冒烟测试
-/verify PR 前检查一下
-/verify 发布前全量回归
-/verify 测试一下 H5
-```
-AI 从自然语言中提取参数。
-
-**模式 B — 显式参数**：
-```
-/verify --stage deploy --project-dir ~/my-app
-/verify --config ./tests/smoke.yaml --env-file staging
-/verify --ui --url https://example.com
-```
-直接解析参数，不经过自然语言理解。
-
-### 参数定义
-
-| 参数 | 短名 | 长名 | 必填 | 默认值 | 说明 |
-|:---|:---|:---|:---|:---|:---|
-| stage | -s | --stage | 否 | - | 测试阶段：dev/pr/deploy/release |
-| config | -c | --config | 否 | - | 测试场景配置文件路径 |
-| env-file | -e | --env-file | 否 | - | 环境配置文件路径或环境名 |
-| ui | -u | --ui | 否 | false | 启用 UI 验证 |
-| smoke-only | - | --smoke-only | 否 | false | 仅冒烟测试 |
-| visual-only | - | --visual-only | 否 | false | 仅视觉检查 |
-| api-contract | - | --api-contract | 否 | false | API 契约测试 |
-| perf | - | --perf | 否 | false | 性能基线测试 |
-| type | -t | --type | 否 | - | 验证类型：compile/lint/test/all |
-| url | - | --url | 否 | - | 目标 URL（独立模式） |
-| spec | - | --spec | 否 | - | VERIFY_SPEC.yaml 路径 |
-| router-file | - | --router-file | 否 | - | 前端路由配置文件路径 |
-| project-dir | - | --project-dir | 否 | - | 外部项目目录路径 |
-
-### 意图映射表
-
-| 用户说法 | 推断命令 | 推断参数 |
-|:---|:---|:---|
-| "跑冒烟测试" | verify | --stage deploy |
-| "PR 前检查一下" | verify | --stage pr |
-| "发布前全量回归" | verify | --stage release |
-| "开发时跑测试" | verify | --stage dev |
-| "测试一下 H5" | verify | --ui --config ./tests/smoke.yaml |
-| "验证 API 契约" | verify | --api-contract |
-| "跑视觉检查" | verify | --ui --visual-only |
-| "测试外部项目" | verify | --project-dir {路径} --stage deploy |
-
-### 阶段映射详情
-
-| stage | 自动参数 | 覆盖范围 |
-|:---|:---|:---|
-| dev | --type all | 编译 + Lint + 单元测试 |
-| pr | --type all --ui --smoke-only --api-contract | 代码质量 + 关键页面冒烟 + API 契约 |
-| deploy | --ui --smoke-only | 仅 UI 冒烟测试 |
-| release | --ui --api-contract --perf | 全量 UI + API + 性能回归 |
-
----
-
-## Step 2: 参数缺失 → 交互式提示
-
-### 测试阶段缺失
-
-```
-🧪 speccore verify — 请选择测试阶段
-
-可用阶段：
-  [1] dev      — 开发阶段（编译 + Lint + 单元测试）
-  [2] pr       — PR 阶段（代码质量 + 冒烟 + API 契约）
-  [3] deploy   — 部署阶段（仅冒烟测试）
-  [4] release  — 发布阶段（全量回归）
-
-请回复阶段名或序号（如：deploy 或 3）
-```
-
-### 测试配置缺失（--stage 指定但无对应配置）
-
-```
-⚠️ 未找到阶段对应的测试配置文件
-
-建议操作：
-  1. 运行 speccore update 初始化默认测试配置模板
-  2. 手动创建 .speccore/tests/smoke.yaml
-  3. 使用 --config 显式指定配置路径
-```
-
----
-
-## Step 3: 前置校验
-
-### 校验项
-
-1. **外部项目目录有效性**（指定 --project-dir 时）
-   - 检查目录是否存在
-   - 检查是否为 Git 仓库（可选）
-
-2. **测试配置文件存在性**（指定 --config 时）
-   - 检查文件是否存在
-   - 不存在 → 提示可用配置列表
-
-3. **环境配置存在性**（指定 --env-file 时）
-   - 检查 `.speccore/environments/{env}.yaml` 是否存在
-   - 不存在 → 提示可用环境列表
-
----
-
-## 命令组装规则
-
-### verify（默认）
-```bash
-speccore verify [--stage {stage}] [--config {path}] [--env-file {env}] [--ui] [--smoke-only] [--visual-only] [--api-contract] [--perf] [--type {type}] [--url {url}] [--spec {spec}] [--router-file {path}] [--project-dir {dir}]
-```
-
-**意图 → 命令映射**：
-- 用户说"冒烟"、"smoke" → `--stage deploy` 或 `--ui --smoke-only`
-- 用户说"PR"、"提交前" → `--stage pr`
-- 用户说"发布"、"上线前"、"回归" → `--stage release`
-- 用户说"编译"、"lint"、"单元测试" → `--stage dev`
-- 用户说"视觉"、"截图" → `--ui --visual-only`
-- 用户说"API"、"契约" → `--api-contract`
-- 用户说"性能" → `--perf`
-
----
-
-## 外部项目测试
-
-```bash
-/verify --project-dir ~/projects/other-app --stage deploy
-/verify --project-dir ~/projects/other-app --config ./tests/smoke.yaml
-```
-
-最小外部项目配置：
-```yaml
-# ~/my-test-projects/minimal/.speccore/environments/test.yaml
-env: test
-tests:
-  base_urls:
-    h5: https://example.com
-```
-
----
-
-## 错误处理
-
-| 场景 | 提示 |
-|:---|:---|
-| 测试配置不存在 | "未找到测试配置文件，运行 `speccore update` 初始化默认配置" |
-| 环境配置不存在 | "环境 {env} 未配置，运行 `speccore update` 初始化默认环境" |
-| 外部项目目录无效 | "目录 {path} 不存在，请检查路径" |
-| 视觉模型调用失败 | "视觉模型调用失败，检查 DASHSCOPE_API_KEY / OPENAI_API_KEY 环境变量" |
+不要输出命令文本，不要分析意图，一切交给 speccore ask。

package/.agents/skills/spec-welcome/SKILL.md

@@ -8,72 +8,6 @@ allowed-tools: ["Bash", "Read"]
 disable-model-invocation: false
 ---
 
-# spec-welcome — 欢迎页（专属逻辑）
-
-> **定位**：`/welcome` 快捷入口的专属预处理层
-> **原则**：不影响 `speccore ask` 的意图识别能力
-
----
-
-## 调用方式
-
-```
-/welcome
-```
-
----
-
-## 执行流程
-
-```
-用户输入 /welcome
-        │
-        ▼
-┌───────────────────────────────────────┐
-│ Step 1: 前置校验                        │
-│ 检查 .speccore/ 目录是否存在              │
-└───────────────────────────────────────┘
-        │
-   ┌────┴────┐
-   ▼         ▼
- 不存在     存在
-   │         │
-   ▼         ▼
-输出提示    调用 ask
-引导 init   执行 welcome
-```
-
----
-
-## 前置校验
-
-### 检查项目初始化状态
-
-```bash
-ls -d .speccore 2>/dev/null && echo "initialized" || echo "not-initialized"
-```
-
-### 未初始化时的交互提示
-
-```
-⚠️  项目尚未初始化
-
-当前目录未检测到 .speccore/ 规范数据库，无法展示项目名片。
-
-建议操作：
-  speccore init                    # 初始化 SpecCore 项目
-
-初始化完成后，可重新执行 /welcome 查看项目状态。
-```
-
----
-
-## 执行
-
-项目已初始化时，直接调用 `speccore ask`：
-
-```
-直接执行: execute_command("speccore ask '显示项目欢迎页'")
+直接执行: execute_command("speccore ask '用户原话'")
 
 不要输出命令文本，不要分析意图，一切交给 speccore ask。
-```

package/.agents/skills/speccore-router/SKILL.md

@@ -37,6 +37,14 @@ allowed-tools: ["Bash", "Read", "Write", "Edit"]
 - `[SPECCORE_DASHBOARD: <path>]` → **立即执行** `present_files(<path>)` 展示仪表盘页
 - `[SPECCORE_EXEC: <cmd>]` → 直接 `execute_command` 执行
 - `[SPECCORE_INTENT]` → 展示给用户确认
+- `[SPECCORE_GATE_A]` / `[SPECCORE_GATE_B]` / `[SPECCORE_GATE_C]` → **🚨 停下来 review，等用户确认后再继续，禁止自动续跑**：
+  1. 读取 stdout 中闸口块的 title + hint + 「确认后继续」命令
+  2. 按闸口类型把 review 产物展示给用户：
+     - **Gate A（Spec 定稿）** → 展示 `020-specs/` 的 REQUIREMENT / ANALYSIS / TECH / API_CONTRACT，让用户确认功能单元边界、端覆盖、验收标准
+     - **Gate B（代码 review）** → 展示 `.issues.md` / `.deviations` 及 AI 标记的低置信点，让用户确认或修正
+     - **Gate C（部署前确认）** → 明确告知这是 destructive 部署操作，展示部署目标（env/platform），必须用户明确同意
+  3. 停下来问用户「是否确认继续？」，**用户明确确认后**才执行「确认后继续」命令（`speccore run --auto --from <stage>`）
+  4. ❌ 禁止在用户未确认时自动执行续跑命令；❌ 禁止只说"检测到闸口"而不展示 review 产物
 
 ## ⛔ 最高优先级：用户意图优先于效率判断
 
@@ -284,12 +292,16 @@ allowed-tools: ["Bash", "Read", "Write", "Edit"]
 | {owner} 的工作回顾 | owner | `speccore retro --owner {owner}` |
 | {type} 类型的回顾 | type | `speccore retro --type {type}` |
 
-### 智能级联
+### 智能级联 / 端到端流水线
 | 用户说法 | 提取参数 | CLI 命令 |
 | :--- | :--- | :--- |
 | 智能级联/全流程推进 | - | `speccore dev` |
 | 推进项目/继续开发 | - | `speccore dev` |
-| 全自动推进 | - | `speccore dev --auto` |
+| 全自动推进/跑流水线 | - | `speccore run` |
+| 端到端/一键开发/自动开发 | demand? | `speccore run "{demand}"` |
+| {一句话需求描述}（如"做积分功能"） | demand | `speccore run "{demand}"` |
+| 演示模式跑一遍 {需求} | demand | `speccore run --demo "{demand}"` |
+| 从 {stage} 继续 | stage | `speccore run --auto --from {stage}` |
 
 ### 全量层管理
 | 用户说法 | 提取参数 | CLI 命令 |

package/README.en.md

@@ -5,9 +5,9 @@
 > Juggling 5 microservices and 3 frontend platforms? SpecCore turns requirements → splits → plans → code → delivery into a traceable, automated pipeline.
 
 ```
-  init → doc2spec → analyze → split → plan → execute → pr → done
-  🚀Setup   📝Import   🧠Analyze  📦Split  📋Plan  💻Build  🔀PR  ✅Archive
-  ✅ CLI    🔒 AI      🔒 AI      🔒 AI     🔒 AI    🔒 AI    🔒 AI  🔒 AI
+  init → doc2spec → analyze(overview) → analyze(units) → split → plan → execute → pr → done → spec2doc
+  🚀Setup   📝Import   🧠Analyze   🧠Analyze   📦Split  📋Plan  💻Build  🔀PR  ✅Archive  📤Export
+  ✅ CLI    🔒 AI      🔒 AI       🔒 AI       🔒 AI     🔒 AI    🔒 AI    🔒 AI  🔒 AI      🔒 AI
 ```
 
 ## 🚀 5 Minutes to First Task
@@ -53,7 +53,7 @@ speccore iteration create -n Q1     # Create iteration
 | **Split requirements into tasks** | `speccore iteration split -I Q1 --interactive` |
 | **Fix a bug** | `speccore task new -n "Login timeout" --type=bugfix` |
 | **Batch fix bugs** | `speccore task new --batch-file=bugs.xlsx --type=bugfix` |
-| **Schedule overnight execution** | `speccore schedule create --at "02:00" --all -I Q1` |
+| **Refresh retrieval layers** | `speccore refresh` |
 | **AI auto-development** | `@spec-ask "execute Task-001"` 🔒 |
 | **Create a Pull Request** | `@spec-ask "create PR for Task-001"` 🔒 |
 | **Archive a completed task** | `@spec-ask "archive Task-001"` 🔒 |
@@ -70,13 +70,13 @@ speccore iteration create -n Q1     # Create iteration
 |:---|:---|:---|
 | `🧠 pr --interactive` | `🧠 change --interactive` | `🧠 done --interactive` |
 
-## ⏰ Scheduled Execution
+## 🔄 Unified Retrieval Refresh
 
 ```bash
-speccore task new -n "Data migration" --schedule=night         # Queue for night
-speccore schedule create --at "2026-08-10 02:00" --all -I Q1   # Exact time
-speccore schedule daemon start                                  # Auto-execute on schedule
-# 🔒 AI: @spec-ask "run all scheduled tasks"
+speccore refresh                    # Refresh all retrieval layers (code index + RAG + knowledge graph)
+speccore refresh --code             # Only code index
+speccore refresh --rag              # Only document RAG
+speccore refresh --graph            # Only knowledge graph
 ```
 
 ## 📚 Documentation

package/README.md

@@ -367,7 +367,8 @@ speccore --version   # v8.3.167
 | `graph` | `g` | 🕸️ 统一图谱查询（知识+代码）+ Mermaid 渲染 |
 | `knowledge` | `kg` |  🌐 知识图谱可视化 + 衰减检测 + 代码图谱查询 |
 | `track` | `trk` | 🔗 🔒 REQ→Task→Code 全链路 |
-| `search` | `sh` | 🔍 跨 Spec 全文搜索 |
+| `search` | `sh` | 🔍 跨 Spec 全文搜索 + 全局语义检索（--global） |
+| `refresh` | `rf` | 🔄 统一刷新检索层（代码索引 + 文档 RAG + 知识图谱）+ 全局文档过期检测 |
 | `retro` | `rt` | 📝 🔒 任务回顾复盘 + 评分 |
 | `rename` | `rn` | ✏️ 🔒 重命名 |
 | `history` | `hi` | 📜 历史记录（操作日志 / 需求变更） |

package/dist/cli.js

@@ -163,21 +163,7 @@ commander_1.program
     .option('-i, --iteration <iteration>', 'Target iteration')
     .option('--export <path>', 'Export HTML to custom path')
     .action(knowledge_1.knowledgeCommand);
-commander_1.program
-    .command('knowledge-explain <node>')
-    .alias('kg-explain')
-    .description('解释代码知识图谱中的节点及其连接')
-    .action(knowledge_1.knowledgeExplainCommand);
-commander_1.program
-    .command('knowledge-path <from> <to>')
-    .alias('kg-path')
-    .description('查找代码图谱中两个节点之间的最短路径')
-    .action(knowledge_1.knowledgePathCommand);
-commander_1.program
-    .command('knowledge-query <question>')
-    .alias('kg-query')
-    .description('自然语言查询代码知识图谱')
-    .action(knowledge_1.knowledgeQueryCommand);
+// v8.3.186+: knowledge-explain/path/query 已合并到 graph 子命令（graph 是超集，融合知识图谱+代码图谱）
 const graphCmd = commander_1.program
     .command('graph')
     .alias('g')
@@ -236,13 +222,28 @@ commander_1.program
     .description('智能级联：--auto 全自动流水线，--from/--to 指定起止阶段')
     .option('-i, --iteration <iteration>', 'Target iteration')
     .option('--force', 'Auto-execute without confirmation')
-    .option('--auto', '全自动流水线：init→doc2spec→analyze→split→plan→execute→pr→done→spec2doc')
-    .option('--auto-steps <steps>', '指定连续步骤自动执行（如 analyze,split,execute）')
-    .option('--from <phase>', '从指定阶段开始（init/doc2spec/analyze/split/plan/execute/pr/done/spec2doc）')
-    .option('--to <phase>', '到指定阶段结束（init/doc2spec/analyze/split/plan/execute/pr/done/spec2doc）')
+    .option('--auto', '全自动流水线：init→clarify→doc2spec→analyze→validate→split→plan→execute→verify→pipeline→pr→done→spec2doc')
+    .option('--auto-steps <steps>', '指定连续步骤自动执行（如 analyze,validate,split,execute）')
+    .option('--from <phase>', '从指定阶段开始（init/clarify/doc2spec/analyze/validate/split/plan/execute/verify/pipeline/pr/done/spec2doc）')
+    .option('--to <phase>', '到指定阶段结束（init/clarify/doc2spec/analyze/validate/split/plan/execute/verify/pipeline/pr/done/spec2doc）')
+    .option('--demo', '演示模式（放宽闸口 A/B，保留部署前确认）')
     .option('--web', '强制输出 HTML 页面')
     .option('--lang <lang>', 'en 英文 / zh 中文（默认中文）')
     .action(dev_1.devCommand);
+commander_1.program
+    .command('run [demand...]')
+    .alias('r')
+    .description('端到端流水线：一句话需求 → 澄清 → 分析 → 拆分 → 执行 → 验证 → 部署（默认三闸口，--demo 放宽 A/B）')
+    .option('-i, --iteration <iteration>', 'Target iteration')
+    .option('--auto', '全自动（run 默认即全自动，此选项为续跑一致性保留）')
+    .option('--from <phase>', '从指定阶段开始（init/clarify/doc2spec/analyze/validate/split/plan/execute/verify/pipeline/pr/done/spec2doc）')
+    .option('--to <phase>', '到指定阶段结束（同上）')
+    .option('--demo', '演示模式（放宽闸口 A/B，保留部署前确认）')
+    .option('--env <env>', '部署环境（透传给 pipeline，默认 staging）')
+    .action((demand, options) => {
+    // pipeline: true 让 devCommand 走 autoPipeline（非 TTY 下不会落到 HTML 渲染分支）
+    (0, dev_1.devCommand)({ ...options, auto: true, pipeline: true, demand: demand && demand.length ? demand.join(' ') : undefined });
+});
 commander_1.program
     .command('prompts')
     .alias('pt')
@@ -610,13 +611,8 @@ commander_1.program
     .description('项目状态 → status-panel（同一入口）')
     .option('-i, --iteration <iteration>', 'Target iteration')
     .option('-a, --assignee <assignee>', 'Filter by assignee')
+    .option('--health', '项目健康度报告（原 health 命令，已合并）')
     .action(status_panel_1.statusPanelCommand);
-commander_1.program
-    .command('health')
-    .alias('hl')
-    .description('项目健康度 → status-panel --health')
-    .option('-i, --iteration <iteration>', 'Target iteration')
-    .action((opts) => (0, status_panel_1.statusPanelCommand)({ ...opts, health: true }));
 commander_1.program
     .command('progress')
     .alias('pg')
@@ -708,6 +704,7 @@ commander_1.program
     .option('--get <key>', 'Get configuration value by path (e.g., arbitration.mode)')
     .option('--set <key=value>', 'Set configuration value (e.g., arbitration.mode=l1-only)')
     .option('--upgrade', 'Upgrade config structure to latest schema_version')
+    .option('--project', 'Operate on project config (.speccore/PROJECT.yaml) instead of system config')
     .option('-r, --rule <name>', 'Target spec-rule (CONSTITUTION.md)')
     .option('-t, --tech <target>', 'Target tech-stack (TECH_STACK.md): <端名>')
     .option('--reset', 'Reset to default configuration')
@@ -849,6 +846,7 @@ commander_1.program
     .option('--interactive', '交互: AI 提问 → 回答 → 优化')
     .option('--prompt', '输出结构化 Prompt 到 stdout（Skill 协作模式）')
     .option('--with-code', '结合 CONSTITUTION.md 配置的工程源码一起分析')
+    .option('--from-code', '从源码反推候选需求（两跳：逐模块 IR → 合成 UR，含 EARS 验收标准）')
     .option('--no-source', '不读取源码内容（默认会读）')
     .option('--source-scope <dirs>', '指定源码扫描目录（逗号分隔，如 src/commands,src/core）')
     .option('--supplement', '补充模式：追加未覆盖的源码到现有报告（不重新生成）')
@@ -1026,6 +1024,7 @@ commander_1.program
     .description('全文搜索：跨所有 Spec 文件关键词检索')
     .option('--task <id>', 'Limit search to a task')
     .option('--iteration <name>', 'Limit search to an iteration')
+    .option('--global', '全局层语义检索（RAG + 知识图谱加分，而非关键词搜索）')
     .action((query, opts) => (0, search_1.searchCommand)({ ...opts, query }));
 commander_1.program
     .command('welcome')