soloforge 1.4.4 → 1.4.6

package/dist/adapters/shared/workflow_template.js

@@ -109,7 +109,7 @@ export function validateWorkflowRuleSources(rootDir) {
     };
 }
 /** 当前嵌入的权威规则校验和 — 由 `npm run update-workflow-checksum` 更新。 */
-const EMBEDDED_CHECKSUM = "3620b50bb23320b5";
+const EMBEDDED_CHECKSUM = "1329a153ea580993";
 function getEmbeddedChecksum() {
     return EMBEDDED_CHECKSUM;
 }

package/dist/bin/soloforge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"soloforge.d.ts","sourceRoot":"","sources":["../../src/bin/soloforge.ts"],"names":[],"mappings":";AAqgCA,OAAO,EAAE,0BAA0B,EAAE,MAAM,gDAAgD,CAAC"}
+{"version":3,"file":"soloforge.d.ts","sourceRoot":"","sources":["../../src/bin/soloforge.ts"],"names":[],"mappings":";AAshCA,OAAO,EAAE,0BAA0B,EAAE,MAAM,gDAAgD,CAAC"}

package/dist/bin/soloforge.js

@@ -18,6 +18,7 @@ import { isReadForbidden } from "../engine/privacy_secret_contract.js";
 import { routeIntent } from "../engine/intent_router.js";
 import { debugLog, debug, userInfo, userWarn, userError, internalWarn, jsonSafeError, initLoggerFromEnv } from "../engine/logger.js";
 import { auditControlPlaneProject, isSoloforgeStateBypassCommand } from "../engine/control_plane_contract.js";
+import { getDesignLifecycleArtifactPaths } from "../engine/design_lifecycle_contract.js";
 const command = process.argv[2];
 const args = process.argv.slice(3);
 async function main() {
@@ -741,9 +742,24 @@ function isImplementationSourcePath(relativeFilePath) {
     return /\.(?:java|kt|kts|scala|ts|tsx|js|jsx|mjs|cjs|py|go|rs|php|rb|cs|swift|vue|svelte|sql|xml|yml|yaml|properties)$/.test(relativeFilePath);
 }
 function isDesignArtifactPath(relativeFilePath) {
+    const lifecyclePaths = getDesignLifecycleArtifactPaths();
+    if ([
+        lifecyclePaths.decision_record,
+        lifecyclePaths.architecture_document,
+        lifecyclePaths.database_document,
+        lifecyclePaths.api_document,
+        lifecyclePaths.optional_detail_design_document,
+        lifecyclePaths.slice_plan,
+        lifecyclePaths.consistency_report,
+        lifecyclePaths.traceability_matrix,
+        lifecyclePaths.openapi,
+    ].includes(relativeFilePath))
+        return true;
     return /^docs\/architecture\//.test(relativeFilePath) ||
+        /^docs\/traceability\//.test(relativeFilePath) ||
         /^docs\/api\/openapi\.(?:ya?ml|json)$/.test(relativeFilePath) ||
-        /^db\/(?:migrations|schema)\//.test(relativeFilePath);
+        /^db\/(?:migrations?|schema|changelog)\//.test(relativeFilePath) ||
+        /(?:^|\/)(?:src\/main\/resources\/)?db\/(?:migrations?|schema|changelog)\//.test(relativeFilePath);
 }
 function denyPreToolUse(reason) {
     process.stdout.write(JSON.stringify({
@@ -776,23 +792,25 @@ async function evaluateImplementationWriteGate(projectPath, relativeFilePath) {
         return "检测到项目已有设计产物，但当前任务缺少 design_artifact_pack 复验状态。不得取消任务后直接写业务实现，不得改用 Bash 绕过；请先运行 soloforge audit-design-artifacts，并通过 sf_expand/sf_verify 绑定设计产物包。";
     }
     if (designPack && designPack.status !== "implementation_ready") {
-        return `设计产物包状态为 ${designPack.status}，不得改用 Bash/Edit/Write 绕过设计复验；请先完善 docs/architecture、docs/api/openapi 或 db/migrations|schema 并通过复验，再写入业务实现`;
+        return `设计产物包状态为 ${designPack.status}，不得改用 Bash/Edit/Write 绕过设计复验；请先完善 docs/architecture、docs/traceability、docs/api/openapi 或 db/migration|migrations|schema|changelog 并通过复验，再写入业务实现`;
     }
     return undefined;
 }
 function hasDesignArtifacts(projectPath) {
+    const lifecyclePaths = getDesignLifecycleArtifactPaths();
     const candidates = [
-        path.join(projectPath, "docs", "architecture", "00-架构决策记录.md"),
-        path.join(projectPath, "docs", "architecture", "01-架构设计文档.md"),
-        path.join(projectPath, "docs", "architecture", "02-数据库设计文档.md"),
-        path.join(projectPath, "docs", "architecture", "03-API接口规格文档.md"),
-        path.join(projectPath, "docs", "architecture", "04-详细设计文档.md"),
-        path.join(projectPath, "docs", "architecture", "99-设计一致性验收报告.md"),
-        path.join(projectPath, "docs", "api", "openapi.yaml"),
+        lifecyclePaths.decision_record,
+        lifecyclePaths.architecture_document,
+        lifecyclePaths.database_document,
+        lifecyclePaths.api_document,
+        lifecyclePaths.optional_detail_design_document,
+        lifecyclePaths.slice_plan,
+        lifecyclePaths.consistency_report,
+        lifecyclePaths.traceability_matrix,
+        lifecyclePaths.openapi,
         path.join(projectPath, "docs", "api", "openapi.yml"),
-        path.join(projectPath, "db", "migrations"),
-        path.join(projectPath, "db", "migration"),
-    ];
+        ...lifecyclePaths.sql_roots,
+    ].map((candidate) => path.join(projectPath, candidate));
     return candidates.some((candidate) => fss.existsSync(candidate));
 }
 async function cmdPostBash() {
@@ -1058,6 +1076,7 @@ async function cmdValidate() {
         }
         // 使用共享函数验证配置优先级
         let hasHardFail = false;
+        const hardFailSources = new Set();
         try {
             const { reports, entries } = await resolveCurrentProjectConfigReports(projectPath);
             const findings = validateConfigPrecedence(reports, entries);
@@ -1065,6 +1084,7 @@ async function cmdValidate() {
             const advisory = findings.filter(f => f.severity === "advisory");
             if (hardFails.length > 0) {
                 hasHardFail = true;
+                hardFailSources.add("配置优先级");
                 userInfo(`❌ 配置优先级: ${hardFails.length} hard_fail`);
                 for (const f of hardFails) {
                     userInfo(`  - [${f.rule}] ${f.field_path ?? "N/A"}: ${f.message}`);
@@ -1099,6 +1119,7 @@ async function cmdValidate() {
                     userInfo(`  - [${f.kind}] ${f.message_zh}`);
                 }
                 hasHardFail = true;
+                hardFailSources.add("知识治理");
             }
             else {
                 userInfo(`✅ 知识治理检查: ${kgReport.warning_count} warning, 0 hard_fail`);
@@ -1137,6 +1158,7 @@ async function cmdValidate() {
                     }
                 }
                 hasHardFail = true;
+                hardFailSources.add("项目知识承载");
             }
             else {
                 userInfo(`✅ 项目知识承载: ${pkReport.total} 条，${pkReport.injectable} 条可注入，${pkReport.index_only} 条仅索引，0 hard_fail`);
@@ -1151,6 +1173,7 @@ async function cmdValidate() {
                 for (const v of extResult.violations)
                     userInfo(`    - ${v}`);
                 hasHardFail = true;
+                hardFailSources.add("扩展清单");
             }
             else {
                 userInfo("  ✓ 扩展清单校验通过");
@@ -1176,6 +1199,7 @@ async function cmdValidate() {
             if (platformReport.platform_compatibility_status === "blocked") {
                 userInfo(`  ✗ 平台兼容性阻断: ${platformReport.issues_found.join(", ")}`);
                 hasHardFail = true;
+                hardFailSources.add("平台兼容性");
             }
             else {
                 userInfo(`  ✓ 平台兼容性检查: ${platformReport.platform_compatibility_status}`);
@@ -1202,6 +1226,7 @@ async function cmdValidate() {
                     for (const hf of hardFails)
                         userInfo(`    - ${hf.message_zh}`);
                     hasHardFail = true;
+                    hardFailSources.add("README 命令漂移");
                 }
                 else if (warnings.length > 0) {
                     userInfo("  ⚠ README 命令漂移警告:");
@@ -1273,6 +1298,7 @@ async function cmdValidate() {
                 if (tsHardFail) {
                     userError(`❌ 测试策略覆盖验证失败: ${tsChecked} 个已检查, ${tsPending} 个元数据缺失`);
                     hasHardFail = true;
+                    hardFailSources.add("测试策略覆盖");
                 }
                 else {
                     userInfo(`✅ 测试策略覆盖: 已检查 ${tsChecked} 个 enforced 契约`);
@@ -1281,6 +1307,7 @@ async function cmdValidate() {
             catch (e) {
                 userError(`❌ 测试策略验证异常: ${e.message}`);
                 hasHardFail = true;
+                hardFailSources.add("测试策略覆盖");
             }
         } // 双层机制检查结束
         try {
@@ -1296,7 +1323,8 @@ async function cmdValidate() {
             userInfo(`  ⚠ 导航摘要异常: ${e instanceof Error ? e.message : String(e)}`);
         }
         if (hasHardFail) {
-            userError("❌ validate 失败: 配置优先级存在 hard_fail");
+            const sources = hardFailSources.size > 0 ? Array.from(hardFailSources).join("、") : "校验项";
+            userError(`❌ validate 失败: ${sources} 存在 hard_fail`);
             process.exit(1);
         }
     }
@@ -2498,7 +2526,20 @@ async function cmdNext() {
             if (plan.project_knowledge_context.selected.length > 0) {
                 userInfo("  下一步会优先参考:");
                 for (const item of plan.project_knowledge_context.selected) {
-                    userInfo(`    - ${item.name} (${item.rel_path}, ${item.consumption})`);
+                    userInfo(`    - ${item.name} (${item.rel_path}, ${item.enforcement ?? item.consumption})`);
+                    if (item.reason_zh)
+                        userInfo(`      原因: ${item.reason_zh}`);
+                    if (item.verification_command)
+                        userInfo(`      复验: ${item.verification_command}`);
+                }
+            }
+            if (plan.project_knowledge_context.blocked && plan.project_knowledge_context.blocked.length > 0) {
+                userInfo("  必须先处理:");
+                for (const item of plan.project_knowledge_context.blocked) {
+                    userInfo(`    - ${item.name} (${item.rel_path})`);
+                    userInfo(`      原因: ${item.reason_zh}`);
+                    if (item.recovery)
+                        userInfo(`      恢复: ${item.recovery}`);
                 }
             }
         }
@@ -2912,14 +2953,30 @@ async function cmdAuditProjectKnowledge() {
     userInfo(`  hard_fail: ${report.hard_fail_count}`);
     userInfo(`  warning: ${report.warning_count}`);
     for (const asset of report.assets) {
-        if (asset.findings.length === 0)
-            continue;
         userInfo(`  - ${asset.rel_path} (${asset.identity}/${asset.consumption})`);
+        userInfo(`    创建: ${asset.evidence.created_by}；索引: ${asset.evidence.indexed_by}`);
+        if (asset.lifecycle_stages.length > 0)
+            userInfo(`    阶段: ${asset.lifecycle_stages.join(", ")}`);
+        if (asset.path_patterns.length > 0)
+            userInfo(`    路径: ${asset.path_patterns.join(", ")}`);
+        if (asset.traceability_ids.length > 0)
+            userInfo(`    追踪: ${asset.traceability_ids.join(", ")}`);
+        if (asset.verification_commands.length > 0)
+            userInfo(`    复验: ${asset.verification_commands.join(" / ")}`);
+        if (asset.evidence.last_consumed_at) {
+            userInfo(`    最近消费: ${asset.evidence.last_consumption_consumer}/${asset.evidence.last_consumption_action} ${asset.evidence.last_consumed_task} @ ${asset.evidence.last_consumed_at}`);
+        }
         for (const finding of asset.findings) {
             const mark = finding.severity === "hard_fail" ? "❌" : finding.severity === "warning" ? "⚠️" : "ℹ️";
             userInfo(`    ${mark} [${finding.code}] ${finding.message_zh}`);
         }
     }
+    if (report.recent_consumption.length > 0) {
+        userInfo("  最近消费证据:");
+        for (const item of report.recent_consumption.slice(0, 10)) {
+            userInfo(`    - ${item.rel_path ?? item.asset_id}: ${item.consumer}/${item.action ?? "unknown"} ${item.lifecycle_stage ?? "unknown_stage"} ${item.task_id_or_route} ${item.decision ?? ""}`);
+        }
+    }
     if (report.recommended_next_steps.length > 0) {
         userInfo("  下一步:");
         for (const step of report.recommended_next_steps)