@xenonbyte/da-vinci-workflow 0.2.2 → 0.2.3

package/lib/supervisor-review.js

@@ -416,7 +416,7 @@ function extractMcpRuntimeGateStatus(markdownText) {
   }
 
   const statusMatch = String(section).match(
-    /(?:^|\n)\s*-\s*(?:Status|状态)\s*:\s*`?(PASS|WARN|BLOCK)`?\b/i
+    /(?:^|\n)\s*-\s*(?:Final runtime gate status|Status|状态)\s*:\s*`?(PASS|WARN|BLOCK)`?\b/i
   );
   return statusMatch ? String(statusMatch[1]).toUpperCase() : "";
 }

package/lib/workflow-bootstrap.js

@@ -1,8 +1,8 @@
 const fs = require("fs");
 const path = require("path");
 
-const { isPathInside } = require("./fs-safety");
 const { ensurePenFile } = require("./pen-persistence");
+const { resolvePreferredRegisteredPenPath } = require("./design-source-registry");
 const { pathExists, readTextIfExists, writeFileAtomic } = require("./utils");
 
 const DEFAULT_PROJECT_PEN_RELATIVE_PATH = ".da-vinci/designs/project-baseline.pen";
@@ -20,17 +20,6 @@ function validateChangeId(changeId) {
   return normalized;
 }
 
-function extractRegisteredPenPath(projectRoot, registryText) {
-  const matches = String(registryText || "").match(/\.da-vinci\/designs\/[^\s`]+\.pen/g) || [];
-  for (const relativePath of matches) {
-    const resolvedPath = path.resolve(projectRoot, relativePath);
-    if (isPathInside(projectRoot, resolvedPath)) {
-      return resolvedPath;
-    }
-  }
-  return "";
-}
-
 function buildProjectTemplates(preferredPenRelativePath) {
   return {
     "DA-VINCI.md": [
@@ -151,7 +140,7 @@ function bootstrapProjectArtifacts(projectPathInput, options = {}) {
   fs.mkdirSync(path.join(projectRoot, ".da-vinci", "changes"), { recursive: true });
 
   const existingRegistryText = readTextIfExists(path.join(projectRoot, ".da-vinci", "design-registry.md"));
-  const registeredPenPath = extractRegisteredPenPath(projectRoot, existingRegistryText);
+  const registeredPenPath = resolvePreferredRegisteredPenPath(projectRoot, existingRegistryText);
   const preferredPenPath = registeredPenPath || path.join(projectRoot, DEFAULT_PROJECT_PEN_RELATIVE_PATH);
   const preferredPenRelativePath = path.relative(projectRoot, preferredPenPath) || DEFAULT_PROJECT_PEN_RELATIVE_PATH;
 

package/lib/workflow-persisted-state.js

@@ -2,7 +2,7 @@ const fs = require("fs");
 const path = require("path");
 const { writeFileAtomic, pathExists, readTextIfExists } = require("./utils");
 
-const WORKFLOW_STATE_VERSION = 1;
+const WORKFLOW_STATE_VERSION = 2;
 const DEFAULT_STALE_WINDOW_MS = 24 * 60 * 60 * 1000;
 const PERSISTED_NOTE_EXCLUDE_PATTERNS = [
   /^No persisted workflow state found for this change; deriving from artifacts\.$/i,
@@ -38,7 +38,9 @@ function fingerprintForPath(targetPath) {
 function buildWorkflowFingerprint(projectRoot, changeId) {
   const changeRoot = changeId ? path.join(projectRoot, ".da-vinci", "changes", changeId) : "";
   const candidates = [
+    path.join(projectRoot, "DA-VINCI.md"),
     path.join(projectRoot, ".da-vinci", "page-map.md"),
+    path.join(projectRoot, ".da-vinci", "design-registry.md"),
     path.join(changeRoot, "proposal.md"),
     path.join(changeRoot, "design.md"),
     path.join(changeRoot, "pencil-design.md"),

package/lib/workflow-state.js

@@ -13,7 +13,8 @@ const {
   STATUS,
   CHECKPOINT_LABELS,
   HANDOFF_GATES,
-  getStageById
+  getStageById,
+  mergeStatuses
 } = require("./workflow-contract");
 const {
   selectPersistedStateForChange,
@@ -49,6 +50,14 @@ function dedupeFindings(findings) {
   findings.notes = dedupeMessages(findings.notes);
 }
 
+function normalizeCheckpointStatus(status) {
+  const normalized = String(status || "").toUpperCase();
+  if (normalized === STATUS.PASS || normalized === STATUS.WARN || normalized === STATUS.BLOCK) {
+    return normalized;
+  }
+  return STATUS.PASS;
+}
+
 function collectIntegrityAudit(projectRoot, workflowRoot, signalSummary) {
   if (!pathExists(workflowRoot)) {
     return null;
@@ -266,6 +275,24 @@ function deriveStageFromArtifacts(artifactState, checkpointStatuses, findings) {
     findings.warnings.push("`design checkpoint` is WARN.");
   }
 
+  const designSourceCheckpoint = checkpointStatuses[CHECKPOINT_LABELS.DESIGN_SOURCE];
+  if (designSourceCheckpoint === STATUS.BLOCK) {
+    findings.blockers.push("`design source checkpoint` is BLOCK.");
+    return "design";
+  }
+  if (designSourceCheckpoint === STATUS.WARN) {
+    findings.warnings.push("`design source checkpoint` is WARN.");
+  }
+
+  const runtimeGateCheckpoint = checkpointStatuses[CHECKPOINT_LABELS.RUNTIME_GATE];
+  if (runtimeGateCheckpoint === STATUS.BLOCK) {
+    findings.blockers.push("`mcp runtime gate` is BLOCK.");
+    return "design";
+  }
+  if (runtimeGateCheckpoint === STATUS.WARN) {
+    findings.warnings.push("`mcp runtime gate` is WARN.");
+  }
+
   const mappingCheckpoint = checkpointStatuses[CHECKPOINT_LABELS.MAPPING];
   if (mappingCheckpoint === STATUS.BLOCK) {
     findings.blockers.push("`mapping checkpoint` is BLOCK.");
@@ -482,6 +509,15 @@ function deriveWorkflowStatus(projectPathInput, options = {}) {
       )
     : {};
   const integrityAudit = collectIntegrityAudit(projectRoot, workflowRoot, signalSummary);
+  const designCheckpointStatus = normalizeCheckpointStatus(checkpointStatuses[CHECKPOINT_LABELS.DESIGN]);
+  const designSourceCheckpointStatus = normalizeCheckpointStatus(
+    checkpointStatuses[CHECKPOINT_LABELS.DESIGN_SOURCE]
+  );
+  const runtimeGateCheckpointStatus = normalizeCheckpointStatus(
+    checkpointStatuses[CHECKPOINT_LABELS.RUNTIME_GATE]
+  );
+  const mappingCheckpointStatus = normalizeCheckpointStatus(checkpointStatuses[CHECKPOINT_LABELS.MAPPING]);
+  const taskCheckpointStatus = normalizeCheckpointStatus(checkpointStatuses[CHECKPOINT_LABELS.TASK]);
 
   if (activeChangeId) {
     const persistedSelection = selectPersistedStateForChange(projectRoot, activeChangeId, {
@@ -579,11 +615,23 @@ function deriveWorkflowStatus(projectPathInput, options = {}) {
   const gates = {
     [HANDOFF_GATES.BREAKDOWN_TO_DESIGN]:
       artifactState.proposal && artifactState.specFiles.length > 0 ? STATUS.PASS : STATUS.BLOCK,
-    [HANDOFF_GATES.DESIGN_TO_TASKS]:
+    [HANDOFF_GATES.DESIGN_TO_TASKS]: mergeStatuses([
       artifactState.design && artifactState.pencilDesign && artifactState.pencilBindings
         ? STATUS.PASS
         : STATUS.BLOCK,
-    [HANDOFF_GATES.TASKS_TO_BUILD]: artifactState.tasks ? STATUS.PASS : STATUS.BLOCK,
+      designCheckpointStatus,
+      designSourceCheckpointStatus,
+      runtimeGateCheckpointStatus,
+      mappingCheckpointStatus
+    ]),
+    [HANDOFF_GATES.TASKS_TO_BUILD]: mergeStatuses([
+      artifactState.tasks ? STATUS.PASS : STATUS.BLOCK,
+      designCheckpointStatus,
+      designSourceCheckpointStatus,
+      runtimeGateCheckpointStatus,
+      mappingCheckpointStatus,
+      taskCheckpointStatus
+    ]),
     [HANDOFF_GATES.BUILD_TO_VERIFY]: artifactState.verification ? STATUS.PASS : STATUS.BLOCK,
     [HANDOFF_GATES.VERIFY_TO_COMPLETE]:
       completionAudit && completionAudit.status === "PASS" ? STATUS.PASS : STATUS.WARN

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xenonbyte/da-vinci-workflow",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Requirement-to-design-to-code workflow skill for Codex, Claude, and Gemini",
   "bin": {
     "da-vinci": "bin/da-vinci.js",

package/tui/catalog.js

@@ -80,6 +80,86 @@ const STAGES = [
   }
 ];
 
+const SCENES = [
+  {
+    id: "install-uninstall",
+    title: {
+      en: "Install & Uninstall",
+      zh: "安装与卸载"
+    },
+    summary: {
+      en: "Choose install or uninstall and run it against all supported platforms.",
+      zh: "选择安装或卸载，并直接对所有支持平台执行。"
+    }
+  },
+  {
+    id: "current-status",
+    title: {
+      en: "Current Status",
+      zh: "当前状态"
+    },
+    summary: {
+      en: "Run workflow-status plus next-step, then show the current workflow summary and recommended next move.",
+      zh: "执行 workflow-status 与 next-step，并汇总当前工作流状态和建议下一步。"
+    }
+  },
+  {
+    id: "switch-work-item",
+    title: {
+      en: "Switch Work Item",
+      zh: "切换工作项"
+    },
+    summary: {
+      en: "Choose the active change from existing work items in this project.",
+      zh: "从当前项目已有的工作项目中选择正在处理的 change。"
+    }
+  },
+  {
+    id: "design-work",
+    title: {
+      en: "Design Ops",
+      zh: "设计操作"
+    },
+    summary: {
+      en: "Run design-save, icon sync, and managed Visual Assist generation.",
+      zh: "执行设计保存、图标同步和受控 Visual Assist 生成。"
+    }
+  },
+  {
+    id: "pre-implementation-checks",
+    title: {
+      en: "Pre-Implementation Checks",
+      zh: "实施前检查"
+    },
+    summary: {
+      en: "Run planning and readiness checks before writing implementation code.",
+      zh: "在开始实现代码前执行规划与就绪度检查。"
+    }
+  },
+  {
+    id: "pre-completion-validation",
+    title: {
+      en: "Pre-Acceptance Checks",
+      zh: "验收前检查"
+    },
+    summary: {
+      en: "Run the pre-acceptance verify chain before completion claims.",
+      zh: "在完成声明前运行验收前 verify 链路。"
+    }
+  },
+  {
+    id: "more",
+    title: {
+      en: "Settings",
+      zh: "设置"
+    },
+    summary: {
+      en: "Language and logs.",
+      zh: "语言与日志。"
+    }
+  }
+];
+
 function normalizeLanguage(value) {
   return value === "zh" ? "zh" : "en";
 }
@@ -765,6 +845,28 @@ const COMMANDS = [
       return args;
     }
   }),
+  createCommand({
+    id: "save-current-design",
+    stageId: "pencil",
+    title: { en: "save-current-design", zh: "save-current-design" },
+    summary: {
+      en: "Run the high-level bound-source save flow for the active Pencil design session.",
+      zh: "运行高层绑定源保存流程，保存当前活跃 Pencil 设计会话。"
+    },
+    details: {
+      en: "This flow validates registered/session/editor convergence and reports saved, blocked, or unavailable honestly.",
+      zh: "该流程会校验 registered/session/editor 三方收敛，并明确返回 saved、blocked 或 unavailable。"
+    },
+    supportsJson: true,
+    supportsContinueOnError: true,
+    buildArgs(context) {
+      const args = ["save-current-design"];
+      maybeProject(args, context, { force: true });
+      maybeJson(args, context, true);
+      maybeContinueOnError(args, context, true);
+      return args;
+    }
+  }),
   createCommand({
     id: "pencil-session-end",
     stageId: "pencil",
@@ -1175,6 +1277,7 @@ function tokenizeCommandLine(input) {
 }
 
 module.exports = {
+  SCENES,
   STAGES,
   COMMANDS,
   buildCommandArgs,