speccore 8.3.333 → 8.3.341

package/dist/commands/iteration/taskify.js

@@ -48,6 +48,8 @@ const readline_1 = require("readline");
 const prompt_builder_1 = require("../../core/prompt-builder");
 const index_guard_1 = require("../../core/index-guard");
 const spec_paths_1 = require("../../core/spec-paths");
+const task_paths_1 = require("../../core/task-paths");
+const unit_staffing_1 = require("../../core/unit-staffing");
 const spec_skeleton_1 = require("../../core/spec-skeleton");
 const questions_1 = require("../../core/questions");
 const pipeline_engine_1 = require("../../core/pipeline-engine");
@@ -232,14 +234,26 @@ function buildTaskTopic(sec, taskType) {
     return (0, global_counters_1.toSlug)(sec.name);
 }
 /**
- * 生成子任务全局唯一 ID
- * 格式: Task-{父任务尾段}-{端名}
- * 例: Task-033-login-flow-booking-service（父任务 ID Task-033-login-flow 去 Task- 前缀后接端名）
+ * v8.3.337+: 解析模块目录名——功能单元目录名直接对齐（与 features/、020-specs/ 一致），
+ * 去掉 Task-NNN 计数器序号。非目录名格式（自创英文名/中文名）返回空，回退原 topic 链。
+ * 目录名格式校验：小写字母/数字/连字符组成（功能单元命名 v8.3.271+ 契约）。
  */
-function generateSubtaskId(parentTaskId, platform) {
-    // v6.49.5+ / v8.3.10+：确定性格式 {taskId}-{platform}，保证全项目唯一
-    // 因为每个任务每个端只有一个子任务，所以 {taskId}-{platform} 已经唯一
-    return `Task-${parentTaskId}-${platform}`;
+function resolveModuleDirName(sec) {
+    const functionalUnit = sec?.functionalUnit || '';
+    if (functionalUnit && /^[a-z0-9][a-z0-9-]*[a-z0-9]$/.test(functionalUnit)) {
+        return functionalUnit;
+    }
+    return '';
+}
+/**
+ * 生成子任务目录名（v8.3.337+ 改造）
+ * 格式: Task-{模块名}——与模块目录名（功能单元名）一致，不再拼端名。
+ * 端名已由目录层级承载（{模块}/{端}/{子任务}），拼入子任务 ID 是冗余；
+ * 多端同名子任务分处不同端目录无目录冲突，Git 分支重名由 createTaskBranch hash 兜底。
+ * 例: 模块 admin-web-01-yudingguanli → 子任务 Task-admin-web-01-yudingguanli
+ */
+function generateSubtaskId(moduleDirName) {
+    return `Task-${moduleDirName}`;
 }
 /** 拆分约束常量（简化版：每个功能单元按涉及的端拆分，每端1个子任务） */
 const SPLIT_RULES = {
@@ -1084,9 +1098,15 @@ async function iterationTaskifyCommand(options) {
                 const aiIdToTaskId = new Map();
                 for (const sec of sections) {
                     // v8.3.294+: bugfix 任务目录名拼「模块英文-内容英文」，其余类型保持原链
+                    // v8.3.337+: 模块目录名优先对齐功能单元目录名（无计数器），非目录名回退原链
                     const taskType = sec._taskType || 'feature';
                     const taskTopic = buildTaskTopic(sec, taskType);
-                    const { id: taskId } = await (0, global_counters_1.nextTaskId)(sec.name, taskTopic);
+                    const moduleName = resolveModuleDirName(sec);
+                    let taskId;
+                    if (moduleName)
+                        taskId = moduleName;
+                    else
+                        taskId = (await (0, global_counters_1.nextTaskId)(sec.name, taskTopic)).id;
                     sec._taskId = taskId;
                     const aiId = sec._aiId;
                     if (aiId)
@@ -1533,12 +1553,17 @@ async function iterationTaskifyCommand(options) {
         }
         logger_1.logger.info(`Found ${sections.length} sections to split`);
         logger_1.logger.info(`Platforms: ${platforms.join(', ')}`);
-        // ── 预分配任务 ID（确保所有路径使用计数器，避免编号重复） ──
+        // ── 预分配任务 ID（v8.3.337+: 模块目录名优先对齐功能单元目录名）──
         for (const section of sections) {
             // v8.3.294+: bugfix 任务目录名拼「模块英文-内容英文」，其余类型保持原链
             const taskType = section._taskType || 'feature';
             const topic = buildTaskTopic(section, taskType);
-            const { id: taskId } = await (0, global_counters_1.nextTaskId)(section.name, topic);
+            const moduleName = resolveModuleDirName(section);
+            let taskId;
+            if (moduleName)
+                taskId = moduleName;
+            else
+                taskId = (await (0, global_counters_1.nextTaskId)(section.name, topic)).id;
             section._taskId = taskId;
         }
         // ── Strict mode: preview + confirm each task's split plan ──
@@ -1959,11 +1984,11 @@ async function createTaskFromSection(iterationDir, taskId, section, allPlatforms
         logger_1.logger.warn(`   ⚠️  未找到 020-specs/ 分析文档，任务级 REQ.md/TECH.md 将生成空模板`);
         logger_1.logger.warn(`      建议先运行: speccore analyze -I ${iterationName} --auto`);
     }
-    // 预生成所有端的子任务 ID（保证同一端在所有文件中 ID 一致）
+    // 预生成所有端的子任务 ID（子任务名 = Task-{模块名}，不拼端名）
     const taskNum = taskId.replace(/^Task-/, '');
     const subtaskIdMap = new Map();
     for (const p of taskPlatforms) {
-        subtaskIdMap.set(p, generateSubtaskId(taskNum, p));
+        subtaskIdMap.set(p, generateSubtaskId(taskNum));
     }
     // ── 1. 任务目录指引（功能模块分组） ──
     await (0, fs_extra_1.ensureDir)(taskDir);
@@ -2565,7 +2590,7 @@ ${!isBk && docSet.hasComponentTree ? '| COMPONENT_TREE.md | ⏳ | ./COMPONENT_TR
         // 从端列表查找第一个后端端名作为 fallback（v6.48.0+）
         const allPlatforms = await (0, spec_paths_1.parsePlatformList)();
         const fallbackBackend = allPlatforms.find(p => p === 'backend' || p.startsWith('后台') || /-(service|api|server|backend)$/i.test(p)) || 'backend';
-        const fallbackSubtaskId = subtaskIdMap.get(fallbackBackend) || generateSubtaskId(taskNum, fallbackBackend);
+        const fallbackSubtaskId = subtaskIdMap.get(fallbackBackend) || generateSubtaskId(taskNum);
         const autoSubtaskDir = (0, path_1.join)(taskDir, fallbackBackend, fallbackSubtaskId);
         await (0, fs_extra_1.ensureDir)((0, path_1.join)(autoSubtaskDir, '.meta'));
         await (0, fs_extra_1.writeFile)((0, path_1.join)(autoSubtaskDir, '.meta', 'type'), taskType);
@@ -2585,7 +2610,7 @@ ${!isBk && docSet.hasComponentTree ? '| COMPONENT_TREE.md | ⏳ | ./COMPONENT_TR
         await (0, fs_extra_1.writeFile)((0, path_1.join)(autoSubtaskDir, 'TASK.md'), `# ${section.name} — ${fallbackBackend}（自动补充）
 
 ## 子任务信息
-- **子任务 ID**: \`${taskId}-${fallbackBackend}-auto\`
+- **子任务 ID**: \`${fallbackSubtaskId}-auto\`
 - **所属模块**: \`${taskId}\`
 - **功能单元**: ${featureName}
 - **端**: ${fallbackBackend}
@@ -2608,7 +2633,8 @@ ${!isBk && docSet.hasComponentTree ? '| COMPONENT_TREE.md | ⏳ | ./COMPONENT_TR
         if (docSet.hasMonitor)
             await (0, fs_extra_1.writeFile)((0, path_1.join)(autoSubtaskDir, 'MONITOR.md'), generateMonitorTemplate(section, monitorMaterial));
         taskPlatforms.push(fallbackBackend);
-        subtaskIdMap.set(fallbackBackend, `${taskId}-${fallbackBackend}-auto`);
+        // 自动补充的后端子任务名也遵循 Task-{模块名}-auto（后缀区分自动补充来源）
+        subtaskIdMap.set(fallbackBackend, `${fallbackSubtaskId}-auto`);
     }
     // ─ 5. 任务上下文 CONTEXT.md ─
     const sourceFile = section._sourceFile || '';
@@ -4131,6 +4157,8 @@ function readStaffing(iterationDir) {
         name: m.name,
         platforms: m.directions,
         capacity: m.capacity,
+        roles: m.roles,
+        initials: m.initials,
     }));
     return members.length > 0 ? members : null;
 }
@@ -4163,25 +4191,86 @@ async function resolveUnitOwnerFromMatrix(iterationDir, sectionName, platform) {
     return undefined;
 }
 /**
- * 根据平台和负荷自动推荐负责人
+ * 端名 → 需求岗位映射（v8.3.337+）：按端名关键词推断技术岗位维度。
+ * 用于 autoAssign 双维匹配——岗位（技术栈维度）+ 方向（业务端维度）正交筛选。
+ */
+function platformToRoles(platform) {
+    const p = platform.toLowerCase();
+    const roles = [];
+    if (/web|admin|h5|frontend|pc|小程序/.test(p))
+        roles.push('web');
+    if (/service|api|server|backend|后台/.test(p))
+        roles.push('后端');
+    if (/app|mobile|移动|android|ios/.test(p))
+        roles.push('移动端');
+    return roles;
+}
+/** 岗位别名归一（成员表自由填写：web/前端、后端/服务端、移动端/APP 同义） */
+const ROLE_ALIASES = {
+    'web': ['前端', 'frontend'],
+    '后端': ['backend', '服务端', 'server'],
+    '移动端': ['mobile', 'app'],
+};
+/** 成员岗位是否命中任务所需岗位之一（v8.3.339+: 通配成员恒命中） */
+function memberRoleMatches(memberRoles, needRoles) {
+    if (needRoles.length === 0 || memberRoles.length === 0)
+        return false;
+    if (memberRoles.includes(unit_staffing_1.WILDCARD))
+        return true; // 全栈成员岗位恒命中
+    for (const need of needRoles) {
+        const n = need.toLowerCase();
+        const aliases = ROLE_ALIASES[n] ?? [];
+        for (const r of memberRoles) {
+            const rl = r.toLowerCase();
+            if (rl === n || rl.includes(n) || n.includes(rl))
+                return true;
+            if (aliases.some((a) => rl.includes(a.toLowerCase()) || a.toLowerCase().includes(rl)))
+                return true;
+        }
+    }
+    return false;
+}
+/**
+ * 根据平台和负荷自动推荐负责人（v8.3.337+ 双维匹配）
+ *
+ * 三级匹配（从严格到宽松，同级内取负荷最低者）：
+ *   1. 岗位+方向双命中（技术栈与业务端都对口）
+ *   2. 仅方向命中（沿用 v8.3.319 语义）
+ *   3. 仅岗位命中（方向未声明但技术栈对口）
+ * 均无命中 → 未分配。已剔除「不在项目」成员（loadStaffing 过滤）。
  */
 function autoAssign(section, platforms, staffing) {
     const targetPlatform = section.platform || '';
     if (!targetPlatform || !staffing.length)
         return '未分配';
-    // 找到匹配平台的、负荷最低的人
-    let best = null;
-    let bestLoad = Infinity;
-    for (const m of staffing) {
-        if (m.capacity <= 0)
-            continue; // v8.3.319: 投入比例 0% = 本迭代不参与分配（如休假）
-        const platformMatch = m.platforms.some(p => targetPlatform.includes(p) || p.includes(targetPlatform));
-        if (platformMatch && m.capacity < bestLoad) {
-            best = m;
-            bestLoad = m.capacity;
-        }
-    }
-    return best ? best.name : '未分配';
+    const needRoles = platformToRoles(targetPlatform);
+    const pickLowest = (candidates) => {
+        let best = null;
+        let bestLoad = Infinity;
+        for (const m of candidates) {
+            if (m.capacity <= 0)
+                continue; // v8.3.319: 投入比例 0% = 本迭代不参与分配（如休假）
+            if (m.capacity < bestLoad) {
+                best = m;
+                bestLoad = m.capacity;
+            }
+        }
+        return best;
+    };
+    const directionHit = (m) => m.platforms.includes(unit_staffing_1.WILDCARD) || // v8.3.339+: 通配方向恒命中（全栈成员兜底）
+        m.platforms.some((p) => targetPlatform.includes(p) || p.includes(targetPlatform));
+    const roleHit = (m) => memberRoleMatches(m.roles, needRoles);
+    // 1. 岗位+方向双命中
+    const dual = pickLowest(staffing.filter((m) => directionHit(m) && roleHit(m)));
+    if (dual)
+        return dual.name;
+    // 2. 仅方向命中
+    const dirOnly = pickLowest(staffing.filter(directionHit));
+    if (dirOnly)
+        return dirOnly.name;
+    // 3. 仅岗位命中
+    const roleOnly = pickLowest(staffing.filter(roleHit));
+    return roleOnly ? roleOnly.name : '未分配';
 }
 /**
  * 分析章节复杂度，决定优先级和工时（简化版）
@@ -4249,24 +4338,27 @@ async function detectExistingTasks(iterDir) {
     // 优先从 030-tasks/ 扫描
     const scanDir = (0, path_1.join)(iterDir, '030-tasks');
     const targetDir = (await (0, fs_extra_1.pathExists)(scanDir)) ? scanDir : iterDir;
-    const scanRecursive = async (dir) => {
+    // v8.3.337+: 新布局模块目录名=功能单元名（无 Task- 前缀），位于类型子目录直接层
+    // （030-tasks/{type}/{模块}）。depth ≤ 1 时按功能单元名识别为模块并停止深入，
+    // 避免误把端目录/子任务目录当任务收集。旧布局 030-tasks/Task-* 仍按前缀识别。
+    const scanRecursive = async (dir, depth) => {
         try {
             const entries = await (0, fs_extra_1.readdir)(dir, { withFileTypes: true });
             for (const e of entries) {
                 if (e.isDirectory()) {
-                    if (e.name.startsWith('Task-')) {
+                    if (e.name.startsWith('Task-') || (depth <= 1 && (0, task_paths_1.isTaskModuleDirName)(e.name))) {
                         tasks.push(e.name);
                     }
                     else if (!e.name.startsWith('.')) {
                         // 递归扫描类型子目录（feature/bugfix/refactor/research）
-                        await scanRecursive((0, path_1.join)(dir, e.name));
+                        await scanRecursive((0, path_1.join)(dir, e.name), depth + 1);
                     }
                 }
             }
         }
         catch { }
     };
-    await scanRecursive(targetDir);
+    await scanRecursive(targetDir, 0);
     return tasks;
 }
 /**
@@ -4294,7 +4386,8 @@ async function pruneTasksByModules(iterDir, modules) {
                 if (!e.isDirectory())
                     continue;
                 const full = (0, path_1.join)(dir, e.name);
-                if (e.name.startsWith('Task-')) {
+                // v8.3.337+: 新布局模块目录=功能单元名（无 Task- 前缀），同样按 .meta/feature 匹配
+                if (e.name.startsWith('Task-') || (0, task_paths_1.isTaskModuleDirName)(e.name)) {
                     let feature = '';
                     try {
                         feature = (await (0, fs_extra_1.readFile)((0, path_1.join)(full, '.meta', 'feature'), 'utf-8')).trim();
@@ -5054,7 +5147,12 @@ async function tryModuleDrivenSplit(iteration, iterationDir, options) {
     // 逐模块创建任务目录（按模块各自的涉及端）
     const createdSections = [];
     for (const mod of modules) {
-        const { id: taskId } = await (0, global_counters_1.nextTaskId)(mod.name, mod.slug);
+        // v8.3.337+: 模块目录名优先对齐功能单元目录名（mod.name 即功能单元名）
+        let taskId;
+        if (mod.name && /^[a-z0-9][a-z0-9-]*[a-z0-9]$/.test(mod.name))
+            taskId = mod.name;
+        else
+            taskId = (await (0, global_counters_1.nextTaskId)(mod.name, mod.slug)).id;
         const modPlatforms = mod.platforms.length > 0 ? mod.platforms : [...allPlatforms];
         // v8.3.249+: section.content 从 sourceFile（SOURCE.md 等）读取——此前硬编码空串，
         // 导致 REQ.md 四级回退全部落空（aiReq/analyzeReq/短 section.content 均不满足），