speccore 8.3.333 → 8.3.341

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

@@ -26,6 +26,10 @@ disable-model-invocation: false
 不要输出命令文本，不要分析意图，一切交给 speccore ask。
 
 ## 输出标记处理
+- `[SPECCORE_ONBOARD: <path>]` / `[SPECCORE_WELCOME: <path>]` / `[SPECCORE_SETUP_GUIDE: <path>]` 等 HTML 展示标记 → **必须最先处理，立即把 HTML 页面展示给用户**：
+  - 有 present_files 工具的宿主：直接 `present_files(<path>)`
+  - Qoder（无 present_files）：后台起静态服务器 `python3 -m http.server 8899 -d <页面所在目录>`，再用 RunPreview 打开 `http://localhost:8899/<页面文件名>`；同时附上可点击链接 `[打开页面](file://<path>)` 作为回退
+  - 禁止只说“检测到引导页”而不展示 — 说了不等于做了
 - `[SPECCORE_EXEC: <cmd>]` → 立即执行该命令，不要向用户复述命令文本
 - `[SPECCORE_PROMPT]` → 将后续 Prompt 内容作为你的工作指令执行
 - `[SPECCORE_NEEDS_INFO]` → 用交互式提问向用户收集缺失参数，收齐后重新执行

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

@@ -5,7 +5,8 @@ description: >
   /unitize 等关键词，或明确要求通过 speccore 切分需求文档为功能单元（unitize）时使用。
   参数提取与前置校验（输入文件格式：.md 可直接切、
   .docx/.pdf 需先 doc2spec 转换；端名须与 CONSTITUTION.md 端列表一致；
-  features/ 已有同名单元时重切会覆盖旧切片；多文档可批量 --files "a.md=端1,b.md"）由 speccore ask 引擎执行；
+  features/ 已有同名单元时重切会覆盖旧切片；多文档可批量 --files "a.md=端1,b.md"；
+  支持 --titles 仅切指定标题章节、--files 多文档各自挂标题组 a.md=端@标题1|标题2）由 speccore ask 引擎执行；
   参数缺失时引擎输出 [SPECCORE_NEEDS_INFO] 交互式提示（参数说明 + 使用示例）。
   不处理一般性的"切分/拆分"讨论（如"帮我切一下这段文本"），只处理 speccore 上下文中的切分。
   与 spec-taskify 的区别：unitize 切需求（文档→功能单元 features/），taskify 拆任务（功能单元→开发任务 Task-*）。
@@ -27,6 +28,13 @@ disable-model-invocation: false
 - `[SPECCORE_INTENT]` / `[SPECCORE_RESULT]` → 原样转达用户
 - 其他 `[SPECCORE_*]` 标记 → 参照 speccore-router 的 SKILL.md 处理
 
+## 标题过滤（v8.3.334+：仅切指定标题章节）
+
+用户说「切 admin-web.md 里的预订管理、消息中心」「只切 a.md 的订单确认和 b.md 的扫码签到」时，ask 引擎自动提取文档与标题组合生成命令，无需宿主改写：
+- 单文档：speccore unitize --file x.md --titles "标题1,标题2"
+- 多文档各自标题：--files "a.md=端1@标题1|标题2,b.md=端2@标题3"
+- 匹配语义：模糊包含（「预订管理」命中「3.1 预订管理」），未命中标题 CLI 会警告；全局章节不受过滤影响照常归 overview/
+
 ## 英译接力剧本（宿主 AI 接手翻译）
 
 unitize 执行时（auto 默认；v8.3.289+ auto 模式会消费 auto_host_ai 配置），若当前环境无直连 LLM（无 providers 池/SPECCORE_LLM_KEY/OPENAI_API_KEY），且项目处于宿主模式（ai.provider=host 或 auto_host_ai: true），CLI 会：

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

@@ -23,18 +23,21 @@ allowed-tools: ["Bash", "Read", "Write", "Edit"]
 
 执行任何 `speccore` 命令后，检查 stdout 中的标记：
 - `[SPECCORE_ONBOARD: <path>]` → **🚨 必须最先处理，不可跳过，不可只口头提及**：
-  1. **立即执行** `present_files(<path>)` 展示 HTML 引导页（Qoder/Trae/Cursor 均支持）
+  1. **立即展示 HTML 引导页给用户**，按宿主环境选择方式：
+     - **有 present_files 工具的宿主**（Trae/Cursor 等）：直接 `present_files(<path>)`
+     - **Qoder（无 present_files）**：后台起静态服务器 `python3 -m http.server 8899 -d <页面所在目录>`，再用 RunPreview 打开 `http://localhost:8899/<页面文件名>`；同时附上可点击链接 `[打开页面](file://<path>)` 作为回退
   2. ❌ 禁止只说“检测到引导页”而不执行展示动作 — 说了不等于做了
   3. ❌ 禁止用文字描述引导页内容代替实际展示 — 必须让用户看到 HTML 页面
   4. **展示完成后**，再继续处理其他输出
-- `[SPECCORE_SETUP_GUIDE: <path>]` → **立即执行** `present_files(<path>)` 展示配置引导页
-- `[SPECCORE_ABOUT: <path>]` → **立即执行** `present_files(<path>)` 展示版本信息页
-- `[SPECCORE_HELP: <path>]` → **立即执行** `present_files(<path>)` 展示帮助中心页
-- `[SPECCORE_WELCOME: <path>]` → **立即执行** `present_files(<path>)` 展示项目名片页
-- `[SPECCORE_KNOWLEDGE: <path>]` → **立即执行** `present_files(<path>)` 展示知识图谱页
-- `[SPECCORE_PLAN: <path>]` → **立即执行** `present_files(<path>)` 展示执行计划页
-- `[SPECCORE_RETRO: <path>]` → **立即执行** `present_files(<path>)` 展示回顾报告页
-- `[SPECCORE_DASHBOARD: <path>]` → **立即执行** `present_files(<path>)` 展示仪表盘页
+- `[SPECCORE_SETUP_GUIDE: <path>]` → **立即展示配置引导页**（方式同上，Qoder 用静态服务器 + RunPreview）
+- `[SPECCORE_ABOUT: <path>]` → **立即展示版本信息页**（方式同上）
+- `[SPECCORE_HELP: <path>]` → **立即展示帮助中心页**（方式同上）
+- `[SPECCORE_WELCOME: <path>]` → **立即展示项目名片页**（方式同上）
+- `[SPECCORE_KNOWLEDGE: <path>]` → **立即展示知识图谱页**（方式同上）
+- `[SPECCORE_PLAN: <path>]` → **立即展示执行计划页**（方式同上）
+- `[SPECCORE_RETRO: <path>]` → **立即展示回顾报告页**（方式同上）
+- `[SPECCORE_DASHBOARD: <path>]` → **立即展示仪表盘页**（方式同上）
+- `[SPECCORE_PROMPTS: <path>]` → **立即展示提示词库页**（方式同上）
 - `[SPECCORE_EXEC: <cmd>]` → 直接 `execute_command` 执行
 - `[SPECCORE_PROMPT]` → 将后续 Prompt 内容作为你的工作指令执行（不要改写、不要略过）
 - `[SPECCORE_NEEDS_INFO]` → 用交互式提问向用户收集缺失参数，收齐后重新执行
@@ -278,8 +281,6 @@ allowed-tools: ["Bash", "Read", "Write", "Edit"]
 | 合规检查 | iter? | `speccore validate -I {iter}` |
 | 搜索 "{keyword}" | keyword | `speccore search "{keyword}"` |
 | 全局搜索 "{keyword}" | keyword | `speccore search "{keyword}" --global` |
-| 追溯 {req} | req | `speccore track --req {req}` |
-| 影响分析 {req} | req | `speccore impact --req {req}` |
 
 ### 知识库与索引
 | 用户说法 | 提取参数 | CLI 命令 |

package/README.en.md

@@ -158,14 +158,6 @@ speccore ask "from analyze to develop"          # → run --from analyze --to ex
 
 One "spec once" phrase packs the whole requirement-to-deploy chain into a single session: entry (feature units / doc path / one-liner) → clarify → analyze → taskify → execute → local smoke → deploy verification. **Dual mode**: interactive by default (pauses at every node); say "full-auto / don't stop" to switch to auto mode (pauses only at three safety points: scope confirmation, quality-gate failure, smoke failure). Unsatisfied with a step? **Roll back and rerun**: re-analyze (`analyze --unit` overwrite + backup), re-taskify (`taskify --modules`), re-execute (`execute` single task), re-unitize (`unitize --on-duplicate`). Best for a few feature units (≤3); larger scope goes through `speccore run`.
 
-### 🧠 Knowledge graph & code graph
-
-```bash
-speccore graph query "order-related code"       # natural-language query
-speccore graph path Task-001 Task-002           # shortest dependency path
-speccore knowledge                               # interactive HTML graph
-```
-
 ### 📊 Dashboard
 
 `speccore dashboard` generates a Jira-standard 7-dimension board.
@@ -198,9 +190,9 @@ speccore verify -t Task-001 --ui
 | Finishing | `pipeline` `pr` `done` `spec2doc` |
 | Status / nav | `status` `next` `dashboard` `progress` |
 | Init / config | `init` `config` `doctor` `update` |
-| Management | `units` `pattern` `rollback` `history` `baseline` `rename` `cleanup` |
-| Change / special | `change` `retro` `verdict` `review` `sync` |
-| Knowledge | `graph` `knowledge` `query` `entity` `related` `path` `search` `stats` |
+| Management | `units` `pattern` `rename` `cleanup` |
+| Change / special | `change` `retro` `review` `sync` |
+| Knowledge | `search` |
 
 ---
 

package/README.md

@@ -159,16 +159,6 @@ speccore ask "分析本迭代需求，跳过澄清"     # → analyze --skip-cla
 
 一句「spec once」把需求到部署整条链装进一次会话：需求入口（功能单元 / 文档地址 / 一句话需求）→ 澄清 → 分析 → 拆分任务 → 开发 → 本地冒烟 → 部署验证。**双模式**：默认人机交互（每个节点停下确认），说「全自动/别停」切全自动（仅范围确认、质量门禁失败、冒烟失败三个安全点停下）。哪一步不满意可**回退重跑**：重分析（`analyze --unit` 覆盖+备份）、重拆（`taskify --modules`）、重执行（`execute` 单任务）、重切（`unitize --on-duplicate`）。适合少量功能单元（≤3）的快速闭环，大范围走 `speccore run` 流水线。
 
-### 🧠 知识图谱 & 代码图谱
-
-`speccore graph` 统一查询（知识 + 代码），`speccore knowledge` 可视化图谱：
-
-```bash
-speccore graph query "订单相关代码"        # 自然语言查询
-speccore graph path Task-001 Task-002      # 最短依赖路径
-speccore knowledge                          # 交互式 HTML 知识图谱
-```
-
 ### 📊 仪表盘
 
 `speccore dashboard` 生成 Jira 标准 7 维度看板（需求状态 / 项目健康度 / 进度条）。
@@ -220,9 +210,9 @@ speccore run --skip-smoke                  # 单次跳过冒烟
 | 收尾 | `pipeline` `pr` `done` `spec2doc` |
 | 状态 / 导航 | `status` `next` `dashboard` `progress` |
 | 初始化 / 配置 | `init` `config` `doctor` `update` |
-| 管理工具 | `units` `pattern` `rollback` `history` `baseline` `rename` `cleanup` |
-| 变更 / 专项 | `change` `retro` `verdict` `review` `sync` |
-| 知识检索 | `graph` `knowledge` `query` `entity` `related` `path` `search` `stats` |
+| 管理工具 | `units` `pattern` `rename` `cleanup` |
+| 变更 / 专项 | `change` `retro` `review` `sync` |
+| 知识检索 | `search` |
 
 > 💡 **全命令 Skill**：所有命令均支持 `/命令 + 自然语言` 快捷入口，如 `/deploy 部署到测试环境`、`/verify 跑冒烟测试`。
 

package/dist/cli.js

@@ -58,36 +58,23 @@ const execute_1 = require("./commands/execute");
 const ask_1 = require("./commands/ask");
 const about_1 = require("./commands/about");
 const doctor_1 = require("./commands/doctor");
-const notify_1 = require("./commands/notify");
-const recommend_1 = require("./commands/recommend");
 const change_1 = require("./commands/change");
 const sync_1 = require("./commands/sync");
-const history_1 = require("./commands/history");
 const pattern_1 = require("./commands/pattern");
 const global_1 = require("./commands/global");
-const rollback_1 = require("./commands/rollback");
-const handover_1 = require("./commands/handover");
 const help_1 = require("./commands/help");
 const run_1 = require("./commands/run");
 const next_1 = require("./commands/next");
 const welcome_1 = require("./commands/welcome");
 const status_panel_1 = require("./commands/status-panel");
-const knowledge_1 = require("./commands/knowledge");
-const graph_1 = require("./commands/graph");
 const doc2spec_1 = require("./commands/doc2spec");
 const unitize_1 = require("./commands/unitize");
 const spec2doc_1 = require("./commands/spec2doc");
 const units_1 = require("./commands/units");
-const code_index_1 = require("./commands/code-index");
-const rag_index_1 = require("./commands/rag-index");
-const refresh_1 = require("./commands/refresh");
 // 全量层命令
 const iteration_from_global_1 = require("./commands/iteration-from-global");
 const sync_global_1 = require("./commands/sync-global");
 // P0/P1/P2 新增命令
-const impact_1 = require("./commands/impact");
-const baseline_1 = require("./commands/baseline");
-const audit_1 = require("./commands/audit");
 const analyze_1 = require("./commands/analyze");
 const req_doc_1 = require("./commands/req-doc");
 const pr_1 = require("./commands/pr");
@@ -97,8 +84,6 @@ const pipeline_1 = require("./commands/pipeline");
 const constitution_builder_1 = require("./core/constitution-builder");
 const context_output_1 = require("./commands/context-output");
 const done_1 = require("./commands/done");
-const verdict_1 = require("./commands/verdict");
-const workspace_1 = require("./commands/workspace");
 // rename 命令
 const rename_1 = require("./commands/rename");
 const retro_1 = require("./commands/retro");
@@ -106,9 +91,6 @@ const reindex_1 = require("./commands/reindex");
 const update_1 = require("./commands/update");
 const migrate_1 = require("./commands/migrate");
 const completion_1 = require("./commands/completion");
-const diff_1 = require("./commands/diff");
-const trace_1 = require("./commands/trace");
-const merge_check_1 = require("./commands/merge-check");
 const delete_1 = require("./commands/delete");
 const search_1 = require("./commands/search");
 const prompts_1 = require("./commands/prompts");
@@ -207,66 +189,6 @@ commander_1.program
     .option('--scope <scope>', '视图: iteration(默认/当前迭代) | global(全量)', 'iteration')
     .option('--group-by <key>', '任务分组维度: feature（按功能模块分组列出清单）')
     .action(status_panel_1.statusPanelCommand);
-commander_1.program
-    .command('knowledge')
-    .alias('kg')
-    .description('知识图谱可视化：交互式图谱 + 衰减检测 + RAG 上下文预览')
-    .option('-i, --iteration <iteration>', 'Target iteration')
-    .option('--export <path>', 'Export HTML to custom path')
-    .action(knowledge_1.knowledgeCommand);
-// v8.3.186+: knowledge-explain/path/query 已合并到 graph 子命令（graph 是超集，融合知识图谱+代码图谱）
-const graphCmd = commander_1.program
-    .command('graph')
-    .alias('g')
-    .description('统一图谱查询：融合知识图谱 + 代码图谱');
-graphCmd
-    .command('query <question>')
-    .alias('q')
-    .description('自然语言查询两种图谱（默认启用 LLM 语义增强）')
-    .option('-t, --type <type>', '查询范围: all | knowledge | code', 'all')
-    .option('-l, --limit <n>', '最多返回结果数', '10')
-    .option('--smart', '启用 LLM 语义增强（默认开启）', true)
-    .option('--fast', '快速模式，跳过 LLM 语义增强')
-    .action((question, opts) => (0, graph_1.graphQueryCommand)(question, {
-    type: opts.type,
-    limit: parseInt(opts.limit, 10),
-    smart: opts.fast ? false : opts.smart !== false,
-}));
-graphCmd
-    .command('entity <id>')
-    .alias('e')
-    .description('查询特定实体详情')
-    .option('-t, --type <type>', '查询范围: all | knowledge | code', 'all')
-    .action((id, opts) => (0, graph_1.graphEntityCommand)(id, { type: opts.type }));
-graphCmd
-    .command('related <id>')
-    .alias('r')
-    .description('查询实体的关联实体（一阶邻居）')
-    .action((id) => (0, graph_1.graphRelatedCommand)(id, {}));
-graphCmd
-    .command('path <from> <to>')
-    .alias('p')
-    .description('查找两实体间的最短路径')
-    .option('-t, --type <type>', '查询范围: all | knowledge | code', 'all')
-    .action((from, to, opts) => (0, graph_1.graphPathCommand)(from, to, { type: opts.type }));
-graphCmd
-    .command('stats')
-    .alias('s')
-    .description('输出两种图谱的统计信息')
-    .option('-t, --type <type>', '统计范围: all | knowledge | code', 'all')
-    .action((opts) => (0, graph_1.graphStatsCommand)({ type: opts.type }));
-graphCmd
-    .command('render [file]')
-    .alias('r')
-    .description('渲染 Mermaid 图表为 HTML（支持 .mmd 文件或从 Markdown 提取）')
-    .option('--all', '批量渲染 diagrams/ 目录下所有 .mmd')
-    .option('--extract', '从 Markdown 文件提取 Mermaid 代码块')
-    .option('-o, --output <dir>', '输出目录')
-    .action((file, opts) => (0, graph_1.graphRenderCommand)(file, {
-    all: opts.all,
-    extract: opts.extract,
-    output: opts.output,
-}));
 commander_1.program
     .command('next')
     .alias('n')
@@ -546,7 +468,7 @@ commander_1.program
     .option('--backend', '仅后端任务（自动识别项目中的后端端名）')
     .option('--frontend', '仅前端任务（自动识别项目中的前端端名）')
     .option('--platform <platform>', '按端过滤（工程标识，如 CONSTITUTION.md 端列表中的端名）')
-    .option('--module <module>', '按所属功能模块筛选（如 支付，匹配 .meta/feature）')
+    .option('--module <modules>', '按所属功能模块/模块目录名筛选（逗号分隔多值，模糊匹配，如 "支付,订单"）')
     .option('--plan <id>', 'Execute a saved plan (from speccore plan --list)')
     .option('--interactive', 'Interactive selection')
     .option('--dry-run', 'Preview execution plan')
@@ -702,14 +624,6 @@ commander_1.program
     const { verifyCommand } = await Promise.resolve().then(() => __importStar(require('./commands/verify')));
     return verifyCommand(options);
 });
-// 源码索引
-(0, code_index_1.registerCodeIndexCommand)(commander_1.program);
-// RAG 索引管理
-(0, rag_index_1.registerRagIndexCommand)(commander_1.program);
-// 统一刷新所有检索层
-(0, refresh_1.registerRefreshCommand)(commander_1.program);
-(0, notify_1.registerNotifyCommand)(commander_1.program);
-(0, recommend_1.registerRecommendCommand)(commander_1.program);
 // 全量索引重建与一致性检查
 commander_1.program
     .command('reindex')
@@ -758,15 +672,6 @@ commander_1.program
 // ================================================================
 // 📦 归档与交接
 // ================================================================
-commander_1.program;
-commander_1.program
-    .command('handover')
-    .alias('ho')
-    .description('Generate handover documentation for current iteration')
-    .option('-i, --iteration <iteration>', 'Target iteration')
-    .option('-o, --output <path>', 'Output file path')
-    .option('--format <format>', 'Output format: md', 'md')
-    .action(handover_1.handoverCommand);
 commander_1.program
     .command('archive')
     .alias('ar')
@@ -803,7 +708,7 @@ commander_1.program
         // --arch: 委托给 arch-update 逻辑
         const it = await require('../core/context').getDefaultIteration(opts.iteration);
         if (it)
-            await (0, merge_check_1.updateArchitecture)(it, (opts.apis || '').split(',').filter(Boolean), (opts.tables || '').split(',').filter(Boolean));
+            await (0, update_1.updateArchitecture)(it, (opts.apis || '').split(',').filter(Boolean), (opts.tables || '').split(',').filter(Boolean));
         return;
     }
     return (0, update_1.updateCommand)(opts);
@@ -864,6 +769,7 @@ commander_1.program
     .option('--task <task>', '导入到指定 Task 目录')
     .option('--files <files>', '批量: "a.docx=平台1,b.pdf=平台2"')
     .option('--no-ai', '纯 pandoc 机械转换（终端快速模式）')
+    .option("--normalize", "按 SpecCore 标准标题体系重写标题（AI 语义调整，默认关闭；调整前版本快照 backup/）")
     .option("--prompt", "输出验证 Prompt 到 stdout（Skill 协作模式）")
     .option("--response <response>", "接收 AI 修正内容写入文件")
     .option("--classify", "AI 智能分类 sources/ 文档 → staging/（按类型提取）")
@@ -877,9 +783,10 @@ commander_1.program
     .alias('unitz')
     .description('切分需求文档为功能单元 → features/（独立能力；拆任务用 taskify）')
     .option('-f, --file <path>', '需求文档路径（.md，通常为 converted/*.md）')
-    .option('--files <files>', '批量: "a.md=平台1,b.md=平台2"')
+    .option('--files <files>', '批量: "a.md=平台1,b.md=平台2"（v8.3.334+ 支持 a.md=端@标题1|标题2 仅切指定标题）')
     .option('-c, --content <text>', '直接切分一段文档内容（自动写入 converted/，配合 --title 指定文档名）')
     .option('--title <name>', '内容切分时的文档标题/文件名（配合 --content；缺省取内容首个 H1）')
+    .option('--titles <names>', '仅切分指定标题的章节（逗号/顿号分隔标题名，模糊包含匹配；配合 --file/--files/--content）')
     .option('-i, --iter <name>', '目标迭代（缺省用当前活跃迭代）')
     .option('-p, --platform <name>', '平台标识（端名，缺省由 analyze 端推断）')
     .option("--translate-en <mode>", "单元标题英译: auto(默认) | host | off")
@@ -928,46 +835,8 @@ commander_1.program
     .option('--force', 'Overwrite existing pattern')
     .action(pattern_1.patternCommand);
 // ================================================================
-// 🔙 回滚
-// ================================================================
-commander_1.program
-    .command('rollback')
-    .alias('rb')
-    .description('Restore Spec files from .bak backups')
-    .option('-t, --task <task>', 'Target task')
-    .option('-i, --iteration <iteration>', 'Target iteration')
-    .option('--list', 'List backups only, do not restore')
-    .option('--confirm', 'Confirm restore (required to execute)')
-    .action(rollback_1.rollbackCommand);
-commander_1.program
-    .command('history')
-    .alias('hi')
-    .description('📜 历史记录：默认显示操作日志，--req 查看需求变更历史')
-    .option('--req <reqId>', '需求 ID，查看指定需求的变更历史')
-    .action(history_1.historyCommand);
-commander_1.program;
-// ================================================================
 // 🔗 P0/P1/P2 新增命令
 // ================================================================
-commander_1.program
-    .command('impact')
-    .alias('if')
-    .description('Intelligent impact analysis: analyze upstream/downstream effects of changes')
-    .option('--req <id>', 'Requirement ID (e.g., REQ-001)')
-    .option('--task <id>', 'Task ID (e.g., Task-001)')
-    .option('--depth <n>', 'Trace depth (default: 3)', '3')
-    .option('--output <format>', 'Output format: report, graph', 'report')
-    .action(impact_1.impactCommand);
-commander_1.program
-    .command('baseline')
-    .alias('bl')
-    .description('Version baseline: create snapshots, compare, list, and rollback')
-    .option('--name <name>', 'Baseline name')
-    .option('--list', 'List all baselines')
-    .option('--compare <name>', 'Compare current state with baseline')
-    .option('--restore <name>', 'Restore to baseline')
-    .option('--req <id>', 'Requirement ID for rollback')
-    .action(baseline_1.baselineCommand);
 commander_1.program
     .command('analyze')
     .alias('al')
@@ -1093,25 +962,6 @@ commander_1.program
     .action((input, opts) => {
     (0, req_doc_1.reqDocCommand)({ ...opts, input });
 });
-commander_1.program
-    .command('workspace')
-    .alias('ws')
-    .description('管理临时工作区（list/show/clean）')
-    .option('--list', '列出所有条目（默认）')
-    .option('--show <entryId>', '查看条目详情')
-    .option('--clean', '清理旧条目')
-    .option('--days <n>', '清理天数阈值（默认 30）')
-    .option('--type <type>', '过滤类型: clarify | research')
-    .action(workspace_1.workspaceCommand);
-commander_1.program
-    .command('audit')
-    .alias('ad')
-    .description('AI-powered audit: detect duplicates, ambiguity, and orphaned requirements')
-    .option('--fix', 'Auto-fix fixable issues')
-    .option('--detail', 'Show detailed analysis')
-    .option('--specs', 'Audit 020-specs/ quality: enum consistency, API path alignment, coverage gaps')
-    .option('-I, --iteration <name>', 'Target iteration for --specs audit')
-    .action(audit_1.auditCommand);
 // 重命名
 commander_1.program
     .command('rename')
@@ -1155,45 +1005,11 @@ commander_1.program
     .option("--prompt", "输出验收总结 Prompt 到 stdout（Skill 协作模式）")
     .option("--response <response>", "接收 AI 验收总结")
     .action(done_1.doneCommand);
-commander_1.program
-    .command('verdict')
-    .alias('vd')
-    .description('契约冲突裁决：查看冲突、人工裁决、查看裁决书')
-    .option('--list', '列出待裁决冲突')
-    .option('--conflict <id>', '指定冲突 ID 进行裁决')
-    .option('--decide <outcome>', '裁决结果: pass | pass-with-conditions | reject | defer')
-    .option('--reason <reason>', '裁决理由')
-    .option('--report <task>', '查看指定任务的裁决书')
-    .option('-t, --task <task>', '指定任务')
-    .option('-i, --iteration <iteration>', '指定迭代')
-    .action(verdict_1.verdictCommand);
 commander_1.program
     .command('completion [shell]')
     .alias('cmp')
     .description('Generate shell completion script (bash/zsh)')
     .action(completion_1.completionCommand);
-commander_1.program
-    .command('diff')
-    .alias('df')
-    .description('Compare two iterations or baselines')
-    .requiredOption('--source <name>', 'Source iteration/baseline')
-    .requiredOption('--target <name>', 'Target iteration/baseline')
-    .action(diff_1.diffCommand);
-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('track')
-    .alias('trk')
-    .description('REQ→Task→Code 全链路追踪')
-    .option('--req <id>', 'Trace from requirement ID')
-    .option('--task <id>', 'Trace from task ID')
-    .option('--full', 'Full project trace')
-    .action(trace_1.traceCommand);
 commander_1.program
     .command('delete')
     .alias('dl')
@@ -1262,7 +1078,40 @@ if (process.argv.length <= 2) {
                     nextDesc = '需求分析';
                 }
                 else {
-                    const tds = readdirSync(base).filter((d) => d.startsWith('Task-'));
+                    // v8.3.337+: 任务模块收集兼容新旧布局
+                    // （旧: 030-tasks/Task-* 或 Iteration 直接层；新: 030-tasks/{type}/{功能单元名}）
+                    const { isTaskModuleDirName } = require('./core/task-paths');
+                    const { statSync } = require('fs');
+                    const collectModules = (dir, depth) => {
+                        const out = [];
+                        try {
+                            for (const d of readdirSync(dir)) {
+                                if (d.startsWith('.') || d.startsWith('_'))
+                                    continue;
+                                const p = join(dir, d);
+                                let st;
+                                try {
+                                    st = statSync(p);
+                                }
+                                catch {
+                                    continue;
+                                }
+                                if (!st.isDirectory())
+                                    continue;
+                                if (d.startsWith('Task-') || (depth <= 1 && isTaskModuleDirName(d)))
+                                    out.push(p);
+                                else if (depth < 2)
+                                    out.push(...collectModules(p, depth + 1));
+                            }
+                        }
+                        catch { }
+                        return out;
+                    };
+                    const tasksRoot = join(base, '030-tasks');
+                    let tds = existsSync(tasksRoot) ? collectModules(tasksRoot, 0) : [];
+                    if (tds.length === 0) {
+                        tds = readdirSync(base).filter((d) => d.startsWith('Task-')).map((d) => join(base, d));
+                    }
                     if (tds.length === 0) {
                         phase = 'taskify';
                         nextCmd = 'speccore iteration taskify --iteration=' + iteration;
@@ -1270,36 +1119,45 @@ if (process.argv.length <= 2) {
                     }
                     else {
                         total = tds.length;
-                        for (const td of tds) {
-                            // 扫描子目录中的 TASK.md 判断任务状态
-                            const taskDirPath = join(base, td);
-                            let found = false;
-                            // 新结构: 扫描子目录中的 TASK.md
+                        // 递归探测 TASK.md（新旧子任务结构兼容，最多 4 层）
+                        const findDone = (dir, depth) => {
                             try {
-                                const subdirs = readdirSync(taskDirPath).filter((d) => !d.startsWith('.') && !d.startsWith('_') && !d.startsWith('9') &&
-                                    existsSync(join(taskDirPath, d)) &&
-                                    require('fs').statSync(join(taskDirPath, d)).isDirectory());
-                                for (const sd of subdirs) {
-                                    const subTask = join(taskDirPath, sd, 'TASK.md');
-                                    if (existsSync(subTask) && readFileSync(subTask, 'utf-8').includes('已完成')) {
-                                        found = true;
-                                        break;
+                                for (const d of readdirSync(dir)) {
+                                    if (d.startsWith('.') || d.startsWith('_'))
+                                        continue;
+                                    const p = join(dir, d);
+                                    let st;
+                                    try {
+                                        st = statSync(p);
+                                    }
+                                    catch {
+                                        continue;
+                                    }
+                                    if (st.isDirectory()) {
+                                        if (depth < 4 && findDone(p, depth + 1))
+                                            return true;
+                                    }
+                                    else if (d === 'TASK.md' && readFileSync(p, 'utf-8').includes('已完成')) {
+                                        return true;
                                     }
                                 }
                             }
                             catch { }
-                            if (found)
+                            return false;
+                        };
+                        for (const td of tds) {
+                            if (findDone(td, 0))
                                 done2++;
                         }
                         if (done2 < total) {
                             phase = 'dev';
-                            nextCmd = 'speccore execute --task=' + tds[done2] + ' --force';
+                            nextCmd = 'speccore execute --task=' + tds[done2].split('/').pop() + ' --force';
                             nextDesc = '执行开发 (' + (done2 + 1) + '/' + total + ')';
                         }
                         else {
                             phase = 'done';
                             nextCmd = 'speccore pr';
-                            nextDesc = '创建 PR 提交代码';
+                            nextDesc = '创建 PR 提交 代码';
                         }
                     }
                 }