@synergenius/flow-weaver 0.33.2 → 0.44.0

package/dist/doc-metadata/extractors/error-codes.js

@@ -1,372 +0,0 @@
-/**
- * Single source of truth for validation error code documentation.
- *
- * Every code the validator (src/validator.ts) and agent rules
- * (src/validation/agent-rules.ts) can emit is listed here.
- *
- * The generate-docs script uses this to build the summary tables
- * in docs/reference/error-codes.md.
- */
-export const VALIDATION_CODES = [
-    // ── Structural ──────────────────────────────────────────────────────
-    {
-        code: 'MISSING_WORKFLOW_NAME',
-        severity: 'error',
-        title: 'Missing Workflow Name',
-        description: 'Workflow has no name',
-        category: 'structural',
-    },
-    {
-        code: 'MISSING_FUNCTION_NAME',
-        severity: 'error',
-        title: 'Missing Function Name',
-        description: 'Workflow has no function name',
-        category: 'structural',
-    },
-    {
-        code: 'DUPLICATE_NODE_NAME',
-        severity: 'error',
-        title: 'Duplicate Node Name',
-        description: 'Two node types share a function name',
-        category: 'structural',
-    },
-    {
-        code: 'MUTABLE_NODE_TYPE_BINDING',
-        severity: 'warning',
-        title: 'Mutable Node Binding',
-        description: 'Node type declared with let/var instead of const',
-        category: 'structural',
-    },
-    {
-        code: 'INFERRED_NODE_TYPE',
-        severity: 'warning',
-        title: 'Inferred Node Type',
-        description: 'Node type auto-inferred without explicit annotation',
-        category: 'structural',
-    },
-    {
-        code: 'ANNOTATION_SIGNATURE_MISMATCH',
-        severity: 'warning',
-        title: 'Optional Port Mismatch',
-        description: 'Port optionality differs between annotation and sig',
-        category: 'structural',
-    },
-    {
-        code: 'ANNOTATION_SIGNATURE_TYPE_MISMATCH',
-        severity: 'warning',
-        title: 'Annotation Type Mismatch',
-        description: 'Port type differs between annotation and signature',
-        category: 'structural',
-    },
-    // ── Naming ──────────────────────────────────────────────────────────
-    {
-        code: 'RESERVED_NODE_NAME',
-        severity: 'error',
-        title: 'Reserved Name Used',
-        description: 'Node type uses "Start" or "Exit"',
-        category: 'naming',
-    },
-    {
-        code: 'RESERVED_INSTANCE_ID',
-        severity: 'error',
-        title: 'Reserved Instance ID',
-        description: 'Instance ID is "Start" or "Exit"',
-        category: 'naming',
-    },
-    // ── Connection ──────────────────────────────────────────────────────
-    {
-        code: 'UNKNOWN_SOURCE_NODE',
-        severity: 'error',
-        title: 'Missing Source Node',
-        description: 'Connection from nonexistent node',
-        category: 'connection',
-    },
-    {
-        code: 'UNKNOWN_TARGET_NODE',
-        severity: 'error',
-        title: 'Missing Target Node',
-        description: 'Connection to nonexistent node',
-        category: 'connection',
-    },
-    {
-        code: 'UNKNOWN_SOURCE_PORT',
-        severity: 'error',
-        title: 'Unknown Output Port',
-        description: 'Connection from nonexistent output port',
-        category: 'connection',
-    },
-    {
-        code: 'UNKNOWN_TARGET_PORT',
-        severity: 'error',
-        title: 'Unknown Input Port',
-        description: 'Connection to nonexistent input port',
-        category: 'connection',
-    },
-    {
-        code: 'MULTIPLE_CONNECTIONS_TO_INPUT',
-        severity: 'error',
-        title: 'Multiple Input Connections',
-        description: 'Data input port has more than one source',
-        category: 'connection',
-    },
-    // ── Type ────────────────────────────────────────────────────────────
-    {
-        code: 'STEP_PORT_TYPE_MISMATCH',
-        severity: 'error',
-        title: 'Wrong Port Type',
-        description: 'STEP port connected to data port or vice versa',
-        category: 'type',
-    },
-    {
-        code: 'TYPE_INCOMPATIBLE',
-        severity: 'error',
-        title: 'Type Incompatible',
-        description: 'Type mismatch with @strictTypes enabled',
-        category: 'type',
-    },
-    {
-        code: 'OBJECT_TYPE_MISMATCH',
-        severity: 'warning',
-        title: 'Object Shape Mismatch',
-        description: 'OBJECT ports have different structural types',
-        category: 'type',
-    },
-    {
-        code: 'LOSSY_TYPE_COERCION',
-        severity: 'warning',
-        title: 'Lossy Type Conversion',
-        description: 'Type coercion may lose information',
-        category: 'type',
-    },
-    {
-        code: 'UNUSUAL_TYPE_COERCION',
-        severity: 'warning',
-        title: 'Unusual Type Coercion',
-        description: 'Type coercion is semantically unusual',
-        category: 'type',
-    },
-    {
-        code: 'TYPE_MISMATCH',
-        severity: 'warning',
-        title: 'Type Mismatch',
-        description: 'Incompatible types, runtime coercion attempted',
-        category: 'type',
-    },
-    // ── Node Reference ──────────────────────────────────────────────────
-    {
-        code: 'UNKNOWN_NODE_TYPE',
-        severity: 'error',
-        title: 'Unknown Node Type',
-        description: 'Instance references nonexistent node type',
-        category: 'node-ref',
-    },
-    {
-        code: 'UNDEFINED_NODE',
-        severity: 'error',
-        title: 'Undefined Node',
-        description: 'Connection references node with no instance',
-        category: 'node-ref',
-    },
-    {
-        code: 'MISSING_REQUIRED_INPUT',
-        severity: 'error',
-        title: 'Missing Required Input',
-        description: 'Required input has no connection/default/expression',
-        category: 'node-ref',
-    },
-    // ── Graph ───────────────────────────────────────────────────────────
-    {
-        code: 'CYCLE_DETECTED',
-        severity: 'error',
-        title: 'Circular Dependency Found',
-        description: 'Graph contains a loop',
-        category: 'graph',
-    },
-    {
-        code: 'INVALID_EXIT_PORT_TYPE',
-        severity: 'error',
-        title: 'Invalid Exit Port Type',
-        description: 'Exit onSuccess/onFailure is not STEP type',
-        category: 'graph',
-    },
-    // ── Data Flow ───────────────────────────────────────────────────────
-    {
-        code: 'UNUSED_NODE',
-        severity: 'warning',
-        title: 'Unused Node',
-        description: 'Node defined but not connected',
-        category: 'data-flow',
-    },
-    {
-        code: 'NO_START_CONNECTIONS',
-        severity: 'warning',
-        title: 'No Start Connections',
-        description: 'No connections from Start',
-        category: 'data-flow',
-    },
-    {
-        code: 'NO_EXIT_CONNECTIONS',
-        severity: 'warning',
-        title: 'No Exit Connections',
-        description: 'No connections to Exit',
-        category: 'data-flow',
-    },
-    {
-        code: 'UNUSED_OUTPUT_PORT',
-        severity: 'warning',
-        title: 'Unused Output Port',
-        description: 'Output port data is discarded',
-        category: 'data-flow',
-    },
-    {
-        code: 'UNREACHABLE_EXIT_PORT',
-        severity: 'warning',
-        title: 'Unreachable Exit Port',
-        description: 'Exit port has no incoming connection',
-        category: 'data-flow',
-    },
-    {
-        code: 'MULTIPLE_EXIT_CONNECTIONS',
-        severity: 'warning',
-        title: 'Multiple Exit Connections',
-        description: 'Exit port has multiple sources',
-        category: 'data-flow',
-    },
-    // ── Scope ───────────────────────────────────────────────────────────
-    {
-        code: 'SCOPE_MISSING_REQUIRED_INPUT',
-        severity: 'error',
-        title: 'Scope Child Missing Input',
-        description: 'Required input port on a scoped child has no connection',
-        category: 'graph',
-    },
-    {
-        code: 'SCOPE_UNUSED_INPUT',
-        severity: 'warning',
-        title: 'Scope Input Unused',
-        description: 'Scoped input port has no connection from inner nodes',
-        category: 'graph',
-    },
-    {
-        code: 'SCOPE_WRONG_SCOPE_NAME',
-        severity: 'error',
-        title: 'Invalid Scope Qualifier',
-        description: 'Connection uses a scope name not defined on the node',
-        category: 'graph',
-    },
-    {
-        code: 'SCOPE_CONNECTION_OUTSIDE',
-        severity: 'error',
-        title: 'Scope Connection Leak',
-        description: 'Scoped connection references a node outside the scope',
-        category: 'graph',
-    },
-    {
-        code: 'SCOPE_PORT_TYPE_MISMATCH',
-        severity: 'warning',
-        title: 'Scope Port Type Mismatch',
-        description: 'Type mismatch between scoped port and connected child port',
-        category: 'type',
-    },
-    {
-        code: 'SCOPE_UNKNOWN_PORT',
-        severity: 'error',
-        title: 'Unknown Scoped Port',
-        description: 'Connection references a port that is not a scoped port of the specified scope',
-        category: 'connection',
-    },
-    {
-        code: 'SCOPE_ORPHANED_CHILD',
-        severity: 'warning',
-        title: 'Orphaned Scope Child',
-        description: 'Child node in scope has no scoped connections to parent',
-        category: 'graph',
-    },
-    // ── Agent ───────────────────────────────────────────────────────────
-    {
-        code: 'AGENT_LLM_MISSING_ERROR_HANDLER',
-        severity: 'error',
-        title: 'LLM Missing Error Handler',
-        description: "LLM node's onFailure port is unconnected",
-        category: 'agent',
-    },
-    {
-        code: 'AGENT_UNGUARDED_TOOL_EXECUTOR',
-        severity: 'warning',
-        title: 'Unguarded Tool Executor',
-        description: 'Tool executor has no upstream human-approval gate',
-        category: 'agent',
-    },
-    {
-        code: 'AGENT_MISSING_MEMORY_IN_LOOP',
-        severity: 'warning',
-        title: 'No Memory in Agent Loop',
-        description: 'Loop has LLM but no conversation memory node',
-        category: 'agent',
-    },
-    {
-        code: 'AGENT_LLM_NO_FALLBACK',
-        severity: 'warning',
-        title: 'LLM Failure Goes to Exit',
-        description: 'LLM onFailure routes directly to Exit',
-        category: 'agent',
-    },
-    {
-        code: 'AGENT_TOOL_NO_OUTPUT_HANDLING',
-        severity: 'warning',
-        title: 'Tool Results Discarded',
-        description: 'Tool executor data outputs all unconnected',
-        category: 'agent',
-    },
-    // ── Design ──────────────────────────────────────────────────────────
-    {
-        code: 'DESIGN_ASYNC_NO_ERROR_PATH',
-        severity: 'warning',
-        title: 'Async Node Missing Error Path',
-        description: 'Async node has no onFailure connection',
-        category: 'design',
-    },
-    {
-        code: 'DESIGN_SCOPE_NO_FAILURE_EXIT',
-        severity: 'warning',
-        title: 'Scope Missing Failure Exit',
-        description: 'Scope node has no failure path out',
-        category: 'design',
-    },
-    {
-        code: 'DESIGN_UNBOUNDED_RETRY',
-        severity: 'warning',
-        title: 'Unbounded Retry Loop',
-        description: 'Retry scope has no visible attempt limit',
-        category: 'design',
-    },
-    {
-        code: 'DESIGN_FANOUT_NO_FANIN',
-        severity: 'warning',
-        title: 'Fan-Out Without Fan-In',
-        description: 'Fan-out to multiple step targets with no merge back',
-        category: 'design',
-    },
-    {
-        code: 'DESIGN_EXIT_DATA_UNREACHABLE',
-        severity: 'warning',
-        title: 'Exit Data Unreachable',
-        description: 'Exit data port has no connection and no pull-execution provider',
-        category: 'design',
-    },
-    {
-        code: 'DESIGN_PULL_CANDIDATE',
-        severity: 'warning',
-        title: 'Pull Execution Candidate',
-        description: 'Node has no step trigger but its outputs are consumed downstream',
-        category: 'design',
-    },
-    {
-        code: 'DESIGN_PULL_UNUSED',
-        severity: 'warning',
-        title: 'Unused Pull Execution',
-        description: 'Pull-execution node has no downstream consumers',
-        category: 'design',
-    },
-];
-//# sourceMappingURL=error-codes.js.map

package/dist/doc-metadata/extractors/grammar-rules.js

@@ -1,51 +0,0 @@
-/**
- * Extractor for grammar rule documentation.
- *
- * Generates EBNF text and terminal definitions from the Chevrotain parsers
- * so the jsdoc-grammar.md reference doc stays in sync with source code.
- */
-import { getAllGrammars, serializedToEBNF, } from '../../chevrotain-parser/grammar-diagrams.js';
-/**
- * Extract EBNF for all grammar groups.
- */
-export function extractGrammarEBNF() {
-    const grammars = getAllGrammars();
-    const groups = [];
-    for (const [name, productions] of Object.entries(grammars)) {
-        const ebnf = serializedToEBNF(productions);
-        if (ebnf.trim()) {
-            groups.push({ name: name, ebnf });
-        }
-    }
-    return groups;
-}
-/**
- * Extract terminal pattern definitions for the Terminals section of docs.
- *
- * These are the key token patterns from tokens.ts that users need to know.
- */
-export function extractTerminals() {
-    return [
-        {
-            name: 'IDENTIFIER',
-            pattern: '[a-zA-Z_$] [a-zA-Z0-9_$\\/-]*',
-            description: 'IDENTIFIER supports `/` and `-` to accommodate npm package naming conventions (e.g., `npm/react-window/areEqual`).',
-        },
-        {
-            name: 'INTEGER',
-            pattern: '"-"? [0-9]+',
-            description: 'Signed integer literal.',
-        },
-        {
-            name: 'STRING',
-            pattern: `'"' { any character except '"' or '\\', or escape sequence } '"'`,
-            description: 'Double-quoted string with escape sequences.',
-        },
-        {
-            name: 'TEXT',
-            pattern: 'any characters to end of line',
-            description: 'Free-form text to end of line (used in descriptions).',
-        },
-    ];
-}
-//# sourceMappingURL=grammar-rules.js.map