@guanlin4924/devflow-pi 0.1.103 → 0.1.105

package/README.md

@@ -11,7 +11,7 @@ Devflow Pi 是一个面向项目研发交付的独立 OMP 产品入口，内置
 安装与启动：
 
 ```bash
-npm install -g @guanlin4924/devflow-pi@0.1.103
+npm install -g @guanlin4924/devflow-pi@0.1.105
 cd /path/to/your-project
 devflow-pi init
 devflow-pi doctor

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guanlin4924/devflow-pi",
-  "version": "0.1.103",
+  "version": "0.1.105",
   "type": "module",
   "description": "Devflow 专项研发 Pi，基于固定版本 OMP Runtime 组装研发状态机、代码智能、设计、实现与质量门禁。",
   "license": "UNLICENSED",

package/plugins/devflow-core/skills/workflow-orchestrator/scripts/inspect_state.rb

@@ -563,6 +563,7 @@ result =
             next_step = next_id && step_by_id[next_id]
             checkpoint_id = state["checkpoint"] || current_step["checkpoint"]
             checkpoint = checkpoint_id && workflow.fetch("checkpoints", {})[checkpoint_id]
+            checkpoint = checkpoint.merge("id" => checkpoint_id) if checkpoint.is_a?(Hash)
             parallel_window = active_parallel_window(workflow, state, root, step_by_id, completed_ids, pending_ids, artifact_by_path)
             failure_branch = active_failure_branch(workflow, state, current_step, current_outputs, root)
 
@@ -636,7 +637,14 @@ result =
               missing_outputs = current_outputs
                                 .select { |output| output["required"] && !output["exists"] }
                                 .map { |output| output["resolved_path"] }
-              checkpoint_meta_errors = CheckpointMeta.validate(root: root, state: state, checkpoint: checkpoint)
+              # Approval-path outputs are written by Core only after the user
+              # confirms; they must not block entry into the waiting checkpoint.
+              meta_path = checkpoint.is_a?(Hash) && checkpoint["required_meta_output"]
+              checkpoint_meta_errors = if CheckpointMeta.approval_output?(checkpoint, meta_path)
+                                         []
+                                       else
+                                         CheckpointMeta.validate(root: root, state: state, checkpoint: checkpoint)
+                                       end
               missing_outputs.concat(checkpoint_meta_errors.map { |entry| entry["path"] }.compact)
               base.merge(
                 action: missing_outputs.empty? ? "await_user_confirmation" : "blocked",

package/plugins/devflow-core/skills/workflow-orchestrator/scripts/review_preflight.py

@@ -176,6 +176,9 @@ def preflight(root: Path, feature: str, step: str, contract_path: str,
             elif producer == "existing":
                 if not input_present(path):
                     issues.append({"code": "MISSING_INPUT_FACT", "index": index, "path": relative})
+                elif path.is_dir():
+                    # A rendered directory has no single-file fingerprint.
+                    evidence.append({"kind": "input_collection", "path": relative})
                 elif obligation.get("sha256") is not None and obligation.get("sha256") != sha256(path):
                     issues.append({"code": "STALE_INPUT_FACT", "index": index, "path": relative})
                 else:

package/plugins/devflow-core/skills/workflow-orchestrator/scripts/startup_preflight.py

@@ -40,7 +40,13 @@ def read_handoff(root: Path, relative: str, evidence: list[dict], issues: list[d
                 except ValueError:
                     issues.append({"code": "PREVIOUS_OUTPUT_MISSING", "path": output_relative})
                     continue
-                if not output_path.is_file():
+                if output_path.is_dir() and item.get("sha256") is None:
+                    # Directory outputs (e.g. wireframes/screens) are recorded without a hash.
+                    if review_preflight.input_present(output_path):
+                        evidence.append({"kind": "previous_output_collection", "path": output_relative})
+                    else:
+                        issues.append({"code": "PREVIOUS_OUTPUT_MISSING", "path": output_relative})
+                elif not output_path.is_file():
                     issues.append({"code": "PREVIOUS_OUTPUT_MISSING", "path": output_relative})
                 elif item.get("sha256") != review_preflight.sha256(output_path):
                     issues.append({"code": "PREVIOUS_OUTPUT_CHANGED", "path": output_relative})

package/src/constants.ts

@@ -1,5 +1,5 @@
 export const PRODUCT_NAME = "Devflow Pi";
-export const PRODUCT_VERSION = "0.1.103";
+export const PRODUCT_VERSION = "0.1.105";
 export const PROJECT_SCHEMA_VERSION = 1;
 export const OMP_RUNTIME_VERSION = "17.2.7";
 

package/src/workflow-diagnosis.ts

@@ -114,6 +114,26 @@ function validationEvidence(snapshot: Record<string, unknown>): string[] {
   });
 }
 
+/**
+ * The blocking step may declare no required outputs of its own while the
+ * checkpoint meta output is what is actually missing. Surface the inspector's
+ * own missing list so the diagnosis never renders with empty evidence.
+ */
+function missingOutputEvidence(snapshot: Record<string, unknown>): string[] {
+  const missing = Array.isArray(snapshot.missing_outputs) ? snapshot.missing_outputs : [];
+  const metaErrors = Array.isArray(snapshot.checkpoint_meta_errors) ? snapshot.checkpoint_meta_errors : [];
+  const missingPaths = missing.filter((item): item is string => typeof item === "string");
+  const missingItems = missingPaths.map(item => `${item}（缺失）`);
+  const metaItems = metaErrors.slice(0, 5).flatMap(error => {
+    const item = record(error);
+    const path = text(item?.path);
+    if (!path || missingPaths.includes(path)) return [];
+    const field = text(item?.field);
+    return [`${path}${field ? `（缺少字段 ${field}）` : "（缺失或不合法）"}`];
+  });
+  return [...missingItems, ...metaItems];
+}
+
 function progressOf(snapshot: Record<string, unknown>, stepId: string | undefined): WorkflowDiagnosis["progress"] {
   const steps = Array.isArray(snapshot.workflow_steps) ? snapshot.workflow_steps : [];
   const index = steps.findIndex(step => record(step)?.id === stepId);
@@ -215,7 +235,7 @@ export function diagnoseWorkflow(input: DiagnosisInput): WorkflowDiagnosis {
     const evidence = [
       ...(text(snapshot.message) ? [String(snapshot.message)] : []),
       ...validationEvidence(snapshot),
-      ...(code === "CHECKPOINT_OUTPUTS_MISSING" ? outputPaths(step) : []),
+      ...(code === "CHECKPOINT_OUTPUTS_MISSING" ? [...missingOutputEvidence(snapshot), ...outputPaths(step)] : []),
     ];
     return {
       ...base,