flagwatch 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mariselvam
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,178 @@
+# Flagwatch
+
+[![npm version](https://img.shields.io/npm/v/flagwatch)](https://www.npmjs.com/package/flagwatch)
+[![License](https://img.shields.io/npm/l/flagwatch)](LICENSE)
+[![CI Status](https://img.shields.io/github/workflow/status/your-org/flagwatch/CI)](https://github.com/your-org/flagwatch/actions)
+
+> **CI-first visibility into feature flags and conditional code paths**  
+> Detect unused, missing, and misleading flags *before* they turn into dead code or risky releases.
+
+---
+
+## Quick Start
+
+```bash
+# Run analysis
+npx flagwatch
+
+# CI-friendly output
+npx flagwatch --ci
+
+# JSON output
+npx flagwatch --json
+```
+
+No installation required. Works with any Node.js project.
+
+---
+
+## What Flagwatch Does
+
+Flagwatch statically analyzes your codebase to extract feature-flag usage from conditional logic. It identifies:
+
+- **Unused flags** - Never enabled anywhere
+- **Missing flags** - Referenced but undefined
+- **Dead conditionals** - Always true or always false
+- **Flag patterns** - Environment variables, feature flags, and conditional logic
+
+**Example output:**
+
+```
+🚩 Feature Flag Summary
+
+• 11 flags detected
+• 3 flags never enabled anywhere
+• 2 flags referenced but undefined
+• 1 flag always true (dead conditional)
+
+Review recommended
+```
+
+---
+
+## Core Features
+
+- 🔍 **Static Analysis** - Detects feature flags in conditional logic
+- ❌ **Dead Code Detection** - Identifies flags that are never enabled
+- ⚠️ **Conditional Analysis** - Flags always-true / always-false conditionals
+- 🧠 **Deterministic** - Same input always produces same output
+- 🤖 **CI-First** - Designed for continuous integration workflows
+- 🔒 **Secure** - No shell execution, no network calls, no side effects
+
+---
+
+## Why Flagwatch?
+
+Modern codebases rely heavily on feature flags, environment-based conditionals, and rollout toggles. Over time, teams lose clarity on which flags are active, which are never enabled, and which conditionals are always true or false.
+
+This leads to:
+- Dead or unreachable code
+- Confusing PR reviews
+- Risky refactors
+- Silent production bugs
+
+**Flagwatch exists to make conditional logic visible, reviewable, and trustworthy.**
+
+---
+
+## Usage
+
+### Local Development
+
+```bash
+# Basic usage
+npx flagwatch
+
+# With configuration file
+npx flagwatch --config flagwatch.config.json
+
+# Ignore specific patterns
+npx flagwatch --ignore "**/test/**" --ignore "**/node_modules/**"
+```
+
+### CI Integration
+
+Flagwatch is designed to run in CI and surface conditional-risk early.
+
+```yaml
+# GitHub Actions example
+- name: Flagwatch
+  run: npx flagwatch --ci
+```
+
+See [CI Integration Guide](docs/ci-integration.md) for detailed setup instructions.
+
+---
+
+## Documentation
+
+- **[Comprehensive Guide](docs/flagwatch_readme.md)** - Full documentation and feature overview
+- **[Configuration Reference](docs/configuration.md)** - Configuration options and examples
+- **[CI Integration](docs/ci-integration.md)** - Step-by-step CI setup guides
+- **[Examples](docs/examples.md)** - Practical code examples and patterns
+
+---
+
+## Design Principles
+
+- **Visibility before enforcement** - Inform, don't block (v1)
+- **Static analysis only** - No runtime evaluation
+- **Deterministic output** - Same input → same output
+- **Zero side effects** - No file modifications, no network calls
+- **Readable over exhaustive** - Clear, actionable insights
+
+---
+
+## Operating Modes
+
+| Mode | Behavior | Exit Code |
+|------|----------|-----------|
+| Default | Report only | `0` |
+| `--ci` | CI-friendly output (no emojis) | `0` |
+| `--json` | Machine-readable output | `0` |
+
+> **Note:** Flagwatch does not block builds in v1. It informs — it does not enforce.
+
+**Exit Codes:** `0` = Success, `1` = Policy violation (future), `2` = Internal failure. See [Exit Codes](docs/flagwatch_readme.md#exit-codes) for details.
+
+---
+
+## Signals Analyzed (v1 Scope)
+
+- Feature flags in `if` / ternary conditions
+- Environment-based flags (`process.env.*`)
+- Flags that are always true / false
+- Flags referenced but never defined
+
+> No runtime evaluation. No mutation. No enforcement.
+
+---
+
+## Contributing
+
+Contributions are welcome! Please see our [Contributing Guidelines](docs/flagwatch_readme.md#contributing) for details.
+
+1. Fork the repo
+2. Create a feature branch
+3. Add tests
+4. Submit a PR
+
+---
+
+## Roadmap (Post-v1)
+
+- PR comments (GitHub Actions)
+- Optional enforcement mode
+- Config-file based flags
+- Monorepo support
+
+---
+
+## License
+
+See [LICENSE](LICENSE) file for details.
+
+---
+
+> **Remember:** Dead code is rarely intentional — it's forgotten.  
+> Flagwatch restores **clarity, intent, and confidence** to feature-flag driven codebases.

package/dist/analyzer/analyze-flags.d.ts

@@ -0,0 +1,3 @@
+import { FlagReference, FlagDefinition, AnalysisResult } from '../types';
+export declare function analyzeFlags(files: string[], references: FlagReference[], definitions: FlagDefinition[]): AnalysisResult;
+//# sourceMappingURL=analyze-flags.d.ts.map

package/dist/analyzer/analyze-flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-flags.d.ts","sourceRoot":"","sources":["../../src/analyzer/analyze-flags.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAmB,cAAc,EAAE,MAAM,UAAU,CAAC;AA+G1F,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,aAAa,EAAE,EAC3B,WAAW,EAAE,cAAc,EAAE,GAC5B,cAAc,CA4ChB"}

package/dist/analyzer/analyze-flags.js

@@ -0,0 +1,165 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyzeFlags = analyzeFlags;
+const fs = __importStar(require("fs"));
+function findUnusedFlags(definitions, references) {
+    const referencedNames = new Set(references.map((ref) => ref.name));
+    return definitions.filter((def) => !referencedNames.has(def.name));
+}
+function findMissingFlags(definitions, references) {
+    const definedNames = new Set(definitions.map((def) => def.name));
+    return references.filter((ref) => !definedNames.has(ref.name));
+}
+function detectDeadConditionals(filePath) {
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const deadConditionals = [];
+    const alwaysTruePattern = /if\s*\(\s*(true|1|"true"|'true')\s*\)/g;
+    let match;
+    while ((match = alwaysTruePattern.exec(content)) !== null) {
+        if (match.index === undefined) {
+            continue;
+        }
+        const beforeMatch = content.substring(0, match.index);
+        const lines = beforeMatch.split('\n');
+        const line = lines.length;
+        const column = lines[lines.length - 1].length + 1;
+        deadConditionals.push({
+            file: filePath,
+            line,
+            column,
+            condition: match[0],
+            alwaysTrue: true,
+            alwaysFalse: false,
+        });
+    }
+    const alwaysFalsePattern = /if\s*\(\s*(false|0|"false"|'false'|null|undefined)\s*\)/g;
+    while ((match = alwaysFalsePattern.exec(content)) !== null) {
+        if (match.index === undefined) {
+            continue;
+        }
+        const beforeMatch = content.substring(0, match.index);
+        const lines = beforeMatch.split('\n');
+        const line = lines.length;
+        const column = lines[lines.length - 1].length + 1;
+        deadConditionals.push({
+            file: filePath,
+            line,
+            column,
+            condition: match[0],
+            alwaysTrue: false,
+            alwaysFalse: true,
+        });
+    }
+    const constTruePattern = /const\s+([A-Z_][A-Z0-9_]*)\s*=\s*(true|1|"true"|'true')\s*;[\s\S]*?if\s*\(\s*\1\s*\)/g;
+    while ((match = constTruePattern.exec(content)) !== null) {
+        if (match.index === undefined || !match[1]) {
+            continue;
+        }
+        const beforeMatch = content.substring(0, match.index);
+        const lines = beforeMatch.split('\n');
+        const line = lines.length;
+        const column = lines[lines.length - 1].length + 1;
+        deadConditionals.push({
+            file: filePath,
+            line,
+            column,
+            condition: `const ${match[1]} = ${match[2]}`,
+            alwaysTrue: true,
+            alwaysFalse: false,
+        });
+    }
+    const constFalsePattern = /const\s+([A-Z_][A-Z0-9_]*)\s*=\s*(false|0|"false"|'false')\s*;[\s\S]*?if\s*\(\s*\1\s*\)/g;
+    while ((match = constFalsePattern.exec(content)) !== null) {
+        if (match.index === undefined || !match[1]) {
+            continue;
+        }
+        const beforeMatch = content.substring(0, match.index);
+        const lines = beforeMatch.split('\n');
+        const line = lines.length;
+        const column = lines[lines.length - 1].length + 1;
+        deadConditionals.push({
+            file: filePath,
+            line,
+            column,
+            condition: `const ${match[1]} = ${match[2]}`,
+            alwaysTrue: false,
+            alwaysFalse: true,
+        });
+    }
+    return deadConditionals;
+}
+function analyzeFlags(files, references, definitions) {
+    const sortedReferences = [...references].sort((a, b) => {
+        if (a.file !== b.file) {
+            return a.file.localeCompare(b.file);
+        }
+        if (a.line !== b.line) {
+            return a.line - b.line;
+        }
+        return a.column - b.column;
+    });
+    const sortedDefinitions = [...definitions].sort((a, b) => {
+        if (a.file !== b.file) {
+            return a.file.localeCompare(b.file);
+        }
+        if (a.line !== b.line) {
+            return a.line - b.line;
+        }
+        return a.column - b.column;
+    });
+    const unusedFlags = findUnusedFlags(sortedDefinitions, sortedReferences);
+    const missingFlags = findMissingFlags(sortedDefinitions, sortedReferences);
+    const allDeadConditionals = [];
+    for (const file of files) {
+        try {
+            const deadConditionals = detectDeadConditionals(file);
+            allDeadConditionals.push(...deadConditionals);
+        }
+        catch {
+            // Skip files that can't be read
+        }
+    }
+    const uniqueFlags = new Set(references.map((ref) => ref.name));
+    const flagsDetected = uniqueFlags.size;
+    return {
+        flagsDetected,
+        flagsUnused: unusedFlags,
+        flagsMissing: missingFlags,
+        deadConditionals: allDeadConditionals,
+        allFlags: sortedReferences,
+    };
+}
+//# sourceMappingURL=analyze-flags.js.map

package/dist/analyzer/analyze-flags.js.map

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

package/dist/cli/parse-args.d.ts

@@ -0,0 +1,5 @@
+import { CliOptions } from '../types';
+export declare function parseArgs(args: string[]): CliOptions;
+export declare function printHelp(): void;
+export declare function printVersion(): void;
+//# sourceMappingURL=parse-args.d.ts.map

package/dist/cli/parse-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-args.d.ts","sourceRoot":"","sources":["../../src/cli/parse-args.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAuCpD;AAED,wBAAgB,SAAS,IAAI,IAAI,CA+BhC;AAKD,wBAAgB,YAAY,IAAI,IAAI,CAKnC"}

package/dist/cli/parse-args.js

@@ -0,0 +1,122 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseArgs = parseArgs;
+exports.printHelp = printHelp;
+exports.printVersion = printVersion;
+function parseArgs(args) {
+    const options = {
+        ci: false,
+        json: false,
+        ignore: [],
+        strict: false,
+        verbose: false,
+        help: false,
+        version: false,
+    };
+    let i = 0;
+    while (i < args.length) {
+        const arg = args[i];
+        if (arg === '--ci') {
+            options.ci = true;
+        }
+        else if (arg === '--json') {
+            options.json = true;
+        }
+        else if (arg === '--config' && i + 1 < args.length) {
+            options.config = args[i + 1];
+            i++;
+        }
+        else if (arg === '--ignore' && i + 1 < args.length) {
+            options.ignore.push(args[i + 1]);
+            i++;
+        }
+        else if (arg === '--strict') {
+            options.strict = true;
+        }
+        else if (arg === '--verbose') {
+            options.verbose = true;
+        }
+        else if (arg === '--help' || arg === '-h') {
+            options.help = true;
+        }
+        else if (arg === '--version' || arg === '-v') {
+            options.version = true;
+        }
+        i++;
+    }
+    return options;
+}
+function printHelp() {
+    console.log(`
+Flagwatch - CI-first visibility into feature flags
+
+Usage:
+  npx flagwatch [options]
+
+Options:
+  --ci              CI-friendly output (no emojis, deterministic)
+  --json            Machine-readable JSON output
+  --config <path>   Path to configuration file
+  --ignore <pattern> Ignore file patterns (can be used multiple times)
+  --strict          Enable strict mode (future: exit 1 on violations)
+  --verbose         Verbose output for debugging
+  --help, -h        Show this help message
+  --version, -v     Show version number
+
+Examples:
+  npx flagwatch
+  npx flagwatch --ci
+  npx flagwatch --json > flags.json
+  npx flagwatch --config flagwatch.config.json
+  npx flagwatch --ignore "**/test/**" --ignore "**/node_modules/**"
+
+Exit Codes:
+  0  Success
+  1  Policy violation (future)
+  2  Internal failure
+
+For more information, see: https://github.com/your-org/flagwatch
+`);
+}
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+function printVersion() {
+    const packageJsonPath = path.join(__dirname, '../../package.json');
+    const packageJsonContent = fs.readFileSync(packageJsonPath, 'utf-8');
+    const packageJson = JSON.parse(packageJsonContent);
+    console.log(packageJson.version);
+}
+//# sourceMappingURL=parse-args.js.map

package/dist/cli/parse-args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-args.js","sourceRoot":"","sources":["../../src/cli/parse-args.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,8BAuCC;AAED,8BA+BC;AAKD,oCAKC;AAlFD,SAAgB,SAAS,CAAC,IAAc;IACtC,MAAM,OAAO,GAAe;QAC1B,EAAE,EAAE,KAAK;QACT,IAAI,EAAE,KAAK;QACX,MAAM,EAAE,EAAE;QACV,MAAM,EAAE,KAAK;QACb,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,KAAK;KACf,CAAC;IAEF,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEpB,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;YACnB,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC;QACpB,CAAC;aAAM,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;QACtB,CAAC;aAAM,IAAI,GAAG,KAAK,UAAU,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YACrD,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC7B,CAAC,EAAE,CAAC;QACN,CAAC;aAAM,IAAI,GAAG,KAAK,UAAU,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YACrD,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACjC,CAAC,EAAE,CAAC;QACN,CAAC;aAAM,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;YAC9B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;QACxB,CAAC;aAAM,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;YAC/B,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;QACzB,CAAC;aAAM,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YAC5C,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;QACtB,CAAC;aAAM,IAAI,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YAC/C,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;QACzB,CAAC;QAED,CAAC,EAAE,CAAC;IACN,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAgB,SAAS;IACvB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6Bb,CAAC,CAAC;AACH,CAAC;AAED,uCAAyB;AACzB,2CAA6B;AAE7B,SAAgB,YAAY;IAC1B,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;IACnE,MAAM,kBAAkB,GAAG,EAAE,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IACrE,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAwB,CAAC;IAC1E,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const parse_args_1 = require("./cli/parse-args");
+const load_config_1 = require("./config/load-config");
+const index_1 = require("./index");
+const errors_1 = require("./errors");
+const logger_1 = require("./logger");
+const EXIT_CODE_SUCCESS = 0;
+const EXIT_CODE_POLICY_VIOLATION = 1;
+const EXIT_CODE_INTERNAL_FAILURE = 2;
+function main() {
+    const args = process.argv.slice(2);
+    const options = (0, parse_args_1.parseArgs)(args);
+    if (options.help) {
+        (0, parse_args_1.printHelp)();
+        process.exit(EXIT_CODE_SUCCESS);
+    }
+    if (options.version) {
+        (0, parse_args_1.printVersion)();
+        process.exit(EXIT_CODE_SUCCESS);
+    }
+    const reporterOptions = {
+        ci: options.ci,
+        json: options.json,
+        verbose: options.verbose,
+    };
+    try {
+        const config = (0, load_config_1.loadConfig)(options.config, options.ignore);
+        const { result, exitCode } = (0, index_1.run)({
+            config,
+            reporterOptions,
+        });
+        console.log(result);
+        if (exitCode === EXIT_CODE_POLICY_VIOLATION && !config.strict) {
+            process.exit(EXIT_CODE_SUCCESS);
+        }
+        else {
+            process.exit(exitCode);
+        }
+    }
+    catch (error) {
+        const logger = (0, logger_1.createLogger)(options.verbose);
+        if (error instanceof errors_1.ConfigurationError) {
+            logger.error(`Configuration error: ${error.message}`);
+            if (error.configPath) {
+                logger.error(`Config path: ${error.configPath}`);
+            }
+            process.exit(EXIT_CODE_INTERNAL_FAILURE);
+        }
+        else if (error instanceof errors_1.InternalError) {
+            logger.error(`Internal error: ${error.message}`);
+            if (options.verbose && error.cause) {
+                logger.debug(`Cause: ${error.cause.message}`);
+            }
+            process.exit(EXIT_CODE_INTERNAL_FAILURE);
+        }
+        else {
+            logger.error(`Unexpected error: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            process.exit(EXIT_CODE_INTERNAL_FAILURE);
+        }
+    }
+}
+main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;AAEA,iDAAsE;AACtE,sDAAkD;AAClD,mCAA8B;AAE9B,qCAA6D;AAC7D,qCAAwC;AAExC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAC5B,MAAM,0BAA0B,GAAG,CAAC,CAAC;AACrC,MAAM,0BAA0B,GAAG,CAAC,CAAC;AAErC,SAAS,IAAI;IACX,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,IAAA,sBAAS,EAAC,IAAI,CAAC,CAAC;IAEhC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,IAAA,sBAAS,GAAE,CAAC;QACZ,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,IAAA,yBAAY,GAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,eAAe,GAAoB;QACvC,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAA,wBAAU,EAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAE1D,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAA,WAAG,EAAC;YAC/B,MAAM;YACN,eAAe;SAChB,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAEpB,IAAI,QAAQ,KAAK,0BAA0B,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YAC9D,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAClC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAE7C,IAAI,KAAK,YAAY,2BAAkB,EAAE,CAAC;YACxC,MAAM,CAAC,KAAK,CAAC,wBAAwB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACtD,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBACrB,MAAM,CAAC,KAAK,CAAC,gBAAgB,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;YACnD,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QAC3C,CAAC;aAAM,IAAI,KAAK,YAAY,sBAAa,EAAE,CAAC;YAC1C,MAAM,CAAC,KAAK,CAAC,mBAAmB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACjD,IAAI,OAAO,CAAC,OAAO,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBACnC,MAAM,CAAC,KAAK,CAAC,UAAU,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAChD,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,KAAK,CAAC,qBAAqB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;YAC9F,OAAO,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/config/load-config.d.ts

@@ -0,0 +1,3 @@
+import { FlagwatchConfig } from '../types';
+export declare function loadConfig(configPath?: string, cliExcludes?: string[]): FlagwatchConfig;
+//# sourceMappingURL=load-config.d.ts.map

package/dist/config/load-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-config.d.ts","sourceRoot":"","sources":["../../src/config/load-config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAyF3C,wBAAgB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,WAAW,GAAE,MAAM,EAAO,GAAG,eAAe,CA8C3F"}