codika 3.0.0

package/dist/utils/version-manager.js

@@ -0,0 +1,91 @@
+/**
+ * Version Manager
+ * Utilities for managing version.json files and semver operations.
+ */
+import { readFileSync, writeFileSync, existsSync } from 'fs';
+import { join } from 'path';
+/**
+ * Read version from version.json in a use case folder.
+ * Returns "1.0.0" if the file doesn't exist.
+ */
+export function readVersion(useCasePath) {
+    const versionPath = join(useCasePath, 'version.json');
+    if (!existsSync(versionPath)) {
+        return '1.0.0';
+    }
+    const data = JSON.parse(readFileSync(versionPath, 'utf-8'));
+    return data.version;
+}
+/**
+ * Write version to version.json in a use case folder.
+ */
+export function writeVersion(useCasePath, version) {
+    const versionPath = join(useCasePath, 'version.json');
+    writeFileSync(versionPath, JSON.stringify({ version }, null, 2) + '\n');
+}
+/**
+ * Parse a semver string (X.Y.Z) into parts.
+ */
+export function parseSemver(version) {
+    const parts = version.split('.');
+    if (parts.length !== 3) {
+        throw new Error(`Invalid semver format: ${version}. Expected X.Y.Z format.`);
+    }
+    const [major, minor, patch] = parts.map((p) => parseInt(p, 10));
+    if (isNaN(major) || isNaN(minor) || isNaN(patch)) {
+        throw new Error(`Invalid semver format: ${version}. All parts must be numbers.`);
+    }
+    return { major, minor, patch };
+}
+/**
+ * Format semver parts back to string.
+ */
+export function formatSemver(version) {
+    return `${version.major}.${version.minor}.${version.patch}`;
+}
+/**
+ * Increment a semver version based on strategy.
+ */
+export function incrementSemver(version, strategy) {
+    switch (strategy) {
+        case 'major':
+            return { major: version.major + 1, minor: 0, patch: 0 };
+        case 'minor':
+            return { major: version.major, minor: version.minor + 1, patch: 0 };
+        case 'patch':
+        default:
+            return { major: version.major, minor: version.minor, patch: version.patch + 1 };
+    }
+}
+/**
+ * Resolve shorthand CLI flags to API and local version strategies.
+ *
+ * | Flag               | API strategy  | Local strategy |
+ * |--------------------|---------------|----------------|
+ * | (default / --patch)| minor_bump    | patch          |
+ * | --minor            | minor_bump    | minor          |
+ * | --major            | major_bump    | major          |
+ * | --version X.Y      | explicit      | patch          |
+ */
+export function resolveVersionStrategies(flags) {
+    if (flags.major) {
+        return { apiStrategy: 'major_bump', localStrategy: 'major' };
+    }
+    if (flags.minor) {
+        return { apiStrategy: 'minor_bump', localStrategy: 'minor' };
+    }
+    if (flags.version) {
+        const parts = flags.version.split('.');
+        if (parts.length !== 2 || isNaN(parseInt(parts[0])) || isNaN(parseInt(parts[1]))) {
+            throw new Error(`Invalid version format "${flags.version}". Expected "X.Y" format (e.g., "1.0").`);
+        }
+        return {
+            apiStrategy: 'explicit',
+            localStrategy: 'patch',
+            explicitVersion: flags.version,
+        };
+    }
+    // Default: --patch or no flags
+    return { apiStrategy: 'minor_bump', localStrategy: 'patch' };
+}
+//# sourceMappingURL=version-manager.js.map

package/dist/utils/version-manager.js.map

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

package/dist/utils/workflow-encoding.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Workflow Encoding Utilities
+ * Handles loading, encoding, and decoding of n8n workflow JSON files
+ */
+/**
+ * Load a workflow JSON file and return as parsed object
+ */
+export declare function loadWorkflowJson(filePath: string): object;
+/**
+ * Encode a workflow object to base64 string
+ */
+export declare function encodeWorkflowToBase64(workflow: object): string;
+/**
+ * Decode a base64 string back to workflow object
+ */
+export declare function decodeWorkflowFromBase64(base64String: string): object;
+/**
+ * Encode a JSON string directly to base64
+ */
+export declare function encodeWorkflowFromString(jsonString: string): string;
+/**
+ * Load a workflow JSON file and return as base64 encoded string
+ * Convenience function combining load + encode
+ */
+export declare function loadAndEncodeWorkflow(filePath: string): string;
+//# sourceMappingURL=workflow-encoding.d.ts.map

package/dist/utils/workflow-encoding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-encoding.d.ts","sourceRoot":"","sources":["../../src/utils/workflow-encoding.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAGrE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG9D"}

package/dist/utils/workflow-encoding.js

@@ -0,0 +1,41 @@
+/**
+ * Workflow Encoding Utilities
+ * Handles loading, encoding, and decoding of n8n workflow JSON files
+ */
+import { readFileSync } from 'fs';
+/**
+ * Load a workflow JSON file and return as parsed object
+ */
+export function loadWorkflowJson(filePath) {
+    const content = readFileSync(filePath, 'utf-8');
+    return JSON.parse(content);
+}
+/**
+ * Encode a workflow object to base64 string
+ */
+export function encodeWorkflowToBase64(workflow) {
+    const jsonString = JSON.stringify(workflow);
+    return Buffer.from(jsonString, 'utf-8').toString('base64');
+}
+/**
+ * Decode a base64 string back to workflow object
+ */
+export function decodeWorkflowFromBase64(base64String) {
+    const jsonString = Buffer.from(base64String, 'base64').toString('utf-8');
+    return JSON.parse(jsonString);
+}
+/**
+ * Encode a JSON string directly to base64
+ */
+export function encodeWorkflowFromString(jsonString) {
+    return Buffer.from(jsonString, 'utf-8').toString('base64');
+}
+/**
+ * Load a workflow JSON file and return as base64 encoded string
+ * Convenience function combining load + encode
+ */
+export function loadAndEncodeWorkflow(filePath) {
+    const content = readFileSync(filePath, 'utf-8');
+    return encodeWorkflowFromString(content);
+}
+//# sourceMappingURL=workflow-encoding.js.map

package/dist/utils/workflow-encoding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-encoding.js","sourceRoot":"","sources":["../../src/utils/workflow-encoding.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAElC;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAChD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACrD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC5C,OAAO,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,YAAoB;IAC3D,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACzE,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,UAAkB;IACzD,OAAO,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAC7D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgB;IACpD,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAChD,OAAO,wBAAwB,CAAC,OAAO,CAAC,CAAC;AAC3C,CAAC"}

package/dist/validation/fixer.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Auto-Fix Orchestrator
+ *
+ * Applies automatic fixes to files based on findings.
+ * Follows ESLint-style fixing pattern where each finding
+ * can optionally include a fix function.
+ */
+import type { Finding, FixResult } from './types.js';
+/**
+ * Options for applying fixes
+ */
+export interface FixerOptions {
+    /** If true, don't actually write changes to disk */
+    dryRun?: boolean;
+}
+/**
+ * Apply all available fixes to a file
+ *
+ * @param filePath - Path to the file to fix
+ * @param findings - Array of findings, some of which may have fix functions
+ * @param options - Fixer options (dryRun, etc.)
+ * @returns Result with number of fixes applied and new content
+ */
+export declare function applyFixes(filePath: string, findings: Finding[], options?: FixerOptions): FixResult;
+/**
+ * Apply fixes to multiple files
+ *
+ * @param fileFindings - Map of file path to findings
+ * @param options - Fixer options
+ * @returns Array of fix results for each file
+ */
+export declare function applyFixesToMultipleFiles(fileFindings: Map<string, Finding[]>, options?: FixerOptions): FixResult[];
+/**
+ * Group findings by file path
+ *
+ * @param findings - Array of findings from multiple files
+ * @returns Map of file path to findings for that file
+ */
+export declare function groupFindingsByFile(findings: Finding[]): Map<string, Finding[]>;
+/**
+ * Preview what fixes would be applied to a file
+ *
+ * @param filePath - Path to the file
+ * @param findings - Findings with potential fixes
+ * @returns Preview of changes that would be made
+ */
+export declare function previewFixes(filePath: string, findings: Finding[]): {
+    file: string;
+    fixes: Array<{
+        rule: string;
+        description: string;
+        before?: string;
+        after?: string;
+    }>;
+};
+//# sourceMappingURL=fixer.d.ts.map

package/dist/validation/fixer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixer.d.ts","sourceRoot":"","sources":["../../src/validation/fixer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,GAAE,YAAiB,GACzB,SAAS,CA6EX;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,EACpC,OAAO,GAAE,YAAiB,GACzB,SAAS,EAAE,CASb;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAU/E;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,OAAO,EAAE,GAClB;IACD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ,CAgDA"}

package/dist/validation/fixer.js

@@ -0,0 +1,168 @@
+/**
+ * Auto-Fix Orchestrator
+ *
+ * Applies automatic fixes to files based on findings.
+ * Follows ESLint-style fixing pattern where each finding
+ * can optionally include a fix function.
+ */
+import { readFileSync, writeFileSync } from 'fs';
+/**
+ * Apply all available fixes to a file
+ *
+ * @param filePath - Path to the file to fix
+ * @param findings - Array of findings, some of which may have fix functions
+ * @param options - Fixer options (dryRun, etc.)
+ * @returns Result with number of fixes applied and new content
+ */
+export function applyFixes(filePath, findings, options = {}) {
+    // Get fixable findings
+    const fixableFindings = findings.filter(f => f.fixable && f.fix);
+    if (fixableFindings.length === 0) {
+        return {
+            filePath,
+            applied: 0,
+            content: '',
+            wouldFix: [],
+        };
+    }
+    // In dry-run mode, just return what would be fixed
+    if (options.dryRun) {
+        return {
+            filePath,
+            applied: 0,
+            content: '',
+            wouldFix: fixableFindings,
+        };
+    }
+    // Read current file content
+    let content;
+    try {
+        content = readFileSync(filePath, 'utf-8');
+    }
+    catch (error) {
+        // If we can't read the file, we can't fix it
+        return {
+            filePath,
+            applied: 0,
+            content: '',
+            wouldFix: fixableFindings,
+        };
+    }
+    // Apply fixes in order
+    let applied = 0;
+    const originalContent = content;
+    for (const finding of fixableFindings) {
+        if (!finding.fix)
+            continue;
+        try {
+            const newContent = finding.fix.apply(content);
+            // Only count as applied if content actually changed
+            if (newContent !== content) {
+                content = newContent;
+                applied++;
+            }
+        }
+        catch (error) {
+            // Skip fixes that throw errors
+            console.error(`Fix for ${finding.rule} failed: ${error.message}`);
+        }
+    }
+    // Write back to file if changes were made
+    if (applied > 0 && content !== originalContent) {
+        try {
+            writeFileSync(filePath, content, 'utf-8');
+        }
+        catch (error) {
+            console.error(`Failed to write fixes to ${filePath}: ${error.message}`);
+            return {
+                filePath,
+                applied: 0,
+                content: originalContent,
+            };
+        }
+    }
+    return {
+        filePath,
+        applied,
+        content,
+    };
+}
+/**
+ * Apply fixes to multiple files
+ *
+ * @param fileFindings - Map of file path to findings
+ * @param options - Fixer options
+ * @returns Array of fix results for each file
+ */
+export function applyFixesToMultipleFiles(fileFindings, options = {}) {
+    const results = [];
+    for (const [filePath, findings] of fileFindings) {
+        const result = applyFixes(filePath, findings, options);
+        results.push(result);
+    }
+    return results;
+}
+/**
+ * Group findings by file path
+ *
+ * @param findings - Array of findings from multiple files
+ * @returns Map of file path to findings for that file
+ */
+export function groupFindingsByFile(findings) {
+    const grouped = new Map();
+    for (const finding of findings) {
+        const existing = grouped.get(finding.path) || [];
+        existing.push(finding);
+        grouped.set(finding.path, existing);
+    }
+    return grouped;
+}
+/**
+ * Preview what fixes would be applied to a file
+ *
+ * @param filePath - Path to the file
+ * @param findings - Findings with potential fixes
+ * @returns Preview of changes that would be made
+ */
+export function previewFixes(filePath, findings) {
+    const fixableFindings = findings.filter(f => f.fixable && f.fix);
+    let content;
+    try {
+        content = readFileSync(filePath, 'utf-8');
+    }
+    catch {
+        return {
+            file: filePath,
+            fixes: fixableFindings.map(f => ({
+                rule: f.rule,
+                description: f.fix?.description || 'Unknown fix',
+            })),
+        };
+    }
+    const fixes = [];
+    for (const finding of fixableFindings) {
+        if (!finding.fix)
+            continue;
+        try {
+            const newContent = finding.fix.apply(content);
+            if (newContent !== content) {
+                // Extract relevant lines for before/after preview
+                // This is a simplified version - could be enhanced
+                fixes.push({
+                    rule: finding.rule,
+                    description: finding.fix.description,
+                    // For line-specific changes, we could extract just those lines
+                    // For now, we just note that a change would be made
+                });
+            }
+        }
+        catch {
+            // Skip preview for fixes that would fail
+        }
+    }
+    return {
+        file: filePath,
+        fixes,
+    };
+}
+//# sourceMappingURL=fixer.js.map

package/dist/validation/fixer.js.map

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

package/dist/validation/rules/codika-init-required.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Rule: CODIKA-INIT
+ *
+ * Every parent workflow must contain at least one Codika Init node.
+ * This ensures execution tracking is initialized before business logic runs.
+ *
+ * Valid init operations:
+ * - initWorkflow (standard workflows)
+ * - initDataIngestion (RAG ingestion workflows)
+ *
+ * Exception: Sub-workflows (starting with Execute Workflow Trigger) are exempt
+ * as they inherit execution context from the parent workflow.
+ */
+import type { RuleRunner } from '@replikanti/flowlint-core';
+import type { RuleMetadata } from '../types.js';
+export declare const metadata: RuleMetadata;
+export declare const codikaInitRequired: RuleRunner;
+//# sourceMappingURL=codika-init-required.d.ts.map

package/dist/validation/rules/codika-init-required.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codika-init-required.d.ts","sourceRoot":"","sources":["../../../src/validation/rules/codika-init-required.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAkB,UAAU,EAAwB,MAAM,2BAA2B,CAAC;AAClG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,eAAO,MAAM,QAAQ,EAAE,YAOtB,CAAC;AAuCF,eAAO,MAAM,kBAAkB,EAAE,UAsBhC,CAAC"}

package/dist/validation/rules/codika-init-required.js

@@ -0,0 +1,70 @@
+/**
+ * Rule: CODIKA-INIT
+ *
+ * Every parent workflow must contain at least one Codika Init node.
+ * This ensures execution tracking is initialized before business logic runs.
+ *
+ * Valid init operations:
+ * - initWorkflow (standard workflows)
+ * - initDataIngestion (RAG ingestion workflows)
+ *
+ * Exception: Sub-workflows (starting with Execute Workflow Trigger) are exempt
+ * as they inherit execution context from the parent workflow.
+ */
+export const metadata = {
+    id: 'CODIKA-INIT',
+    name: 'codika_init_required',
+    severity: 'must',
+    description: 'Parent workflows must contain a Codika Init node',
+    details: 'Add a Codika Init node to enable execution tracking on the Codika platform',
+    category: 'codika',
+};
+// Sub-workflow trigger - exempt from this rule
+const SUBWORKFLOW_TRIGGER = 'n8n-nodes-base.executeWorkflowTrigger';
+// Codika node type
+const CODIKA_NODE_TYPE = 'n8n-nodes-codika.codika';
+// 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 valid 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 || '');
+}
+/**
+ * Check if the workflow is a sub-workflow (has an executeWorkflowTrigger)
+ */
+function isSubWorkflow(graph) {
+    return graph.nodes.some(n => isSubWorkflowTrigger(n));
+}
+export const codikaInitRequired = (graph, ctx) => {
+    const findings = [];
+    // Empty workflows and sub-workflows are exempt
+    if (graph.nodes.length === 0 || isSubWorkflow(graph)) {
+        return [];
+    }
+    // Check if ANY node in the workflow is a valid Codika Init
+    const hasCodikaInit = graph.nodes.some(n => isCodikaInitNode(n));
+    if (!hasCodikaInit) {
+        findings.push({
+            rule: metadata.id,
+            severity: metadata.severity,
+            path: ctx.path,
+            message: `Workflow is missing a Codika Init node`,
+            raw_details: `Add a Codika Init node (operation: initWorkflow or initDataIngestion) to enable execution tracking on the Codika platform. Sub-workflows are exempt from this rule.`,
+        });
+    }
+    return findings;
+};
+//# sourceMappingURL=codika-init-required.js.map

package/dist/validation/rules/codika-init-required.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codika-init-required.js","sourceRoot":"","sources":["../../../src/validation/rules/codika-init-required.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,MAAM,CAAC,MAAM,QAAQ,GAAiB;IACpC,EAAE,EAAE,aAAa;IACjB,IAAI,EAAE,sBAAsB;IAC5B,QAAQ,EAAE,MAAM;IAChB,WAAW,EAAE,kDAAkD;IAC/D,OAAO,EAAE,4EAA4E;IACrF,QAAQ,EAAE,QAAQ;CACnB,CAAC;AAEF,+CAA+C;AAC/C,MAAM,mBAAmB,GAAG,uCAAuC,CAAC;AAEpE,mBAAmB;AACnB,MAAM,gBAAgB,GAAG,yBAAyB,CAAC;AAEnD,wBAAwB;AACxB,MAAM,qBAAqB,GAAG,CAAC,cAAc,EAAE,mBAAmB,CAAC,CAAC;AAEpE;;GAEG;AACH,SAAS,oBAAoB,CAAC,IAAa;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC,CAAC;AACpE,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,IAAa;IACrC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;IACjC,MAAM,SAAS,GAAG,MAAM,CAAC,SAA+B,CAAC;IAEzD,OAAO,qBAAqB,CAAC,QAAQ,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,KAAY;IACjC,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAe,CAAC,KAAY,EAAE,GAAgB,EAAa,EAAE;IAC1F,MAAM,QAAQ,GAAc,EAAE,CAAC;IAE/B,+CAA+C;IAC/C,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QACrD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,2DAA2D;IAC3D,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;IAEjE,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,QAAQ,CAAC,EAAE;YACjB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,OAAO,EAAE,wCAAwC;YACjD,WAAW,EAAE,qKAAqK;SACnL,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC"}

package/dist/validation/rules/codika-submit-result.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 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.
+ */
+import type { RuleRunner } from '@replikanti/flowlint-core';
+import type { RuleMetadata } from '../types.js';
+export declare const metadata: RuleMetadata;
+export declare const codikaSubmitResult: RuleRunner;
+//# sourceMappingURL=codika-submit-result.d.ts.map

package/dist/validation/rules/codika-submit-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codika-submit-result.d.ts","sourceRoot":"","sources":["../../../src/validation/rules/codika-submit-result.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,QAAQ,EAAE,YAOtB,CAAC;AAgFF,eAAO,MAAM,kBAAkB,EAAE,UAoEhC,CAAC"}