@uipath/maestro-tool 1.204.0 → 1.205.0-preview.258

package/dist/{flow-validate-service-6ra3j72r.js → flow-validate-service-hgswxecb.js}

@@ -1,6 +1,3 @@
-import {
-  checkForwardMigration
-} from "./packager-tool-fgaphqq0.js";
 import {
   connectorNodeValidator,
   crossNodeBindingValidator,
@@ -8,7 +5,10 @@ import {
   isConnectorWaitForEventType,
   isEventDrivenConnectorType,
   readEssentialConfiguration
-} from "./packager-tool-3t417qyw.js";
+} from "./packager-tool-ktnfjmbs.js";
+import {
+  checkForwardMigration
+} from "./packager-tool-kd0whk4p.js";
 import {
   ERROR_SOURCE_PORT,
   deriveHandleCustomizationSourceOverride,
@@ -26,87 +26,99 @@ import {
   UI_ONLY_NODE_TYPES
 } from "./packager-tool-6c0vgghb.js";
 import {
+  INLINE_ACTIVITY_SOURCE,
+  INLINE_ACTIVITY_TYPE_PREFIX,
   collectNodeBindingResourceKeys,
+  collectScriptRefs,
+  getInlineActivityConfiguration,
   isProcessNode,
   resolveProcessTarget
-} from "./packager-tool-zm7thgdg.js";
+} from "./packager-tool-s7c0dg22.js";
+import"./packager-tool-v5ft7109.js";
+import"./packager-tool-n90231c7.js";
 import {
-  INLINE_ACTIVITY_SOURCE,
-  INLINE_ACTIVITY_TYPE_PREFIX,
-  collectScriptRefs,
-  getInlineActivityConfiguration
-} from "./packager-tool-3mvr6njb.js";
+  loadRegistry
+} from "./packager-tool-f6bh7bsm.js";
+import"./packager-tool-b84rs07t.js";
+import"./packager-tool-212khq09.js";
+import"./packager-tool-sb08yxk6.js";
 import {
-  isRecord
-} from "./packager-tool-64zypey6.js";
+  resolveProjectFlowFile
+} from "./packager-tool-sga4h8yj.js";
 import {
   findNodeDefinition
-} from "./packager-tool-7msx23gd.js";
+} from "./packager-tool-2qywkm61.js";
 import {
-  resolveProjectFlowFile
-} from "./packager-tool-b39nrh8y.js";
-import"./packager-tool-p7eactax.js";
-import"./packager-tool-7t0xj5pz.js";
+  isRecord
+} from "./packager-tool-m1901c0c.js";
 import {
-  loadRegistry
-} from "./packager-tool-rs4cgyy5.js";
-import"./packager-tool-k0bc2f6w.js";
-import"./packager-tool-zvpkw29f.js";
-import"./packager-tool-2k0hp4st.js";
-import"./packager-tool-eypvc2kv.js";
-import"./packager-tool-nct4k0y8.js";
+  loadCurrentTenantNodes
+} from "./packager-tool-arbc078z.js";
+import"./packager-tool-ajth6af3.js";
+import {
+  findProjectsWithoutProcessResource,
+  loadResourceKeyMap,
+  resourcesRefreshCommand
+} from "./packager-tool-0z498fh0.js";
 import"./packager-tool-8qp60s20.js";
-import"./packager-tool-8pydv61j.js";
-import"./packager-tool-vte7g48a.js";
+import"./packager-tool-5hnx28q0.js";
 import {
-  ManifestClient,
   buildErrorHandle
-} from "./packager-tool-c94w8xmz.js";
+} from "./packager-tool-9c2hte0h.js";
 import"./packager-tool-paq9c70w.js";
-import"./packager-tool-znhjsec2.js";
-import {
-  getLoginStatusAsync
-} from "./packager-tool-v99ygh9f.js";
+import"./packager-tool-7hw344bt.js";
+import"./packager-tool-eypvc2kv.js";
+import"./packager-tool-wwbk750c.js";
+import"./packager-tool-yn33pw57.js";
 import"./packager-tool-0gctz400.js";
 import"./packager-tool-qa9gftnj.js";
 import"./packager-tool-yc4kw997.js";
-import"./packager-tool-kme3q8xv.js";
+import"./packager-tool-ajhgr4bs.js";
+import"./packager-tool-mrskd7mn.js";
+import"./packager-tool-8tv6dvs5.js";
 import {
   findNearestParentUipxFile,
   readSolutionManifest
-} from "./packager-tool-j6q8v3kc.js";
-import"./packager-tool-npr79108.js";
-import"./packager-tool-8xhjr5ya.js";
-import"./packager-tool-ps84n76y.js";
+} from "./packager-tool-1q0ee9ht.js";
+import {
+  readSolutionInlineEntities
+} from "./packager-tool-6g510cab.js";
+import"./packager-tool-tgh9btcq.js";
 import {
   OutputFormatter,
   RESULTS,
   extractErrorMessageSync,
-  logger
-} from "./packager-tool-yv10w46z.js";
+  logger,
+  quoteForShell
+} from "./packager-tool-zgm0r4yp.js";
+import"./packager-tool-6sm17vbx.js";
 import {
   canonicalAgentInputPath,
   collectAgentInputLeaves,
   createFlowRefResolver,
   hydrateAgentNodeInputs,
+  inlineEntityBindingIssues,
   inlineFlowRefs,
   parseFlowSource,
   resolveWorkflowRefs,
   runDesignerRules
-} from "./packager-tool-x2py933t.js";
-import"./packager-tool-ts5t1nmn.js";
-import"./packager-tool-5jb06280.js";
-import"./packager-tool-kveaemqp.js";
-import"./packager-tool-nase5ajk.js";
+} from "./packager-tool-tzc6xsp3.js";
+import"./packager-tool-sxqtxw0e.js";
+import"./packager-tool-d1kd88zq.js";
+import"./packager-tool-y4tyghzf.js";
+import"./packager-tool-msecps3h.js";
+import"./packager-tool-rp7pny4t.js";
 import"./packager-tool-nkrmjr3a.js";
 import {
   getFileSystem
-} from "./packager-tool-xdxr3ync.js";
+} from "./packager-tool-hdxtgckw.js";
 import"./packager-tool-rs6jm14d.js";
 import"./packager-tool-hk1gxnth.js";
-import"./packager-tool-7q6z6npd.js";
+import"./packager-tool-mgcz986r.js";
+import"./packager-tool-xj0agqpk.js";
+import"./packager-tool-pcvhcn2k.js";
 import"./packager-tool-sc961w0q.js";
-import"./packager-tool-d88rqwk8.js";
+import"./packager-tool-6z1hsm2h.js";
 import"./packager-tool-dxz4sejs.js";
 import"./packager-tool-sztqqbxp.js";
 import"./packager-tool-gbgfwx8f.js";
@@ -133,12 +145,13 @@ import"./packager-tool-c23zrhj8.js";
 import"./packager-tool-yvcrdbgp.js";
 import {
   parse
-} from "./packager-tool-ajjpgh1s.js";
+} from "./packager-tool-nkbz7fsb.js";
 import"./packager-tool-bfgdz1zh.js";
-import"./packager-tool-8yjmkys9.js";
+import"./packager-tool-cza49qc1.js";
+import"./packager-tool-sm8ertv4.js";
 import {
   catchError
-} from "./packager-tool-z1qbc0qf.js";
+} from "./packager-tool-wv85dhy2.js";
 import {
   __require
 } from "./packager-tool-1yh8g550.js";
@@ -345,7 +358,7 @@ function buildDiagnosticMessage(label, classification, strict) {
   const strictNote = strict ? " (--strict-bindings promoted this to an error.)" : " Pass `--strict-bindings` to fail validation on this.";
   const connectorDetail = `{"authentication":"connector",` + `"targetConnector":"${classification.connectorKeyword}",` + `"connectionId":"<uuid>","folderKey":"<uuid>","method":"GET","url":"<path>"}`;
   const manualDetail = `{"authentication":"manual","method":"GET","url":"https://…"}`;
-  return `Node "${label}" ${connectorHint} but uses the generic Managed HTTP type \`${MANAGED_HTTP_NODE_TYPE}\` ` + "with no connection binding. The runtime will issue a raw HTTP call to an undefined endpoint. " + `Either bind a real Integration Service connection with \`uip maestro flow node configure <file> <node-id> --detail '${connectorDetail}'\`, ` + `or configure manual-mode HTTP with \`--detail '${manualDetail}'\`. ` + "If this node is intentionally a raw HTTP call, rename it so the label doesn't " + `imply a connector binding.${strictNote}`;
+  return `Node "${label}" ${connectorHint} but uses the generic Managed HTTP type \`${MANAGED_HTTP_NODE_TYPE}\` ` + "with no connection binding. The runtime will issue a raw HTTP call to an undefined endpoint. " + `Either bind a real Integration Service connection with \`uip maestro flow nodes configure <file> <node-id> --detail '${connectorDetail}'\`, ` + `or configure manual-mode HTTP with \`--detail '${manualDetail}'\`. ` + "If this node is intentionally a raw HTTP call, rename it so the label doesn't " + `imply a connector binding.${strictNote}`;
 }
 var MCP_CONNECTOR_KEY = "uipath-uipath-mcp";
 function readDetail(node) {
@@ -445,7 +458,7 @@ async function ensureCatalogRegistered() {
   if (catalogRegistered || !instance.isInitialized)
     return;
   try {
-    const { registerFlowExpressionModelI18n } = await import("./localization-p76prk3f.js");
+    const { registerFlowExpressionModelI18n } = await import("./localization-d151bzb1.js");
     registerFlowExpressionModelI18n(instance);
   } catch (error) {
     logger.warn(`Expression type checking localization unavailable, falling back to English: ${extractErrorMessageSync(error)}`);
@@ -454,7 +467,7 @@ async function ensureCatalogRegistered() {
 }
 var headlessModule;
 function loadHeadless() {
-  headlessModule ??= import("./headless-7rs6g9wg.js").then((mod) => {
+  headlessModule ??= import("./headless-z9enfh9f.js").then((mod) => {
     logger.info(`Expression type checking: @uipath/flow-expression-model (TypeScript ${mod.HEADLESS_TYPESCRIPT_VERSION})`);
     return mod;
   }).catch((error) => {
@@ -515,7 +528,7 @@ var activityTypeIdValidator = {
       {
         path: `nodes[${node.id}].inputs.detail.uiPathActivityTypeId`,
         severity: "error",
-        message: `${nodeKind} (\`${node.type}\`): \`inputs.detail.uiPathActivityTypeId\` is missing — Studio Web crashes when opening this flow. ` + `Fix: refresh the embedded definition without re-IDing the node — \`uip maestro flow registry get ${quotedType} --output json\`, replace the matching entry in \`definitions[]\` with the returned node object (preserve \`typeVersion\` exactly as returned), ` + `then \`uip maestro flow node configure <file> ${quotedId} --detail <json>\` to re-populate \`inputs.detail.uiPathActivityTypeId\` from the fresh manifest.`
+        message: `${nodeKind} (\`${node.type}\`): \`inputs.detail.uiPathActivityTypeId\` is missing — Studio Web crashes when opening this flow. ` + `Fix: refresh the embedded definition without re-IDing the node — \`uip maestro flow registry get ${quotedType} --output json\`, replace the matching entry in \`definitions[]\` with the returned node object (preserve \`typeVersion\` exactly as returned), ` + `then \`uip maestro flow nodes configure <file> ${quotedId} --detail <json>\` to re-populate \`inputs.detail.uiPathActivityTypeId\` from the fresh manifest.`
       }
     ];
   }
@@ -894,7 +907,7 @@ var inlineActivityValidator = {
     const config = getInlineActivityConfiguration(node);
     if (!config) {
       return [
-        issue("inputs.inlineActivityConfiguration", `Non-catalog activity node (\`${node.type}\`) has no \`inputs.inlineActivityConfiguration\` — the runtime has no activity to run. ` + "Fix: remove the node and re-add it with `uip maestro flow node add <file> <type> --metadata <Name>.json --scripts <dir>`.")
+        issue("inputs.inlineActivityConfiguration", `Non-catalog activity node (\`${node.type}\`) has no \`inputs.inlineActivityConfiguration\` — the runtime has no activity to run. ` + "Fix: remove the node and re-add it with `uip maestro flow nodes create <file> <type> --metadata <Name>.json --scripts <dir>`.")
       ];
     }
     if (!isInlineType) {
@@ -920,10 +933,10 @@ var inlineActivityValidator = {
     if (context && typeof context === "object") {
       const ac = context;
       if (ac.source !== INLINE_ACTIVITY_SOURCE) {
-        issues.push(issue("inputs.detail.activityContext.source", `\`activityContext.source\` must be "${INLINE_ACTIVITY_SOURCE}" for a non-catalog activity (got ${JSON.stringify(ac.source)}). Re-run \`uip maestro flow node configure\`.`));
+        issues.push(issue("inputs.detail.activityContext.source", `\`activityContext.source\` must be "${INLINE_ACTIVITY_SOURCE}" for a non-catalog activity (got ${JSON.stringify(ac.source)}). Re-run \`uip maestro flow nodes configure\`.`));
       }
       if (scriptRef && ac.scriptRef !== scriptRef) {
-        issues.push(issue("inputs.detail.activityContext.scriptRef", `\`activityContext.scriptRef\` (${JSON.stringify(ac.scriptRef)}) does not match the embedded activity's \`scriptRef\` ("${scriptRef}"). Re-run \`uip maestro flow node configure\`.`));
+        issues.push(issue("inputs.detail.activityContext.scriptRef", `\`activityContext.scriptRef\` (${JSON.stringify(ac.scriptRef)}) does not match the embedded activity's \`scriptRef\` ("${scriptRef}"). Re-run \`uip maestro flow nodes configure\`.`));
       }
     }
     return issues;
@@ -950,7 +963,12 @@ var FORBIDDEN_INPUT_FIELDS = [
   "fileName",
   "mimeType"
 ];
-var FILE_REF_PATTERN = /^=js:\$vars\.[A-Za-z_$]/;
+var FILE_REF_BODY_PATTERN = /^\$vars\.[A-Za-z_$]/;
+function isFileRefExpression(fileRef) {
+  const body = getJsExpressionBody(fileRef);
+  return body !== undefined && FILE_REF_BODY_PATTERN.test(body);
+}
+var EXTRACT_V2_NODE_TYPE = "uipath.ixp.extract-document-builder";
 var ixpNodeValidator = {
   id: "ixp-node",
   appliesTo: (node) => typeof node.type === "string" && node.type.startsWith("uipath.ixp."),
@@ -959,21 +977,23 @@ var ixpNodeValidator = {
     const inputs = node.inputs ?? {};
     const outputs = node.outputs ?? {};
     const base = `nodes[${node.id}]`;
-    const model = inputs.model;
     const isNonEmptyString2 = (v) => typeof v === "string" && v.length > 0;
-    if (typeof model !== "object" || model === null || Array.isArray(model) || !isNonEmptyString2(model.modelName) || !isNonEmptyString2(model.folderKey)) {
-      issues.push({
-        path: `${base}.inputs.model`,
-        severity: "error",
-        message: "inputs.model must be an object with non-empty string " + "`modelName` and `folderKey`. Studio Web's property " + "panel destructures these and crashes when either is " + "missing or not a string."
-      });
+    if (node.type !== EXTRACT_V2_NODE_TYPE) {
+      const model = inputs.model;
+      if (typeof model !== "object" || model === null || Array.isArray(model) || !isNonEmptyString2(model.modelName) || !isNonEmptyString2(model.folderKey)) {
+        issues.push({
+          path: `${base}.inputs.model`,
+          severity: "error",
+          message: "inputs.model must be an object with non-empty string " + "`modelName` and `folderKey`. Studio Web's property " + "panel destructures these and crashes when either is " + "missing or not a string."
+        });
+      }
     }
     const fileRef = inputs.fileRef;
-    if (typeof fileRef !== "string" || !FILE_REF_PATTERN.test(fileRef)) {
+    if (!isFileRefExpression(fileRef)) {
       issues.push({
         path: `${base}.inputs.fileRef`,
         severity: "error",
-        message: "inputs.fileRef must be a `=js:$vars.…` expression. " + "The canonical form for an upstream node output is " + "`=js:$vars.<upstream>.output.<field>`. Without the " + "`=js:` prefix the BPMN serializer treats the value " + "as a literal string at runtime."
+        message: "inputs.fileRef must be a `$vars` reference, for " + "example to an upstream node output. Write it either " + "as the string `=js:$vars.<upstream>.output.<field>` " + 'or as `{ "type": "jsExpression", "expression": ' + '"$vars.<upstream>.output.<field>" }` (no `=js:` ' + "prefix inside a jsExpression). Any other value, " + "including a `literal` value, reaches the runtime as " + "a literal and the upstream output never resolves."
       });
     }
     for (const port of ["output", "error"]) {
@@ -2119,6 +2139,7 @@ class FlowValidateService {
   availableModelNames;
   validateCurrentManifests;
   currentManifestOverrides;
+  manifestCache;
   strictBindings;
   strictExpressions;
   connectorCatalogOverride;
@@ -2135,6 +2156,7 @@ class FlowValidateService {
     this.availableModelNames = options.availableModelNames;
     this.validateCurrentManifests = options.validateCurrentManifests === true || options.currentManifests !== undefined;
     this.currentManifestOverrides = options.currentManifests;
+    this.manifestCache = options.manifestCache !== false;
     this.strictBindings = options.strictBindings === true;
     this.strictExpressions = options.strictExpressions === true;
     this.connectorCatalogOverride = options.connectorCatalog;
@@ -2188,27 +2210,13 @@ ${warnings.map((i) => `  - [${i.path}] ${i.message}`).join(`
     if (manifests) {
       return new Map(manifests.map((m) => [m.nodeType.toLowerCase(), m]));
     }
-    const [loginError, loginStatus] = await catchError(getLoginStatusAsync());
-    if (loginError) {
-      logger.warn(`Could not read login status for current manifest validation; using OOTB manifests: ${loginError.message}`);
-    }
-    const client = new ManifestClient({
-      baseUrl: loginStatus?.baseUrl || "localhost"
-    });
-    const auth = loginStatus?.loginStatus === "Logged in" && loginStatus.accessToken && loginStatus.tenantId && loginStatus.organizationId ? {
-      accessToken: loginStatus.accessToken,
-      tenantId: loginStatus.tenantId,
-      organizationId: loginStatus.organizationId
-    } : undefined;
-    const [error, manifest] = await catchError(client.getManifest({
-      ...auth && { auth },
-      inlineAgentNodes: true
-    }));
-    if (error || !manifest?.nodes) {
+    const [error, result] = await catchError(loadCurrentTenantNodes({ force: !this.manifestCache }));
+    if (error || result.nodes.length === 0) {
       logger.warn(`Could not load current OOTB node manifests; skipping stale-handle validation: ${error?.message ?? "manifest response did not include nodes"}`);
       return new Map;
     }
-    return new Map(manifest.nodes.map((m) => [
+    logger.debug(`Current node manifests: ${result.nodes.length} nodes (${result.fromCache ? "from cache" : `fetched, source=${result.source}`})`);
+    return new Map(result.nodes.map((m) => [
       m.nodeType.toLowerCase(),
       m
     ]));
@@ -2249,6 +2257,7 @@ Validating: ${absolutePath}
     issues.push(...await this.validateForwardMigration(content, absolutePath));
     issues.push(...this.validateGraph(workflow, "", rawDefErrorHandling, currentManifests));
     issues.push(...this.validateGlobalVariableUniqueness(workflow, ""));
+    issues.push(...this.validateFileWideIdUniqueness(workflow));
     issues.push(...this.validateGlobalTriggerBindings(workflow, ""));
     issues.push(...this.validateTriggerScopedBareVarReads(workflow, ""));
     issues.push(...this.validateUnboundInputGlobals(workflow, ""));
@@ -2260,7 +2269,8 @@ Validating: ${absolutePath}
     issues.push(...this.validateAgentPromptInputRefs(workflow, hydrationDiagnoses, ""));
     issues.push(...this.validateAgentInputScopeRefs(workflow, hydrationDiagnoses, ""));
     issues.push(...this.validateVoiceAgentSettings(workflow, hydrationDiagnoses, ""));
-    issues.push(...await this.validateSolutionRegistrationAndLayout(absolutePath));
+    issues.push(...await this.validateInlineEntityBindings(workflow, absolutePath));
+    issues.push(...await this.validateSolutionRegistrationAndLayout(absolutePath, workflow));
     issues.push(...await validateExpressions(workflow, "", this.strictExpressions));
     const subflows = workflow.subflows ?? {};
     for (const [subflowId, entry] of Object.entries(subflows)) {
@@ -2798,7 +2808,7 @@ Validating: ${absolutePath}
         const sameTypeVersions = definedVersionsByType.get(node.type);
         const hint = sameTypeVersions?.length ? `
     Hint: \`definitions[]\` has \`${node.type}\` at version(s) ${sameTypeVersions.map((v) => `"${v}"`).join(", ")} but the node uses \`typeVersion: "${node.typeVersion}"\`. Align one side — \`typeVersion\` must match the definition's \`version\` exactly (e.g., \`"1.0"\` ≠ \`"1.0.0"\`).` : `
-    Hint: run \`uip maestro flow registry get ${node.type} --output json\` and append the returned node object to \`definitions[]\` (depending on plugin version, the object is at \`Data.Node\` or the top level). Set \`typeVersion\` to the returned \`version\` exactly — registry may emit \`"1.0"\` while older flows used \`"1.0.0"\`. To scaffold a new node with its definition auto-injected, run \`uip maestro flow node add <file> ${node.type}\` instead.`;
+    Hint: run \`uip maestro flow registry get ${node.type} --output json\` and append the returned node object to \`definitions[]\` (depending on plugin version, the object is at \`Data.Node\` or the top level). Set \`typeVersion\` to the returned \`version\` exactly — registry may emit \`"1.0"\` while older flows used \`"1.0.0"\`. To scaffold a new node with its definition auto-injected, run \`uip maestro flow nodes create <file> ${node.type}\` instead.`;
         issues.push({
           path: `nodes[${node.id}].type`,
           message: `Node type "${key}" has no matching definition.${hint}`,
@@ -2838,6 +2848,49 @@ Validating: ${absolutePath}
     }
     return issues;
   }
+  validateFileWideIdUniqueness(workflow) {
+    const scopes = [
+      {
+        label: "root",
+        nodes: workflow.nodes ?? [],
+        edges: workflow.edges ?? []
+      }
+    ];
+    const subflows = workflow.subflows ?? {};
+    for (const [subflowId, entry] of Object.entries(subflows)) {
+      scopes.push({
+        label: `subflows[${subflowId}]`,
+        nodes: entry?.nodes ?? [],
+        edges: entry?.edges ?? []
+      });
+    }
+    const placesById = new Map;
+    for (const scope of scopes) {
+      for (const kind of ["nodes", "edges"]) {
+        const place = `${kind === "nodes" ? "node" : "edge"} in ${scope.label}`;
+        for (const element of scope[kind]) {
+          const id = element?.id;
+          if (typeof id !== "string")
+            continue;
+          const places = placesById.get(id) ?? [];
+          if (!places.includes(place))
+            places.push(place);
+          placesById.set(id, places);
+        }
+      }
+    }
+    const issues = [];
+    for (const [id, places] of placesById) {
+      if (places.length < 2)
+        continue;
+      issues.push({
+        path: places.some((p) => p.startsWith("node")) ? "nodes" : "edges",
+        message: `Duplicate ID across the file: "${id}" is used by ${places.join(", ")}. Node and edge IDs share one namespace across the root and all subflows; pack merges them into one BPMN document and drops or fails on a repeated ID.`,
+        severity: "error"
+      });
+    }
+    return issues;
+  }
   validateGlobalVariableUniqueness(flow, pathPrefix) {
     const issues = [];
     const globals = flow.variables?.globals ?? [];
@@ -3002,6 +3055,10 @@ Validating: ${absolutePath}
     }
     return issues;
   }
+  async validateInlineEntityBindings(workflow, absolutePath) {
+    const inlineEntities = await readSolutionInlineEntities(this.fs, absolutePath);
+    return inlineEntityBindingIssues(workflow, inlineEntities, absolutePath);
+  }
   validateResourceBindings(workflow) {
     const issues = [];
     const bindings = workflow.bindings ?? [];
@@ -3136,7 +3193,7 @@ Validating: ${absolutePath}
     this.connectorCatalogCache ??= loadConnectorCatalog();
     return this.connectorCatalogCache;
   }
-  async validateSolutionRegistrationAndLayout(absolutePath) {
+  async validateSolutionRegistrationAndLayout(absolutePath, workflow) {
     const issues = [];
     const flowDir = this.fs.path.dirname(absolutePath);
     const discovery = await findNearestParentUipxFile(this.fs, absolutePath);
@@ -3149,20 +3206,20 @@ Validating: ${absolutePath}
     }
     const solutionDir = this.fs.path.dirname(discovery.solutionFile);
     const flowDirReal = await this.canonicalizePath(flowDir);
-    let isRegistered = false;
+    let currentProject;
     for (const p of manifest.projects) {
       const projectDir = this.fs.path.resolve(solutionDir, this.fs.path.dirname(p.ProjectRelativePath));
       const projectDirReal = await this.canonicalizePath(projectDir);
       if (projectDirReal === flowDirReal) {
-        isRegistered = true;
+        currentProject = p;
         break;
       }
     }
-    if (!isRegistered) {
+    if (!currentProject) {
       issues.push({
         path: "(workflow)",
         severity: "warning",
-        message: `.flow file at ${absolutePath} is not registered as a project of solution ${discovery.solutionFile}. Run \`uip solution projects add "${flowDir}"\` so Studio Web and \`flow debug\` can discover it.`
+        message: `.flow file at ${absolutePath} is not registered as a project of solution ${discovery.solutionFile}. So Studio Web and \`flow debug\` can discover it, run: uip solution projects add ${quoteForShell(flowDir)}`
       });
     }
     const flowBase = this.fs.path.basename(absolutePath, ".flow");
@@ -3174,8 +3231,56 @@ Validating: ${absolutePath}
         message: `.flow file at ${absolutePath} does not match canonical layout. Expected the .flow basename ("${flowBase}") to match its parent directory name ("${dirBase}"). The canonical layout is <solution>/<projectName>/<projectName>.flow.`
       });
     }
+    issues.push(...await this.validateInSolutionProcessKeys(workflow, solutionDir, manifest.projects, currentProject?.Id));
     return issues;
   }
+  async validateInSolutionProcessKeys(workflow, solutionDir, projects, currentProjectId) {
+    const definitions = workflow.definitions;
+    const nodes = [
+      ...workflow.nodes.map((n) => ({ ...n, scope: "" })),
+      ...Object.entries(workflow.subflows ?? {}).flatMap(([subflowId, sub]) => (sub.nodes ?? []).map((n) => ({
+        ...n,
+        scope: `subflows[${subflowId}].`
+      })))
+    ];
+    const refs = nodes.flatMap((node) => {
+      const def = findNodeDefinition(definitions, node);
+      const bindings = def?.model?.bindings;
+      const key = bindings?.resourceKey;
+      if (!Array.isArray(def?.tags) || !def.tags.includes("in-solution") || String(bindings?.resource).toLowerCase() !== "process" || typeof key !== "string" || key.length === 0) {
+        return [];
+      }
+      const projectId = typeof def.projectId === "string" ? def.projectId : undefined;
+      return [{ node, key, projectId }];
+    });
+    if (refs.length === 0)
+      return [];
+    const keyByProject = await loadResourceKeyMap(solutionDir);
+    const known = new Set([...keyByProject.values()].map((k) => k.toLowerCase()));
+    const withoutProcessResource = new Map((await findProjectsWithoutProcessResource({
+      solutionDir,
+      projects,
+      currentProjectId
+    })).map((p) => [p.id.toLowerCase(), p]));
+    const severity = this.strictBindings ? "error" : "warning";
+    return refs.filter(({ key }) => !known.has(key.toLowerCase())).map(({ node, key, projectId }) => {
+      const pending = withoutProcessResource.get(key.toLowerCase());
+      if (pending) {
+        return {
+          path: `${node.scope}nodes[${node.id}].bindings`,
+          severity,
+          message: `Node "${node.id}" (type ${node.type}) calls in-solution process key "${key}", which is the project id of '${pending.name}', a project with no process resource yet. The next \`uip solution resources refresh\` gives it a new key, and this call stops matching. Run: ${resourcesRefreshCommand(solutionDir)}. Then re-run \`uip maestro flow registry get <node-type> --local\` and replace the node's definition and bindings.`
+        };
+      }
+      const currentKey = projectId ? keyByProject.get(projectId.toLowerCase()) : undefined;
+      const hint = currentKey ? `Its project now has process key "${currentKey}"; re-run \`uip maestro flow registry get <node-type> --local\` and replace the node's definition and bindings.` : "No project in the solution has that key. Re-add the project, or remove the node.";
+      return {
+        path: `${node.scope}nodes[${node.id}].bindings`,
+        severity,
+        message: `Node "${node.id}" (type ${node.type}) calls in-solution process key "${key}", which matches no process resource in solution ${solutionDir}. ${hint}`
+      };
+    });
+  }
   async canonicalizePath(p) {
     const [err, real] = await catchError(this.fs.realpath(p));
     return err || !real ? p : real;
@@ -3555,4 +3660,4 @@ export {
   FlowValidateService
 };
 
-//# debugId=79444041C063495564756E2164756E21
+//# debugId=8D320A0E3758182864756E2164756E21