flagwatch 1.0.0

package/dist/scanner/glob-matcher.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.matchesGlob = matchesGlob;
+exports.matchesAnyGlob = matchesAnyGlob;
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+function globToRegex(pattern) {
+    const parts = pattern.split('/');
+    const regexParts = parts.map((part) => {
+        if (part === '**') {
+            return '.*';
+        }
+        let processed = part;
+        // Handle brace patterns first (before escaping)
+        processed = processed.replace(/\{([^}]+)\}/g, (_match, content) => {
+            const alternatives = content.split(',').map((alt) => escapeRegex(alt.trim()));
+            return `(${alternatives.join('|')})`;
+        });
+        // Replace ** wildcards
+        processed = processed.replace(/\*\*/g, 'PLACEHOLDER_DOUBLE_STAR');
+        // Replace * wildcards
+        processed = processed.replace(/\*/g, 'PLACEHOLDER_SINGLE_STAR');
+        // Escape all special characters
+        processed = escapeRegex(processed);
+        // Restore our placeholders with actual regex
+        processed = processed.replace(/PLACEHOLDER_DOUBLE_STAR/g, '.*');
+        processed = processed.replace(/PLACEHOLDER_SINGLE_STAR/g, '[^/]*');
+        // Unescape the patterns we created from braces
+        processed = processed.replace(/\\\(/g, '(').replace(/\\\)/g, ')').replace(/\\\|/g, '|');
+        return processed;
+    });
+    const regexStr = `^${regexParts.join('/')}$`;
+    return new RegExp(regexStr);
+}
+function matchesGlob(filePath, pattern) {
+    const normalizedPath = filePath.replace(/\\/g, '/');
+    const regex = globToRegex(pattern);
+    return regex.test(normalizedPath);
+}
+function matchesAnyGlob(filePath, patterns) {
+    return patterns.some((pattern) => matchesGlob(filePath, pattern));
+}
+//# sourceMappingURL=glob-matcher.js.map

package/dist/scanner/glob-matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob-matcher.js","sourceRoot":"","sources":["../../src/scanner/glob-matcher.ts"],"names":[],"mappings":";;AA0CA,kCAIC;AAED,wCAEC;AAlDD,SAAS,WAAW,CAAC,GAAW;IAC9B,OAAO,GAAG,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,WAAW,CAAC,OAAe;IAClC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACpC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,SAAS,GAAG,IAAI,CAAC;QAErB,gDAAgD;QAChD,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE;YAChE,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YACtF,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;QACvC,CAAC,CAAC,CAAC;QAEH,uBAAuB;QACvB,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,yBAAyB,CAAC,CAAC;QAElE,sBAAsB;QACtB,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,yBAAyB,CAAC,CAAC;QAEhE,gCAAgC;QAChC,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;QAEnC,6CAA6C;QAC7C,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,0BAA0B,EAAE,IAAI,CAAC,CAAC;QAChE,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,0BAA0B,EAAE,OAAO,CAAC,CAAC;QAEnE,+CAA+C;QAC/C,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAExF,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAC7C,OAAO,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC9B,CAAC;AAED,SAAgB,WAAW,CAAC,QAAgB,EAAE,OAAe;IAC3D,MAAM,cAAc,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACnC,OAAO,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AACpC,CAAC;AAED,SAAgB,cAAc,CAAC,QAAgB,EAAE,QAAkB;IACjE,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;AACpE,CAAC"}

package/dist/scanner/scan-files.d.ts

@@ -0,0 +1,2 @@
+export declare function scanFiles(rootPath: string, includePatterns: string[], excludePatterns: string[]): string[];
+//# sourceMappingURL=scan-files.d.ts.map

package/dist/scanner/scan-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-files.d.ts","sourceRoot":"","sources":["../../src/scanner/scan-files.ts"],"names":[],"mappings":"AA0DA,wBAAgB,SAAS,CACvB,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,EAAE,EACzB,eAAe,EAAE,MAAM,EAAE,GACxB,MAAM,EAAE,CAkBV"}

package/dist/scanner/scan-files.js

@@ -0,0 +1,90 @@
+"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.scanFiles = scanFiles;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const glob_matcher_1 = require("./glob-matcher");
+const errors_1 = require("../errors");
+function shouldIncludeFile(filePath, includePatterns, excludePatterns) {
+    const normalizedPath = filePath.replace(/\\/g, '/');
+    if (excludePatterns.length > 0 && (0, glob_matcher_1.matchesAnyGlob)(normalizedPath, excludePatterns)) {
+        return false;
+    }
+    if (includePatterns.length === 0) {
+        return true;
+    }
+    return (0, glob_matcher_1.matchesAnyGlob)(normalizedPath, includePatterns);
+}
+function scanDirectory(dirPath, includePatterns, excludePatterns, files) {
+    try {
+        const entries = fs.readdirSync(dirPath, { withFileTypes: true });
+        const sortedEntries = entries.sort((a, b) => {
+            return a.name.localeCompare(b.name);
+        });
+        for (const entry of sortedEntries) {
+            const fullPath = path.join(dirPath, entry.name);
+            if (entry.isDirectory()) {
+                if (shouldIncludeFile(fullPath, includePatterns, excludePatterns)) {
+                    scanDirectory(fullPath, includePatterns, excludePatterns, files);
+                }
+            }
+            else if (entry.isFile()) {
+                if (shouldIncludeFile(fullPath, includePatterns, excludePatterns)) {
+                    files.push(fullPath);
+                }
+            }
+        }
+    }
+    catch (error) {
+        throw new errors_1.FileScanError(`Failed to scan directory: ${dirPath}`, dirPath, error instanceof Error ? error : undefined);
+    }
+}
+function scanFiles(rootPath, includePatterns, excludePatterns) {
+    const files = [];
+    if (!fs.existsSync(rootPath)) {
+        throw new errors_1.FileScanError(`Root path does not exist: ${rootPath}`, rootPath);
+    }
+    const stats = fs.statSync(rootPath);
+    if (stats.isFile()) {
+        if (shouldIncludeFile(rootPath, includePatterns, excludePatterns)) {
+            files.push(rootPath);
+        }
+        return files;
+    }
+    scanDirectory(rootPath, includePatterns, excludePatterns, files);
+    return files.sort();
+}
+//# sourceMappingURL=scan-files.js.map

package/dist/scanner/scan-files.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,51 @@
+export interface FlagwatchConfig {
+    include: string[];
+    exclude: string[];
+    flagPatterns: string[];
+    envVarPrefixes: string[];
+    strict: boolean;
+}
+export interface FlagReference {
+    name: string;
+    file: string;
+    line: number;
+    column: number;
+    pattern: string;
+}
+export interface FlagDefinition {
+    name: string;
+    file: string;
+    line: number;
+    column: number;
+}
+export interface DeadConditional {
+    file: string;
+    line: number;
+    column: number;
+    condition: string;
+    alwaysTrue: boolean;
+    alwaysFalse: boolean;
+}
+export interface AnalysisResult {
+    flagsDetected: number;
+    flagsUnused: FlagDefinition[];
+    flagsMissing: FlagReference[];
+    deadConditionals: DeadConditional[];
+    allFlags: FlagReference[];
+}
+export interface CliOptions {
+    ci: boolean;
+    json: boolean;
+    config?: string;
+    ignore: string[];
+    strict: boolean;
+    verbose: boolean;
+    help: boolean;
+    version: boolean;
+}
+export interface ReporterOptions {
+    ci: boolean;
+    json: boolean;
+    verbose: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,YAAY,EAAE,aAAa,EAAE,CAAC;IAC9B,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "flagwatch",
+  "version": "1.0.0",
+  "description": "CI-first visibility into feature flags and conditional code paths",
+  "main": "dist/index.js",
+  "bin": {
+    "flagwatch": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/cli.js",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage"
+  },
+  "keywords": [
+    "feature-flags",
+    "static-analysis",
+    "ci",
+    "code-analysis",
+    "dead-code"
+  ],
+  "author": "",
+  "license": "MIT",
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.0.3",
+    "jest": "^30.2.0",
+    "ts-jest": "^29.4.6",
+    "typescript": "^5.9.3"
+  }
+}