codika 3.0.0

package/dist/validation/use-case-scripts/skill-consistency.js

@@ -0,0 +1,180 @@
+/**
+ * Script: SKILL-CONSISTENCY
+ *
+ * Validates skill files in the skills/ directory follow the Claude Agent Skills format:
+ * - Each subdirectory must contain a SKILL.md file
+ * - SKILL.md must have valid YAML frontmatter (name, description, workflowTemplateId)
+ * - name must follow Claude spec: max 64 chars, lowercase+numbers+hyphens, no reserved words
+ * - description must be non-empty, max 1024 chars
+ * - workflowTemplateId must reference an existing workflow
+ * - No duplicate names or workflowTemplateIds
+ *
+ * Skills folder is optional — no error if missing.
+ */
+import { existsSync, readdirSync, readFileSync, statSync } from 'fs';
+import { join, basename } from 'path';
+import { parseSkillFrontmatter } from '../../utils/skill-parser.js';
+export const metadata = {
+    id: 'SKILL-CONSISTENCY',
+    name: 'skill_consistency',
+    severity: 'must',
+    description: 'Skill files must follow Claude Agent Skills format with valid frontmatter and workflow references',
+    details: 'Each skill directory must contain a SKILL.md with name, description, and workflowTemplateId in YAML frontmatter',
+    category: 'skills',
+};
+const MAX_NAME_LENGTH = 64;
+const MAX_DESCRIPTION_LENGTH = 1024;
+const NAME_PATTERN = /^[a-z0-9-]+$/;
+const RESERVED_WORDS = ['anthropic', 'claude'];
+/**
+ * Check skill consistency across the use case
+ */
+export async function checkSkillConsistency(useCasePath) {
+    const findings = [];
+    const skillsPath = join(useCasePath, 'skills');
+    // Skills folder is optional
+    if (!existsSync(skillsPath)) {
+        return findings;
+    }
+    // Collect known workflow template IDs from workflows/ folder
+    const workflowsPath = join(useCasePath, 'workflows');
+    const knownTemplateIds = existsSync(workflowsPath)
+        ? readdirSync(workflowsPath)
+            .filter(f => f.endsWith('.json'))
+            .map(f => basename(f, '.json'))
+        : [];
+    const entries = readdirSync(skillsPath);
+    const seenNames = new Set();
+    const seenWorkflowIds = new Set();
+    for (const entry of entries) {
+        const entryPath = join(skillsPath, entry);
+        // Only check directories
+        if (!statSync(entryPath).isDirectory()) {
+            continue;
+        }
+        const skillMdPath = join(entryPath, 'SKILL.md');
+        const relativePath = `skills/${entry}/SKILL.md`;
+        // SKILL-STRUCTURE: Directory must contain SKILL.md
+        if (!existsSync(skillMdPath)) {
+            findings.push({
+                rule: 'SKILL-STRUCTURE',
+                severity: 'must',
+                path: entryPath,
+                message: `${relativePath}: skill directory '${entry}' is missing a SKILL.md file`,
+            });
+            continue;
+        }
+        const content = readFileSync(skillMdPath, 'utf-8');
+        const { frontmatter } = parseSkillFrontmatter(content);
+        // SKILL-FRONTMATTER: Must have valid frontmatter
+        if (!frontmatter.name && !frontmatter.description && !frontmatter.workflowTemplateId) {
+            findings.push({
+                rule: 'SKILL-FRONTMATTER',
+                severity: 'must',
+                path: skillMdPath,
+                message: `${relativePath}: missing or empty YAML frontmatter`,
+            });
+            continue;
+        }
+        // SKILL-NAME-FORMAT: name validation (Claude spec)
+        if (!frontmatter.name) {
+            findings.push({
+                rule: 'SKILL-NAME-FORMAT',
+                severity: 'must',
+                path: skillMdPath,
+                message: `${relativePath}: missing required 'name' in frontmatter`,
+            });
+        }
+        else {
+            if (frontmatter.name.length > MAX_NAME_LENGTH) {
+                findings.push({
+                    rule: 'SKILL-NAME-FORMAT',
+                    severity: 'must',
+                    path: skillMdPath,
+                    message: `${relativePath}: name '${frontmatter.name}' exceeds ${MAX_NAME_LENGTH} characters`,
+                });
+            }
+            if (!NAME_PATTERN.test(frontmatter.name)) {
+                findings.push({
+                    rule: 'SKILL-NAME-FORMAT',
+                    severity: 'must',
+                    path: skillMdPath,
+                    message: `${relativePath}: name '${frontmatter.name}' must contain only lowercase letters, numbers, and hyphens`,
+                });
+            }
+            for (const reserved of RESERVED_WORDS) {
+                if (frontmatter.name.includes(reserved)) {
+                    findings.push({
+                        rule: 'SKILL-NAME-FORMAT',
+                        severity: 'must',
+                        path: skillMdPath,
+                        message: `${relativePath}: name '${frontmatter.name}' contains reserved word '${reserved}'`,
+                    });
+                }
+            }
+            // SKILL-DUPLICATE: Check for duplicate names
+            if (seenNames.has(frontmatter.name)) {
+                findings.push({
+                    rule: 'SKILL-DUPLICATE',
+                    severity: 'must',
+                    path: skillMdPath,
+                    message: `${relativePath}: duplicate skill name '${frontmatter.name}'`,
+                });
+            }
+            else {
+                seenNames.add(frontmatter.name);
+            }
+        }
+        // SKILL-DESCRIPTION: description validation
+        if (!frontmatter.description) {
+            findings.push({
+                rule: 'SKILL-DESCRIPTION',
+                severity: 'should',
+                path: skillMdPath,
+                message: `${relativePath}: missing 'description' in frontmatter`,
+            });
+        }
+        else if (frontmatter.description.length > MAX_DESCRIPTION_LENGTH) {
+            findings.push({
+                rule: 'SKILL-DESCRIPTION',
+                severity: 'must',
+                path: skillMdPath,
+                message: `${relativePath}: description exceeds ${MAX_DESCRIPTION_LENGTH} characters`,
+            });
+        }
+        // SKILL-WORKFLOW-REF: workflowTemplateId validation
+        if (!frontmatter.workflowTemplateId) {
+            findings.push({
+                rule: 'SKILL-WORKFLOW-REF',
+                severity: 'must',
+                path: skillMdPath,
+                message: `${relativePath}: missing required 'workflowTemplateId' in frontmatter`,
+            });
+        }
+        else {
+            if (knownTemplateIds.length > 0 && !knownTemplateIds.includes(frontmatter.workflowTemplateId)) {
+                findings.push({
+                    rule: 'SKILL-WORKFLOW-REF',
+                    severity: 'must',
+                    path: skillMdPath,
+                    message: `${relativePath}: workflowTemplateId '${frontmatter.workflowTemplateId}' does not match any workflow file`,
+                    raw_details: `Known workflows: ${knownTemplateIds.join(', ')}`,
+                });
+            }
+            // SKILL-DUPLICATE: Check for duplicate workflowTemplateIds
+            if (seenWorkflowIds.has(frontmatter.workflowTemplateId)) {
+                findings.push({
+                    rule: 'SKILL-DUPLICATE',
+                    severity: 'must',
+                    path: skillMdPath,
+                    message: `${relativePath}: duplicate workflowTemplateId '${frontmatter.workflowTemplateId}'`,
+                });
+            }
+            else {
+                seenWorkflowIds.add(frontmatter.workflowTemplateId);
+            }
+        }
+    }
+    return findings;
+}
+//# sourceMappingURL=skill-consistency.js.map

package/dist/validation/use-case-scripts/skill-consistency.js.map

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

package/dist/validation/use-case-scripts/subworkflow-references.d.ts

@@ -0,0 +1,22 @@
+/**
+ * SUBWKFL-REFERENCES Validation Script
+ *
+ * Validates that all SUBWKFL_ placeholders in workflow files
+ * reference existing workflowTemplateId values defined in config.ts
+ *
+ * @see .guides/specific/placeholder-patterns.md - "Sub-Workflow References (SUBWKFL)"
+ */
+import type { Finding, RuleMetadata } from '../types.js';
+export declare const RULE_ID = "SUBWKFL-REFERENCES";
+export declare const metadata: RuleMetadata & {
+    guideRef: {
+        path: string;
+        section: string;
+    };
+};
+/**
+ * Validates that all SUBWKFL_ placeholders reference existing template IDs
+ */
+export declare function checkSubworkflowReferences(useCasePath: string): Promise<Finding[]>;
+export default checkSubworkflowReferences;
+//# sourceMappingURL=subworkflow-references.d.ts.map

package/dist/validation/use-case-scripts/subworkflow-references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subworkflow-references.d.ts","sourceRoot":"","sources":["../../../src/validation/use-case-scripts/subworkflow-references.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,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;CAYlF,CAAC;AAuCF;;GAEG;AACH,wBAAsB,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAuFxF;AAED,eAAe,0BAA0B,CAAC"}

package/dist/validation/use-case-scripts/subworkflow-references.js

@@ -0,0 +1,139 @@
+/**
+ * SUBWKFL-REFERENCES Validation Script
+ *
+ * Validates that all SUBWKFL_ placeholders in workflow files
+ * reference existing workflowTemplateId values defined in config.ts
+ *
+ * @see .guides/specific/placeholder-patterns.md - "Sub-Workflow References (SUBWKFL)"
+ */
+import { readFileSync, readdirSync, existsSync } from 'fs';
+import { join } from 'path';
+export const RULE_ID = 'SUBWKFL-REFERENCES';
+export const metadata = {
+    id: RULE_ID,
+    name: 'subworkflow_references',
+    severity: 'must',
+    description: 'SUBWKFL placeholders must reference existing workflow template IDs',
+    details: 'Each {{SUBWKFL_<TEMPLATE_ID>_LFKWBUS}} placeholder must reference a workflowTemplateId defined in config.ts',
+    fixable: false,
+    category: 'references',
+    guideRef: {
+        path: 'specific/placeholder-patterns.md',
+        section: 'Sub-Workflow References (SUBWKFL)',
+    },
+};
+// Regex to find SUBWKFL placeholders
+const SUBWKFL_PATTERN = /\{\{SUBWKFL_([a-zA-Z0-9_-]+)_LFKWBUS\}\}/g;
+// Regex to extract workflowTemplateId from config.ts
+const TEMPLATE_ID_PATTERN = /workflowTemplateId:\s*['"]([^'"]+)['"]/g;
+/**
+ * Extracts all workflowTemplateId values from config.ts content
+ */
+function extractTemplateIds(configContent) {
+    const templateIds = [];
+    let match;
+    while ((match = TEMPLATE_ID_PATTERN.exec(configContent)) !== null) {
+        templateIds.push(match[1]);
+    }
+    return templateIds;
+}
+/**
+ * Extracts all SUBWKFL_ references from workflow content
+ */
+function extractSubworkflowReferences(content) {
+    const references = [];
+    let match;
+    // Reset regex state
+    SUBWKFL_PATTERN.lastIndex = 0;
+    while ((match = SUBWKFL_PATTERN.exec(content)) !== null) {
+        references.push(match[1]);
+    }
+    return references;
+}
+/**
+ * Validates that all SUBWKFL_ placeholders reference existing template IDs
+ */
+export async function checkSubworkflowReferences(useCasePath) {
+    const findings = [];
+    // Check if config.ts exists
+    const configPath = join(useCasePath, 'config.ts');
+    if (!existsSync(configPath)) {
+        findings.push({
+            rule: RULE_ID,
+            severity: 'must',
+            path: useCasePath,
+            message: 'Cannot find config.ts in use-case folder',
+            raw_details: 'Ensure config.ts exists in the use-case root folder',
+            guideRef: metadata.guideRef,
+        });
+        return findings;
+    }
+    // Read config.ts and extract template IDs
+    let configContent;
+    try {
+        configContent = readFileSync(configPath, 'utf-8');
+    }
+    catch {
+        findings.push({
+            rule: RULE_ID,
+            severity: 'must',
+            path: configPath,
+            message: 'Cannot read config.ts',
+            raw_details: 'Ensure config.ts is readable',
+            guideRef: metadata.guideRef,
+        });
+        return findings;
+    }
+    const templateIds = extractTemplateIds(configContent);
+    // Check workflows folder
+    const workflowsPath = join(useCasePath, 'workflows');
+    if (!existsSync(workflowsPath)) {
+        // No workflows folder - nothing to validate
+        return findings;
+    }
+    // Get all workflow JSON files
+    let workflowFiles;
+    try {
+        workflowFiles = readdirSync(workflowsPath)
+            .filter(f => f.endsWith('.json'))
+            .map(f => join(workflowsPath, f));
+    }
+    catch {
+        findings.push({
+            rule: RULE_ID,
+            severity: 'must',
+            path: workflowsPath,
+            message: 'Cannot read workflows folder',
+            raw_details: 'Ensure workflows folder is readable',
+            guideRef: metadata.guideRef,
+        });
+        return findings;
+    }
+    // Check each workflow file for SUBWKFL_ references
+    for (const workflowFile of workflowFiles) {
+        let content;
+        try {
+            content = readFileSync(workflowFile, 'utf-8');
+        }
+        catch {
+            continue; // Skip unreadable files
+        }
+        const references = extractSubworkflowReferences(content);
+        // Validate each reference
+        for (const ref of references) {
+            if (!templateIds.includes(ref)) {
+                findings.push({
+                    rule: RULE_ID,
+                    severity: 'must',
+                    path: workflowFile,
+                    message: `SUBWKFL placeholder references unknown template ID: "${ref}"`,
+                    raw_details: `The placeholder {{SUBWKFL_${ref}_LFKWBUS}} references a template ID that doesn't exist in config.ts. Available template IDs: ${templateIds.join(', ') || '(none)'}`,
+                    guideRef: metadata.guideRef,
+                });
+            }
+        }
+    }
+    return findings;
+}
+export default checkSubworkflowReferences;
+//# sourceMappingURL=subworkflow-references.js.map

package/dist/validation/use-case-scripts/subworkflow-references.js.map

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

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

@@ -0,0 +1,25 @@
+/**
+ * TRIGGER-TYPE-CONSISTENCY Validation Script
+ *
+ * Validates that the trigger type declared in config.ts matches the actual
+ * trigger node type found in the corresponding workflow JSON file.
+ *
+ * For example, if config.ts declares type: 'http', the workflow must contain
+ * a webhook node, not a scheduleTrigger or a service-specific trigger node.
+ *
+ * @see .guides/specific/third-party-triggers.md - "Config.ts for Third-Party Triggered Workflows"
+ */
+import type { Finding, RuleMetadata } from '../types.js';
+export declare const RULE_ID = "TRIGGER-TYPE-CONSISTENCY";
+export declare const metadata: RuleMetadata & {
+    guideRef: {
+        path: string;
+        section: string;
+    };
+};
+/**
+ * Validates that trigger types in config.ts match the workflow trigger nodes.
+ */
+export declare function checkTriggerTypeConsistency(useCasePath: string): Promise<Finding[]>;
+export default checkTriggerTypeConsistency;
+//# sourceMappingURL=trigger-type-consistency.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-type-consistency.d.ts","sourceRoot":"","sources":["../../../src/validation/use-case-scripts/trigger-type-consistency.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEzD,eAAO,MAAM,OAAO,6BAA6B,CAAC;AAElD,eAAO,MAAM,QAAQ,EAAE,YAAY,GAAG;IAAE,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAclF,CAAC;AAqMF;;GAEG;AACH,wBAAsB,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAmFzF;AAED,eAAe,2BAA2B,CAAC"}

package/dist/validation/use-case-scripts/trigger-type-consistency.js

@@ -0,0 +1,265 @@
+/**
+ * TRIGGER-TYPE-CONSISTENCY Validation Script
+ *
+ * Validates that the trigger type declared in config.ts matches the actual
+ * trigger node type found in the corresponding workflow JSON file.
+ *
+ * For example, if config.ts declares type: 'http', the workflow must contain
+ * a webhook node, not a scheduleTrigger or a service-specific trigger node.
+ *
+ * @see .guides/specific/third-party-triggers.md - "Config.ts for Third-Party Triggered Workflows"
+ */
+import { readFileSync, readdirSync, existsSync } from 'fs';
+import { join, basename } from 'path';
+export const RULE_ID = 'TRIGGER-TYPE-CONSISTENCY';
+export const metadata = {
+    id: RULE_ID,
+    name: 'trigger_type_consistency',
+    severity: 'must',
+    description: 'Config trigger type must match the actual trigger node in the workflow',
+    details: 'The trigger type in config.ts (http, schedule, subworkflow, service_event) must be consistent ' +
+        'with the trigger node found in the workflow JSON. A mismatch causes runtime failures.',
+    fixable: false,
+    category: 'triggers',
+    guideRef: {
+        path: 'specific/third-party-triggers.md',
+        section: 'Config.ts for Third-Party Triggered Workflows',
+    },
+};
+const GUIDE_REF = {
+    path: 'specific/third-party-triggers.md',
+    section: 'Config.ts for Third-Party Triggered Workflows',
+};
+/**
+ * Known trigger node types and their categories
+ */
+const WEBHOOK_NODE = 'n8n-nodes-base.webhook';
+const SCHEDULE_NODE = 'n8n-nodes-base.scheduleTrigger';
+const EXECUTE_WORKFLOW_TRIGGER_NODE = 'n8n-nodes-base.executeWorkflowTrigger';
+/**
+ * Determines the trigger category from an n8n node type string.
+ */
+function categorizeNodeType(nodeType) {
+    if (nodeType === WEBHOOK_NODE)
+        return 'webhook';
+    if (nodeType === SCHEDULE_NODE)
+        return 'schedule';
+    if (nodeType.toLowerCase().includes('executeworkflowtrigger'))
+        return 'subworkflow';
+    // Any other node whose type contains "Trigger" (case-insensitive) is a service trigger
+    if (/trigger/i.test(nodeType))
+        return 'service_trigger';
+    return 'unknown';
+}
+/**
+ * Determines the primary trigger category for a workflow.
+ * Non-webhook triggers take precedence over webhook triggers
+ * (a workflow might have both a service trigger and a webhook).
+ */
+function getPrimaryTriggerCategory(triggers) {
+    if (triggers.length === 0)
+        return null;
+    // Prefer non-webhook, non-unknown triggers
+    const primary = triggers.find(t => t.category !== 'webhook' && t.category !== 'unknown');
+    if (primary)
+        return primary;
+    // Fall back to webhook
+    const webhook = triggers.find(t => t.category === 'webhook');
+    if (webhook)
+        return webhook;
+    return triggers[0];
+}
+/**
+ * Extracts trigger type declarations from config.ts per workflow.
+ */
+function extractConfigTriggerTypes(configContent) {
+    const results = [];
+    const templateIdPattern = /workflowTemplateId:\s*['"]([^'"]+)['"]/g;
+    let templateMatch;
+    while ((templateMatch = templateIdPattern.exec(configContent)) !== null) {
+        const templateId = templateMatch[1];
+        const templateIdEndPos = templateMatch.index + templateMatch[0].length;
+        // Find the end of this workflow block
+        const nextTemplatePattern = /workflowTemplateId:/g;
+        nextTemplatePattern.lastIndex = templateIdEndPos;
+        const nextMatch = nextTemplatePattern.exec(configContent);
+        const blockEnd = nextMatch ? nextMatch.index : configContent.length;
+        const workflowBlock = configContent.slice(templateMatch.index, blockEnd);
+        // Find triggers array in this block
+        const triggersMatch = workflowBlock.match(/triggers:\s*\[([\s\S]*?)\]/);
+        if (!triggersMatch)
+            continue;
+        const triggersContent = triggersMatch[1];
+        if (triggersContent.trim().length === 0)
+            continue;
+        // Extract trigger type values
+        const triggerTypes = [];
+        const typePattern = /type:\s*['"]([^'"]+)['"]/g;
+        let typeMatch;
+        typePattern.lastIndex = 0;
+        while ((typeMatch = typePattern.exec(triggersContent)) !== null) {
+            triggerTypes.push(typeMatch[1]);
+        }
+        if (triggerTypes.length > 0) {
+            results.push({ workflowTemplateId: templateId, triggerTypes });
+        }
+    }
+    return results;
+}
+/**
+ * Extracts trigger nodes from a workflow JSON.
+ */
+function extractWorkflowTriggers(workflowContent) {
+    const triggers = [];
+    try {
+        const workflow = JSON.parse(workflowContent);
+        for (const node of workflow.nodes || []) {
+            const category = categorizeNodeType(node.type || '');
+            if (category !== 'unknown') {
+                triggers.push({
+                    nodeType: node.type,
+                    nodeName: node.name || node.type,
+                    category,
+                });
+            }
+        }
+    }
+    catch {
+        // Invalid JSON — other validators handle this
+    }
+    return triggers;
+}
+/**
+ * Checks whether a config trigger type is compatible with the detected workflow trigger.
+ * Returns an error message if incompatible, null if compatible.
+ */
+function checkCompatibility(configType, primaryTrigger) {
+    const { category } = primaryTrigger;
+    switch (configType) {
+        case 'http':
+            // http config type requires a webhook node
+            if (category !== 'webhook') {
+                return `Config declares type 'http' but the workflow's primary trigger is a ${category} node (${primaryTrigger.nodeType}). ` +
+                    `Use type: '${suggestConfigType(category)}' instead.`;
+            }
+            return null;
+        case 'schedule':
+            // schedule config type requires a scheduleTrigger node
+            if (category !== 'schedule') {
+                return `Config declares type 'schedule' but the workflow's primary trigger is a ${category} node (${primaryTrigger.nodeType}). ` +
+                    `Use type: '${suggestConfigType(category)}' instead.`;
+            }
+            return null;
+        case 'subworkflow':
+            // subworkflow config type requires an executeWorkflowTrigger node
+            if (category !== 'subworkflow') {
+                return `Config declares type 'subworkflow' but the workflow's primary trigger is a ${category} node (${primaryTrigger.nodeType}). ` +
+                    `Use type: '${suggestConfigType(category)}' instead.`;
+            }
+            return null;
+        case 'service_event':
+            // service_event is flexible — it should NOT be used with webhook, schedule, or subworkflow
+            if (category === 'webhook' || category === 'schedule' || category === 'subworkflow') {
+                return `Config declares type 'service_event' but the workflow's primary trigger is a ${category} node (${primaryTrigger.nodeType}). ` +
+                    `Use type: '${suggestConfigType(category)}' instead.`;
+            }
+            return null;
+        default:
+            // Unknown config type — don't validate
+            return null;
+    }
+}
+/**
+ * Suggests the correct config type for a given trigger category.
+ */
+function suggestConfigType(category) {
+    switch (category) {
+        case 'webhook': return 'http';
+        case 'schedule': return 'schedule';
+        case 'subworkflow': return 'subworkflow';
+        case 'service_trigger': return 'service_event';
+        default: return 'service_event';
+    }
+}
+/**
+ * Validates that trigger types in config.ts match the workflow trigger nodes.
+ */
+export async function checkTriggerTypeConsistency(useCasePath) {
+    const findings = [];
+    const configPath = join(useCasePath, 'config.ts');
+    if (!existsSync(configPath)) {
+        return findings;
+    }
+    let configContent;
+    try {
+        configContent = readFileSync(configPath, 'utf-8');
+    }
+    catch {
+        return findings;
+    }
+    const configTriggers = extractConfigTriggerTypes(configContent);
+    if (configTriggers.length === 0) {
+        return findings;
+    }
+    // Check workflows folder
+    const workflowsPath = join(useCasePath, 'workflows');
+    if (!existsSync(workflowsPath)) {
+        return findings;
+    }
+    // Read all workflow files
+    let workflowFiles;
+    try {
+        workflowFiles = readdirSync(workflowsPath)
+            .filter(f => f.endsWith('.json'))
+            .map(f => join(workflowsPath, f));
+    }
+    catch {
+        return findings;
+    }
+    // Build a map of templateId -> workflow triggers
+    const workflowTriggerMap = new Map();
+    for (const workflowFile of workflowFiles) {
+        const templateId = basename(workflowFile, '.json');
+        let content;
+        try {
+            content = readFileSync(workflowFile, 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        workflowTriggerMap.set(templateId, extractWorkflowTriggers(content));
+    }
+    // Validate each config workflow's trigger types against workflow nodes
+    for (const configInfo of configTriggers) {
+        const workflowTriggers = workflowTriggerMap.get(configInfo.workflowTemplateId);
+        if (!workflowTriggers || workflowTriggers.length === 0) {
+            // No workflow file or no trigger nodes — other rules handle this
+            continue;
+        }
+        const primaryTrigger = getPrimaryTriggerCategory(workflowTriggers);
+        if (!primaryTrigger)
+            continue;
+        for (const configType of configInfo.triggerTypes) {
+            const error = checkCompatibility(configType, primaryTrigger);
+            if (error) {
+                findings.push({
+                    rule: RULE_ID,
+                    severity: 'must',
+                    path: configPath,
+                    message: `Trigger type mismatch in workflow "${configInfo.workflowTemplateId}": ${error}`,
+                    raw_details: `The config.ts trigger type '${configType}' does not match the workflow's actual trigger node.\n\n` +
+                        `Workflow trigger node: ${primaryTrigger.nodeType} (${primaryTrigger.nodeName})\n` +
+                        `Detected category: ${primaryTrigger.category}\n` +
+                        `Config trigger type: ${configType}\n\n` +
+                        `Update the trigger type in config.ts to match the workflow's trigger node.\n\n` +
+                        `See documentation:\n` +
+                        `- .guides/${GUIDE_REF.path} > "${GUIDE_REF.section}"`,
+                    guideRef: GUIDE_REF,
+                });
+            }
+        }
+    }
+    return findings;
+}
+export default checkTriggerTypeConsistency;
+//# sourceMappingURL=trigger-type-consistency.js.map