soloforge 1.4.16 → 2.0.0

package/dist/engine/context_engine/views/knowledge_ref.js

@@ -0,0 +1,264 @@
+/**
+ * knowledge_ref 视图 — 知识资产引用追踪。
+ *
+ * 给定目标知识资产文件列表，解析 frontmatter 中的引用关系，
+ * 追踪 companion_rules / consumes / emits / required_evidence / triggers 字段，
+ * 检测孤儿引用和未被引用的资产，生成引用图报告。
+ *
+ * P1 实现：基于正则的 YAML frontmatter 解析，不依赖 YAML 库。
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { debugLog } from "../../core/logger.js";
+// ── 辅助函数 ──
+/** 引用字段与 refType 的映射 */
+const FIELD_MAP = {
+    companion_rules: "companion",
+    consumes: "consumes",
+    emits: "emits",
+    required_evidence: "requires_evidence",
+    triggers: "triggers",
+};
+/** 提取 frontmatter 区块（--- 之间的内容） */
+function extractFrontmatter(content) {
+    const match = content.match(/^---\s*\n([\s\S]*?)\n---/);
+    return match ? match[1] : "";
+}
+/** 从 frontmatter 文本中提取指定字段的原始值 */
+function extractFieldRaw(frontmatter, fieldName) {
+    // 匹配 field_name: 后面的内容（直到下一个顶层字段或区块结束）
+    const pattern = new RegExp(`^${fieldName}\\s*:\\s*([\\s\\S]*?)(?=^\\w[\\w_-]*\\s*:|\\s*$)`, "m");
+    const match = frontmatter.match(pattern);
+    return match ? match[1].trim() : "";
+}
+/**
+ * 从 companion_rules 值中提取文件名。
+ * 支持两种格式：
+ * 1. 引号包裹的 JSON-like 条目：`["规则文件名.md:execute", ...]`
+ * 2. YAML 列表条目：`- 规则文件名.md:execute`
+ * 返回去除 `:action` 后缀的纯文件名。
+ */
+function extractCompanionFilenames(rawValue) {
+    const filenames = [];
+    // 1. 匹配引号包裹的条目
+    const quotedEntries = rawValue.match(/["']([^"']+)["']/g);
+    if (quotedEntries) {
+        for (const entry of quotedEntries) {
+            const inner = entry.replace(/["']/g, "");
+            const colonIdx = inner.indexOf(":");
+            const filename = colonIdx > 0 ? inner.slice(0, colonIdx).trim() : inner.trim();
+            if (filename.endsWith(".md") || filename.endsWith(".yaml") || filename.endsWith(".yml")) {
+                filenames.push(filename);
+            }
+        }
+    }
+    // 2. 匹配 YAML 列表条目: - 规则文件名.md:execute
+    const yamlEntries = rawValue.match(/^- (.+)$/gm);
+    if (yamlEntries) {
+        for (const entry of yamlEntries) {
+            const inner = entry.replace(/^-\s*/, "").trim();
+            // 去除可能残留的引号
+            const cleaned = inner.replace(/^["']|["']$/g, "");
+            const colonIdx = cleaned.indexOf(":");
+            const filename = colonIdx > 0 ? cleaned.slice(0, colonIdx).trim() : cleaned.trim();
+            if (filename.endsWith(".md") || filename.endsWith(".yaml") || filename.endsWith(".yml")) {
+                filenames.push(filename);
+            }
+        }
+    }
+    return filenames;
+}
+/**
+ * 从 consumes / emits 值中提取机制 ID。
+ * 格式示例：`["mechanism_a", "mechanism_b"]`
+ * 注意：机制 ID 不是文件路径，仅记录不解析。
+ */
+function extractMechanismIds(rawValue) {
+    const ids = [];
+    const entries = rawValue.match(/["']([^"']+)["']/g);
+    if (!entries)
+        return ids;
+    for (const entry of entries) {
+        ids.push(entry.replace(/["']/g, "").trim());
+    }
+    return ids;
+}
+/**
+ * 在 templates 目录中递归查找指定文件名的完整路径。
+ * 返回第一个匹配的相对路径，未找到返回 null。
+ */
+function resolveAssetPath(root, filename) {
+    const templatesDir = path.join(root, "templates");
+    if (!fs.existsSync(templatesDir))
+        return null;
+    const results = [];
+    try {
+        // 使用简单递归扫描
+        const entries = fs.readdirSync(templatesDir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(templatesDir, entry.name);
+            if (entry.isDirectory()) {
+                collectFilesRecursive(fullPath, filename, entry.name, results);
+            }
+            else if (entry.name === filename) {
+                results.push(path.join("templates", filename));
+            }
+        }
+    }
+    catch {
+        return null;
+    }
+    return results.length > 0 ? results[0] : null;
+}
+/** 递归收集匹配文件名的相对路径 */
+function collectFilesRecursive(dir, targetName, relativePrefix, results) {
+    try {
+        const entries = fs.readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.name.startsWith(".") || entry.name === "node_modules")
+                continue;
+            const fullPath = path.join(dir, entry.name);
+            const relPath = path.join(relativePrefix, entry.name);
+            if (entry.isDirectory()) {
+                collectFilesRecursive(fullPath, targetName, relPath, results);
+            }
+            else if (entry.name === targetName) {
+                results.push(path.join("templates", relPath));
+            }
+        }
+    }
+    catch {
+        // 忽略权限错误等
+    }
+}
+/** 规范化路径为 POSIX 格式 */
+function normalizePath(p) {
+    return p.replace(/\\/g, "/");
+}
+// ── 核心分析 ──
+/**
+ * 分析单个知识资产文件的引用关系。
+ */
+function analyzeAsset(root, targetRelPath) {
+    const fullPath = path.isAbsolute(targetRelPath)
+        ? targetRelPath
+        : path.join(root, targetRelPath);
+    let content;
+    try {
+        content = fs.readFileSync(fullPath, "utf-8");
+    }
+    catch {
+        debugLog(`knowledge_ref: 无法读取文件 ${targetRelPath}`);
+        return [];
+    }
+    const frontmatter = extractFrontmatter(content);
+    if (!frontmatter)
+        return [];
+    const refs = [];
+    for (const [fieldName, refType] of Object.entries(FIELD_MAP)) {
+        const rawValue = extractFieldRaw(frontmatter, fieldName);
+        if (!rawValue)
+            continue;
+        let targets = [];
+        if (refType === "companion") {
+            // companion_rules: 提取文件名并解析为路径
+            // 保留无法解析的引用（用于孤儿检测）
+            const filenames = extractCompanionFilenames(rawValue);
+            targets = filenames.map((fn) => {
+                const resolved = resolveAssetPath(root, fn);
+                return resolved ? normalizePath(resolved) : normalizePath(path.join("templates", fn));
+            });
+        }
+        else if (refType === "consumes" || refType === "emits") {
+            // consumes/emits: 机制 ID，不解析文件路径
+            const ids = extractMechanismIds(rawValue);
+            targets = ids;
+        }
+        else {
+            // required_evidence / triggers: 提取字符串条目
+            targets = extractMechanismIds(rawValue);
+        }
+        for (const target of targets) {
+            refs.push({
+                source: normalizePath(path.relative(root, fullPath)),
+                target,
+                refType,
+                field: fieldName,
+            });
+        }
+    }
+    return refs;
+}
+// ── 视图实现 ──
+/**
+ * knowledge_ref 视图：追踪知识资产之间的引用关系。
+ */
+export const knowledgeRefView = {
+    name: "knowledge_ref",
+    capabilities: ["knowledge_index"],
+    async analyze(root, params) {
+        const targets = params.targets ?? [];
+        const evidence = [];
+        debugLog(`knowledge_ref: 分析 ${targets.length} 个知识资产的引用关系`);
+        // 收集所有引用关系
+        const allRefs = [];
+        for (const target of targets) {
+            const refs = analyzeAsset(root, target);
+            allRefs.push(...refs);
+        }
+        // 检测孤儿引用（目标文件不存在）
+        const orphanRefs = allRefs.filter((ref) => {
+            // consumes/emits 的机制 ID 不检查文件存在性
+            if (ref.refType === "consumes" || ref.refType === "emits")
+                return false;
+            const targetFullPath = path.join(root, ref.target);
+            return !fs.existsSync(targetFullPath);
+        });
+        // 构建引用图
+        const refGraph = {};
+        for (const ref of allRefs) {
+            if (!refGraph[ref.source])
+                refGraph[ref.source] = [];
+            refGraph[ref.source].push(ref.target);
+        }
+        // 查找未被引用的资产（在 targets 中但没有出现在任何 ref.target 中）
+        const referencedSet = new Set(allRefs.map((r) => r.target));
+        const unreferenced = targets
+            .filter((t) => {
+            const normalized = normalizePath(path.relative(root, path.isAbsolute(t) ? t : path.join(root, t)));
+            return !referencedSet.has(normalized);
+        });
+        // 证据：孤儿引用警告
+        for (const orphan of orphanRefs) {
+            evidence.push({
+                type: "grep_match",
+                verify_command: `test -f "${orphan.target}"`,
+                source: `孤儿引用: ${orphan.source} → ${orphan.target} (${orphan.field})`,
+            });
+        }
+        // 证据：引用关系汇总
+        if (allRefs.length > 0) {
+            evidence.push({
+                type: "grep_match",
+                verify_command: `grep -rn "companion_rules\\|consumes\\|emits\\|required_evidence\\|triggers" --include="*.md" templates/`,
+                source: `共发现 ${allRefs.length} 条引用关系, ${orphanRefs.length} 条孤儿引用, ${unreferenced.length} 个未引用资产`,
+            });
+        }
+        const data = {
+            refs: allRefs,
+            orphanRefs,
+            unreferenced,
+            refGraph,
+        };
+        return {
+            view: "knowledge_ref",
+            summary: `分析了 ${targets.length} 个知识资产: ` +
+                `${allRefs.length} 条引用关系, ` +
+                `${orphanRefs.length} 条孤儿引用, ` +
+                `${unreferenced.length} 个未被引用的资产`,
+            data: data,
+            evidence,
+        };
+    },
+};
+//# sourceMappingURL=knowledge_ref.js.map

package/dist/engine/context_engine/views/knowledge_ref.js.map

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

package/dist/engine/context_engine/views/reference_trace.d.ts

@@ -0,0 +1,49 @@
+/**
+ * reference_trace 视图 — 引用链追踪。
+ *
+ * 给定目标文件列表，追踪 import/require 链路，
+ * 生成传递闭包和按类型统计的引用报告。
+ *
+ * P0 实现：基于 grep 模式的 import 解析。
+ */
+import type { ContextView } from "../view_registry.js";
+/** 单条引用关系 */
+export interface RefEdge {
+    /** 引用方文件 */
+    from: string;
+    /** 被引用模块 */
+    to: string;
+    /** 引用类型 */
+    type: "import" | "require" | "dynamic_import" | "reexport";
+}
+/** 引用链追踪结果 */
+export interface TraceResult {
+    /** 起始文件 */
+    source: string;
+    /** 直接引用的模块 */
+    references: string[];
+    /** 传递闭包（间接引用链） */
+    transitive: string[];
+    /** 按引用类型统计 */
+    by_type: Record<RefEdge["type"], number>;
+}
+/** reference_trace 视图结果数据 */
+export interface ReferenceTraceData {
+    /** 输入的目标文件列表 */
+    targets: string[];
+    /** 每个目标文件的追踪结果 */
+    traces: TraceResult[];
+    /** 汇总统计 */
+    summary: {
+        total_targets: number;
+        total_references: number;
+        total_transitive: number;
+        total_edges: number;
+        max_depth: number;
+    };
+}
+/**
+ * reference_trace 视图：追踪目标文件的 import/require 引用链。
+ */
+export declare const referenceTraceView: ContextView;
+//# sourceMappingURL=reference_trace.d.ts.map

package/dist/engine/context_engine/views/reference_trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference_trace.d.ts","sourceRoot":"","sources":["../../../../src/engine/context_engine/views/reference_trace.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAwB,MAAM,qBAAqB,CAAC;AAK7E,aAAa;AACb,MAAM,WAAW,OAAO;IACtB,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,YAAY;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,WAAW;IACX,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,gBAAgB,GAAG,UAAU,CAAC;CAC5D;AAED,cAAc;AACd,MAAM,WAAW,WAAW;IAC1B,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;IACf,cAAc;IACd,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,kBAAkB;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,cAAc;IACd,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;CAC1C;AAED,6BAA6B;AAC7B,MAAM,WAAW,kBAAkB;IACjC,gBAAgB;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,kBAAkB;IAClB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,WAAW;IACX,OAAO,EAAE;QACP,aAAa,EAAE,MAAM,CAAC;QACtB,gBAAgB,EAAE,MAAM,CAAC;QACzB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAmND;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,WA4ChC,CAAC"}

package/dist/engine/context_engine/views/reference_trace.js

@@ -0,0 +1,227 @@
+/**
+ * reference_trace 视图 — 引用链追踪。
+ *
+ * 给定目标文件列表，追踪 import/require 链路，
+ * 生成传递闭包和按类型统计的引用报告。
+ *
+ * P0 实现：基于 grep 模式的 import 解析。
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { debugLog } from "../../core/logger.js";
+// ── 辅助函数 ──
+/** 从文件内容解析 import/require 语句中的模块路径 */
+function extractImports(fileContent, filePath) {
+    const edges = [];
+    const dir = path.dirname(filePath);
+    const lines = fileContent.split("\n");
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith("//") || trimmed.startsWith("*"))
+            continue;
+        // 匹配 import ... from 'module' 模式
+        const importMatch = trimmed.match(/import\s+.*?\s+from\s+['"]([^'"]+)['"]/);
+        if (importMatch) {
+            const modulePath = resolveModulePath(importMatch[1], dir);
+            if (modulePath) {
+                edges.push({ from: filePath, to: modulePath, type: "import" });
+            }
+            continue;
+        }
+        // import 'module'（副作用导入）
+        const sideEffectMatch = trimmed.match(/^import\s+['"]([^'"]+)['"]/);
+        if (sideEffectMatch) {
+            const modulePath = resolveModulePath(sideEffectMatch[1], dir);
+            if (modulePath) {
+                edges.push({ from: filePath, to: modulePath, type: "import" });
+            }
+            continue;
+        }
+        // 匹配 export ... from 'module' 重导出模式
+        const reexportMatch = trimmed.match(/export\s+.*?\s+from\s+['"]([^'"]+)['"]/);
+        if (reexportMatch) {
+            const modulePath = resolveModulePath(reexportMatch[1], dir);
+            if (modulePath) {
+                edges.push({ from: filePath, to: modulePath, type: "reexport" });
+            }
+            continue;
+        }
+        // 匹配 require('module') 模式
+        const requireMatch = trimmed.match(/require\s*\(\s*['"]([^'"]+)['"]\s*\)/);
+        if (requireMatch) {
+            const modulePath = resolveModulePath(requireMatch[1], dir);
+            if (modulePath) {
+                edges.push({ from: filePath, to: modulePath, type: "require" });
+            }
+            continue;
+        }
+        // import('module')（动态导入）
+        const dynamicMatch = trimmed.match(/import\s*\(\s*['"]([^'"]+)['"]\s*\)/);
+        if (dynamicMatch) {
+            const modulePath = resolveModulePath(dynamicMatch[1], dir);
+            if (modulePath) {
+                edges.push({ from: filePath, to: modulePath, type: "dynamic_import" });
+            }
+        }
+    }
+    return edges;
+}
+/** 解析模块路径为相对文件路径 */
+function resolveModulePath(moduleSpecifier, fromDir) {
+    // 跳过 node_modules 内置模块
+    if (!moduleSpecifier.startsWith("."))
+        return null;
+    // .js/.jsx 导入映射到 .ts/.tsx 源文件（TypeScript 编译惯例）
+    let normalized = moduleSpecifier;
+    if (normalized.endsWith(".js")) {
+        normalized = normalized.slice(0, -3) + ".ts";
+    }
+    else if (normalized.endsWith(".jsx")) {
+        normalized = normalized.slice(0, -4) + ".tsx";
+    }
+    const resolved = path.resolve(fromDir, normalized);
+    // 路径本身存在（已有扩展名且文件存在）
+    if (fs.existsSync(resolved)) {
+        return resolved;
+    }
+    // 尝试添加扩展名（无扩展名的导入路径）
+    const extensions = [".ts", ".tsx", ".js", ".jsx", "/index.ts", "/index.js"];
+    const baseResolved = path.resolve(fromDir, moduleSpecifier);
+    for (const ext of extensions) {
+        if (fs.existsSync(baseResolved + ext)) {
+            return baseResolved + ext;
+        }
+    }
+    // 最后尝试原始路径
+    const originalResolved = path.resolve(fromDir, moduleSpecifier);
+    if (fs.existsSync(originalResolved)) {
+        return originalResolved;
+    }
+    return null;
+}
+/** 规范化路径为 POSIX 格式的相对路径 */
+function toRelative(root, absPath) {
+    return path.relative(root, absPath).replace(/\\/g, "/");
+}
+/** BFS 追踪传递闭包，限制最大深度 */
+function traceTransitive(root, startPath, maxDepth = 10) {
+    const visited = new Set([startPath]);
+    const transitive = [];
+    const allEdges = [];
+    let currentDepth = 0;
+    const queue = [{ filePath: startPath, depth: 0 }];
+    while (queue.length > 0) {
+        const { filePath, depth } = queue.shift();
+        if (depth >= maxDepth)
+            continue;
+        if (depth > currentDepth)
+            currentDepth = depth;
+        // 读取文件内容
+        let content;
+        try {
+            content = fs.readFileSync(filePath, "utf-8");
+        }
+        catch {
+            continue;
+        }
+        const edges = extractImports(content, filePath);
+        allEdges.push(...edges);
+        for (const edge of edges) {
+            const relPath = toRelative(root, edge.to);
+            if (!visited.has(relPath)) {
+                visited.add(relPath);
+                transitive.push(relPath);
+                queue.push({ filePath: edge.to, depth: depth + 1 });
+            }
+        }
+    }
+    return { transitive, edges: allEdges, depth: currentDepth };
+}
+// ── 核心分析 ──
+/**
+ * 追踪单个目标文件的引用链。
+ */
+function traceFile(root, targetRelPath) {
+    const fullPath = path.isAbsolute(targetRelPath)
+        ? targetRelPath
+        : path.join(root, targetRelPath);
+    if (!fs.existsSync(fullPath)) {
+        return {
+            source: targetRelPath,
+            references: [],
+            transitive: [],
+            by_type: { import: 0, require: 0, dynamic_import: 0, reexport: 0 },
+        };
+    }
+    // 直接引用：从文件内容解析 import 语句
+    const content = fs.readFileSync(fullPath, "utf-8");
+    const directEdges = extractImports(content, fullPath);
+    const references = directEdges
+        .map((e) => toRelative(root, e.to))
+        .filter((p) => p.length > 0);
+    // 按类型统计
+    const by_type = {
+        import: 0,
+        require: 0,
+        dynamic_import: 0,
+        reexport: 0,
+    };
+    for (const edge of directEdges) {
+        by_type[edge.type]++;
+    }
+    // 传递闭包
+    const { transitive, edges: allEdges } = traceTransitive(root, fullPath);
+    // 更新按类型统计（包含传递闭包的边）
+    const totalByType = { ...by_type };
+    for (const edge of allEdges) {
+        if (!directEdges.includes(edge)) {
+            totalByType[edge.type]++;
+        }
+    }
+    return {
+        source: targetRelPath,
+        references: [...new Set(references)],
+        transitive: [...new Set(transitive)],
+        by_type: totalByType,
+    };
+}
+// ── 视图实现 ──
+/**
+ * reference_trace 视图：追踪目标文件的 import/require 引用链。
+ */
+export const referenceTraceView = {
+    name: "reference_trace",
+    capabilities: ["grep", "ast"],
+    async analyze(root, params) {
+        const targets = params.targets ?? [];
+        const evidence = [];
+        debugLog(`reference_trace: 追踪 ${targets.length} 个目标文件的引用链`);
+        const traces = targets.map((target) => traceFile(root, target));
+        const summary = {
+            total_targets: targets.length,
+            total_references: traces.reduce((sum, t) => sum + t.references.length, 0),
+            total_transitive: traces.reduce((sum, t) => sum + t.transitive.length, 0),
+            total_edges: traces.reduce((sum, t) => sum + t.by_type.import + t.by_type.require + t.by_type.dynamic_import + t.by_type.reexport, 0),
+            max_depth: 0,
+        };
+        const data = { targets, traces, summary };
+        // 证据：引用链汇总
+        if (summary.total_references > 0) {
+            evidence.push({
+                type: "import_chain",
+                verify_command: `grep -rn "import.*from" --include="*.ts" ${targets.join(" ")}`,
+                source: `共发现 ${summary.total_references} 个直接引用, ${summary.total_transitive} 个传递引用`,
+            });
+        }
+        return {
+            view: "reference_trace",
+            summary: `追踪了 ${summary.total_targets} 个文件的引用链: ` +
+                `${summary.total_references} 直接引用, ` +
+                `${summary.total_transitive} 传递引用, ` +
+                `${summary.total_edges} 总边数`,
+            data: data,
+            evidence,
+        };
+    },
+};
+//# sourceMappingURL=reference_trace.js.map

package/dist/engine/context_engine/views/reference_trace.js.map

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

package/dist/engine/contracts/architecture_decision_workshop.d.ts

@@ -0,0 +1,63 @@
+/**
+ * 架构决策研讨契约。
+ *
+ * 架构设计不是先写结果再补理由。该模块定义六类决策域的确认状态，
+ * 供 sf_stage_execute 在生成正式设计指令前强制校验。
+ */
+export declare const ARCHITECTURE_DECISION_DOMAINS: readonly ["business_process", "data_architecture", "security_architecture", "backend_architecture", "frontend_architecture", "infrastructure"];
+export type ArchitectureDecisionDomain = typeof ARCHITECTURE_DECISION_DOMAINS[number];
+export type ArchitectureDecisionStatus = "not_started" | "exploring" | "recommended" | "awaiting_confirmation" | "confirmed" | "rejected" | "rework_required" | "not_applicable_with_reason" | "deferred_with_impact";
+export type ArchitectureProjectContext = "existing_system" | "new_system" | "empty_project" | "refactor_or_upgrade";
+export interface ArchitectureDecisionOption {
+    option_id: string;
+    summary: string;
+    benefits: string[];
+    risks: string[];
+    rejected_reason?: string;
+}
+export interface ArchitectureDecisionRecord {
+    decision_id: string;
+    domain: ArchitectureDecisionDomain;
+    status: ArchitectureDecisionStatus;
+    required: boolean;
+    facts_and_constraints: string[];
+    evidence_refs: string[];
+    options: ArchitectureDecisionOption[];
+    recommendation?: {
+        option_id: string;
+        rationale: string[];
+    };
+    user_confirmation_ref?: string;
+    dependent_domains: ArchitectureDecisionDomain[];
+    deferred_impact?: string[];
+    not_applicable_reason?: string;
+}
+export interface ArchitectureDecisionWorkshopContract {
+    task_id: string;
+    project_context: ArchitectureProjectContext;
+    status: "draft" | "awaiting_confirmation" | "confirmed" | "rework_required" | "blocked";
+    prerequisite_evidence_refs: string[];
+    domains: Record<ArchitectureDecisionDomain, ArchitectureDecisionRecord>;
+    document_output_confirmation_ref?: string;
+    required_diagrams: string[];
+    design_generation_allowed: boolean;
+    blocking_findings: string[];
+}
+export interface ArchitectureWorkshopGateResult {
+    allowed: boolean;
+    status: ArchitectureDecisionWorkshopContract["status"];
+    missing_domains: ArchitectureDecisionDomain[];
+    blocking_findings: string[];
+    next_domain?: ArchitectureDecisionDomain;
+}
+export declare function createArchitectureDecisionWorkshop(taskId: string, projectContext?: ArchitectureProjectContext): ArchitectureDecisionWorkshopContract;
+/** 架构设计、重大系统方案才进入六域研讨，低风险修改不误拦。 */
+export declare function requiresArchitectureDecisionWorkshop(workflowIntent: string | undefined, intent: string, projectContext?: {
+    /** 已有架构设计文档（路径存在且非空） */
+    hasArchitectureDoc?: boolean;
+    /** 项目级或先前任务的研讨记录已被用户确认 */
+    hasConfirmedDecisions?: boolean;
+}): boolean;
+export declare function evaluateArchitectureDecisionWorkshop(contract: ArchitectureDecisionWorkshopContract | undefined): ArchitectureWorkshopGateResult;
+export declare function applyArchitectureWorkshopGate(contract: ArchitectureDecisionWorkshopContract | undefined): ArchitectureDecisionWorkshopContract | undefined;
+//# sourceMappingURL=architecture_decision_workshop.d.ts.map

package/dist/engine/contracts/architecture_decision_workshop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"architecture_decision_workshop.d.ts","sourceRoot":"","sources":["../../../src/engine/contracts/architecture_decision_workshop.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,6BAA6B,gJAOhC,CAAC;AAEX,MAAM,MAAM,0BAA0B,GAAG,OAAO,6BAA6B,CAAC,MAAM,CAAC,CAAC;AACtF,MAAM,MAAM,0BAA0B,GAClC,aAAa,GACb,WAAW,GACX,aAAa,GACb,uBAAuB,GACvB,WAAW,GACX,UAAU,GACV,iBAAiB,GACjB,4BAA4B,GAC5B,sBAAsB,CAAC;AAE3B,MAAM,MAAM,0BAA0B,GAClC,iBAAiB,GACjB,YAAY,GACZ,eAAe,GACf,qBAAqB,CAAC;AAE1B,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,0BAA0B;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,0BAA0B,CAAC;IACnC,MAAM,EAAE,0BAA0B,CAAC;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,EAAE,0BAA0B,EAAE,CAAC;IACtC,cAAc,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC5D,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,iBAAiB,EAAE,0BAA0B,EAAE,CAAC;IAChD,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,oCAAoC;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,0BAA0B,CAAC;IAC5C,MAAM,EAAE,OAAO,GAAG,uBAAuB,GAAG,WAAW,GAAG,iBAAiB,GAAG,SAAS,CAAC;IACxF,0BAA0B,EAAE,MAAM,EAAE,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC,0BAA0B,EAAE,0BAA0B,CAAC,CAAC;IACxE,gCAAgC,CAAC,EAAE,MAAM,CAAC;IAC1C,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,yBAAyB,EAAE,OAAO,CAAC;IACnC,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,8BAA8B;IAC7C,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,oCAAoC,CAAC,QAAQ,CAAC,CAAC;IACvD,eAAe,EAAE,0BAA0B,EAAE,CAAC;IAC9C,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,0BAA0B,CAAC;CAC1C;AAWD,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,MAAM,EACd,cAAc,GAAE,0BAAyC,GACxD,oCAAoC,CAyBtC;AAED,mCAAmC;AACnC,wBAAgB,oCAAoC,CAClD,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,MAAM,EAAE,MAAM,EACd,cAAc,CAAC,EAAE;IACf,wBAAwB;IACxB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,0BAA0B;IAC1B,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC,GACA,OAAO,CAOT;AAED,wBAAgB,oCAAoC,CAClD,QAAQ,EAAE,oCAAoC,GAAG,SAAS,GACzD,8BAA8B,CAyDhC;AAED,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,oCAAoC,GAAG,SAAS,GACzD,oCAAoC,GAAG,SAAS,CASlD"}