codika 3.0.0

package/dist/validation/rules/codika-submit-result.js

@@ -0,0 +1,144 @@
+/**
+ * Rule: CODIKA-SUBMIT
+ *
+ * In parent workflows that have a Codika Init node, every terminal node
+ * (node with no outgoing edges) that is reachable from the Init node
+ * must be a Codika Submit Result or Codika Report Error.
+ *
+ * This ensures that every execution path that begins tracking (Init)
+ * also ends tracking (Submit/Report Error).
+ *
+ * Terminal nodes NOT reachable from a Codika Init are ignored — they
+ * belong to branches that don't participate in execution tracking
+ * (e.g., early-exit guard branches in routers).
+ *
+ * Exception: Sub-workflows (starting with Execute Workflow Trigger) are exempt
+ * as they return data to the parent workflow instead.
+ */
+export const metadata = {
+    id: 'CODIKA-SUBMIT',
+    name: 'codika_submit_result',
+    severity: 'must',
+    description: 'Terminal nodes reachable from Codika Init must be Submit Result or Report Error',
+    details: 'Add Codika Submit Result node at the end of success paths, and Codika Report Error at the end of error paths',
+    category: 'codika',
+};
+// Valid result operations
+const VALID_RESULT_OPERATIONS = ['submitResult', 'reportError', 'ingestionCallback'];
+// Valid init operations
+const VALID_INIT_OPERATIONS = ['initWorkflow', 'initDataIngestion'];
+/**
+ * Check if a node is a sub-workflow trigger (exempt from rule)
+ */
+function isSubWorkflowTrigger(node) {
+    return node.type.toLowerCase().includes('executeworkflowtrigger');
+}
+/**
+ * Check if a node is a Codika result node (Submit Result or Report Error)
+ */
+function isCodikaResultNode(node) {
+    if (!node.type.toLowerCase().includes('codika')) {
+        return false;
+    }
+    const params = node.params || {};
+    const operation = params.operation;
+    return VALID_RESULT_OPERATIONS.includes(operation || '');
+}
+/**
+ * Check if a node is a Codika Init node
+ */
+function isCodikaInitNode(node) {
+    if (!node.type.toLowerCase().includes('codika')) {
+        return false;
+    }
+    const params = node.params || {};
+    const operation = params.operation;
+    return VALID_INIT_OPERATIONS.includes(operation || '');
+}
+/**
+ * Find all nodes reachable from a given node via BFS
+ */
+function findReachableNodes(graph, startId) {
+    const reachable = new Set();
+    const queue = [startId];
+    while (queue.length > 0) {
+        const current = queue.shift();
+        if (reachable.has(current))
+            continue;
+        reachable.add(current);
+        for (const edge of graph.edges) {
+            if (edge.from === current && !reachable.has(edge.to)) {
+                queue.push(edge.to);
+            }
+        }
+    }
+    return reachable;
+}
+/**
+ * Find all terminal nodes (nodes with no outgoing edges)
+ */
+function findTerminalNodes(graph) {
+    const nodesWithOutgoing = new Set();
+    for (const edge of graph.edges) {
+        nodesWithOutgoing.add(edge.from);
+    }
+    return graph.nodes.filter(n => !nodesWithOutgoing.has(n.id) &&
+        !n.type.includes('stickyNote'));
+}
+export const codikaSubmitResult = (graph, ctx) => {
+    const findings = [];
+    // Check if this is a sub-workflow (exempt from this rule)
+    if (graph.nodes.some(n => isSubWorkflowTrigger(n))) {
+        return [];
+    }
+    // Find all Codika Init nodes
+    const initNodes = graph.nodes.filter(n => isCodikaInitNode(n));
+    // No Init nodes — CODIKA-INIT rule handles that; nothing for us to check
+    if (initNodes.length === 0) {
+        return [];
+    }
+    // Find all nodes reachable from any Init node
+    const reachableFromInit = new Set();
+    for (const initNode of initNodes) {
+        const reachable = findReachableNodes(graph, initNode.id);
+        for (const id of reachable) {
+            reachableFromInit.add(id);
+        }
+    }
+    // Find all terminal nodes
+    const terminalNodes = findTerminalNodes(graph);
+    // Check terminal nodes that are reachable from Init
+    const nonCompliantTerminals = [];
+    for (const terminal of terminalNodes) {
+        // Skip terminals not reachable from Init (e.g., early-exit guards)
+        if (!reachableFromInit.has(terminal.id)) {
+            continue;
+        }
+        // Skip Init nodes themselves (if Init is terminal, that's a different issue)
+        if (isCodikaInitNode(terminal)) {
+            continue;
+        }
+        // Check if it's a Codika result node
+        if (isCodikaResultNode(terminal)) {
+            continue;
+        }
+        nonCompliantTerminals.push(terminal);
+    }
+    // Report findings for non-compliant paths
+    if (nonCompliantTerminals.length > 0) {
+        const terminalNames = nonCompliantTerminals
+            .map(n => `"${n.name || n.type}"`)
+            .join(', ');
+        findings.push({
+            rule: metadata.id,
+            severity: metadata.severity,
+            path: ctx.path,
+            message: `Workflow paths reachable from Codika Init end without Submit Result or Report Error: ${terminalNames}`,
+            raw_details: `Add a Codika Submit Result node (operation: submitResult) at the end of success paths, and Codika Report Error (operation: reportError) at the end of error paths. This is required for proper execution tracking on the Codika platform. Terminal nodes not reachable from Codika Init are not checked.`,
+            nodeId: nonCompliantTerminals[0]?.id,
+            line: ctx.nodeLines?.[nonCompliantTerminals[0]?.id || ''],
+        });
+    }
+    return findings;
+};
+//# sourceMappingURL=codika-submit-result.js.map

package/dist/validation/rules/codika-submit-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codika-submit-result.js","sourceRoot":"","sources":["../../../src/validation/rules/codika-submit-result.ts"],"names":[],"mappings":"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"}

package/dist/validation/rules/error-branch-required.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Rule: ERROR-BRANCH-REQUIRED
+ *
+ * Error-prone nodes (HTTP Request, Google Sheets, Execute Workflow, etc.)
+ * must have an error branch to handle failures explicitly.
+ *
+ * This replaces flowlint-core's R12 (unhandled_error_path) which false-
+ * positives on LangChain sub-nodes. The upstream R12 uses broad regex
+ * matching — e.g. /put/i matches "outputParserStructured" because it
+ * contains "put". LangChain sub-nodes (model, parser, memory, embeddings,
+ * document loader) execute within their parent chain/agent node and cannot
+ * have independent error branches.
+ *
+ * An error branch is satisfied by either:
+ * - An outgoing edge classified as "error" (second output / red connector)
+ * - An outgoing edge to a recognized error handler node (stopAndError, etc.)
+ */
+import type { RuleRunner } from '@replikanti/flowlint-core';
+import type { RuleMetadata } from '../types.js';
+export declare const RULE_ID = "ERROR-BRANCH-REQUIRED";
+export declare const metadata: RuleMetadata;
+export declare const errorBranchRequired: RuleRunner;
+export default errorBranchRequired;
+//# sourceMappingURL=error-branch-required.d.ts.map

package/dist/validation/rules/error-branch-required.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-branch-required.d.ts","sourceRoot":"","sources":["../../../src/validation/rules/error-branch-required.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAkB,UAAU,EAAwB,MAAM,2BAA2B,CAAC;AAClG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,eAAO,MAAM,OAAO,0BAA0B,CAAC;AAE/C,eAAO,MAAM,QAAQ,EAAE,YAUtB,CAAC;AA6CF,eAAO,MAAM,mBAAmB,EAAE,UAyCjC,CAAC;AAEF,eAAe,mBAAmB,CAAC"}

package/dist/validation/rules/error-branch-required.js

@@ -0,0 +1,103 @@
+/**
+ * Rule: ERROR-BRANCH-REQUIRED
+ *
+ * Error-prone nodes (HTTP Request, Google Sheets, Execute Workflow, etc.)
+ * must have an error branch to handle failures explicitly.
+ *
+ * This replaces flowlint-core's R12 (unhandled_error_path) which false-
+ * positives on LangChain sub-nodes. The upstream R12 uses broad regex
+ * matching — e.g. /put/i matches "outputParserStructured" because it
+ * contains "put". LangChain sub-nodes (model, parser, memory, embeddings,
+ * document loader) execute within their parent chain/agent node and cannot
+ * have independent error branches.
+ *
+ * An error branch is satisfied by either:
+ * - An outgoing edge classified as "error" (second output / red connector)
+ * - An outgoing edge to a recognized error handler node (stopAndError, etc.)
+ */
+export const RULE_ID = 'ERROR-BRANCH-REQUIRED';
+export const metadata = {
+    id: RULE_ID,
+    name: 'error_branch_required',
+    severity: 'must',
+    description: 'Error-prone nodes must have an error branch (red connector) for failure handling',
+    details: 'Add onError: "continueErrorOutput" to the node and connect the second output (index 1) ' +
+        'to an error handler node. This prevents silent failures in API calls, database operations, ' +
+        'and external service interactions.',
+    category: 'reliability',
+};
+/**
+ * Patterns matching node types that interact with external services
+ * and are likely to fail at runtime.
+ *
+ * Mirrors flowlint-core's isErrorProneNode() logic.
+ */
+const API_PATTERN = /http|request|google|facebook|ads/i;
+const MUTATION_PATTERN = /write|insert|update|delete|post|put|patch|database|mongo|supabase|sheet/i;
+const EXEC_PATTERN = /execute|workflow|function/i;
+/**
+ * LangChain sub-node types that should be excluded from error branch checks.
+ * These nodes run inside their parent chain/agent and cannot have independent error outputs.
+ */
+const LANGCHAIN_SUBNODE_PATTERN = /langchain\.(lmChat|outputParser|memory|embeddings|document|vectorStore|toolCode|toolWorkflow)/i;
+/**
+ * Check if a node type represents an error-prone operation.
+ */
+function isErrorProneNode(type) {
+    return API_PATTERN.test(type) || MUTATION_PATTERN.test(type) || EXEC_PATTERN.test(type);
+}
+/**
+ * Check if a node type is a LangChain sub-node (false positive for error branch checks).
+ */
+function isLangchainSubnode(type) {
+    return LANGCHAIN_SUBNODE_PATTERN.test(type);
+}
+/**
+ * Check if a node is a recognized error handler (stopAndError, etc.).
+ */
+function isErrorHandlerNode(type, name) {
+    const normalizedName = (name || '').toLowerCase();
+    return (/stopanderror|errorhandler|raiseerror/i.test(type) ||
+        normalizedName.includes('stop and error') ||
+        normalizedName.includes('error handler'));
+}
+export const errorBranchRequired = (graph, ctx) => {
+    const findings = [];
+    for (const node of graph.nodes) {
+        // Only check error-prone nodes
+        if (!isErrorProneNode(node.type))
+            continue;
+        // Exclude LangChain sub-nodes (they can't have independent error branches)
+        if (isLangchainSubnode(node.type))
+            continue;
+        // Check if the node has an error path
+        const hasErrorPath = graph.edges.some(edge => {
+            if (edge.from !== node.id)
+                return false;
+            // Direct error edge (second output from an error-prone node)
+            if (edge.on === 'error')
+                return true;
+            // Edge to a recognized error handler node
+            const targetNode = graph.nodes.find(n => n.id === edge.to);
+            return targetNode ? isErrorHandlerNode(targetNode.type, targetNode.name) : false;
+        });
+        if (!hasErrorPath) {
+            findings.push({
+                rule: RULE_ID,
+                severity: metadata.severity,
+                path: ctx.path,
+                message: `Node ${node.name} has no error branch (add a red connector to handler)`,
+                raw_details: `Add error handling for "${node.name}" (type: ${node.type}).\n\n` +
+                    `Option 1: Set onError: "continueErrorOutput" on the node and connect the second output ` +
+                    `(index 1) to an error handler.\n` +
+                    `Option 2: Connect the node to a Stop And Error node.\n\n` +
+                    `This prevents silent failures when external API calls or database operations fail.`,
+                nodeId: node.id,
+                line: ctx.nodeLines?.[node.id],
+            });
+        }
+    }
+    return findings;
+};
+export default errorBranchRequired;
+//# sourceMappingURL=error-branch-required.js.map

package/dist/validation/rules/error-branch-required.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-branch-required.js","sourceRoot":"","sources":["../../../src/validation/rules/error-branch-required.ts"],"names":[],"mappings":"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"}

package/dist/validation/rules/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Custom Flowlint Rules for Codika
+ *
+ * These rules extend flowlint-core with Codika-specific checks.
+ * Rules operate on the parsed workflow Graph structure.
+ */
+import type { RuleRunner } from '@replikanti/flowlint-core';
+/**
+ * All custom Flowlint rules for Codika workflows
+ *
+ * These are passed to flowlint-core's runAllRules() as extraRules.
+ */
+export declare const customRules: RuleRunner[];
+export { codikaInitRequired } from './codika-init-required.js';
+export { codikaSubmitResult } from './codika-submit-result.js';
+export { subworkflowMinParams } from './subworkflow-min-params.js';
+export { scheduleWebhookConvergence } from './schedule-webhook-convergence.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/validation/rules/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/validation/rules/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAM5D;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,UAAU,EAMnC,CAAC;AAGF,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/validation/rules/index.js

@@ -0,0 +1,28 @@
+/**
+ * Custom Flowlint Rules for Codika
+ *
+ * These rules extend flowlint-core with Codika-specific checks.
+ * Rules operate on the parsed workflow Graph structure.
+ */
+import { codikaInitRequired } from './codika-init-required.js';
+import { codikaSubmitResult } from './codika-submit-result.js';
+import { subworkflowMinParams } from './subworkflow-min-params.js';
+import { scheduleWebhookConvergence } from './schedule-webhook-convergence.js';
+/**
+ * All custom Flowlint rules for Codika workflows
+ *
+ * These are passed to flowlint-core's runAllRules() as extraRules.
+ */
+export const customRules = [
+    codikaInitRequired,
+    codikaSubmitResult,
+    subworkflowMinParams,
+    scheduleWebhookConvergence,
+    // Add more custom rules here as they are implemented
+];
+// Re-export individual rules for direct access
+export { codikaInitRequired } from './codika-init-required.js';
+export { codikaSubmitResult } from './codika-submit-result.js';
+export { subworkflowMinParams } from './subworkflow-min-params.js';
+export { scheduleWebhookConvergence } from './schedule-webhook-convergence.js';
+//# sourceMappingURL=index.js.map

package/dist/validation/rules/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/validation/rules/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAE/E;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAiB;IACvC,kBAAkB;IAClB,kBAAkB;IAClB,oBAAoB;IACpB,0BAA0B;IAC1B,qDAAqD;CACtD,CAAC;AAEF,+CAA+C;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/validation/rules/schedule-webhook-convergence.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Rule: SCHEDULE-WEBHOOK-CONVERGENCE
+ *
+ * When a workflow has a Schedule Trigger, it must also have a Webhook node
+ * for manual execution, and both must connect to the same downstream node.
+ *
+ * This ensures:
+ * - Scheduled workflows can be manually triggered for testing/debugging
+ * - Manual execution follows the same processing flow as scheduled execution
+ *
+ * @see .guides/specific/schedule-triggers.md - "Manual Trigger Webhook"
+ */
+import type { RuleRunner } from '@replikanti/flowlint-core';
+import type { RuleMetadata } from '../types.js';
+export declare const RULE_ID = "SCHEDULE-WEBHOOK-CONVERGENCE";
+export declare const metadata: RuleMetadata & {
+    guideRef: {
+        path: string;
+        section: string;
+    };
+};
+export declare const scheduleWebhookConvergence: RuleRunner;
+export default scheduleWebhookConvergence;
+//# sourceMappingURL=schedule-webhook-convergence.d.ts.map

package/dist/validation/rules/schedule-webhook-convergence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-webhook-convergence.d.ts","sourceRoot":"","sources":["../../../src/validation/rules/schedule-webhook-convergence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAkB,UAAU,EAA8B,MAAM,2BAA2B,CAAC;AACxG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,eAAO,MAAM,OAAO,iCAAiC,CAAC;AAEtD,eAAO,MAAM,QAAQ,EAAE,YAAY,GAAG;IAAE,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAYlF,CAAC;AAkCF,eAAO,MAAM,0BAA0B,EAAE,UAyFxC,CAAC;AAEF,eAAe,0BAA0B,CAAC"}

package/dist/validation/rules/schedule-webhook-convergence.js

@@ -0,0 +1,129 @@
+/**
+ * Rule: SCHEDULE-WEBHOOK-CONVERGENCE
+ *
+ * When a workflow has a Schedule Trigger, it must also have a Webhook node
+ * for manual execution, and both must connect to the same downstream node.
+ *
+ * This ensures:
+ * - Scheduled workflows can be manually triggered for testing/debugging
+ * - Manual execution follows the same processing flow as scheduled execution
+ *
+ * @see .guides/specific/schedule-triggers.md - "Manual Trigger Webhook"
+ */
+export const RULE_ID = 'SCHEDULE-WEBHOOK-CONVERGENCE';
+export const metadata = {
+    id: RULE_ID,
+    name: 'schedule_webhook_convergence',
+    severity: 'must',
+    description: 'Scheduled workflows must have a webhook node that connects to the same downstream node',
+    details: 'Add a webhook node to enable manual triggering, and connect it to the same node as the schedule trigger output',
+    category: 'triggers',
+    guideRef: {
+        path: 'specific/schedule-triggers.md',
+        section: 'Manual Trigger Webhook',
+    },
+};
+// Node types
+const SCHEDULE_TRIGGER_TYPE = 'n8n-nodes-base.scheduleTrigger';
+const WEBHOOK_TYPE = 'n8n-nodes-base.webhook';
+/**
+ * Find all schedule trigger nodes in the workflow
+ */
+function findScheduleTriggerNodes(graph) {
+    return graph.nodes.filter(node => node.type.toLowerCase().includes('scheduletrigger'));
+}
+/**
+ * Find all webhook nodes in the workflow
+ */
+function findWebhookNodes(graph) {
+    return graph.nodes.filter(node => node.type.toLowerCase().includes('webhook'));
+}
+/**
+ * Get the immediate downstream node IDs for a given node
+ */
+function getDownstreamNodeIds(graph, nodeId) {
+    return graph.edges.filter(edge => edge.from === nodeId).map(edge => edge.to);
+}
+/**
+ * Check if two sets of node IDs have at least one common element
+ */
+function hasCommonNode(set1, set2) {
+    return set1.some(id => set2.includes(id));
+}
+export const scheduleWebhookConvergence = (graph, ctx) => {
+    const findings = [];
+    // Find schedule trigger nodes
+    const scheduleTriggers = findScheduleTriggerNodes(graph);
+    // If no schedule triggers, rule doesn't apply
+    if (scheduleTriggers.length === 0) {
+        return [];
+    }
+    // Find webhook nodes
+    const webhookNodes = findWebhookNodes(graph);
+    // Check 1: Must have at least one webhook node when schedule trigger exists
+    if (webhookNodes.length === 0) {
+        for (const scheduleTrigger of scheduleTriggers) {
+            findings.push({
+                rule: RULE_ID,
+                severity: metadata.severity,
+                path: ctx.path,
+                message: `Schedule trigger "${scheduleTrigger.name}" requires a webhook node for manual execution`,
+                raw_details: `Scheduled workflows must have a webhook node to enable manual triggering.\n\n` +
+                    `Add a webhook node and connect it to the same downstream node as the schedule trigger.\n\n` +
+                    `See documentation: .guides/${metadata.guideRef.path} > "${metadata.guideRef.section}"`,
+                nodeId: scheduleTrigger.id,
+                line: ctx.nodeLines?.[scheduleTrigger.id],
+            });
+        }
+        return findings;
+    }
+    // Check 2: Schedule trigger and webhook must connect to the same downstream node
+    for (const scheduleTrigger of scheduleTriggers) {
+        const scheduleDownstream = getDownstreamNodeIds(graph, scheduleTrigger.id);
+        // Skip if schedule trigger has no connections (dead end - different rule)
+        if (scheduleDownstream.length === 0) {
+            continue;
+        }
+        // Check if any webhook connects to the same downstream node
+        let hasMatchingWebhook = false;
+        const webhookDownstreams = [];
+        for (const webhook of webhookNodes) {
+            const webhookDownstream = getDownstreamNodeIds(graph, webhook.id);
+            webhookDownstreams.push({ webhook, downstream: webhookDownstream });
+            if (hasCommonNode(scheduleDownstream, webhookDownstream)) {
+                hasMatchingWebhook = true;
+                break;
+            }
+        }
+        if (!hasMatchingWebhook) {
+            // Find the downstream node names for better error message
+            const scheduleTargetNodes = graph.nodes
+                .filter(n => scheduleDownstream.includes(n.id))
+                .map(n => n.name || n.type);
+            const webhookTargetInfo = webhookDownstreams
+                .map(w => {
+                const targets = graph.nodes
+                    .filter(n => w.downstream.includes(n.id))
+                    .map(n => n.name || n.type);
+                return `"${w.webhook.name}" -> [${targets.join(', ') || 'no connections'}]`;
+            })
+                .join(', ');
+            findings.push({
+                rule: RULE_ID,
+                severity: metadata.severity,
+                path: ctx.path,
+                message: `Schedule trigger "${scheduleTrigger.name}" and webhook(s) do not connect to the same downstream node`,
+                raw_details: `The schedule trigger and webhook must connect to the same node to ensure manual execution follows the same flow.\n\n` +
+                    `Schedule trigger "${scheduleTrigger.name}" connects to: [${scheduleTargetNodes.join(', ')}]\n` +
+                    `Webhook connections: ${webhookTargetInfo}\n\n` +
+                    `Connect both triggers to the same downstream node.\n\n` +
+                    `See documentation: .guides/${metadata.guideRef.path} > "${metadata.guideRef.section}"`,
+                nodeId: scheduleTrigger.id,
+                line: ctx.nodeLines?.[scheduleTrigger.id],
+            });
+        }
+    }
+    return findings;
+};
+export default scheduleWebhookConvergence;
+//# sourceMappingURL=schedule-webhook-convergence.js.map

package/dist/validation/rules/schedule-webhook-convergence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-webhook-convergence.js","sourceRoot":"","sources":["../../../src/validation/rules/schedule-webhook-convergence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,MAAM,CAAC,MAAM,OAAO,GAAG,8BAA8B,CAAC;AAEtD,MAAM,CAAC,MAAM,QAAQ,GAAmE;IACtF,EAAE,EAAE,OAAO;IACX,IAAI,EAAE,8BAA8B;IACpC,QAAQ,EAAE,MAAM;IAChB,WAAW,EAAE,wFAAwF;IACrG,OAAO,EACL,gHAAgH;IAClH,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE;QACR,IAAI,EAAE,+BAA+B;QACrC,OAAO,EAAE,wBAAwB;KAClC;CACF,CAAC;AAEF,aAAa;AACb,MAAM,qBAAqB,GAAG,gCAAgC,CAAC;AAC/D,MAAM,YAAY,GAAG,wBAAwB,CAAC;AAE9C;;GAEG;AACH,SAAS,wBAAwB,CAAC,KAAY;IAC5C,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC,CAAC;AACzF,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,KAAY;IACpC,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;AACjF,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAAC,KAAY,EAAE,MAAc;IACxD,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC/E,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,IAAc,EAAE,IAAc;IACnD,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,CAAC,MAAM,0BAA0B,GAAe,CAAC,KAAY,EAAE,GAAgB,EAAa,EAAE;IAClG,MAAM,QAAQ,GAAc,EAAE,CAAC;IAE/B,8BAA8B;IAC9B,MAAM,gBAAgB,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;IAEzD,8CAA8C;IAC9C,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,qBAAqB;IACrB,MAAM,YAAY,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAE7C,4EAA4E;IAC5E,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,KAAK,MAAM,eAAe,IAAI,gBAAgB,EAAE,CAAC;YAC/C,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,OAAO;gBACb,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,OAAO,EAAE,qBAAqB,eAAe,CAAC,IAAI,gDAAgD;gBAClG,WAAW,EACT,+EAA+E;oBAC/E,4FAA4F;oBAC5F,8BAA8B,QAAQ,CAAC,QAAQ,CAAC,IAAI,OAAO,QAAQ,CAAC,QAAQ,CAAC,OAAO,GAAG;gBACzF,MAAM,EAAE,eAAe,CAAC,EAAE;gBAC1B,IAAI,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,eAAe,CAAC,EAAE,CAAC;aAC1C,CAAC,CAAC;QACL,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,iFAAiF;IACjF,KAAK,MAAM,eAAe,IAAI,gBAAgB,EAAE,CAAC;QAC/C,MAAM,kBAAkB,GAAG,oBAAoB,CAAC,KAAK,EAAE,eAAe,CAAC,EAAE,CAAC,CAAC;QAE3E,0EAA0E;QAC1E,IAAI,kBAAkB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpC,SAAS;QACX,CAAC;QAED,4DAA4D;QAC5D,IAAI,kBAAkB,GAAG,KAAK,CAAC;QAC/B,MAAM,kBAAkB,GAAiD,EAAE,CAAC;QAE5E,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;YACnC,MAAM,iBAAiB,GAAG,oBAAoB,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;YAClE,kBAAkB,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,CAAC,CAAC;YAEpE,IAAI,aAAa,CAAC,kBAAkB,EAAE,iBAAiB,CAAC,EAAE,CAAC;gBACzD,kBAAkB,GAAG,IAAI,CAAC;gBAC1B,MAAM;YACR,CAAC;QACH,CAAC;QAED,IAAI,CAAC,kBAAkB,EAAE,CAAC;YACxB,0DAA0D;YAC1D,MAAM,mBAAmB,GAAG,KAAK,CAAC,KAAK;iBACpC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;iBAC9C,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;YAE9B,MAAM,iBAAiB,GAAG,kBAAkB;iBACzC,GAAG,CAAC,CAAC,CAAC,EAAE;gBACP,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK;qBACxB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;qBACxC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;gBAC9B,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,SAAS,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,gBAAgB,GAAG,CAAC;YAC9E,CAAC,CAAC;iBACD,IAAI,CAAC,IAAI,CAAC,CAAC;YAEd,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,OAAO;gBACb,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,OAAO,EAAE,qBAAqB,eAAe,CAAC,IAAI,6DAA6D;gBAC/G,WAAW,EACT,sHAAsH;oBACtH,qBAAqB,eAAe,CAAC,IAAI,mBAAmB,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK;oBAC/F,wBAAwB,iBAAiB,MAAM;oBAC/C,wDAAwD;oBACxD,8BAA8B,QAAQ,CAAC,QAAQ,CAAC,IAAI,OAAO,QAAQ,CAAC,QAAQ,CAAC,OAAO,GAAG;gBACzF,MAAM,EAAE,eAAe,CAAC,EAAE;gBAC1B,IAAI,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,eAAe,CAAC,EAAE,CAAC;aAC1C,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAEF,eAAe,0BAA0B,CAAC"}

package/dist/validation/rules/subworkflow-min-params.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Rule: SUBWKFL-MIN-PARAMS
+ *
+ * Every sub-workflow must have at least 1 input parameter.
+ * n8n enforces minRequiredFields: 1 on the ExecuteWorkflowTrigger node.
+ * Sub-workflows with zero parameters will fail with: "At least 1 field is required."
+ *
+ * @see .guides/specific/sub-workflows.md - "Input Parameter Requirements" (Section 11)
+ */
+import type { RuleRunner } from '@replikanti/flowlint-core';
+import type { RuleMetadata } from '../types.js';
+export declare const RULE_ID = "SUBWKFL-MIN-PARAMS";
+export declare const metadata: RuleMetadata & {
+    guideRef: {
+        path: string;
+        section: string;
+    };
+};
+export declare const subworkflowMinParams: RuleRunner;
+export default subworkflowMinParams;
+//# sourceMappingURL=subworkflow-min-params.d.ts.map

package/dist/validation/rules/subworkflow-min-params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subworkflow-min-params.d.ts","sourceRoot":"","sources":["../../../src/validation/rules/subworkflow-min-params.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAS,UAAU,EAAwB,MAAM,2BAA2B,CAAC;AACzF,OAAO,KAAK,EAAE,YAAY,EAAW,MAAM,aAAa,CAAC;AAEzD,eAAO,MAAM,OAAO,uBAAuB,CAAC;AAE5C,eAAO,MAAM,QAAQ,EAAE,YAAY,GAAG;IAAE,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAWlF,CAAC;AA6CF,eAAO,MAAM,oBAAoB,EAAE,UA4BlC,CAAC;AAEF,eAAe,oBAAoB,CAAC"}

package/dist/validation/rules/subworkflow-min-params.js

@@ -0,0 +1,84 @@
+/**
+ * Rule: SUBWKFL-MIN-PARAMS
+ *
+ * Every sub-workflow must have at least 1 input parameter.
+ * n8n enforces minRequiredFields: 1 on the ExecuteWorkflowTrigger node.
+ * Sub-workflows with zero parameters will fail with: "At least 1 field is required."
+ *
+ * @see .guides/specific/sub-workflows.md - "Input Parameter Requirements" (Section 11)
+ */
+export const RULE_ID = 'SUBWKFL-MIN-PARAMS';
+export const metadata = {
+    id: RULE_ID,
+    name: 'subworkflow_min_params',
+    severity: 'must',
+    description: 'Sub-workflows must have at least 1 input parameter',
+    details: 'Add at least one input parameter to the Execute Workflow Trigger node. n8n enforces minRequiredFields: 1.',
+    category: 'subworkflow',
+    guideRef: {
+        path: 'specific/sub-workflows.md',
+        section: 'Input Parameter Requirements',
+    },
+};
+// Sub-workflow trigger type
+const SUBWORKFLOW_TRIGGER = 'executeworkflowtrigger';
+/**
+ * Check if a node is a sub-workflow trigger
+ */
+function isSubWorkflowTrigger(node) {
+    return node.type.toLowerCase().includes(SUBWORKFLOW_TRIGGER);
+}
+/**
+ * Count input parameters from the Execute Workflow Trigger node
+ */
+function countInputParams(node) {
+    const params = node.params || {};
+    // Check workflowInputs.values array (newer format)
+    const workflowInputs = params.workflowInputs;
+    if (workflowInputs?.values && Array.isArray(workflowInputs.values)) {
+        return workflowInputs.values.length;
+    }
+    // Check inputSource with defineBelow mode
+    const inputSource = params.inputSource;
+    if (inputSource === 'defineBelow') {
+        // Look for inputDefinitions or schema
+        const schema = params.schema;
+        if (schema?.values && Array.isArray(schema.values)) {
+            return schema.values.length;
+        }
+    }
+    // No parameters found
+    return 0;
+}
+/**
+ * Find the sub-workflow trigger node (if any)
+ */
+function findSubWorkflowTrigger(graph) {
+    return graph.nodes.find(n => isSubWorkflowTrigger(n)) || null;
+}
+export const subworkflowMinParams = (graph, ctx) => {
+    const findings = [];
+    // Find sub-workflow trigger node
+    const triggerNode = findSubWorkflowTrigger(graph);
+    // If no sub-workflow trigger, this rule doesn't apply
+    if (!triggerNode) {
+        return [];
+    }
+    // Count input parameters
+    const paramCount = countInputParams(triggerNode);
+    if (paramCount < 1) {
+        findings.push({
+            rule: RULE_ID,
+            severity: metadata.severity,
+            path: ctx.path,
+            message: `Sub-workflow must have at least 1 input parameter, found ${paramCount}`,
+            raw_details: `n8n enforces minRequiredFields: 1 on the ExecuteWorkflowTrigger node. Add at least one input parameter to the workflowInputs.values array. Without this, the workflow will fail with "At least 1 field is required."`,
+            nodeId: triggerNode.id,
+            line: ctx.nodeLines?.[triggerNode.id],
+            guideRef: metadata.guideRef,
+        });
+    }
+    return findings;
+};
+export default subworkflowMinParams;
+//# sourceMappingURL=subworkflow-min-params.js.map

package/dist/validation/rules/subworkflow-min-params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subworkflow-min-params.js","sourceRoot":"","sources":["../../../src/validation/rules/subworkflow-min-params.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,MAAM,CAAC,MAAM,OAAO,GAAG,oBAAoB,CAAC;AAE5C,MAAM,CAAC,MAAM,QAAQ,GAAmE;IACtF,EAAE,EAAE,OAAO;IACX,IAAI,EAAE,wBAAwB;IAC9B,QAAQ,EAAE,MAAM;IAChB,WAAW,EAAE,oDAAoD;IACjE,OAAO,EAAE,2GAA2G;IACpH,QAAQ,EAAE,aAAa;IACvB,QAAQ,EAAE;QACR,IAAI,EAAE,2BAA2B;QACjC,OAAO,EAAE,8BAA8B;KACxC;CACF,CAAC;AAEF,4BAA4B;AAC5B,MAAM,mBAAmB,GAAG,wBAAwB,CAAC;AAErD;;GAEG;AACH,SAAS,oBAAoB,CAAC,IAAa;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC;AAC/D,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,IAAa;IACrC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;IAEjC,mDAAmD;IACnD,MAAM,cAAc,GAAG,MAAM,CAAC,cAAoD,CAAC;IACnF,IAAI,cAAc,EAAE,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;QACnE,OAAO,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC;IACtC,CAAC;IAED,0CAA0C;IAC1C,MAAM,WAAW,GAAG,MAAM,CAAC,WAAiC,CAAC;IAC7D,IAAI,WAAW,KAAK,aAAa,EAAE,CAAC;QAClC,sCAAsC;QACtC,MAAM,MAAM,GAAG,MAAM,CAAC,MAA4C,CAAC;QACnE,IAAI,MAAM,EAAE,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACnD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;GAEG;AACH,SAAS,sBAAsB,CAAC,KAAY;IAC1C,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAChE,CAAC;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAe,CAAC,KAAY,EAAE,GAAgB,EAAa,EAAE;IAC5F,MAAM,QAAQ,GAAc,EAAE,CAAC;IAE/B,iCAAiC;IACjC,MAAM,WAAW,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;IAElD,sDAAsD;IACtD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,yBAAyB;IACzB,MAAM,UAAU,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAEjD,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;QACnB,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,OAAO,EAAE,4DAA4D,UAAU,EAAE;YACjF,WAAW,EAAE,sNAAsN;YACnO,MAAM,EAAE,WAAW,CAAC,EAAE;YACtB,IAAI,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC;YACrC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;SAC5B,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAEF,eAAe,oBAAoB,CAAC"}