speccore 6.83.0 → 6.89.0

package/dist/core/agents/engine/agent-loader.js

@@ -0,0 +1,377 @@
+"use strict";
+/**
+ * AGENTS 引擎 — 加载器
+ *
+ * 负责：
+ * 1. 扫描 .speccore/AGENTS/ 目录下的角色定义
+ * 2. 解析 Markdown 文件为 AgentDefinition
+ * 3. 解析 _INDEX.md 注册表
+ * 4. 根据 platform/industry 解析特化版本
+ * 5. 条件过滤和优先级排序
+ *
+ * v6.84.0+
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveAgentName = resolveAgentName;
+exports.loadAllAgents = loadAllAgents;
+exports.loadRegistry = loadRegistry;
+exports.resolveAgentsForPhase = resolveAgentsForPhase;
+exports.loadAgentDefinition = loadAgentDefinition;
+exports.getBuiltinAgentContents = getBuiltinAgentContents;
+exports.getBuiltinRegistryContent = getBuiltinRegistryContent;
+exports.getBuiltinTemplateContent = getBuiltinTemplateContent;
+const path_1 = require("path");
+const fs_extra_1 = require("fs-extra");
+const BUILTIN_AGENTS_DIR = (0, path_1.join)(__dirname, '..', 'defaults');
+// ============================================================
+// 1. Markdown 解析
+// ============================================================
+function parseAgentMarkdown(content, source) {
+    const name = extractHeading(content) || 'unknown';
+    const description = extractSection(content, '职责') || extractSection(content, 'Description') || '';
+    const responsibilities = extractListItems(content, '职责') || extractListItems(content, 'Responsibilities') || [];
+    const inputSpec = extractSection(content, '输入') || extractSection(content, 'Input') || '';
+    const checkList = extractCheckboxItems(content) || [];
+    const outputFormat = extractSection(content, '输出格式') || extractSection(content, 'Output Format') || '';
+    const activations = parseSelfDescribedActivations(content);
+    // rolePrompt = 整个文档内容（作为 AI 的 system prompt 注入）
+    const rolePrompt = content;
+    return {
+        name,
+        description,
+        responsibilities,
+        inputSpec,
+        checkList,
+        outputFormat,
+        rolePrompt,
+        source,
+        activations,
+    };
+}
+/**
+ * 解析 Agent 自描述激活规则
+ * 从 Markdown 中的 "## 激活规则" 或 "## Activations" 部分提取
+ *
+ * 支持格式：
+ * | 命令 | 阶段 | 优先级 | 条件 |
+ * | :--- | :--- | :--- | :--- |
+ * | analyze | clarify | 60 | project.industry == 'finance' |
+ */
+function parseSelfDescribedActivations(content) {
+    const section = extractSection(content, '激活规则') || extractSection(content, 'Activations');
+    if (!section)
+        return [];
+    const activations = [];
+    const lines = section.split('\n').filter(l => l.trim().startsWith('|') && !l.trim().match(/^\|[\s-:]+\|/));
+    for (const line of lines) {
+        const cells = line.split('|').map(c => c.trim()).filter(Boolean);
+        if (cells.length >= 3) {
+            activations.push({
+                command: cells[0],
+                phase: cells[1],
+                priority: parseInt(cells[2], 10) || 50,
+                condition: cells[3] && cells[3] !== '—' && cells[3] !== '-' ? cells[3] : undefined,
+            });
+        }
+    }
+    return activations;
+}
+function extractHeading(content) {
+    const m = content.match(/^#\s+Agent:\s*(.+)$/m);
+    return m?.[1].trim();
+}
+function extractSection(content, sectionName) {
+    const regex = new RegExp(`^##\\s+${sectionName}\\s*\\n(.*?)(?=\\n##\\s|$)`, 'ms');
+    const m = content.match(regex);
+    return m?.[1].trim();
+}
+function extractListItems(content, sectionName) {
+    const section = extractSection(content, sectionName);
+    if (!section)
+        return undefined;
+    const items = [];
+    for (const line of section.split('\n')) {
+        const m = line.match(/^\s*[-*]\s+(.+)$/);
+        if (m)
+            items.push(m[1].trim());
+    }
+    return items.length > 0 ? items : undefined;
+}
+function extractCheckboxItems(content) {
+    const items = [];
+    const matches = content.match(/^\s*-\s*\[[ x]\]\s*(.+)$/gm);
+    if (matches) {
+        for (const m of matches) {
+            const item = m.replace(/^\s*-\s*\[[ x]\]\s*/, '').trim();
+            if (item)
+                items.push(item);
+        }
+    }
+    return items.length > 0 ? items : undefined;
+}
+// ============================================================
+// 2. 注册表解析
+// ============================================================
+function parseRegistryMarkdown(content) {
+    const phases = {};
+    const phaseMatches = content.matchAll(/^##\s+(.+?)\s*\/\s*(.+?)\s*\n([\s\S]*?)(?=\n##\s|$)/gm);
+    for (const match of phaseMatches) {
+        const command = match[1].trim();
+        const phase = match[2].trim();
+        const phaseKey = `${command}/${phase}`;
+        const tableContent = match[3];
+        phases[phaseKey] = parseRegistryTable(tableContent);
+    }
+    return { phases };
+}
+function parseRegistryTable(content) {
+    const entries = [];
+    const lines = content.split('\n').filter(l => l.trim().startsWith('|') && !l.trim().match(/^\|[\s-:]+\|/));
+    for (const line of lines) {
+        const cells = line.split('|').map(c => c.trim()).filter(Boolean);
+        if (cells.length >= 2) {
+            entries.push({
+                agent: cells[0],
+                priority: parseInt(cells[1], 10) || 50,
+                condition: cells[2] && cells[2] !== '—' && cells[2] !== '-' ? cells[2] : undefined,
+                description: cells[3],
+            });
+        }
+    }
+    return entries;
+}
+// ============================================================
+// 3. 条件表达式求值（简单实现）
+// ============================================================
+function evaluateCondition(condition, context) {
+    if (!condition)
+        return true;
+    try {
+        // 支持的格式：
+        // project.industry == 'finance'
+        // project.securityLevel > 2
+        // platform == 'backend'
+        const eqMatch = condition.match(/^(.+?)\s*==\s*['"](.+?)['"]$/);
+        if (eqMatch) {
+            const path = eqMatch[1].trim();
+            const expected = eqMatch[2];
+            const actual = getContextValue(context, path);
+            return String(actual) === expected;
+        }
+        const gtMatch = condition.match(/^(.+?)\s*>\s*(\d+)$/);
+        if (gtMatch) {
+            const path = gtMatch[1].trim();
+            const expected = parseInt(gtMatch[2], 10);
+            const actual = getContextValue(context, path);
+            return Number(actual) > expected;
+        }
+        const gteMatch = condition.match(/^(.+?)\s*>=\s*(\d+)$/);
+        if (gteMatch) {
+            const path = gteMatch[1].trim();
+            const expected = parseInt(gteMatch[2], 10);
+            const actual = getContextValue(context, path);
+            return Number(actual) >= expected;
+        }
+        // 简单布尔：存在即真
+        const path = condition.trim();
+        const actual = getContextValue(context, path);
+        return actual !== undefined && actual !== null && actual !== false;
+    }
+    catch {
+        return true; // 条件解析失败，默认通过
+    }
+}
+function getContextValue(context, path) {
+    const parts = path.split('.');
+    let current = context;
+    for (const part of parts) {
+        if (current === null || current === undefined)
+            return undefined;
+        current = current[part];
+    }
+    return current;
+}
+// ============================================================
+// 4. Agent 扫描与加载
+// ============================================================
+/**
+ * 扫描指定目录下的所有 Agent 定义文件
+ */
+async function scanAgentFiles(dir) {
+    if (!(await (0, fs_extra_1.pathExists)(dir)))
+        return [];
+    const entries = await (0, fs_extra_1.readdir)(dir, { withFileTypes: true });
+    const agents = [];
+    for (const e of entries) {
+        if (!e.isFile() || !e.name.endsWith('.md'))
+            continue;
+        if (e.name.startsWith('_'))
+            continue; // _INDEX.md, _TEMPLATE.md 跳过
+        const content = await (0, fs_extra_1.readFile)((0, path_1.join)(dir, e.name), 'utf-8');
+        agents.push({
+            name: e.name.replace(/\.md$/, ''),
+            content,
+            source: dir === BUILTIN_AGENTS_DIR ? 'builtin' : 'user-defined',
+        });
+    }
+    return agents;
+}
+// ============================================================
+// 5. 特化版本解析
+// ============================================================
+/**
+ * 根据 platform/industry 解析特化版本的 Agent 名称
+ *
+ * 优先级：platform-specific > industry-specific > generic
+ */
+function resolveAgentName(baseAgent, context, availableAgents) {
+    const platform = context.platform;
+    const industry = context.project?.industry;
+    // 1. 尝试 platform-specific: product-analyst-backend
+    if (platform) {
+        const platformSpecific = `${baseAgent}-${platform}`;
+        if (availableAgents.has(platformSpecific))
+            return platformSpecific;
+    }
+    // 2. 尝试 industry-specific: security-reviewer-finance
+    if (industry) {
+        const industrySpecific = `${baseAgent}-${industry}`;
+        if (availableAgents.has(industrySpecific))
+            return industrySpecific;
+    }
+    // 3. 回退到通用版
+    return baseAgent;
+}
+// ============================================================
+// 6. 主 API
+// ============================================================
+/**
+ * 加载所有可用的 Agent 定义
+ * 优先读取用户自定义，回退到内置默认
+ */
+async function loadAllAgents(projectRoot) {
+    const agents = new Map();
+    const userAgentsDir = (0, path_1.join)(projectRoot, '.speccore', 'AGENTS');
+    // 1. 先加载内置默认
+    const builtinFiles = await scanAgentFiles(BUILTIN_AGENTS_DIR);
+    for (const f of builtinFiles) {
+        const def = parseAgentMarkdown(f.content, 'builtin');
+        agents.set(f.name, def);
+    }
+    // 2. 用户自定义覆盖（同名覆盖）
+    const userFiles = await scanAgentFiles(userAgentsDir);
+    for (const f of userFiles) {
+        const def = parseAgentMarkdown(f.content, 'user-defined');
+        agents.set(f.name, def);
+    }
+    return agents;
+}
+/**
+ * 加载注册表
+ * 优先读取用户自定义，回退到内置默认
+ */
+async function loadRegistry(projectRoot) {
+    const userIndex = (0, path_1.join)(projectRoot, '.speccore', 'AGENTS', '_INDEX.md');
+    const builtinIndex = (0, path_1.join)(BUILTIN_AGENTS_DIR, '_INDEX.md');
+    let content = '';
+    if (await (0, fs_extra_1.pathExists)(userIndex)) {
+        content = await (0, fs_extra_1.readFile)(userIndex, 'utf-8');
+    }
+    else if (await (0, fs_extra_1.pathExists)(builtinIndex)) {
+        content = await (0, fs_extra_1.readFile)(builtinIndex, 'utf-8');
+    }
+    if (!content)
+        return { phases: {} };
+    return parseRegistryMarkdown(content);
+}
+/**
+ * 获取指定命令/阶段下需要激活的 Agent 列表
+ * 返回按优先级排序的 ResolvedAgent 数组
+ *
+ * 混合模式：
+ * 1. 注册表中的核心角色（显式配置，优先）
+ * 2. 用户自定义角色的自描述激活规则（扩展）
+ */
+async function resolveAgentsForPhase(command, phase, context, projectRoot) {
+    const phaseKey = `${command}/${phase}`;
+    // 1. 加载注册表和 Agent 定义
+    const registry = await loadRegistry(projectRoot);
+    const allAgents = await loadAllAgents(projectRoot);
+    const availableNames = new Set(allAgents.keys());
+    // 2. 收集注册表中的角色
+    const registryEntries = registry.phases[phaseKey] || [];
+    const resolvedMap = new Map();
+    for (const entry of registryEntries) {
+        if (!evaluateCondition(entry.condition, context))
+            continue;
+        const resolvedName = resolveAgentName(entry.agent, context, availableNames);
+        const def = allAgents.get(resolvedName);
+        if (!def)
+            continue;
+        resolvedMap.set(resolvedName, {
+            name: resolvedName,
+            definition: def,
+            priority: entry.priority,
+        });
+    }
+    // 3. 扫描用户自定义角色的自描述激活规则（扩展角色）
+    for (const [agentName, def] of allAgents) {
+        // 只扫描用户自定义的角色（内置角色不扫描自描述规则）
+        if (def.source !== 'user-defined')
+            continue;
+        // 已在注册表中的跳过（注册表优先）
+        if (resolvedMap.has(agentName))
+            continue;
+        for (const act of def.activations) {
+            if (act.command === command && act.phase === phase) {
+                if (evaluateCondition(act.condition, context)) {
+                    resolvedMap.set(agentName, {
+                        name: agentName,
+                        definition: def,
+                        priority: act.priority,
+                    });
+                }
+                break; // 匹配到一个就够了
+            }
+        }
+    }
+    // 4. 按优先级排序（高优先级在前）
+    const resolved = Array.from(resolvedMap.values());
+    resolved.sort((a, b) => b.priority - a.priority);
+    return resolved;
+}
+/**
+ * 获取单个 Agent 的定义
+ */
+async function loadAgentDefinition(agentName, projectRoot) {
+    const allAgents = await loadAllAgents(projectRoot);
+    return allAgents.get(agentName);
+}
+/**
+ * 获取内置 Agent 的原始 Markdown 内容（用于 init 时复制到项目）
+ */
+async function getBuiltinAgentContents() {
+    const files = await scanAgentFiles(BUILTIN_AGENTS_DIR);
+    return files.map(f => ({ name: f.name, content: f.content }));
+}
+/**
+ * 获取内置注册表内容（用于 init 时复制到项目）
+ */
+async function getBuiltinRegistryContent() {
+    const path = (0, path_1.join)(BUILTIN_AGENTS_DIR, '_INDEX.md');
+    if (await (0, fs_extra_1.pathExists)(path)) {
+        return (0, fs_extra_1.readFile)(path, 'utf-8');
+    }
+    return undefined;
+}
+/**
+ * 获取内置模板内容（用于 init 时复制到项目）
+ */
+async function getBuiltinTemplateContent() {
+    const path = (0, path_1.join)(BUILTIN_AGENTS_DIR, '_TEMPLATE.md');
+    if (await (0, fs_extra_1.pathExists)(path)) {
+        return (0, fs_extra_1.readFile)(path, 'utf-8');
+    }
+    return undefined;
+}
+//# sourceMappingURL=agent-loader.js.map

package/dist/core/agents/engine/agent-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-loader.js","sourceRoot":"","sources":["../../../../src/core/agents/engine/agent-loader.ts"],"names":[],"mappings":"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"}

package/dist/core/agents/engine/types.d.ts

@@ -0,0 +1,71 @@
+/**
+ * AGENTS 引擎 — 类型定义
+ *
+ * v6.84.0+: 规范数据库驱动的 Multi-Agent 调度架构
+ */
+export interface AgentDefinition {
+    name: string;
+    description: string;
+    responsibilities: string[];
+    inputSpec: string;
+    checkList: string[];
+    outputFormat: string;
+    rolePrompt: string;
+    source: 'builtin' | 'user-defined';
+    activations: AgentActivation[];
+}
+export interface AgentActivation {
+    command: string;
+    phase: string;
+    priority: number;
+    condition?: string;
+}
+export interface AgentRegistryEntry {
+    agent: string;
+    priority: number;
+    condition?: string;
+    description?: string;
+}
+export interface AgentRegistry {
+    phases: Record<string, AgentRegistryEntry[]>;
+}
+export interface AgentContext {
+    iteration?: string;
+    iterationDir?: string;
+    taskDir?: string;
+    codePath?: string;
+    platform?: string;
+    project?: {
+        industry?: string;
+        securityLevel?: number;
+        [key: string]: any;
+    };
+    [key: string]: any;
+}
+export interface AgentTask {
+    agent: string;
+    input: AgentContext;
+    priority?: number;
+}
+export interface AgentResult {
+    agent: string;
+    passed: boolean;
+    findings: AgentFinding[];
+    rewrite?: string;
+    nextAgents?: string[];
+    duration: number;
+    output?: string;
+}
+export interface AgentFinding {
+    severity: 'critical' | 'major' | 'minor' | 'info';
+    category: string;
+    message: string;
+    suggestion?: string;
+    location?: string;
+}
+export interface ResolvedAgent {
+    name: string;
+    definition: AgentDefinition;
+    priority: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/agents/engine/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/engine/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,GAAG,cAAc,CAAC;IACnC,WAAW,EAAE,eAAe,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,EAAE,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,eAAe,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/core/agents/engine/types.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * AGENTS 引擎 — 类型定义
+ *
+ * v6.84.0+: 规范数据库驱动的 Multi-Agent 调度架构
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/core/agents/engine/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/core/agents/engine/types.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/dist/core/agents/index.d.ts

@@ -2,7 +2,11 @@
  * Agents Module — 专业 AI 角色定义
  *
  * v6.83.0+: 从单一 AGENTS.md 总纲 → 多角色专业化分离
+ * v6.84.0+: 规范数据库驱动（.speccore/AGENTS/）+ 混合调度器
  * 每个角色包含：角色定义、专业 prompt 构建、领域特定检查清单
  */
 export { PRODUCT_ANALYST_ROLE, INTERACTION_DESIGNER_ROLE, buildProductAnalystPrompt, buildInteractionDesignerPrompt, } from './product-analyst';
+export { AgentDefinition, AgentActivation, AgentRegistryEntry, AgentRegistry, AgentContext, AgentTask, AgentResult, AgentFinding, ResolvedAgent, } from './engine/types';
+export { loadAllAgents, loadRegistry, resolveAgentsForPhase, loadAgentDefinition, resolveAgentName, getBuiltinAgentContents, getBuiltinRegistryContent, getBuiltinTemplateContent, } from './engine/agent-loader';
+export { buildAgentPrompt, prepareAgentTask, parseAgentResponse, mergeAgentResults, } from './engine/agent-executor';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/agents/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/agents/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/agents/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,SAAS,EACT,WAAW,EACX,YAAY,EACZ,aAAa,GACd,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,aAAa,EACb,YAAY,EACZ,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,yBAAyB,CAAC"}

package/dist/core/agents/index.js

@@ -3,13 +3,29 @@
  * Agents Module — 专业 AI 角色定义
  *
  * v6.83.0+: 从单一 AGENTS.md 总纲 → 多角色专业化分离
+ * v6.84.0+: 规范数据库驱动（.speccore/AGENTS/）+ 混合调度器
  * 每个角色包含：角色定义、专业 prompt 构建、领域特定检查清单
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildInteractionDesignerPrompt = exports.buildProductAnalystPrompt = exports.INTERACTION_DESIGNER_ROLE = exports.PRODUCT_ANALYST_ROLE = void 0;
+exports.mergeAgentResults = exports.parseAgentResponse = exports.prepareAgentTask = exports.buildAgentPrompt = exports.getBuiltinTemplateContent = exports.getBuiltinRegistryContent = exports.getBuiltinAgentContents = exports.resolveAgentName = exports.loadAgentDefinition = exports.resolveAgentsForPhase = exports.loadRegistry = exports.loadAllAgents = exports.buildInteractionDesignerPrompt = exports.buildProductAnalystPrompt = exports.INTERACTION_DESIGNER_ROLE = exports.PRODUCT_ANALYST_ROLE = void 0;
+// ── 向后兼容：保留 v6.83.0 硬编码角色（内部使用，不鼓励新代码直接引用）──
 var product_analyst_1 = require("./product-analyst");
 Object.defineProperty(exports, "PRODUCT_ANALYST_ROLE", { enumerable: true, get: function () { return product_analyst_1.PRODUCT_ANALYST_ROLE; } });
 Object.defineProperty(exports, "INTERACTION_DESIGNER_ROLE", { enumerable: true, get: function () { return product_analyst_1.INTERACTION_DESIGNER_ROLE; } });
 Object.defineProperty(exports, "buildProductAnalystPrompt", { enumerable: true, get: function () { return product_analyst_1.buildProductAnalystPrompt; } });
 Object.defineProperty(exports, "buildInteractionDesignerPrompt", { enumerable: true, get: function () { return product_analyst_1.buildInteractionDesignerPrompt; } });
+var agent_loader_1 = require("./engine/agent-loader");
+Object.defineProperty(exports, "loadAllAgents", { enumerable: true, get: function () { return agent_loader_1.loadAllAgents; } });
+Object.defineProperty(exports, "loadRegistry", { enumerable: true, get: function () { return agent_loader_1.loadRegistry; } });
+Object.defineProperty(exports, "resolveAgentsForPhase", { enumerable: true, get: function () { return agent_loader_1.resolveAgentsForPhase; } });
+Object.defineProperty(exports, "loadAgentDefinition", { enumerable: true, get: function () { return agent_loader_1.loadAgentDefinition; } });
+Object.defineProperty(exports, "resolveAgentName", { enumerable: true, get: function () { return agent_loader_1.resolveAgentName; } });
+Object.defineProperty(exports, "getBuiltinAgentContents", { enumerable: true, get: function () { return agent_loader_1.getBuiltinAgentContents; } });
+Object.defineProperty(exports, "getBuiltinRegistryContent", { enumerable: true, get: function () { return agent_loader_1.getBuiltinRegistryContent; } });
+Object.defineProperty(exports, "getBuiltinTemplateContent", { enumerable: true, get: function () { return agent_loader_1.getBuiltinTemplateContent; } });
+var agent_executor_1 = require("./engine/agent-executor");
+Object.defineProperty(exports, "buildAgentPrompt", { enumerable: true, get: function () { return agent_executor_1.buildAgentPrompt; } });
+Object.defineProperty(exports, "prepareAgentTask", { enumerable: true, get: function () { return agent_executor_1.prepareAgentTask; } });
+Object.defineProperty(exports, "parseAgentResponse", { enumerable: true, get: function () { return agent_executor_1.parseAgentResponse; } });
+Object.defineProperty(exports, "mergeAgentResults", { enumerable: true, get: function () { return agent_executor_1.mergeAgentResults; } });
 //# sourceMappingURL=index.js.map

package/dist/core/agents/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/agents/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,qDAK2B;AAJzB,uHAAA,oBAAoB,OAAA;AACpB,4HAAA,yBAAyB,OAAA;AACzB,4HAAA,yBAAyB,OAAA;AACzB,iIAAA,8BAA8B,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/agents/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,8CAA8C;AAC9C,qDAK2B;AAJzB,uHAAA,oBAAoB,OAAA;AACpB,4HAAA,yBAAyB,OAAA;AACzB,4HAAA,yBAAyB,OAAA;AACzB,iIAAA,8BAA8B,OAAA;AAgBhC,sDAS+B;AAR7B,6GAAA,aAAa,OAAA;AACb,4GAAA,YAAY,OAAA;AACZ,qHAAA,qBAAqB,OAAA;AACrB,mHAAA,mBAAmB,OAAA;AACnB,gHAAA,gBAAgB,OAAA;AAChB,uHAAA,uBAAuB,OAAA;AACvB,yHAAA,yBAAyB,OAAA;AACzB,yHAAA,yBAAyB,OAAA;AAG3B,0DAKiC;AAJ/B,kHAAA,gBAAgB,OAAA;AAChB,kHAAA,gBAAgB,OAAA;AAChB,oHAAA,kBAAkB,OAAA;AAClB,mHAAA,iBAAiB,OAAA"}

package/dist/core/command-loader.d.ts

@@ -0,0 +1,31 @@
+/**
+ * COMMANDS 命令模板加载器
+ *
+ * 负责：
+ * 1. 扫描 .speccore/COMMANDS/ 目录下的命令模板文件
+ * 2. 为 CLI 命令提供可配置的 prompt 模板
+ * 3. 支持变量替换（如 {{iteration}}、{{task}}）
+ *
+ * v6.87.0+
+ */
+export interface CommandTemplate {
+    name: string;
+    content: string;
+}
+/**
+ * 加载指定命令模板
+ */
+export declare function loadCommandTemplate(name: string, projectRoot: string): Promise<CommandTemplate | undefined>;
+/**
+ * 简单变量替换
+ * 支持 {{key}} 格式，从 vars 对象中取值
+ */
+export declare function renderTemplate(template: string, vars: Record<string, string>): string;
+/**
+ * 获取内置命令模板的原始内容（用于 init 时复制到项目）
+ */
+export declare function getBuiltinCommandContents(): Promise<{
+    name: string;
+    content: string;
+}[]>;
+//# sourceMappingURL=command-loader.d.ts.map

package/dist/core/command-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-loader.d.ts","sourceRoot":"","sources":["../../src/core/command-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAyCD;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAGtC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAMrF;AAED;;GAEG;AACH,wBAAsB,yBAAyB,IAAI,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAE9F"}

package/dist/core/command-loader.js

@@ -0,0 +1,76 @@
+"use strict";
+/**
+ * COMMANDS 命令模板加载器
+ *
+ * 负责：
+ * 1. 扫描 .speccore/COMMANDS/ 目录下的命令模板文件
+ * 2. 为 CLI 命令提供可配置的 prompt 模板
+ * 3. 支持变量替换（如 {{iteration}}、{{task}}）
+ *
+ * v6.87.0+
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadCommandTemplate = loadCommandTemplate;
+exports.renderTemplate = renderTemplate;
+exports.getBuiltinCommandContents = getBuiltinCommandContents;
+const path_1 = require("path");
+const fs_extra_1 = require("fs-extra");
+const BUILTIN_COMMANDS_DIR = (0, path_1.join)(__dirname, 'commands', 'defaults');
+async function scanCommandFiles(dir) {
+    if (!(await (0, fs_extra_1.pathExists)(dir)))
+        return [];
+    const entries = await (0, fs_extra_1.readdir)(dir, { withFileTypes: true });
+    const commands = [];
+    for (const e of entries) {
+        if (!e.isFile() || !e.name.endsWith('.md'))
+            continue;
+        if (e.name.startsWith('_'))
+            continue;
+        const content = await (0, fs_extra_1.readFile)((0, path_1.join)(dir, e.name), 'utf-8');
+        commands.push({
+            name: e.name.replace(/\.md$/, ''),
+            content,
+        });
+    }
+    return commands;
+}
+async function loadAllCommands(projectRoot) {
+    const userCommandsDir = (0, path_1.join)(projectRoot, '.speccore', 'COMMANDS');
+    const commandMap = new Map();
+    // 1. 加载内置默认
+    const builtinFiles = await scanCommandFiles(BUILTIN_COMMANDS_DIR);
+    for (const f of builtinFiles) {
+        commandMap.set(f.name, { name: f.name, content: f.content });
+    }
+    // 2. 用户自定义覆盖
+    const userFiles = await scanCommandFiles(userCommandsDir);
+    for (const f of userFiles) {
+        commandMap.set(f.name, { name: f.name, content: f.content });
+    }
+    return commandMap;
+}
+/**
+ * 加载指定命令模板
+ */
+async function loadCommandTemplate(name, projectRoot) {
+    const all = await loadAllCommands(projectRoot);
+    return all.get(name);
+}
+/**
+ * 简单变量替换
+ * 支持 {{key}} 格式，从 vars 对象中取值
+ */
+function renderTemplate(template, vars) {
+    let result = template;
+    for (const [key, value] of Object.entries(vars)) {
+        result = result.replace(new RegExp(`\\{\\{\\s*${key}\\s*\\}\\}`, 'g'), value);
+    }
+    return result;
+}
+/**
+ * 获取内置命令模板的原始内容（用于 init 时复制到项目）
+ */
+async function getBuiltinCommandContents() {
+    return scanCommandFiles(BUILTIN_COMMANDS_DIR);
+}
+//# sourceMappingURL=command-loader.js.map