@synergenius/flow-weaver 0.8.3 → 0.9.1

package/dist/validator.js

@@ -14,11 +14,13 @@ const ERROR_DOC_URLS = {
     MISSING_EXIT_CONNECTION: `${DOCS_BASE}/concepts#start-and-exit`,
     INFERRED_NODE_TYPE: `${DOCS_BASE}/node-conversion`,
     DUPLICATE_CONNECTION: `${DOCS_BASE}/concepts#connections`,
+    STUB_NODE: `${DOCS_BASE}/model-driven#stub-nodes`,
 };
 export class WorkflowValidator {
     errors = [];
     warnings = [];
     strictMode = false;
+    draftMode = false;
     /** Look up instance sourceLocation by instance ID */
     getInstanceLocation(workflow, instanceId) {
         const instance = workflow.instances.find((inst) => inst.id === instanceId);
@@ -65,6 +67,7 @@ export class WorkflowValidator {
         this.errors = [];
         this.warnings = [];
         this.strictMode = options?.strictMode ?? false;
+        this.draftMode = options?.mode === 'draft';
         const nodeTypeMap = new Map();
         // Map by both functionName and name to support npm nodes (name='npm/pkg/func', functionName='func')
         workflow.nodeTypes.forEach((nodeType) => {
@@ -106,7 +109,7 @@ export class WorkflowValidator {
         workflow.instances.forEach((instance) => {
             // Check both name (for npm nodes like 'npm/pkg/func') and functionName (for local nodes)
             const nodeType = workflow.nodeTypes.find((nt) => nt.name === instance.nodeType || nt.functionName === instance.nodeType);
-            if (nodeType?.inferred) {
+            if (nodeType?.inferred && nodeType.variant !== 'STUB') {
                 this.warnings.push({
                     type: 'warning',
                     code: 'INFERRED_NODE_TYPE',
@@ -116,6 +119,19 @@ export class WorkflowValidator {
                 });
             }
         });
+        // Stub node diagnostics: always emit as errors, draft mode reclassifies at the end
+        workflow.instances.forEach((instance) => {
+            const nodeType = workflow.nodeTypes.find((nt) => nt.name === instance.nodeType || nt.functionName === instance.nodeType);
+            if (nodeType?.variant === 'STUB') {
+                this.errors.push({
+                    type: 'error',
+                    code: 'STUB_NODE',
+                    message: `Node "${instance.id}" uses stub type "${instance.nodeType}" which has no implementation. Use draft mode to validate structure, or implement the node.`,
+                    node: instance.id,
+                    location: instance.sourceLocation,
+                });
+            }
+        });
         // Structural validation
         this.validateStructure(workflow);
         this.validateDuplicateNodeNames(workflow);
@@ -162,6 +178,30 @@ export class WorkflowValidator {
                 return true;
             });
         }
+        // Draft mode post-processing: reclassify stub-related errors as warnings
+        if (this.draftMode) {
+            const stubTypeNames = new Set(workflow.nodeTypes.filter((nt) => nt.variant === 'STUB').map((nt) => nt.functionName));
+            // Also index by name for npm-style nodes
+            workflow.nodeTypes.filter((nt) => nt.variant === 'STUB').forEach((nt) => {
+                stubTypeNames.add(nt.name);
+            });
+            const stubInstanceIds = new Set(workflow.instances
+                .filter((inst) => stubTypeNames.has(inst.nodeType))
+                .map((inst) => inst.id));
+            const promoted = [];
+            this.errors = this.errors.filter((err) => {
+                if (err.code === 'STUB_NODE') {
+                    promoted.push({ ...err, type: 'warning' });
+                    return false;
+                }
+                if (err.code === 'MISSING_REQUIRED_INPUT' && err.node && stubInstanceIds.has(err.node)) {
+                    promoted.push({ ...err, type: 'warning' });
+                    return false;
+                }
+                return true;
+            });
+            this.warnings.push(...promoted);
+        }
         // Attach doc URLs to diagnostics that have mapped error codes
         for (const diag of [...this.errors, ...this.warnings]) {
             if (!diag.docUrl && ERROR_DOC_URLS[diag.code]) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synergenius/flow-weaver",
-  "version": "0.8.3",
+  "version": "0.9.1",
   "description": "Deterministic workflow compiler for AI agents. Compiles to standalone TypeScript, no runtime dependencies.",
   "private": false,
   "type": "module",