@xenonbyte/da-vinci-workflow 0.2.1 → 0.2.3

package/lib/cli.js

@@ -32,6 +32,11 @@ const {
   endPencilSession,
   getPencilSessionStatus
 } = require("./pencil-session");
+const {
+  SAVE_STATUS,
+  saveCurrentDesign,
+  formatSaveCurrentDesignReport
+} = require("./save-current-design");
 const {
   searchIconLibrary,
   formatIconSearchReport
@@ -74,6 +79,7 @@ const {
 const { diffSpec, formatDiffSpecReport } = require("./diff-spec");
 const { scaffoldFromBindings, formatScaffoldReport } = require("./scaffold");
 const { writeExecutionSignal } = require("./execution-signals");
+const { formatTuiHelp, launchTui } = require("../tui");
 
 const DEFAULT_MAX_PREFLIGHT_STDIN_BYTES = 1024 * 1024;
 const DEFAULT_MAX_STDIN_TRANSIENT_RETRIES = 2000;
@@ -81,6 +87,8 @@ const DEFAULT_MAX_STDIN_TRANSIENT_BACKOFF_MS = 25;
 const OPTION_FLAGS_WITH_VALUES = new Set([
   "--home",
   "--platform",
+  "--lang",
+  "--tui-width",
   "--project",
   "--mode",
   "--change",
@@ -111,6 +119,7 @@ const OPTION_FLAGS_WITH_VALUES = new Set([
   "--from",
   "--to",
   "--pen",
+  "--pencil-bin",
   "--nodes-file",
   "--variables-file",
   "--version",
@@ -120,6 +129,8 @@ const OPTION_FLAGS_WITH_VALUES = new Set([
 
 const HELP_OPTION_SPECS = [
   { flag: "--platform <value>", description: "codex, claude, gemini, or all" },
+  { flag: "--lang <value>", description: "ui language for `da-vinci tui`: en or zh" },
+  { flag: "--tui-width <cols>", description: "fixed layout width (columns) for `da-vinci tui`" },
   { flag: "--home <path>", description: "override HOME for installation targets" },
   { flag: "--project <path>", description: "override project path for audit" },
   {
@@ -185,12 +196,15 @@ const HELP_OPTION_SPECS = [
     flag: "--strict",
     description: "enable strict failure mode for commands that support advisory defaults (for example icon-sync, lint-spec)"
   },
+  { flag: "--alt-screen", description: "enable alternate terminal screen buffer for `da-vinci tui`" },
+  { flag: "--no-alt-screen", description: "disable alternate terminal screen buffer for `da-vinci tui`" },
   {
     flag: "--continue-on-error",
     description: "print BLOCK/FAIL command results without throwing process errors"
   },
   { flag: "--json", description: "print structured JSON output when supported by the command" },
   { flag: "--pen <path>", description: "registered .pen path for sync checks" },
+  { flag: "--pencil-bin <path>", description: "override Pencil executable for interactive capture/verify flows" },
   {
     flag: "--from <path>",
     description: "source path for sync-pen-source, or baseline sidecars directory for diff-spec"
@@ -472,6 +486,7 @@ function printHelp() {
       "  da-vinci install --platform codex,claude,gemini",
       "  da-vinci uninstall --platform codex,claude,gemini",
       "  da-vinci status",
+      "  da-vinci tui [--project <path>] [--change <id>] [--lang en|zh] [--strict] [--json] [--continue-on-error] [--tui-width <cols>] [--alt-screen|--no-alt-screen]",
       "  da-vinci workflow-status [--project <path>] [--change <id>] [--json]",
       "  da-vinci next-step [--project <path>] [--change <id>] [--json]",
       "  da-vinci lint-spec [--project <path>] [--change <id>] [--strict] [--json]",
@@ -498,6 +513,7 @@ function printHelp() {
       "  da-vinci check-pen-baseline --pen <path> --baseline <path>[,<path>...] [--baseline <path>] [--prefer-source <path>]",
       "  da-vinci sync-pen-source --from <path> --to <path>",
       "  da-vinci snapshot-pen --input <path> --output <path>",
+      "  da-vinci save-current-design --project <path> [--json] [--continue-on-error]",
       "  da-vinci pencil-lock acquire --project <path>",
       "  da-vinci pencil-lock release --project <path>",
       "  da-vinci pencil-lock status",
@@ -937,6 +953,33 @@ async function runCli(argv) {
     return;
   }
 
+  if (command === "tui") {
+    const projectPath = getOption(argv, "--project") || positionalArgs[0] || process.cwd();
+    const changeId = getOption(argv, "--change");
+    const lang = getOption(argv, "--lang");
+    const tuiWidth = getOption(argv, "--tui-width");
+    const altScreen = argv.includes("--alt-screen")
+      ? true
+      : argv.includes("--no-alt-screen")
+        ? false
+        : undefined;
+    if (argv.includes("--help") || argv.includes("-h")) {
+      console.log(formatTuiHelp(lang));
+      return;
+    }
+    await launchTui({
+      projectPath,
+      changeId,
+      lang,
+      tuiWidth,
+      altScreen,
+      strict: argv.includes("--strict"),
+      jsonOutput: argv.includes("--json"),
+      continueOnError
+    });
+    return;
+  }
+
   if (command === "workflow-status") {
     const projectPath = getOption(argv, "--project") || positionalArgs[0] || process.cwd();
     const changeId = getOption(argv, "--change");
@@ -1402,6 +1445,35 @@ async function runCli(argv) {
     return;
   }
 
+  if (command === "save-current-design") {
+    const projectPath = getOption(argv, "--project") || positionalArgs[0] || process.cwd();
+    const pencilBin = getOption(argv, "--pencil-bin");
+    const result = await saveCurrentDesign({
+      projectPath,
+      homeDir,
+      pencilBin,
+      allowLocalBridge: true
+    });
+    const useJson = argv.includes("--json");
+    const output = useJson
+      ? JSON.stringify(result, null, 2)
+      : formatSaveCurrentDesignReport(result);
+
+    if (
+      emitOrThrowOnStatus(
+        result.status,
+        [SAVE_STATUS.BLOCKED, SAVE_STATUS.UNAVAILABLE],
+        output,
+        continueOnError
+      )
+    ) {
+      return;
+    }
+
+    console.log(output);
+    return;
+  }
+
   if (command === "pencil-lock") {
     handlePencilLockCommand(argv, homeDir);
     return;

package/lib/design-source-registry.js

@@ -0,0 +1,146 @@
+const path = require("path");
+const { isPathInside } = require("./fs-safety");
+
+const REGISTERED_PEN_PATTERN = /\.da-vinci\/designs\/[^\s`]+\.pen/g;
+
+function normalizeProjectRoot(projectRoot) {
+  return path.resolve(projectRoot || process.cwd());
+}
+
+function collectRegisteredPenReferences(registryText) {
+  const matches = String(registryText || "").match(REGISTERED_PEN_PATTERN) || [];
+  const seen = new Set();
+  const unique = [];
+
+  for (const match of matches) {
+    const normalized = String(match || "").trim();
+    if (!normalized || seen.has(normalized)) {
+      continue;
+    }
+    seen.add(normalized);
+    unique.push(normalized);
+  }
+
+  return unique;
+}
+
+function normalizeBoundPenPath(projectRoot, penPath, options = {}) {
+  const root = normalizeProjectRoot(projectRoot);
+  const raw = typeof penPath === "string" ? penPath.trim() : "";
+
+  if (!raw) {
+    return {
+      ok: false,
+      code: options.missingCode || "missing_path",
+      input: raw,
+      resolvedPath: ""
+    };
+  }
+
+  if (options.rejectNew && raw.toLowerCase() === "new") {
+    return {
+      ok: false,
+      code: options.newCode || "active_editor_new",
+      input: raw,
+      resolvedPath: ""
+    };
+  }
+
+  const resolvedPath = path.normalize(path.isAbsolute(raw) ? raw : path.resolve(root, raw));
+  if (!isPathInside(root, resolvedPath)) {
+    return {
+      ok: false,
+      code: options.outsideCode || "outside_project_root",
+      input: raw,
+      resolvedPath
+    };
+  }
+
+  if (options.requirePenExtension !== false && !/\.pen$/i.test(resolvedPath)) {
+    return {
+      ok: false,
+      code: options.extensionCode || "not_pen_path",
+      input: raw,
+      resolvedPath
+    };
+  }
+
+  return {
+    ok: true,
+    code: "ok",
+    input: raw,
+    resolvedPath
+  };
+}
+
+function normalizeRegisteredPenPath(projectRoot, penPath) {
+  return normalizeBoundPenPath(projectRoot, penPath, {
+    missingCode: "registered_pen_missing",
+    outsideCode: "registered_pen_outside_project_root",
+    extensionCode: "registered_pen_not_pen_path"
+  });
+}
+
+function normalizeSessionPenPath(projectRoot, penPath) {
+  return normalizeBoundPenPath(projectRoot, penPath, {
+    missingCode: "session_pen_missing",
+    outsideCode: "session_pen_outside_project_root",
+    extensionCode: "session_pen_not_pen_path"
+  });
+}
+
+function normalizeActiveEditorPath(projectRoot, activeEditorPath) {
+  return normalizeBoundPenPath(projectRoot, activeEditorPath, {
+    rejectNew: true,
+    missingCode: "active_editor_missing",
+    newCode: "active_editor_new",
+    outsideCode: "active_editor_outside_project_root",
+    extensionCode: "active_editor_not_pen_path"
+  });
+}
+
+function collectRegisteredPenPaths(projectRoot, registryText) {
+  const root = normalizeProjectRoot(projectRoot);
+  const references = collectRegisteredPenReferences(registryText);
+  const validPaths = [];
+  const escapedPaths = [];
+  const seenResolved = new Set();
+
+  for (const relativePath of references) {
+    const normalized = normalizeRegisteredPenPath(root, relativePath);
+    if (normalized.ok) {
+      if (!seenResolved.has(normalized.resolvedPath)) {
+        seenResolved.add(normalized.resolvedPath);
+        validPaths.push(normalized.resolvedPath);
+      }
+      continue;
+    }
+
+    if (normalized.code === "registered_pen_outside_project_root") {
+      escapedPaths.push({
+        relativePath,
+        resolvedPath: normalized.resolvedPath
+      });
+    }
+  }
+
+  return {
+    validPaths,
+    escapedPaths
+  };
+}
+
+function resolvePreferredRegisteredPenPath(projectRoot, registryText) {
+  const resolved = collectRegisteredPenPaths(projectRoot, registryText);
+  return resolved.validPaths[0] || "";
+}
+
+module.exports = {
+  collectRegisteredPenReferences,
+  normalizeBoundPenPath,
+  normalizeRegisteredPenPath,
+  normalizeSessionPenPath,
+  normalizeActiveEditorPath,
+  collectRegisteredPenPaths,
+  resolvePreferredRegisteredPenPath
+};