kcode-pi 0.1.20 → 0.1.23

package/src/harness/artifacts.ts

@@ -47,11 +47,12 @@ export function defaultArtifactContent(phase: KdPhase, goal?: string, profile?:
 				"- 版本：未知",
 				`- 技术栈：${profile?.techStack ?? "未知"}`,
 				`- 语言：${profile?.language ?? "未知"}`,
-				"- 插件类型：未知",
-				"- 目标单据/实体/表单：未知",
+				"- 需求条目：未知",
+				"- 目标对象：未知",
+				"- 依赖和批次：未知",
 				"- 非目标范围：未知",
 				"- 待确认问题：",
-				"  - 确认金蝶产品/版本、技术栈、插件类型和目标对象。",
+				"  - 从需求来源中提取可确认事实；只把无法判断且阻塞推进的关键点列为待确认。",
 				"",
 			].join("\n");
 		case "spec":
@@ -60,9 +61,11 @@ export function defaultArtifactContent(phase: KdPhase, goal?: string, profile?:
 				"",
 				"## 验收标准",
 				"",
-				"## 生命周期 / 扩展点",
+				"## 需求条目",
 				"",
-				"## 数据对象和字段",
+				"## 数据对象、字段或影响范围",
+				"",
+				"## 依赖和批次",
 				"",
 				"## 异常行为和性能约束",
 				"",
@@ -81,12 +84,21 @@ export function defaultArtifactContent(phase: KdPhase, goal?: string, profile?:
 				"",
 				"## 允许修改的文件",
 				"",
+				"## 产品实现范围",
+				"",
+				"- 是否涉及产品实现、构建、元数据或 SDK 查证：待确认",
+				"- 判断依据：待确认",
+				"",
 				"## 必需的金蝶查证项",
 				"",
 				"- Java/C# 代码涉及 SDK 类、方法、构造器、枚举、属性时，必须先用 kd_sdk_signature 或项目构建输出确认真实签名。",
 				"- 知识库搜索、随包 Cosmic API 查询只能作为线索，不能作为最终方法签名事实。",
 				"- SDK 签名证据：evidence/sdk-signature.md",
 				"",
+				"## 需求条目 / 依赖 / 批次",
+				"",
+				"## 验收与验证对应关系",
+				"",
 				"## 执行步骤",
 				"",
 				"- [ ] STEP-001：检查现有目标文件，确认精确修改位置。",

package/src/harness/gates.ts

@@ -37,8 +37,9 @@ function collectGateProblems(cwd: string, run: ActiveRun, phase: KdPhase, mode:
 	const missing: string[] = [];
 	const reasonParts: string[] = [];
 
-	if (phase !== "discuss" && !isKnownProduct(run.profile?.product ?? run.product)) {
-		reasonParts.push(unknownProductReason());
+	if (phaseIndex >= PHASE_ORDER.indexOf("execute") && !isKnownProduct(run.profile?.product ?? run.product)) {
+		const declaration = productImplementationDeclaration(cwd, run);
+		if (declaration !== false) reasonParts.push(unknownProductReason(declaration));
 	}
 
 	if (phaseIndex >= PHASE_ORDER.indexOf("ship") && !hasRiskAssessment(cwd, run)) {
@@ -103,8 +104,24 @@ function gateResult(reasonParts: string[]): GateResult {
 	};
 }
 
-function unknownProductReason(): string {
-	return "不能离开 discuss：产品画像未知。下一步：根据需求或用户回答确认产品，然后执行 /kd-product <flagship|cosmic|xinghan|cangqiong|enterprise>；如果无法判断，先用 kd_question 只问一个最阻塞的产品确认问题。";
+function unknownProductReason(declaration: boolean | undefined): string {
+	if (declaration === undefined) {
+		return "不能进入 execute：产品画像未知，且 PLAN.md 未明确声明是否涉及产品实现、构建、元数据或 SDK 查证。下一步：先由当前需求和项目计划判断该范围；如果涉及产品实现，执行 /kd-product <flagship|xinghan|cangqiong|enterprise>；如果不涉及，在 PLAN.md 的“产品实现范围”写明“不涉及”及依据。";
+	}
+	return "不能进入 execute：PLAN.md 声明涉及产品实现、构建、元数据或 SDK 查证，但产品画像未知。下一步：根据需求、计划或用户回答确认产品，然后执行 /kd-product <flagship|xinghan|cangqiong|enterprise>；如果无法判断，先用 kd_question 只问一个最阻塞的产品确认问题。";
+}
+
+function productImplementationDeclaration(cwd: string, run: ActiveRun): boolean | undefined {
+	const plan = readArtifact(cwd, run, "plan") ?? "";
+	const line = plan
+		.split(/\r?\n/)
+		.map((item) => item.trim())
+		.find((item) => item.includes("是否涉及产品实现、构建、元数据或 SDK 查证"));
+	if (!line) return undefined;
+	const value = line.replace(/^[-*]\s*/, "").split(/[：:]/).slice(1).join(":").trim();
+	if (/^(是|涉及|需要|yes|true)(\s|。|，|,|；|;|$)/i.test(value)) return true;
+	if (/^(否|不涉及|不需要|无|no|false)(\s|。|，|,|；|;|$)/i.test(value)) return false;
+	return undefined;
 }
 
 function hasRiskAssessment(cwd: string, run: ActiveRun): boolean {

package/src/harness/state.ts

@@ -66,7 +66,7 @@ export function finishActiveRun(cwd: string, run: ActiveRun): ActiveRun {
 }
 
 export function createActiveRun(cwd: string, goal: string, productInput?: string, version?: string): ActiveRun {
-	const profile = resolveProductProfile(productInput ?? goal);
+	const profile = resolveProductProfile(productInput);
 	const now = new Date().toISOString();
 	const run: ActiveRun = {
 		id: createRunId(goal),
@@ -155,7 +155,7 @@ export function updateRisk(cwd: string, run: ActiveRun, risk: KdRisk, reason: st
 }
 
 export function ensurePhaseArtifact(cwd: string, run: ActiveRun, phase: KdPhase): string {
-	const path = ensureArtifact(cwd, run, phase, defaultArtifactContent(phase));
+	const path = ensureArtifact(cwd, run, phase, defaultArtifactContent(phase, run.goal, run.profile));
 	run.artifacts[phase] = PHASE_ARTIFACTS[phase];
 	run.gate = inspectGate(cwd, run);
 	writeActiveRun(cwd, run);

package/src/product/profile.ts

@@ -1,4 +1,4 @@
-export type KdProduct = "unknown" | "flagship" | "cosmic" | "xinghan" | "cangqiong" | "enterprise";
+export type KdProduct = "unknown" | "flagship" | "xinghan" | "cangqiong" | "enterprise";
 export type KdPlatform = "unknown" | "cosmic" | "enterprise-csharp" | "enterprise-python";
 export type KdTechStack = "unknown" | "java-bos" | "java-cosmic" | "csharp-bos" | "python-bos" | "ksql";
 export type KdLanguage = "unknown" | "java" | "csharp" | "python" | "sql";
@@ -24,7 +24,7 @@ const PROFILES: Record<KdProduct, ProductProfile> = {
 		language: "unknown",
 		knowledgeScope: "common",
 		requiresMetadataVerification: true,
-		notes: ["尚未选择产品；不要假设 Java、C#、BOS、Cosmic 或 KSQL 规则。"],
+		notes: ["尚未选择产品；不要假设插件技术栈、BOS/Cosmic 平台规则或 KSQL/SQL 交付规则。"],
 	},
 	flagship: {
 		product: "flagship",
@@ -35,21 +35,11 @@ const PROFILES: Record<KdProduct, ProductProfile> = {
 		knowledgeScope: "flagship",
 		requiresMetadataVerification: true,
 		notes: [
-			"星空旗舰版属于 Cosmic 家族。使用 Cosmic 元数据、插件生命周期、SDK 和后置检查约束。",
+			"星空旗舰版基于苍穹/Cosmic 平台。使用平台元数据、插件生命周期、SDK 和后置检查约束，但接口可能存在旗舰版差异。",
 			"如果当前工作区存在 code/ 目录，产品代码应放在 code/ 下。",
 			"创建或编辑代码前，必须检查 code/ 下真实项目结构，并跟随其实际布局；可能按云、按应用组织，也可能不分模块。",
 		],
 	},
-	cosmic: {
-		product: "cosmic",
-		displayName: "金蝶 Cosmic 平台",
-		platform: "cosmic",
-		techStack: "java-cosmic",
-		language: "java",
-		knowledgeScope: "cosmic",
-		requiresMetadataVerification: true,
-		notes: ["Cosmic 是苍穹、星瀚和星空旗舰版的共享平台基础。"],
-	},
 	xinghan: {
 		product: "xinghan",
 		displayName: "金蝶星瀚",
@@ -58,7 +48,7 @@ const PROFILES: Record<KdProduct, ProductProfile> = {
 		language: "java",
 		knowledgeScope: "xinghan",
 		requiresMetadataVerification: true,
-		notes: ["除非存在星瀚特有规则，否则按 Cosmic 家族 Java 处理。"],
+		notes: ["星瀚基于苍穹/Cosmic 平台。默认按平台 Java 插件处理，但接口可能存在星瀚差异。"],
 	},
 	cangqiong: {
 		product: "cangqiong",
@@ -68,7 +58,7 @@ const PROFILES: Record<KdProduct, ProductProfile> = {
 		language: "java",
 		knowledgeScope: "cangqiong",
 		requiresMetadataVerification: true,
-		notes: ["使用苍穹/Cosmic 插件、SDK、元数据、KSQL 和生命周期规则。"],
+		notes: ["Cosmic 在 KCode 中按苍穹平台语境处理。使用苍穹/Cosmic 平台插件、SDK、元数据、KSQL/SQL 和生命周期规则。"],
 	},
 	enterprise: {
 		product: "enterprise",
@@ -86,7 +76,7 @@ const PRODUCT_ALIASES: Array<[RegExp, KdProduct]> = [
 	[/企业版|enterprise|csharp|c#|\.net/i, "enterprise"],
 	[/星瀚|xinghan/i, "xinghan"],
 	[/苍穹|cangqiong/i, "cangqiong"],
-	[/cosmic|云苍穹/i, "cosmic"],
+	[/cosmic|云苍穹/i, "cangqiong"],
 	[/星空旗舰版|星空旗舰|旗舰版|旗舰|flagship/i, "flagship"],
 ];