@xulthekl/team-flow 0.34.0 → 0.34.1

package/.claude/always/phase-guard.md

@@ -1,3 +1,3 @@
-# team-flow v0.34.0 | 阶段: {{state}} | 工作流: {{workflow}}
+# team-flow v0.34.1 | 阶段: {{state}} | 工作流: {{workflow}}
 当前阶段允许的操作由 workflow-start 路由规则定义。
 禁止跨越 DP gate 进入下一阶段。变更范围以 execution-contract.md 的 Intent Lock 为准。

package/.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
     {
       "name": "team-flow",
       "description": "8-state spec workflow + compound global compounding + architecture-design (4A/DDD) + local HTML prototype + product-level orchestration + bootstrap + e2e + session handoff + workflow feedback. 24 skills + 15 agents with embedded TDD, SDD, code review, debugging, delta spec sync, and design-system-driven prototyping.",
-      "version": "0.34.0",
+      "version": "0.34.1",
       "source": "./",
       "author": {
         "name": "LT",

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "team-flow",
-  "version": "0.34.0",
+  "version": "0.34.1",
   "description": "Unified workflow plugin: team-flow (spec-driven dev: TDD/SDD/code-review/debugging) + compound-engineering core subset (brainstorm/plan/compound/strategy/ideate/proof, global compounding) + architecture-design (4A+DDD incremental design & global compounding) + prototype (local HTML prototype, zero external deps) + e2e (Playwright E2E, AC-driven) + workflow-orchestrator (product-level workflow orchestration) + workflow-bootstrap (existing project onboarding) + session-handoff (context transfer) + workflow-feedback (issue tracking). 24 skills + 15 agents, one install.",
   "source": "./",
   "author": {

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "team-flow",
-  "version": "0.34.0",
+  "version": "0.34.1",
   "description": "Spec-first workflow that bridges OpenSpec-style planning and Superpowers-style execution discipline.",
   "author": {
     "name": "MageByte",

package/.cursor-plugin/marketplace.json

@@ -5,7 +5,7 @@
   },
   "metadata": {
     "description": "Unified workflow plugin marketplace for Cursor (team-flow: team-flow + compound + architecture-design + prototype).",
-    "version": "0.34.0"
+    "version": "0.34.1"
   },
   "plugins": [
     {

package/.cursor-plugin/plugin.json

@@ -2,7 +2,7 @@
   "name": "team-flow",
   "displayName": "team-flow",
   "description": "Unified workflow plugin: team-flow (spec-driven dev: TDD/SDD/code-review/debugging) + compound-engineering core subset (brainstorm/plan/compound/strategy/ideate/proof, global compounding) + architecture-design (4A+DDD incremental design & global compounding) + prototype (local HTML prototype, zero external deps) + e2e (Playwright E2E, AC-driven) + workflow-orchestrator (product-level workflow orchestration) + workflow-bootstrap (existing project onboarding) + session-handoff (context transfer) + workflow-feedback (issue tracking). 24 skills + 15 agents, one install.",
-  "version": "0.34.0",
+  "version": "0.34.1",
   "author": {
     "name": "LT",
     "url": "https://github.com/LT"

package/.github/plugin/marketplace.json

@@ -6,13 +6,13 @@
   },
   "metadata": {
     "description": "Unified workflow plugins and skills for AI coding agents (team-flow: team-flow + compound + architecture-design + prototype).",
-    "version": "0.34.0"
+    "version": "0.34.1"
   },
   "plugins": [
     {
       "name": "team-flow",
       "description": "Unified workflow with planning artifacts, execution contracts, TDD, review gates, systematic debugging, delta spec sync, architecture-design, and local HTML prototyping.",
-      "version": "0.34.0",
+      "version": "0.34.1",
       "source": ".",
       "author": {
         "name": "LT",

package/CHANGELOG.md

@@ -6,6 +6,28 @@ The format loosely follows Keep a Changelog.
 
 ## [Unreleased]
 
+## [0.34.1] - 2026-08-04
+
+### Added（工作空间支持——conventions-generator 支持多子项目扫描）
+
+#### 工作空间扫描（v0.34.1 核心特性）
+- **scripts/lib/conventions-generator.mjs**：新增工作空间模式
+  - `scanSubProjects(root)`：扫描工作空间中的所有子项目
+  - `aggregateTechStacks(subProjects)`：汇总所有子项目的技术栈
+  - `selectTemplatesForWorkspace(aggregatedTechStack)`：为工作空间选择 conventions 模板
+  - `run()` 函数支持自动检测工作空间模式（子项目 > 1 时进入）
+  - 输出模式标识：`mode: 'workspace'` 或 `mode: 'single'`
+
+#### 使用场景
+- **前后端分离项目**：Java 后端 + Vue 前端 → 生成 Java + JavaScript conventions
+- **多语言项目**：Java 后端 + Python 脚本 + JavaScript 前端 → 生成三种语言 conventions
+- **单项目兼容**：原有单项目逻辑完全保留
+
+### Tests
+- **tests/lib/conventions-generator.test.mjs**：新增 12 个测试（scanSubProjects: 4 / aggregateTechStacks: 3 / selectTemplatesForWorkspace: 5）
+- 全量回归：583/583 通过（含 27 个 conventions-generator 测试）
+- check-versions ✅
+
 ## [0.34.0] - 2026-08-04
 
 ### Added（测试能力增强——吸收 glaf4-test 通用能力 + conventions 机制，设计见工作区级文档 team-flow-workspace/docs/plan/test-capability-enhancement-design.md）

package/GEMINI.md

@@ -8,7 +8,7 @@ The workflow is self-contained and does not require OpenSpec or Superpowers at r
 
 
 <!-- team-flow-phase-guard-start -->
-# team-flow v0.34.0 | 阶段: {{state}} | 工作流: {{workflow}}
+# team-flow v0.34.1 | 阶段: {{state}} | 工作流: {{workflow}}
 当前阶段允许的操作由 workflow-start 路由规则定义。
 禁止跨越 DP gate 进入下一阶段。变更范围以 execution-contract.md 的 Intent Lock 为准。
 <!-- team-flow-phase-guard-end -->

package/INSTALL.md

@@ -7,7 +7,7 @@
 - [Fission-AI/OpenSpec](https://github.com/Fission-AI/OpenSpec) — 规划引擎（Schema 验证、Delta Spec、工件解析）
 - [obra/superpowers](https://github.com/obra/superpowers) — 执行纪律（TDD 铁律、SDD、系统化调试、代码审查）
 
-当前发布版本：**v0.34.0**。
+当前发布版本：**v0.34.1**。
 
 ---
 

package/README.md

@@ -1,6 +1,6 @@
 # team-flow
 
-> 当前版本：`v0.34.0`
+> 当前版本：`v0.34.1`
 
 > 统一插件：**team-flow**（spec 驱动开发）+ **compound-engineering 核心子集**（全局复利）+ **architecture-design**（4A+DDD 增量设计）+ **prototype**（本地 HTML 原型）+ **e2e**（AC 驱动 E2E）+ **workflow-orchestrator**（产品级编排）+ **workflow-bootstrap**（既有项目接入）。一次安装，七套能力协同。
 

package/docs/README_en.md

@@ -126,7 +126,7 @@ npm install -g team-flow
 
 ### Version
 
-- Current: `v0.34.0`
+- Current: `v0.34.1`
 - v0.9.1 highlights: DP-4 execution-mode recommendations, a portable runtime across 17 platforms, and a raw-package smoke with no plugin-root variable.
 - Self-contained — no OpenSpec or Superpowers runtime required
 - Upstream: [Fission-AI/OpenSpec](https://github.com/Fission-AI/OpenSpec), [obra/superpowers](https://github.com/obra/superpowers)

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "team-flow",
   "description": "Unified workflow plugin: team-flow (spec-driven dev) + compound-engineering core subset + architecture-design (4A/DDD) + prototype (local HTML). 24 skills, one install.",
-  "version": "0.34.0",
+  "version": "0.34.1",
   "contextFileName": "GEMINI.md"
 }

package/hooks/session-start

@@ -1,11 +1,11 @@
 #!/usr/bin/env bash
-# v0.34.0: auto-sync CLI version with plugin version
+# v0.34.1: auto-sync CLI version with plugin version
 set -e
 
 # ═══════════════════════════════════════════════════════════════
 # Plugin version (update this when releasing new versions)
 # ═══════════════════════════════════════════════════════════════
-PLUGIN_VERSION="0.34.0"
+PLUGIN_VERSION="0.34.1"
 
 # ═══════════════════════════════════════════════════════════════
 # Step 1: Auto-sync CLI version with plugin version

package/llms.txt

@@ -3,7 +3,7 @@
 ## Overview
 spec-superflow is a self-contained workflow integration plugin for Claude Code, Cursor, OpenAI Codex CLI/App, GitHub Copilot CLI, Gemini CLI, OpenCode, WorkBuddy, and Trae. It merges spec-driven planning artifacts (proposal, specs, design, tasks) with disciplined execution guardrails (TDD, review gates, controlled handoff) into one unified workflow.
 
-Current version: v0.34.0.
+Current version: v0.34.1.
 
 ## Key Documents
 - README.md: Chinese homepage with full usage guide and FAQ

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xulthekl/team-flow",
-  "version": "0.34.0",
+  "version": "0.34.1",
   "description": "Unified plugin (24 skills + 15 agents) integrating team-flow, compound-engineering, architecture-design, prototype, design-system, workflow-orchestrator, workflow-bootstrap, e2e, session-handoff, workflow-feedback for multi-agent coding tools.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "team-flow",
-  "version": "0.34.0",
+  "version": "0.34.1",
   "description": "Unified workflow plugin: team-flow (spec-driven dev: TDD/SDD/code-review/debugging) + compound-engineering core subset (brainstorm/plan/compound/strategy/ideate/proof, global compounding) + architecture-design (4A+DDD incremental design & global compounding) + prototype (local HTML prototype, zero external deps) + e2e (Playwright E2E, AC-driven) + workflow-orchestrator (product-level workflow orchestration) + workflow-bootstrap (existing project onboarding) + session-handoff (context transfer) + workflow-feedback (issue tracking). 24 skills + 15 agents, one install.",
   "author": {
     "name": "LT"

package/scripts/lib/conventions-generator.mjs

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
-// scripts/lib/conventions-generator.mjs — conventions 生成器（v0.34.0 新增）
+// scripts/lib/conventions-generator.mjs — conventions 生成器（v0.34.0 新增，v0.34.1 工作空间支持）
 //
 // 根据项目技术栈自动生成测试规范 conventions，符合 glaf4-test 要求。
-// 支持存量项目（自动识别）和全新项目（交互式引导）。
+// 支持存量项目（自动识别）、全新项目（交互式引导）和工作空间（多子项目）。
 //
 // 使用方式：
 //   node scripts/lib/conventions-generator.mjs --root <项目根目录> [--interactive]
 //
-// 设计来源：test-capability-enhancement-design v1.0 §四
+// 设计来源：test-capability-enhancement-design v1.0 §四 + §55.4
 
 import { existsSync, mkdirSync, readFileSync, writeFileSync, readdirSync } from 'node:fs';
 import path, { join } from 'node:path';
@@ -98,6 +98,102 @@ export function detectTechStack(root) {
   return result;
 }
 
+// ── 工作空间扫描 ─────────────────────────────────────────────────────────
+
+/**
+ * 扫描工作空间中的所有子项目
+ * @param {string} root 工作空间根目录
+ * @returns {Array<{ path: string, name: string, techStack: object }>}
+ */
+export function scanSubProjects(root) {
+  const subProjects = [];
+
+  // 扫描一级子目录
+  const entries = readdirSync(root, { withFileTypes: true });
+
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    if (entry.name.startsWith('.') || entry.name === 'node_modules') continue;
+
+    const subProjectPath = join(root, entry.name);
+    const techStack = detectTechStack(subProjectPath);
+
+    // 如果检测到技术栈，记录为子项目
+    if (techStack.language) {
+      subProjects.push({
+        path: subProjectPath,
+        name: entry.name,
+        techStack,
+      });
+    }
+  }
+
+  return subProjects;
+}
+
+/**
+ * 汇总所有子项目的技术栈
+ * @param {Array<{ path: string, name: string, techStack: object }>} subProjects
+ * @returns {{ language: string|null, buildTool: string|null, testFramework: string|null, appFramework: string|null, languages: string[], appFrameworks: string[] }}
+ */
+export function aggregateTechStacks(subProjects) {
+  const languages = new Set();
+  const buildTools = new Set();
+  const testFrameworks = new Set();
+  const appFrameworks = new Set();
+
+  for (const { techStack } of subProjects) {
+    if (techStack.language) languages.add(techStack.language);
+    if (techStack.buildTool) buildTools.add(techStack.buildTool);
+    if (techStack.testFramework) testFrameworks.add(techStack.testFramework);
+    if (techStack.appFramework) appFrameworks.add(techStack.appFramework);
+  }
+
+  return {
+    // 主技术栈（第一个子项目）
+    language: subProjects[0]?.techStack.language || null,
+    buildTool: subProjects[0]?.techStack.buildTool || null,
+    testFramework: subProjects[0]?.techStack.testFramework || null,
+    appFramework: subProjects[0]?.techStack.appFramework || null,
+    // 汇总列表
+    languages: [...languages],
+    appFrameworks: [...appFrameworks],
+  };
+}
+
+/**
+ * 为工作空间选择 conventions 模板
+ * @param {{ languages: string[], appFrameworks: string[] }} aggregatedTechStack
+ * @returns {string[]} 模板文件名列表
+ */
+export function selectTemplatesForWorkspace(aggregatedTechStack) {
+  const templates = [];
+
+  // Java 相关
+  if (aggregatedTechStack.languages.includes('java')) {
+    if (existsSync(join(GLAF4_TEMPLATE_DIR, 'java-testing.md'))) {
+      templates.push('glaf4-compliant/java-testing.md');
+    }
+    if (aggregatedTechStack.appFrameworks.includes('spring-boot')) {
+      if (existsSync(join(GLAF4_TEMPLATE_DIR, 'spring-patterns.md'))) {
+        templates.push('glaf4-compliant/spring-patterns.md');
+      }
+    }
+  }
+
+  // JavaScript 相关
+  if (aggregatedTechStack.languages.includes('javascript')) {
+    templates.push('js-testing.md');
+  }
+
+  // Python 相关
+  if (aggregatedTechStack.languages.includes('python')) {
+    templates.push('python-testing.md');
+  }
+
+  return templates;
+}
+
 // ── 模板选择 ─────────────────────────────────────────────────────────────
 
 /**
@@ -290,54 +386,120 @@ export async function run(args) {
     process.exit(0);
   }
 
-  // 检测技术栈
-  let techStack = detectTechStack(root);
+  // 检测是否为工作空间（包含多个子项目）
+  const subProjects = scanSubProjects(root);
 
-  // 如果未检测到技术栈且启用交互式模式
-  if (!techStack.language && values.interactive) {
-    techStack = await interactiveSetup();
-  }
+  if (subProjects.length > 1) {
+    // 工作空间模式：扫描所有子项目
+    console.log(`\n=== 检测到工作空间（${subProjects.length} 个子项目）===\n`);
 
-  // 如果仍未检测到技术栈
-  if (!techStack.language) {
-    console.error('❌ 未检测到技术栈特征');
-    console.error('   请指定项目根目录，或使用 --interactive 模式手动配置');
-    process.exit(1);
-  }
+    for (const { name, techStack } of subProjects) {
+      console.log(`  - ${name}: ${techStack.language}`);
+    }
 
-  // 选择模板
-  const templates = selectTemplates(techStack);
+    // 汇总技术栈
+    const aggregatedTechStack = aggregateTechStacks(subProjects);
 
-  if (templates.length === 0) {
-    console.error('❌ 未找到匹配的 conventions 模板');
-    console.error(`   技术栈: ${JSON.stringify(techStack)}`);
-    process.exit(1);
-  }
+    // 选择模板
+    const templates = selectTemplatesForWorkspace(aggregatedTechStack);
+
+    if (templates.length === 0) {
+      console.error('❌ 未找到匹配的 conventions 模板');
+      console.error(`   检测到的语言: ${aggregatedTechStack.languages.join(', ')}`);
+      process.exit(1);
+    }
+
+    // 生成 conventions
+    const result = generateConventions(root, aggregatedTechStack, templates);
+
+    // 更新配置
+    updateConfig(root, result.created);
+
+    // 输出结果
+    if (values.json) {
+      console.log(JSON.stringify({
+        ok: true,
+        mode: 'workspace',
+        subProjects: subProjects.map(p => ({ name: p.name, language: p.techStack.language })),
+        aggregatedTechStack: {
+          languages: aggregatedTechStack.languages,
+          appFrameworks: aggregatedTechStack.appFrameworks,
+        },
+        templates,
+        created: result.created,
+        skipped: result.skipped,
+        conventionsDir,
+      }));
+    } else {
+      console.log('\n✅ 工作空间级 conventions 生成完成');
+      console.log(`   检测到的语言：${aggregatedTechStack.languages.join(', ')}`);
+      console.log(`   创建：${result.created.join(', ')}`);
+      if (result.skipped.length > 0) {
+        console.log(`   跳过：${result.skipped.join(', ')}`);
+      }
+      console.log(`   路径：${conventionsDir}`);
+    }
 
-  // 生成 conventions
-  const result = generateConventions(root, techStack, templates);
-
-  // 更新配置
-  updateConfig(root, result.created);
-
-  // 输出结果
-  if (values.json) {
-    console.log(JSON.stringify({
-      ok: true,
-      techStack,
-      templates,
-      created: result.created,
-      skipped: result.skipped,
-      conventionsDir,
-    }));
   } else {
-    console.log('✅ conventions 生成完成');
-    console.log(`   技术栈: ${techStack.language} + ${techStack.testFramework}`);
-    console.log(`   创建: ${result.created.join(', ')}`);
-    if (result.skipped.length > 0) {
-      console.log(`   跳过: ${result.skipped.join(', ')}`);
+    // 单项目模式
+    let techStack;
+
+    if (subProjects.length === 1) {
+      // 从子项目检测
+      techStack = subProjects[0].techStack;
+      console.log(`\n=== 检测到单项目：${subProjects[0].name} ===\n`);
+    } else {
+      // 从根目录检测
+      techStack = detectTechStack(root);
+    }
+
+    // 如果未检测到技术栈且启用交互式模式
+    if (!techStack.language && values.interactive) {
+      techStack = await interactiveSetup();
+    }
+
+    // 如果仍未检测到技术栈
+    if (!techStack.language) {
+      console.error('❌ 未检测到技术栈特征');
+      console.error('   请指定项目根目录，或使用 --interactive 模式手动配置');
+      process.exit(1);
+    }
+
+    // 选择模板
+    const templates = selectTemplates(techStack);
+
+    if (templates.length === 0) {
+      console.error('❌ 未找到匹配的 conventions 模板');
+      console.error(`   技术栈: ${JSON.stringify(techStack)}`);
+      process.exit(1);
+    }
+
+    // 生成 conventions
+    const result = generateConventions(root, techStack, templates);
+
+    // 更新配置
+    updateConfig(root, result.created);
+
+    // 输出结果
+    if (values.json) {
+      console.log(JSON.stringify({
+        ok: true,
+        mode: 'single',
+        techStack,
+        templates,
+        created: result.created,
+        skipped: result.skipped,
+        conventionsDir,
+      }));
+    } else {
+      console.log('✅ conventions 生成完成');
+      console.log(`   技术栈: ${techStack.language} + ${techStack.testFramework}`);
+      console.log(`   创建: ${result.created.join(', ')}`);
+      if (result.skipped.length > 0) {
+        console.log(`   跳过: ${result.skipped.join(', ')}`);
+      }
+      console.log(`   路径: ${conventionsDir}`);
     }
-    console.log(`   路径: ${conventionsDir}`);
   }
 }