flowlint 0.3.0 → 0.3.2

package/dist/cli.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * FlowLint CLI
+ *
+ * A command-line tool for static analysis of n8n workflow files.
+ * Can be used locally, in CI pipelines, or pre-commit hooks.
+ */
+export {};

package/dist/cli.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * FlowLint CLI
+ *
+ * A command-line tool for static analysis of n8n workflow files.
+ * Can be used locally, in CI pipelines, or pre-commit hooks.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const scan_1 = require("./commands/scan");
+const init_1 = require("./commands/init");
+const program = new commander_1.Command();
+program
+    .name('flowlint')
+    .description('Static analysis tool for n8n workflows')
+    .version('0.3.0');
+// Register commands
+program.addCommand(scan_1.scanCommand);
+program.addCommand(init_1.initCommand);
+// Parse and execute
+program.parse(process.argv);
+// Show help if no command provided
+if (!process.argv.slice(2).length) {
+    program.outputHelp();
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../../../apps/cli/src/cli.ts"],"names":[],"mappings":";;AAEA;;;;;GAKG;;AAEH,yCAAoC;AACpC,0CAA8C;AAC9C,0CAA8C;AAE9C,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,UAAU,CAAC;KAChB,WAAW,CAAC,wCAAwC,CAAC;KACrD,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,oBAAoB;AACpB,OAAO,CAAC,UAAU,CAAC,kBAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,kBAAW,CAAC,CAAC;AAEhC,oBAAoB;AACpB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAE5B,mCAAmC;AACnC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAClC,OAAO,CAAC,UAAU,EAAE,CAAC;AACvB,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1,8 @@
+/**
+ * init command - Create a .flowlint.yml configuration file interactively
+ *
+ * Usage:
+ *   flowlint init
+ */
+import { Command } from 'commander';
+export declare const initCommand: Command;

package/dist/commands/init.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * init command - Create a .flowlint.yml configuration file interactively
+ *
+ * Usage:
+ *   flowlint init
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initCommand = void 0;
+const commander_1 = require("commander");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const yaml_1 = __importDefault(require("yaml"));
+const flowlint_config_1 = require('../../../../packages/config/flowlint-config');
+exports.initCommand = new commander_1.Command('init')
+    .description('Create a .flowlint.yml configuration file')
+    .action(async () => {
+    const configPath = path_1.default.join(process.cwd(), '.flowlint.yml');
+    // Check if config already exists
+    if (fs_1.default.existsSync(configPath)) {
+        console.log('.flowlint.yml already exists. Skipping initialization.');
+        return;
+    }
+    // For now, just write the default config
+    // In the future, this could be interactive
+    const yaml = yaml_1.default.stringify(flowlint_config_1.defaultConfig, { lineWidth: 120 });
+    fs_1.default.writeFileSync(configPath, yaml, 'utf8');
+    console.log(`✓ Created .flowlint.yml with default configuration`);
+    console.log(`  Edit the file to customize linting rules and patterns`);
+});
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../../../apps/cli/src/commands/init.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;AAEH,yCAAoC;AACpC,4CAAoB;AACpB,gDAAwB;AACxB,gDAAwB;AACxB,qEAAgE;AAEnD,QAAA,WAAW,GAAG,IAAI,mBAAO,CAAC,MAAM,CAAC;KAC3C,WAAW,CAAC,2CAA2C,CAAC;KACxD,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,UAAU,GAAG,cAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,eAAe,CAAC,CAAC;IAE7D,iCAAiC;IACjC,IAAI,YAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,wDAAwD,CAAC,CAAC;QACtE,OAAO;IACT,CAAC;IAED,yCAAyC;IACzC,2CAA2C;IAC3C,MAAM,IAAI,GAAG,cAAI,CAAC,SAAS,CAAC,+BAAa,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;IAC/D,YAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAE3C,OAAO,CAAC,GAAG,CAAC,oDAAoD,CAAC,CAAC;IAClE,OAAO,CAAC,GAAG,CAAC,yDAAyD,CAAC,CAAC;AACzE,CAAC,CAAC,CAAC"}

package/dist/commands/scan.d.ts

@@ -0,0 +1,11 @@
+/**
+ * scan command - Analyze n8n workflow files in a directory
+ *
+ * Usage:
+ *   flowlint scan [path]
+ *   flowlint scan . --config .flowlint.yml
+ *   flowlint scan --format json --out-file report.json
+ *   flowlint scan --fail-on-error
+ */
+import { Command } from 'commander';
+export declare const scanCommand: Command;

package/dist/commands/scan.js

@@ -0,0 +1,59 @@
+"use strict";
+/**
+ * scan command - Analyze n8n workflow files in a directory
+ *
+ * Usage:
+ *   flowlint scan [path]
+ *   flowlint scan . --config .flowlint.yml
+ *   flowlint scan --format json --out-file report.json
+ *   flowlint scan --fail-on-error
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scanCommand = void 0;
+const commander_1 = require("commander");
+const path_1 = __importDefault(require("path"));
+const local_file_source_1 = require("../providers/local-file-source");
+const local_config_provider_1 = require("../providers/local-config-provider");
+const console_reporter_1 = require("../reporters/console-reporter");
+const json_reporter_1 = require("../reporters/json-reporter");
+const review_1 = require('../../../../packages/review');
+exports.scanCommand = new commander_1.Command('scan')
+    .description('Scan workflow files for issues')
+    .argument('[path]', 'Directory to scan', '.')
+    .option('--config <path>', 'Path to .flowlint.yml config file')
+    .option('--format <format>', 'Output format: stylish|json', 'stylish')
+    .option('--out-file <path>', 'Write JSON results to file (implies --format json)')
+    .option('--fail-on-error', 'Exit with code 1 if errors found')
+    .action(async (scanPath, options) => {
+    try {
+        const absolutePath = path_1.default.resolve(process.cwd(), scanPath);
+        const configPath = options.config ? path_1.default.resolve(process.cwd(), options.config) : undefined;
+        const format = options.outFile ? 'json' : options.format;
+        // Initialize providers
+        const fileSource = new local_file_source_1.LocalFileSource(absolutePath);
+        const configProvider = new local_config_provider_1.LocalConfigProvider(configPath);
+        // Choose reporter based on format
+        let reporter;
+        if (format === 'json' || options.outFile) {
+            reporter = new json_reporter_1.JsonReporter(options.outFile);
+        }
+        else {
+            reporter = new console_reporter_1.ConsoleReporter();
+        }
+        // Run analysis
+        const engine = new review_1.DefaultAnalysisEngine(fileSource, configProvider, reporter);
+        const summary = await engine.analyze();
+        // Exit with appropriate code
+        if (options.failOnError && summary.hasBlockingIssues) {
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        console.error('Error:', error instanceof Error ? error.message : String(error));
+        process.exit(2);
+    }
+});
+//# sourceMappingURL=scan.js.map

package/dist/commands/scan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.js","sourceRoot":"","sources":["../../../../../apps/cli/src/commands/scan.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;;;;AAEH,yCAAoC;AACpC,gDAAwB;AACxB,sEAAiE;AACjE,8EAAyE;AACzE,oEAAgE;AAChE,8DAA0D;AAC1D,4CAAwD;AAE3C,QAAA,WAAW,GAAG,IAAI,mBAAO,CAAC,MAAM,CAAC;KAC3C,WAAW,CAAC,gCAAgC,CAAC;KAC7C,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,EAAE,GAAG,CAAC;KAC5C,MAAM,CAAC,iBAAiB,EAAE,mCAAmC,CAAC;KAC9D,MAAM,CAAC,mBAAmB,EAAE,6BAA6B,EAAE,SAAS,CAAC;KACrE,MAAM,CAAC,mBAAmB,EAAE,oDAAoD,CAAC;KACjF,MAAM,CAAC,iBAAiB,EAAE,kCAAkC,CAAC;KAC7D,MAAM,CAAC,KAAK,EAAE,QAAgB,EAAE,OAAY,EAAE,EAAE;IAC/C,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,cAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;QAC3D,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,cAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5F,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QAEzD,uBAAuB;QACvB,MAAM,UAAU,GAAG,IAAI,mCAAe,CAAC,YAAY,CAAC,CAAC;QACrD,MAAM,cAAc,GAAG,IAAI,2CAAmB,CAAC,UAAU,CAAC,CAAC;QAE3D,kCAAkC;QAClC,IAAI,QAAQ,CAAC;QACb,IAAI,MAAM,KAAK,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACzC,QAAQ,GAAG,IAAI,4BAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACN,QAAQ,GAAG,IAAI,kCAAe,EAAE,CAAC;QACnC,CAAC;QAED,eAAe;QACf,MAAM,MAAM,GAAG,IAAI,8BAAqB,CAAC,UAAU,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC;QAC/E,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QAEvC,6BAA6B;QAC7B,IAAI,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;YACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAChF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/providers/local-config-provider.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Local Config Provider
+ * Loads .flowlint.yml from the local filesystem
+ */
+import { type FlowLintConfig } from 'packages/config/flowlint-config';
+import type { ConfigProvider } from 'packages/review/providers';
+export declare class LocalConfigProvider implements ConfigProvider {
+    private configPath?;
+    constructor(configPath?: string | undefined);
+    load(): Promise<FlowLintConfig>;
+}

package/dist/providers/local-config-provider.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * Local Config Provider
+ * Loads .flowlint.yml from the local filesystem
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalConfigProvider = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const yaml_1 = __importDefault(require("yaml"));
+const flowlint_config_1 = require('../../../../packages/config/flowlint-config');
+const merge_1 = require('../../../../packages/review/utils/merge');
+class LocalConfigProvider {
+    constructor(configPath) {
+        this.configPath = configPath;
+    }
+    async load() {
+        // Determine config file path
+        const configFile = this.configPath || path_1.default.join(process.cwd(), '.flowlint.yml');
+        // If config doesn't exist, return defaults
+        if (!fs_1.default.existsSync(configFile)) {
+            return flowlint_config_1.defaultConfig;
+        }
+        try {
+            const content = fs_1.default.readFileSync(configFile, 'utf8');
+            const parsed = yaml_1.default.parse(content) || {};
+            return (0, merge_1.deepMerge)(flowlint_config_1.defaultConfig, parsed);
+        }
+        catch (error) {
+            console.warn(`Failed to load config from ${configFile}: ${error}`);
+            return flowlint_config_1.defaultConfig;
+        }
+    }
+}
+exports.LocalConfigProvider = LocalConfigProvider;
+//# sourceMappingURL=local-config-provider.js.map

package/dist/providers/local-config-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-config-provider.js","sourceRoot":"","sources":["../../../../../apps/cli/src/providers/local-config-provider.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;AAEH,4CAAoB;AACpB,gDAAwB;AACxB,gDAAwB;AACxB,qEAAqF;AAErF,uDAAwD;AAExD,MAAa,mBAAmB;IAC9B,YAAoB,UAAmB;QAAnB,eAAU,GAAV,UAAU,CAAS;IAAG,CAAC;IAE3C,KAAK,CAAC,IAAI;QACR,6BAA6B;QAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,cAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,eAAe,CAAC,CAAC;QAEhF,2CAA2C;QAC3C,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/B,OAAO,+BAAa,CAAC;QACvB,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,YAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YACpD,MAAM,MAAM,GAAI,cAAI,CAAC,KAAK,CAAC,OAAO,CAA6B,IAAI,EAAE,CAAC;YACtE,OAAO,IAAA,iBAAS,EAAC,+BAAa,EAAE,MAAM,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,8BAA8B,UAAU,KAAK,KAAK,EAAE,CAAC,CAAC;YACnE,OAAO,+BAAa,CAAC;QACvB,CAAC;IACH,CAAC;CACF;AArBD,kDAqBC"}

package/dist/providers/local-file-source.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Local File Source Provider
+ * Reads workflow files from the local filesystem
+ */
+import type { FileSource, LintableFile } from 'packages/review/providers';
+export declare class LocalFileSource implements FileSource {
+    private basePath;
+    constructor(basePath: string);
+    getFiles(patterns: {
+        include: string[];
+        ignore: string[];
+    }): Promise<LintableFile[]>;
+}

package/dist/providers/local-file-source.js

@@ -0,0 +1,47 @@
+"use strict";
+/**
+ * Local File Source Provider
+ * Reads workflow files from the local filesystem
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalFileSource = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const glob_1 = require("glob");
+class LocalFileSource {
+    constructor(basePath) {
+        this.basePath = basePath;
+    }
+    async getFiles(patterns) {
+        const files = [];
+        for (const pattern of patterns.include) {
+            // Construct glob pattern relative to basePath
+            const globPattern = path_1.default.join(this.basePath, pattern);
+            const matches = (0, glob_1.globSync)(globPattern, {
+                ignore: patterns.ignore.map((ignorePattern) => path_1.default.join(this.basePath, ignorePattern)),
+                nodir: true,
+            });
+            for (const filePath of matches) {
+                try {
+                    const content = fs_1.default.readFileSync(filePath, 'utf8');
+                    const relativePath = path_1.default.relative(this.basePath, filePath);
+                    files.push({
+                        path: relativePath,
+                        content,
+                    });
+                }
+                catch (error) {
+                    console.warn(`Failed to read file ${filePath}: ${error}`);
+                }
+            }
+        }
+        // Remove duplicates (same file matched multiple patterns)
+        const uniqueFiles = Array.from(new Map(files.map((f) => [f.path, f])).values());
+        return uniqueFiles;
+    }
+}
+exports.LocalFileSource = LocalFileSource;
+//# sourceMappingURL=local-file-source.js.map

package/dist/providers/local-file-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-file-source.js","sourceRoot":"","sources":["../../../../../apps/cli/src/providers/local-file-source.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;AAEH,4CAAoB;AACpB,gDAAwB;AACxB,+BAAgC;AAGhC,MAAa,eAAe;IAC1B,YAAoB,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;IAAG,CAAC;IAExC,KAAK,CAAC,QAAQ,CAAC,QAAiD;QAC9D,MAAM,KAAK,GAAmB,EAAE,CAAC;QAEjC,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACvC,8CAA8C;YAC9C,MAAM,WAAW,GAAG,cAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAEtD,MAAM,OAAO,GAAG,IAAA,eAAQ,EAAC,WAAW,EAAE;gBACpC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,aAAa,EAAE,EAAE,CAAC,cAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;gBACvF,KAAK,EAAE,IAAI;aACZ,CAAC,CAAC;YAEH,KAAK,MAAM,QAAQ,IAAI,OAAO,EAAE,CAAC;gBAC/B,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,YAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;oBAClD,MAAM,YAAY,GAAG,cAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;oBAE5D,KAAK,CAAC,IAAI,CAAC;wBACT,IAAI,EAAE,YAAY;wBAClB,OAAO;qBACR,CAAC,CAAC;gBACL,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,IAAI,CAAC,uBAAuB,QAAQ,KAAK,KAAK,EAAE,CAAC,CAAC;gBAC5D,CAAC;YACH,CAAC;QACH,CAAC;QAED,0DAA0D;QAC1D,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAC5B,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAChD,CAAC;QAEF,OAAO,WAAW,CAAC;IACrB,CAAC;CACF;AArCD,0CAqCC"}

package/dist/reporters/console-reporter.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Console Reporter
+ * Outputs findings to the terminal with colors and formatting
+ */
+import type { AnalysisResult, Reporter } from 'packages/review/providers';
+export declare class ConsoleReporter implements Reporter {
+    report(results: AnalysisResult[]): Promise<void>;
+}

package/dist/reporters/console-reporter.js

@@ -0,0 +1,75 @@
+"use strict";
+/**
+ * Console Reporter
+ * Outputs findings to the terminal with colors and formatting
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConsoleReporter = void 0;
+const findings_1 = require('../../../../packages/review/utils/findings');
+const colors = {
+    reset: '\x1b[0m',
+    bold: '\x1b[1m',
+    red: '\x1b[31m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[36m',
+    gray: '\x1b[90m',
+};
+class ConsoleReporter {
+    async report(results) {
+        const allFindings = results.flatMap((r) => r.findings);
+        // Print header
+        console.log();
+        console.log(`${colors.blue}${colors.bold}FlowLint Analysis Report${colors.reset} ${colors.gray}${new Date().toLocaleTimeString()}${colors.reset}`);
+        console.log(colors.gray + '─'.repeat(80) + colors.reset);
+        console.log();
+        // Print findings grouped by file
+        for (const result of results) {
+            if (result.findings.length === 0 && !result.errors)
+                continue;
+            const { path } = result.file;
+            console.log(`${colors.bold}${path}${colors.reset}`);
+            const sortedFindings = (0, findings_1.sortFindingsBySeverity)(result.findings);
+            for (const finding of sortedFindings) {
+                const severityColor = finding.severity === 'must'
+                    ? colors.red
+                    : finding.severity === 'should'
+                        ? colors.yellow
+                        : colors.gray;
+                const line = finding.line ? `:${finding.line}` : '';
+                const severity = finding.severity.toUpperCase();
+                console.log(`  ${severityColor}${severity}${colors.reset} ${colors.bold}${finding.rule}${colors.reset} ${finding.message}`);
+                console.log(`       at ${colors.gray}${path}${line}${colors.reset}`);
+                if (finding.documentationUrl) {
+                    console.log(`       ${colors.blue}→ See examples: ${finding.documentationUrl}${colors.reset}`);
+                }
+                if (finding.raw_details) {
+                    const details = finding.raw_details.split('\n').slice(0, 3);
+                    for (const detail of details) {
+                        console.log(`       ${colors.gray}${detail}${colors.reset}`);
+                    }
+                }
+            }
+            console.log();
+        }
+        // Print summary
+        const summary = (0, findings_1.countFindingsBySeverity)(allFindings);
+        console.log(colors.gray + '─'.repeat(80) + colors.reset);
+        console.log();
+        if (summary.total === 0) {
+            console.log(`${colors.bold}✓ No issues found${colors.reset}`);
+        }
+        else {
+            const summaryParts = [];
+            if (summary.must > 0)
+                summaryParts.push(`${colors.red}${summary.must} must-fix${colors.reset}`);
+            if (summary.should > 0)
+                summaryParts.push(`${colors.yellow}${summary.should} should-fix${colors.reset}`);
+            if (summary.nit > 0)
+                summaryParts.push(`${colors.gray}${summary.nit} nit${colors.reset}`);
+            console.log(`${colors.bold}Found: ${summaryParts.join(', ')}${colors.reset}`);
+        }
+        console.log();
+    }
+}
+exports.ConsoleReporter = ConsoleReporter;
+//# sourceMappingURL=console-reporter.js.map

package/dist/reporters/console-reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-reporter.js","sourceRoot":"","sources":["../../../../../apps/cli/src/reporters/console-reporter.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAGH,6DAAmH;AAWnH,MAAM,MAAM,GAAe;IACzB,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,SAAS;IACf,GAAG,EAAE,UAAU;IACf,MAAM,EAAE,UAAU;IAClB,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,UAAU;CACjB,CAAC;AAEF,MAAa,eAAe;IAC1B,KAAK,CAAC,MAAM,CAAC,OAAyB;QACpC,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAEvD,eAAe;QACf,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CACT,GAAG,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,2BAA2B,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,kBAAkB,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE,CACtI,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QACzD,OAAO,CAAC,GAAG,EAAE,CAAC;QAEd,iCAAiC;QACjC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM;gBAAE,SAAS;YAE7D,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YAEpD,MAAM,cAAc,GAAG,IAAA,iCAAsB,EAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAE/D,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;gBACrC,MAAM,aAAa,GACjB,OAAO,CAAC,QAAQ,KAAK,MAAM;oBACzB,CAAC,CAAC,MAAM,CAAC,GAAG;oBACZ,CAAC,CAAC,OAAO,CAAC,QAAQ,KAAK,QAAQ;wBAC7B,CAAC,CAAC,MAAM,CAAC,MAAM;wBACf,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;gBAEpB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;gBAEhD,OAAO,CAAC,GAAG,CACT,KAAK,aAAa,GAAG,QAAQ,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,CAC/G,CAAC;gBACF,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;gBAErE,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;oBAC7B,OAAO,CAAC,GAAG,CAAC,UAAU,MAAM,CAAC,IAAI,mBAAmB,OAAO,CAAC,gBAAgB,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;gBACjG,CAAC;gBAED,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;oBACxB,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;oBAC5D,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;wBAC7B,OAAO,CAAC,GAAG,CAAC,UAAU,MAAM,CAAC,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;oBAC/D,CAAC;gBACH,CAAC;YACH,CAAC;YAED,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,CAAC;QAED,gBAAgB;QAChB,MAAM,OAAO,GAAG,IAAA,kCAAuB,EAAC,WAAW,CAAC,CAAC;QAErD,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QACzD,OAAO,CAAC,GAAG,EAAE,CAAC;QAEd,IAAI,OAAO,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,IAAI,oBAAoB,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAChE,CAAC;aAAM,CAAC;YACN,MAAM,YAAY,GAAG,EAAE,CAAC;YACxB,IAAI,OAAO,CAAC,IAAI,GAAG,CAAC;gBAAE,YAAY,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,GAAG,GAAG,OAAO,CAAC,IAAI,YAAY,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YAChG,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;gBAAE,YAAY,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,cAAc,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YACzG,IAAI,OAAO,CAAC,GAAG,GAAG,CAAC;gBAAE,YAAY,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,OAAO,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YAE1F,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,IAAI,UAAU,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAChF,CAAC;QAED,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC;CACF;AAvED,0CAuEC"}

package/dist/reporters/json-reporter.d.ts

@@ -0,0 +1,14 @@
+/**
+ * JSON Reporter
+ * Outputs findings as structured JSON
+ * Suitable for:
+ * - Integration with other tools
+ * - Uploading to Web Dashboard (future)
+ * - Programmatic processing
+ */
+import type { AnalysisResult, Reporter } from 'packages/review/providers';
+export declare class JsonReporter implements Reporter {
+    private outputFile?;
+    constructor(outputFile?: string | undefined);
+    report(results: AnalysisResult[]): Promise<void>;
+}

package/dist/reporters/json-reporter.js

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * JSON Reporter
+ * Outputs findings as structured JSON
+ * Suitable for:
+ * - Integration with other tools
+ * - Uploading to Web Dashboard (future)
+ * - Programmatic processing
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JsonReporter = void 0;
+const fs_1 = __importDefault(require("fs"));
+const findings_1 = require('../../../../packages/review/utils/findings');
+class JsonReporter {
+    constructor(outputFile) {
+        this.outputFile = outputFile;
+    }
+    async report(results) {
+        const allFindings = results.flatMap((r) => r.findings);
+        const severitySummary = (0, findings_1.countFindingsBySeverity)(allFindings);
+        const report = {
+            version: '1.0',
+            timestamp: new Date().toISOString(),
+            summary: {
+                totalFiles: results.length,
+                totalFindings: severitySummary.total,
+                findingsBySeverity: {
+                    must: severitySummary.must,
+                    should: severitySummary.should,
+                    nit: severitySummary.nit,
+                },
+            },
+            results: results.map((result) => ({
+                file: {
+                    path: result.file.path,
+                },
+                findings: result.findings,
+                errors: result.errors,
+            })),
+        };
+        const json = JSON.stringify(report, null, 2);
+        if (this.outputFile) {
+            // Write to file
+            fs_1.default.writeFileSync(this.outputFile, json, 'utf8');
+            console.log(`✓ Report written to ${this.outputFile}`);
+        }
+        else {
+            // Print to stdout
+            console.log(json);
+        }
+    }
+}
+exports.JsonReporter = JsonReporter;
+//# sourceMappingURL=json-reporter.js.map

package/dist/reporters/json-reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-reporter.js","sourceRoot":"","sources":["../../../../../apps/cli/src/reporters/json-reporter.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;;;AAEH,4CAAoB;AAEpB,6DAAyE;AAkCzE,MAAa,YAAY;IACvB,YAAoB,UAAmB;QAAnB,eAAU,GAAV,UAAU,CAAS;IAAG,CAAC;IAE3C,KAAK,CAAC,MAAM,CAAC,OAAyB;QACpC,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QACvD,MAAM,eAAe,GAAG,IAAA,kCAAuB,EAAC,WAAW,CAAC,CAAC;QAE7D,MAAM,MAAM,GAAe;YACzB,OAAO,EAAE,KAAK;YACd,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,OAAO,EAAE;gBACP,UAAU,EAAE,OAAO,CAAC,MAAM;gBAC1B,aAAa,EAAE,eAAe,CAAC,KAAK;gBACpC,kBAAkB,EAAE;oBAClB,IAAI,EAAE,eAAe,CAAC,IAAI;oBAC1B,MAAM,EAAE,eAAe,CAAC,MAAM;oBAC9B,GAAG,EAAE,eAAe,CAAC,GAAG;iBACzB;aACF;YACD,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;gBAChC,IAAI,EAAE;oBACJ,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI;iBACvB;gBACD,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,MAAM,EAAE,MAAM,CAAC,MAAM;aACtB,CAAC,CAAC;SACJ,CAAC;QAEF,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAE7C,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,gBAAgB;YAChB,YAAE,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QACxD,CAAC;aAAM,CAAC;YACN,kBAAkB;YAClB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;CACF;AAvCD,oCAuCC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flowlint",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Static analysis tool for n8n workflows - detect issues early, fix them faster",
   "license": "MIT",
   "type": "commonjs",
@@ -18,6 +18,15 @@
     "build": "tsc --project ../../tsconfig.json",
     "test": "vitest run"
   },
+  "dependencies": {
+    "commander": "^12.1.0",
+    "dotenv": "^16.4.0",
+    "glob": "^10.3.10",
+    "micromatch": "^4.0.8",
+    "pino": "^10.1.0",
+    "pino-pretty": "^13.1.2",
+    "yaml": "^2.4.0"
+  },
   "keywords": [
     "n8n",
     "workflow",