codika 3.0.0

package/dist/validation/runner.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Validation Runner
+ *
+ * Central orchestrator that runs all validation:
+ * - Flowlint core rules (static analysis)
+ * - Custom Codika rules (graph-based)
+ * - Workflow scripts (content-based checks)
+ * - Use-case scripts (folder-based checks)
+ */
+import type { ValidationResult, WorkflowValidationOptions, UseCaseValidationOptions } from './types.js';
+/**
+ * Default rules to exclude from validation.
+ * These are Flowlint rules that produce false positives for Codika workflows.
+ *
+ * R3 - Idempotency guard: False positive for LangChain parser/transform nodes
+ *      that don't perform mutations (e.g., outputParserStructured)
+ *
+ * Add more rules here as needed:
+ * R5 - No outgoing connections: Expected for terminal nodes (Submit/Error)
+ * R8 - Data never reaches consumer: False positive for LangChain sub-nodes
+ */
+/**
+ * Override severity for specific rules.
+ * Flowlint-core rules have hardcoded severity we can't change at source.
+ */
+export declare const SEVERITY_OVERRIDES: Record<string, 'must' | 'should' | 'nit'>;
+export declare const DEFAULT_EXCLUDED_RULES: string[];
+/**
+ * Validate a single workflow JSON file
+ */
+export declare function validateWorkflow(options: WorkflowValidationOptions): Promise<ValidationResult>;
+/**
+ * Validate an entire use-case folder
+ */
+export declare function validateUseCase(options: UseCaseValidationOptions): Promise<ValidationResult>;
+/**
+ * Get list of all available rules (for --rules flag help)
+ */
+export declare function getAvailableRules(): {
+    id: string;
+    description: string;
+}[];
+//# sourceMappingURL=runner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/validation/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH,OAAO,KAAK,EAEV,gBAAgB,EAEhB,yBAAyB,EACzB,wBAAwB,EAEzB,MAAM,YAAY,CAAC;AAMpB;;;;;;;;;;GAUG;AACH;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAExE,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,MAAM,EAW1C,CAAC;AA4CF;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,gBAAgB,CAAC,CAgJ3B;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,gBAAgB,CAAC,CAyH3B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EAAE,CAQzE"}

package/dist/validation/runner.js

@@ -0,0 +1,335 @@
+/**
+ * Validation Runner
+ *
+ * Central orchestrator that runs all validation:
+ * - Flowlint core rules (static analysis)
+ * - Custom Codika rules (graph-based)
+ * - Workflow scripts (content-based checks)
+ * - Use-case scripts (folder-based checks)
+ */
+import { readFileSync, existsSync, readdirSync } from 'fs';
+import { join, resolve, basename } from 'path';
+import { parseN8n, runAllRules as runFlowlintRules, defaultConfig, } from '@replikanti/flowlint-core';
+import { customRules } from './rules/index.js';
+import { workflowScripts } from './workflow-scripts/index.js';
+import { useCaseScripts } from './use-case-scripts/index.js';
+import { applyFixes, groupFindingsByFile } from './fixer.js';
+/**
+ * Default rules to exclude from validation.
+ * These are Flowlint rules that produce false positives for Codika workflows.
+ *
+ * R3 - Idempotency guard: False positive for LangChain parser/transform nodes
+ *      that don't perform mutations (e.g., outputParserStructured)
+ *
+ * Add more rules here as needed:
+ * R5 - No outgoing connections: Expected for terminal nodes (Submit/Error)
+ * R8 - Data never reaches consumer: False positive for LangChain sub-nodes
+ */
+/**
+ * Override severity for specific rules.
+ * Flowlint-core rules have hardcoded severity we can't change at source.
+ */
+export const SEVERITY_OVERRIDES = {
+// Add severity overrides here as needed
+};
+export const DEFAULT_EXCLUDED_RULES = [
+    'R1', // Retry/backoff - replaced by custom RETRY-BACKOFF script with auto-fix
+    'R2', // continueOnFail - legitimate pattern for non-critical nodes (logging, analytics)
+    'R3', // Idempotency guard - false positive for parser nodes
+    'R4', // Hardcoded secrets - false positives on param names; CRED-PLACEHOLDER handles this properly
+    'R5', // No outgoing connections - false positive for Codika Submit/Report Error terminal nodes
+    'R7', // Error path audit - global errorWorkflow handles this
+    'R9', // Env-specific literals - false positives on JS comments, workflow names; CRED-PLACEHOLDER + PLACEHOLDER-SYNTAX cover real cases
+    'R8', // Data never reaches consumer - false positive for Codika Init/Submit/Report data sinks
+    'R11', // Deprecated node type - false positive for executeWorkflow v1.3 which is current
+    'R12', // Unhandled error path - Codika workflows use a global errorWorkflow for error handling
+];
+/**
+ * Calculate summary from findings
+ */
+function calculateSummary(findings) {
+    return {
+        must: findings.filter(f => f.severity === 'must').length,
+        should: findings.filter(f => f.severity === 'should').length,
+        nit: findings.filter(f => f.severity === 'nit').length,
+        fixable: findings.filter(f => f.fixable).length,
+    };
+}
+/**
+ * Filter findings by rule IDs if specified (include list)
+ */
+function filterByRules(findings, rules) {
+    if (!rules || rules.length === 0) {
+        return findings;
+    }
+    const ruleSet = new Set(rules.map(r => r.toUpperCase()));
+    return findings.filter(f => ruleSet.has(f.rule.toUpperCase()));
+}
+/**
+ * Filter out findings by rule IDs (exclude list)
+ * Combines user-provided excludeRules with DEFAULT_EXCLUDED_RULES
+ */
+function excludeByRules(findings, excludeRules) {
+    // Combine default excluded rules with user-provided ones
+    const allExcluded = [
+        ...DEFAULT_EXCLUDED_RULES,
+        ...(excludeRules || []),
+    ];
+    if (allExcluded.length === 0) {
+        return findings;
+    }
+    const excludeSet = new Set(allExcluded.map(r => r.toUpperCase()));
+    return findings.filter(f => !excludeSet.has(f.rule.toUpperCase()));
+}
+/**
+ * Validate a single workflow JSON file
+ */
+export async function validateWorkflow(options) {
+    const absolutePath = resolve(options.path);
+    const findings = [];
+    const filesValidated = [absolutePath];
+    // Check file exists
+    if (!existsSync(absolutePath)) {
+        findings.push({
+            rule: 'FILE-001',
+            severity: 'must',
+            path: absolutePath,
+            message: `Workflow file does not exist: ${absolutePath}`,
+            raw_details: 'Check the file path is correct.',
+        });
+        return {
+            valid: false,
+            findings,
+            summary: calculateSummary(findings),
+            filesValidated,
+        };
+    }
+    // Read file content
+    let content;
+    try {
+        content = readFileSync(absolutePath, 'utf-8');
+    }
+    catch (error) {
+        findings.push({
+            rule: 'FILE-002',
+            severity: 'must',
+            path: absolutePath,
+            message: `Failed to read workflow file: ${error.message}`,
+            raw_details: 'Check file permissions and encoding.',
+        });
+        return {
+            valid: false,
+            findings,
+            summary: calculateSummary(findings),
+            filesValidated,
+        };
+    }
+    // Parse and validate JSON
+    let graph;
+    try {
+        graph = parseN8n(content);
+    }
+    catch (error) {
+        findings.push({
+            rule: 'JSON-001',
+            severity: 'must',
+            path: absolutePath,
+            message: `Invalid workflow JSON: ${error.message}`,
+            raw_details: 'Ensure the file contains valid JSON with proper n8n workflow structure.',
+        });
+        return {
+            valid: false,
+            findings,
+            summary: calculateSummary(findings),
+            filesValidated,
+        };
+    }
+    // Run Flowlint core rules
+    const coreFindings = runFlowlintRules(graph, { cfg: defaultConfig, path: absolutePath });
+    findings.push(...coreFindings);
+    // Run custom Codika rules
+    for (const rule of customRules) {
+        try {
+            const ruleFindings = rule(graph, { cfg: defaultConfig, path: absolutePath });
+            findings.push(...ruleFindings);
+        }
+        catch (error) {
+            findings.push({
+                rule: 'RULE-ERR',
+                severity: 'nit',
+                path: absolutePath,
+                message: `Custom rule error: ${error.message}`,
+            });
+        }
+    }
+    // Run workflow scripts (content-based checks)
+    for (const script of workflowScripts) {
+        try {
+            const scriptFindings = script(content, absolutePath);
+            findings.push(...scriptFindings);
+        }
+        catch (error) {
+            findings.push({
+                rule: 'SCRIPT-ERR',
+                severity: 'nit',
+                path: absolutePath,
+                message: `Workflow script error: ${error.message}`,
+            });
+        }
+    }
+    // Filter by rules if specified (include list)
+    let filteredFindings = filterByRules(findings, options.rules);
+    // Exclude rules if specified (exclude list)
+    filteredFindings = excludeByRules(filteredFindings, options.excludeRules);
+    // Apply severity overrides (before strict mode so --strict can re-promote)
+    filteredFindings = filteredFindings.map(f => {
+        const override = SEVERITY_OVERRIDES[f.rule.toUpperCase()];
+        return override ? { ...f, severity: override } : f;
+    });
+    // Apply strict mode
+    if (options.strict) {
+        filteredFindings = filteredFindings.map(f => f.severity === 'should' ? { ...f, severity: 'must' } : f);
+    }
+    // Handle auto-fix
+    if (options.fix || options.dryRun) {
+        const fixResult = applyFixes(absolutePath, filteredFindings, {
+            dryRun: options.dryRun,
+        });
+        if (fixResult.applied > 0 && !options.dryRun) {
+            // Remove fixed findings from the list
+            const fixedRules = new Set(filteredFindings.filter(f => f.fixable && f.fix).map(f => f.rule));
+            filteredFindings = filteredFindings.filter(f => !f.fixable || !fixedRules.has(f.rule));
+        }
+    }
+    const summary = calculateSummary(filteredFindings);
+    const valid = summary.must === 0;
+    return {
+        valid,
+        findings: filteredFindings,
+        summary,
+        filesValidated,
+    };
+}
+/**
+ * Validate an entire use-case folder
+ */
+export async function validateUseCase(options) {
+    const absolutePath = resolve(options.path);
+    const findings = [];
+    const filesValidated = [];
+    // Check folder exists
+    if (!existsSync(absolutePath)) {
+        findings.push({
+            rule: 'FOLDER-001',
+            severity: 'must',
+            path: absolutePath,
+            message: `Use-case folder does not exist: ${absolutePath}`,
+            raw_details: 'Check the folder path is correct.',
+        });
+        return {
+            valid: false,
+            findings,
+            summary: calculateSummary(findings),
+            filesValidated,
+        };
+    }
+    // Run use-case scripts
+    for (const script of useCaseScripts) {
+        try {
+            const scriptFindings = await script(absolutePath);
+            findings.push(...scriptFindings);
+        }
+        catch (error) {
+            findings.push({
+                rule: 'SCRIPT-ERR',
+                severity: 'nit',
+                path: absolutePath,
+                message: `Use-case script error: ${error.message}`,
+            });
+        }
+    }
+    // Apply fixes to use-case-level findings (e.g., INTEGRATION-INHERITANCE modifies config.ts)
+    if (options.fix) {
+        const useCaseFixable = findings.filter(f => f.fixable && f.fix);
+        if (useCaseFixable.length > 0) {
+            const grouped = groupFindingsByFile(useCaseFixable);
+            for (const [filePath, fileFindings] of grouped) {
+                const fixResult = applyFixes(filePath, fileFindings, {
+                    dryRun: options.dryRun,
+                });
+                if (fixResult.applied > 0) {
+                    // Remove fixed findings from the list
+                    const fixedRules = new Set(fileFindings.filter(f => f.fixable).map(f => `${f.rule}:${f.path}:${f.message}`));
+                    const before = findings.length;
+                    for (let i = findings.length - 1; i >= 0; i--) {
+                        const key = `${findings[i].rule}:${findings[i].path}:${findings[i].message}`;
+                        if (fixedRules.has(key)) {
+                            findings.splice(i, 1);
+                        }
+                    }
+                }
+            }
+        }
+    }
+    // Validate individual workflows unless skipped
+    if (!options.skipWorkflows) {
+        const workflowsPath = join(absolutePath, 'workflows');
+        if (existsSync(workflowsPath)) {
+            const workflowFiles = readdirSync(workflowsPath)
+                .filter(f => f.endsWith('.json'));
+            for (const workflowFile of workflowFiles) {
+                const workflowPath = join(workflowsPath, workflowFile);
+                filesValidated.push(workflowPath);
+                const workflowResult = await validateWorkflow({
+                    path: workflowPath,
+                    strict: options.strict,
+                    fix: options.fix,
+                    dryRun: options.dryRun,
+                    rules: options.rules,
+                    excludeRules: options.excludeRules,
+                });
+                // Add workflow findings with context
+                for (const finding of workflowResult.findings) {
+                    findings.push({
+                        ...finding,
+                        message: `[${basename(workflowFile)}] ${finding.message}`,
+                    });
+                }
+            }
+        }
+    }
+    // Filter by rules if specified (include list)
+    let filteredFindings = filterByRules(findings, options.rules);
+    // Exclude rules if specified (exclude list)
+    filteredFindings = excludeByRules(filteredFindings, options.excludeRules);
+    // Apply severity overrides (before strict mode so --strict can re-promote)
+    filteredFindings = filteredFindings.map(f => {
+        const override = SEVERITY_OVERRIDES[f.rule.toUpperCase()];
+        return override ? { ...f, severity: override } : f;
+    });
+    // Apply strict mode
+    if (options.strict) {
+        filteredFindings = filteredFindings.map(f => f.severity === 'should' ? { ...f, severity: 'must' } : f);
+    }
+    const summary = calculateSummary(filteredFindings);
+    const valid = summary.must === 0;
+    return {
+        valid,
+        findings: filteredFindings,
+        summary,
+        filesValidated: [absolutePath, ...filesValidated],
+    };
+}
+/**
+ * Get list of all available rules (for --rules flag help)
+ */
+export function getAvailableRules() {
+    // This could be expanded to include metadata from all rules
+    return [
+        { id: 'CODIKA-INIT', description: 'Parent workflows must have Codika Init node' },
+        { id: 'CODIKA-SUBMIT', description: 'Workflows must end with Submit Result or Report Error' },
+        { id: 'RETRY-BACKOFF', description: 'API/HTTP nodes should have retry configuration (fixable)' },
+        // Add more as rules are implemented
+    ];
+}
+//# sourceMappingURL=runner.js.map

package/dist/validation/runner.js.map

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

package/dist/validation/types.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Validation Types
+ *
+ * Unified types for all validation rules, scripts, and results.
+ * Extends the Flowlint Finding type with auto-fix support.
+ */
+export type { Graph, RuleRunner, RuleContext, NodeRef, Edge, FlowLintConfig, } from '@replikanti/flowlint-core';
+/**
+ * Extended Finding type with auto-fix support
+ *
+ * Compatible with flowlint-core Finding, but adds optional fix capabilities.
+ */
+export interface Finding {
+    /** Rule ID (e.g., "CODIKA-INIT", "CRED-001", "R1") */
+    rule: string;
+    /** Severity level - determines exit code behavior */
+    severity: 'must' | 'should' | 'nit';
+    /** File path where the issue was found */
+    path: string;
+    /** Human-readable description of the issue */
+    message: string;
+    /** Detailed instructions on how to fix the issue manually */
+    raw_details?: string;
+    /** Node ID for workflow node-specific issues */
+    nodeId?: string;
+    /** Line number in the file where the issue was found */
+    line?: number;
+    /** URL to documentation about this rule */
+    documentationUrl?: string;
+    /** Reference to the guide section explaining this rule */
+    guideRef?: {
+        /** Path relative to .guides/ folder (e.g., 'specific/codika-nodes.md') */
+        path: string;
+        /** Section title within the guide (e.g., 'Critical Workflow Rules') */
+        section?: string;
+    };
+    /** Quick check if an auto-fix is available */
+    fixable?: boolean;
+    /** Auto-fix function (ESLint-style) */
+    fix?: {
+        /** Description of what the fix does */
+        description: string;
+        /** Transform function that applies the fix to file content */
+        apply: (content: string) => string;
+    };
+}
+/**
+ * Result of applying auto-fixes to a file
+ */
+export interface FixResult {
+    /** Path to the file that was fixed */
+    filePath: string;
+    /** Number of fixes successfully applied */
+    applied: number;
+    /** New file content after fixes (empty if dry-run) */
+    content: string;
+    /** Findings that would be fixed (populated in dry-run mode) */
+    wouldFix?: Finding[];
+}
+/**
+ * Summary of validation findings by severity
+ */
+export interface FindingSummary {
+    /** Number of 'must' severity violations (cause exit code 1) */
+    must: number;
+    /** Number of 'should' severity warnings */
+    should: number;
+    /** Number of 'nit' severity suggestions */
+    nit: number;
+    /** Number of issues that can be auto-fixed */
+    fixable: number;
+}
+/**
+ * Complete validation result
+ */
+export interface ValidationResult {
+    /** True if no 'must' severity violations (validation passed) */
+    valid: boolean;
+    /** All findings from all validators */
+    findings: Finding[];
+    /** Summary counts by severity */
+    summary: FindingSummary;
+    /** Files that were validated */
+    filesValidated: string[];
+}
+/**
+ * Options for workflow validation
+ */
+export interface WorkflowValidationOptions {
+    /** Path to the workflow JSON file */
+    path: string;
+    /** Treat 'should' severity as 'must' (stricter validation) */
+    strict?: boolean;
+    /** Apply available auto-fixes */
+    fix?: boolean;
+    /** Show what would be fixed without applying changes */
+    dryRun?: boolean;
+    /** Only run specific rules (by rule ID) */
+    rules?: string[];
+    /** Exclude specific rules (by rule ID) */
+    excludeRules?: string[];
+}
+/**
+ * Options for use-case validation
+ */
+export interface UseCaseValidationOptions {
+    /** Path to the use-case folder */
+    path: string;
+    /** Treat 'should' severity as 'must' (stricter validation) */
+    strict?: boolean;
+    /** Skip validation of individual workflow files */
+    skipWorkflows?: boolean;
+    /** Apply available auto-fixes */
+    fix?: boolean;
+    /** Show what would be fixed without applying changes */
+    dryRun?: boolean;
+    /** Only run specific rules (by rule ID) */
+    rules?: string[];
+    /** Exclude specific rules (by rule ID) */
+    excludeRules?: string[];
+}
+/**
+ * Type for a workflow validation script (non-Flowlint check)
+ *
+ * Scripts receive the raw file content and path, and return findings.
+ * This is different from Flowlint rules which receive a parsed Graph.
+ */
+export type WorkflowScript = (content: string, path: string) => Finding[];
+/**
+ * Type for a use-case validation script
+ *
+ * Scripts receive the use-case folder path and return findings.
+ * They can access config.ts, workflows/, and other files as needed.
+ */
+export type UseCaseScript = (useCasePath: string) => Finding[] | Promise<Finding[]>;
+/**
+ * Rule/script metadata for documentation and filtering
+ */
+export interface RuleMetadata {
+    /** Unique rule ID (e.g., "CODIKA-INIT") */
+    id: string;
+    /** Human-readable rule name (e.g., "codika_init_required") */
+    name: string;
+    /** Default severity */
+    severity: 'must' | 'should' | 'nit';
+    /** Short description of what the rule checks */
+    description: string;
+    /** Detailed explanation and fix instructions */
+    details: string;
+    /** Whether this rule can auto-fix issues */
+    fixable?: boolean;
+    /** Category for grouping (e.g., "codika", "security", "style") */
+    category?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/validation/types.js

@@ -0,0 +1,8 @@
+/**
+ * Validation Types
+ *
+ * Unified types for all validation rules, scripts, and results.
+ * Extends the Flowlint Finding type with auto-fix support.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/validation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/validation/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/validation/use-case-scripts/calledby-consistency.d.ts

@@ -0,0 +1,23 @@
+/**
+ * CALLEDBY-CONSISTENCY Validation Script
+ *
+ * Validates that subworkflows have their callers correctly listed in calledBy.
+ * When workflow A calls subworkflow B via SUBWKFL placeholder,
+ * B's trigger config must include A in its calledBy array.
+ *
+ * @see .guides/specific/sub-workflows.md - "calledBy Array"
+ */
+import type { Finding, RuleMetadata } from '../types.js';
+export declare const RULE_ID = "CALLEDBY-CONSISTENCY";
+export declare const metadata: RuleMetadata & {
+    guideRef: {
+        path: string;
+        section: string;
+    };
+};
+/**
+ * Validates that all workflow callers are listed in subworkflow calledBy arrays
+ */
+export declare function checkCalledByConsistency(useCasePath: string): Promise<Finding[]>;
+export default checkCalledByConsistency;
+//# sourceMappingURL=calledby-consistency.d.ts.map

package/dist/validation/use-case-scripts/calledby-consistency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calledby-consistency.d.ts","sourceRoot":"","sources":["../../../src/validation/use-case-scripts/calledby-consistency.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEzD,eAAO,MAAM,OAAO,yBAAyB,CAAC;AAE9C,eAAO,MAAM,QAAQ,EAAE,YAAY,GAAG;IAAE,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAYlF,CAAC;AAoJF;;GAEG;AACH,wBAAsB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAuGtF;AAED,eAAe,wBAAwB,CAAC"}