@monoes/monograph 1.1.0 → 1.2.1

package/dist/src/analysis/dependency-health.js

@@ -0,0 +1,105 @@
+/**
+ * Dependency health scoring.
+ *
+ * Produces a composite [0, 1] score by combining four sub-metrics:
+ *
+ *  1. Cycle penalty   — fraction of nodes involved in cycles (lower = worse)
+ *  2. Dead-code ratio — fraction of nodes that are unreachable / unused
+ *  3. Fan-out skew    — coefficient of variation of out-degrees (high skew = god nodes)
+ *  4. God-node concentration — max in-degree / total edges (hub dominance)
+ *
+ * Final score = 1 − weighted average of penalties.
+ * All individual penalty components are clamped to [0, 1].
+ */
+function stdDev(values) {
+    if (values.length === 0)
+        return 0;
+    const mean = values.reduce((a, b) => a + b, 0) / values.length;
+    const variance = values.reduce((a, b) => a + (b - mean) ** 2, 0) / values.length;
+    return Math.sqrt(variance);
+}
+function clamp(x) {
+    return Math.max(0, Math.min(1, x));
+}
+/**
+ * Compute a composite dependency health score for the given graph.
+ */
+export function dependencyHealth(input) {
+    const { nodes, edges, cycleCount, deadNodeCount } = input;
+    const n = nodes.length;
+    const m = edges.length;
+    if (n === 0) {
+        return {
+            score: 1,
+            details: { cyclePenalty: 0, deadCodeRatio: 0, fanSkew: 0, godNodeConcentration: 0 },
+        };
+    }
+    // 1. Cycle penalty: cycleCount is the number of nodes in cycles (from topologicalLevelSort)
+    //    Normalised by node count. Capped at 1.
+    const cyclePenalty = clamp(cycleCount / n);
+    // 2. Dead-code ratio
+    const deadCodeRatio = clamp(deadNodeCount / n);
+    // 3. Fan-out skew: coefficient of variation of out-degrees, normalised
+    const outDegree = new Map(nodes.map(id => [id, 0]));
+    for (const { sourceId } of edges) {
+        outDegree.set(sourceId, (outDegree.get(sourceId) ?? 0) + 1);
+    }
+    const outValues = [...outDegree.values()];
+    const outMean = outValues.reduce((a, b) => a + b, 0) / n;
+    const cv = outMean > 0 ? stdDev(outValues) / outMean : 0;
+    // CV > 2 → very skewed; normalise to [0,1] by clamping at 4
+    const fanSkew = clamp(cv / 4);
+    // 4. God-node concentration: max in-degree / total edges
+    const inDegree = new Map(nodes.map(id => [id, 0]));
+    for (const { targetId } of edges) {
+        inDegree.set(targetId, (inDegree.get(targetId) ?? 0) + 1);
+    }
+    // Use reduce instead of spread to avoid RangeError on graphs with 65k+ nodes
+    const maxInDeg = inDegree.size > 0
+        ? [...inDegree.values()].reduce((a, b) => Math.max(a, b), 0)
+        : 0;
+    const godNodeConcentration = m > 0 ? clamp(maxInDeg / m) : 0;
+    // Weighted composite penalty (weights sum to 1)
+    const W_CYCLE = 0.35;
+    const W_DEAD = 0.25;
+    const W_FAN = 0.20;
+    const W_GOD = 0.20;
+    const penalty = W_CYCLE * cyclePenalty +
+        W_DEAD * deadCodeRatio +
+        W_FAN * fanSkew +
+        W_GOD * godNodeConcentration;
+    const score = clamp(1 - penalty);
+    return {
+        score,
+        details: { cyclePenalty, deadCodeRatio, fanSkew, godNodeConcentration },
+    };
+}
+/**
+ * Format dependency health results as structured text for LLM consumption.
+ */
+export function formatDependencyHealth(result) {
+    const { score, details } = result;
+    const pct = (v) => `${(v * 100).toFixed(1)}%`;
+    const grade = score >= 0.9 ? 'Excellent' : score >= 0.75 ? 'Good' : score >= 0.5 ? 'Fair' : 'Poor';
+    const lines = [
+        `Dependency health score: ${pct(score)} (${grade})`,
+        `  Cycle penalty       : ${pct(details.cyclePenalty)}  (fraction of nodes in cycles; weight 35%)`,
+        `  Dead-code ratio     : ${pct(details.deadCodeRatio)}  (fraction of unreachable nodes; weight 25%)`,
+        `  Fan-out skew        : ${pct(details.fanSkew)}  (out-degree coefficient of variation / 4; weight 20%)`,
+        `  God-node density    : ${pct(details.godNodeConcentration)}  (max in-degree / total edges; weight 20%)`,
+    ];
+    const advice = [];
+    if (details.cyclePenalty > 0.1)
+        advice.push('reduce circular imports (cyclePenalty high)');
+    if (details.deadCodeRatio > 0.1)
+        advice.push('remove unreachable exports (deadCodeRatio high)');
+    if (details.fanSkew > 0.25)
+        advice.push('break up high-fan-out modules (fanSkew high)');
+    if (details.godNodeConcentration > 0.1)
+        advice.push('distribute hub dependencies (godNodeConcentration high)');
+    if (advice.length > 0) {
+        lines.push('  Recommendations: ' + advice.join('; '));
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=dependency-health.js.map

package/dist/src/analysis/dependency-health.js.map

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

package/dist/src/analysis/duplicate-exports.d.ts

@@ -0,0 +1,21 @@
+import type { MonographDb } from '../storage/db.js';
+export interface DuplicateExportLocation {
+    nodeId: string;
+    filePath: string | null;
+    startLine: number | null;
+    label: string;
+}
+export interface DuplicateExportGroup {
+    exportName: string;
+    locations: DuplicateExportLocation[];
+    count: number;
+}
+export interface DuplicateExportsResult {
+    groups: DuplicateExportGroup[];
+    totalDuplicates: number;
+    affectedFiles: number;
+}
+export declare function detectDuplicateExports(db: MonographDb): DuplicateExportsResult;
+/** Format DuplicateExportsResult as structured text with file:line hints for LLM navigation. */
+export declare function formatDuplicateExports(result: DuplicateExportsResult): string;
+//# sourceMappingURL=duplicate-exports.d.ts.map

package/dist/src/analysis/duplicate-exports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicate-exports.d.ts","sourceRoot":"","sources":["../../../src/analysis/duplicate-exports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,uBAAuB,EAAE,CAAC;IACrC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACvB;AAaD,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,WAAW,GAAG,sBAAsB,CAiD9E;AAED,gGAAgG;AAChG,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAyB7E"}

package/dist/src/analysis/duplicate-exports.js

@@ -0,0 +1,69 @@
+/** Generic names that are too common to be meaningful duplicates. */
+const GENERIC_NAMES = new Set(['default', 'index', 'module']);
+export function detectDuplicateExports(db) {
+    const rows = db.prepare(`SELECT id, name, file_path, start_line, label
+     FROM nodes
+     WHERE is_exported = 1
+       AND label IN ('Function','Class','Method','Interface','Const','TypeAlias','Enum','Variable')`).all();
+    // Group by normalized name
+    const groups = new Map();
+    for (const row of rows) {
+        const normalized = row.name.toLowerCase().trim();
+        if (GENERIC_NAMES.has(normalized))
+            continue;
+        let list = groups.get(normalized);
+        if (!list) {
+            list = [];
+            groups.set(normalized, list);
+        }
+        list.push({ nodeId: row.id, filePath: row.file_path, startLine: row.start_line ?? null, label: row.label });
+    }
+    // Filter to duplicates only (count > 1)
+    const duplicateGroups = [];
+    const affectedFileSet = new Set();
+    for (const [name, locations] of groups) {
+        if (locations.length <= 1)
+            continue;
+        duplicateGroups.push({
+            exportName: name,
+            locations,
+            count: locations.length,
+        });
+        for (const loc of locations) {
+            if (loc.filePath)
+                affectedFileSet.add(loc.filePath);
+        }
+    }
+    // Sort by count descending
+    duplicateGroups.sort((a, b) => b.count - a.count);
+    return {
+        groups: duplicateGroups,
+        totalDuplicates: duplicateGroups.length,
+        affectedFiles: affectedFileSet.size,
+    };
+}
+/** Format DuplicateExportsResult as structured text with file:line hints for LLM navigation. */
+export function formatDuplicateExports(result) {
+    if (result.totalDuplicates === 0) {
+        return 'Duplicate exports: none detected.';
+    }
+    const lines = [
+        `Duplicate exports: ${result.totalDuplicates} name(s) exported from multiple files (${result.affectedFiles} file(s) affected).`,
+        '',
+    ];
+    for (const group of result.groups) {
+        lines.push(`  ${group.exportName} (${group.count} locations):`);
+        for (const loc of group.locations) {
+            const ref = loc.filePath
+                ? loc.startLine != null
+                    ? `${loc.filePath}:${loc.startLine}`
+                    : loc.filePath
+                : '(unknown)';
+            lines.push(`    ${loc.label}  ${ref}`);
+        }
+    }
+    lines.push('');
+    lines.push('Fix: consolidate duplicate exports into a single canonical location or rename to avoid conflicts.');
+    return lines.join('\n').trimEnd();
+}
+//# sourceMappingURL=duplicate-exports.js.map

package/dist/src/analysis/duplicate-exports.js.map

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

package/dist/src/analysis/fallow-suppression.d.ts

@@ -0,0 +1,12 @@
+export type FallowIssueKind = 'unused-file' | 'unused-export' | 'unused-type' | 'private-type-leak' | 'unused-dependency' | 'unused-dev-dependency' | 'unused-enum-member' | 'unused-class-member' | 'unresolved-import' | 'unlisted-dependency' | 'duplicate-export' | 'code-duplication' | 'circular-dependency' | 'type-only-dependency' | 'test-only-dependency' | 'boundary-violation' | 'coverage-gaps' | 'feature-flag' | 'complexity' | 'stale-suppression';
+export interface FallowSuppression {
+    line: number;
+    commentLine: number;
+    kind: FallowIssueKind | null;
+}
+export declare function parseFallowIssueKind(s: string): FallowIssueKind | undefined;
+export declare function issueKindToDiscriminant(kind: FallowIssueKind): number;
+export declare function issueKindFromDiscriminant(d: number): FallowIssueKind | undefined;
+export declare function isFallowSuppression(line: number): boolean;
+export declare function isFileWideSuppression(suppression: FallowSuppression): boolean;
+//# sourceMappingURL=fallow-suppression.d.ts.map

package/dist/src/analysis/fallow-suppression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallow-suppression.d.ts","sourceRoot":"","sources":["../../../src/analysis/fallow-suppression.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GACvB,aAAa,GACb,eAAe,GACf,aAAa,GACb,mBAAmB,GACnB,mBAAmB,GACnB,uBAAuB,GACvB,oBAAoB,GACpB,qBAAqB,GACrB,mBAAmB,GACnB,qBAAqB,GACrB,kBAAkB,GAClB,kBAAkB,GAClB,qBAAqB,GACrB,sBAAsB,GACtB,sBAAsB,GACtB,oBAAoB,GACpB,eAAe,GACf,cAAc,GACd,YAAY,GACZ,mBAAmB,CAAC;AAExB,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;CAC9B;AAkDD,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAI3E;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAErE;AAED,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAGhF;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,iBAAiB,GAAG,OAAO,CAE7E"}

package/dist/src/analysis/fallow-suppression.js

@@ -0,0 +1,67 @@
+const DISCRIMINANT_MAP = {
+    'unused-file': 1,
+    'unused-export': 2,
+    'unused-type': 3,
+    'private-type-leak': 4,
+    'unused-dependency': 5,
+    'unused-dev-dependency': 6,
+    'unused-enum-member': 7,
+    'unused-class-member': 8,
+    'unresolved-import': 9,
+    'unlisted-dependency': 10,
+    'duplicate-export': 11,
+    'code-duplication': 12,
+    'circular-dependency': 13,
+    'type-only-dependency': 14,
+    'test-only-dependency': 15,
+    'boundary-violation': 16,
+    'coverage-gaps': 17,
+    'feature-flag': 18,
+    'complexity': 19,
+    'stale-suppression': 20,
+};
+const DISCRIMINANT_REVERSE = [
+    'unused-file',
+    'unused-export',
+    'unused-type',
+    'private-type-leak',
+    'unused-dependency',
+    'unused-dev-dependency',
+    'unused-enum-member',
+    'unused-class-member',
+    'unresolved-import',
+    'unlisted-dependency',
+    'duplicate-export',
+    'code-duplication',
+    'circular-dependency',
+    'type-only-dependency',
+    'test-only-dependency',
+    'boundary-violation',
+    'coverage-gaps',
+    'feature-flag',
+    'complexity',
+    'stale-suppression',
+];
+const VALID_KINDS = new Set(Object.keys(DISCRIMINANT_MAP));
+export function parseFallowIssueKind(s) {
+    if (s === 'circular-dependencies')
+        return 'circular-dependency';
+    if (VALID_KINDS.has(s))
+        return s;
+    return undefined;
+}
+export function issueKindToDiscriminant(kind) {
+    return DISCRIMINANT_MAP[kind];
+}
+export function issueKindFromDiscriminant(d) {
+    if (d <= 0 || d > 20)
+        return undefined;
+    return DISCRIMINANT_REVERSE[d - 1];
+}
+export function isFallowSuppression(line) {
+    return line === 0 || line > 0;
+}
+export function isFileWideSuppression(suppression) {
+    return suppression.line === 0;
+}
+//# sourceMappingURL=fallow-suppression.js.map

package/dist/src/analysis/fallow-suppression.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallow-suppression.js","sourceRoot":"","sources":["../../../src/analysis/fallow-suppression.ts"],"names":[],"mappings":"AA4BA,MAAM,gBAAgB,GAAoC;IACxD,aAAa,EAAE,CAAC;IAChB,eAAe,EAAE,CAAC;IAClB,aAAa,EAAE,CAAC;IAChB,mBAAmB,EAAE,CAAC;IACtB,mBAAmB,EAAE,CAAC;IACtB,uBAAuB,EAAE,CAAC;IAC1B,oBAAoB,EAAE,CAAC;IACvB,qBAAqB,EAAE,CAAC;IACxB,mBAAmB,EAAE,CAAC;IACtB,qBAAqB,EAAE,EAAE;IACzB,kBAAkB,EAAE,EAAE;IACtB,kBAAkB,EAAE,EAAE;IACtB,qBAAqB,EAAE,EAAE;IACzB,sBAAsB,EAAE,EAAE;IAC1B,sBAAsB,EAAE,EAAE;IAC1B,oBAAoB,EAAE,EAAE;IACxB,eAAe,EAAE,EAAE;IACnB,cAAc,EAAE,EAAE;IAClB,YAAY,EAAE,EAAE;IAChB,mBAAmB,EAAE,EAAE;CACxB,CAAC;AAEF,MAAM,oBAAoB,GAAsB;IAC9C,aAAa;IACb,eAAe;IACf,aAAa;IACb,mBAAmB;IACnB,mBAAmB;IACnB,uBAAuB;IACvB,oBAAoB;IACpB,qBAAqB;IACrB,mBAAmB;IACnB,qBAAqB;IACrB,kBAAkB;IAClB,kBAAkB;IAClB,qBAAqB;IACrB,sBAAsB;IACtB,sBAAsB;IACtB,oBAAoB;IACpB,eAAe;IACf,cAAc;IACd,YAAY;IACZ,mBAAmB;CACpB,CAAC;AAEF,MAAM,WAAW,GAAG,IAAI,GAAG,CAAS,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;AAEnE,MAAM,UAAU,oBAAoB,CAAC,CAAS;IAC5C,IAAI,CAAC,KAAK,uBAAuB;QAAE,OAAO,qBAAqB,CAAC;IAChE,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;QAAE,OAAO,CAAoB,CAAC;IACpD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAqB;IAC3D,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,CAAS;IACjD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,SAAS,CAAC;IACvC,OAAO,oBAAoB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,IAAI,KAAK,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,WAA8B;IAClE,OAAO,WAAW,CAAC,IAAI,KAAK,CAAC,CAAC;AAChC,CAAC"}

package/dist/src/analysis/feature-flags-config.d.ts

@@ -0,0 +1,8 @@
+export interface SdkPattern {
+    packageName: string;
+    displayName: string;
+    callPatterns: RegExp[];
+}
+export declare const KNOWN_SDK_PATTERNS: SdkPattern[];
+export declare function detectSdkFromPackageJson(deps: Record<string, string>): SdkPattern[];
+//# sourceMappingURL=feature-flags-config.d.ts.map

package/dist/src/analysis/feature-flags-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flags-config.d.ts","sourceRoot":"","sources":["../../../src/analysis/feature-flags-config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,eAAO,MAAM,kBAAkB,EAAE,UAAU,EAoC1C,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,UAAU,EAAE,CAEnF"}

package/dist/src/analysis/feature-flags-config.js

@@ -0,0 +1,41 @@
+export const KNOWN_SDK_PATTERNS = [
+    {
+        packageName: 'launchdarkly-js-client-sdk',
+        displayName: 'LaunchDarkly',
+        callPatterns: [/ldClient\.variation\s*\(/, /\.variation\s*\(/],
+    },
+    {
+        packageName: '@statsig/js-client',
+        displayName: 'Statsig',
+        callPatterns: [/\.checkGate\s*\(/, /\.getExperiment\s*\(/, /Statsig\.checkGate/],
+    },
+    {
+        packageName: 'unleash-client',
+        displayName: 'Unleash',
+        callPatterns: [/\.isEnabled\s*\(/, /unleash\.isEnabled/],
+    },
+    {
+        packageName: '@growthbook/growthbook',
+        displayName: 'GrowthBook',
+        callPatterns: [/\.isOn\s*\(/, /\.evalFeature\s*\(/, /growthbook\.isOn/],
+    },
+    {
+        packageName: 'configcat-js',
+        displayName: 'ConfigCat',
+        callPatterns: [/\.getValueAsync\s*\(/, /configcat\.getValue/],
+    },
+    {
+        packageName: 'flagsmith',
+        displayName: 'Flagsmith',
+        callPatterns: [/flagsmith\.hasFeature\s*\(/, /flagsmith\.getValue\s*\(/],
+    },
+    {
+        packageName: '@splitsoftware/splitio',
+        displayName: 'Split',
+        callPatterns: [/\.getTreatment\s*\(/, /splitClient\.getTreatment/],
+    },
+];
+export function detectSdkFromPackageJson(deps) {
+    return KNOWN_SDK_PATTERNS.filter(sdk => deps[sdk.packageName] !== undefined);
+}
+//# sourceMappingURL=feature-flags-config.js.map

package/dist/src/analysis/feature-flags-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flags-config.js","sourceRoot":"","sources":["../../../src/analysis/feature-flags-config.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,kBAAkB,GAAiB;IAC9C;QACE,WAAW,EAAE,4BAA4B;QACzC,WAAW,EAAE,cAAc;QAC3B,YAAY,EAAE,CAAC,0BAA0B,EAAE,kBAAkB,CAAC;KAC/D;IACD;QACE,WAAW,EAAE,oBAAoB;QACjC,WAAW,EAAE,SAAS;QACtB,YAAY,EAAE,CAAC,kBAAkB,EAAE,sBAAsB,EAAE,oBAAoB,CAAC;KACjF;IACD;QACE,WAAW,EAAE,gBAAgB;QAC7B,WAAW,EAAE,SAAS;QACtB,YAAY,EAAE,CAAC,kBAAkB,EAAE,oBAAoB,CAAC;KACzD;IACD;QACE,WAAW,EAAE,wBAAwB;QACrC,WAAW,EAAE,YAAY;QACzB,YAAY,EAAE,CAAC,aAAa,EAAE,oBAAoB,EAAE,kBAAkB,CAAC;KACxE;IACD;QACE,WAAW,EAAE,cAAc;QAC3B,WAAW,EAAE,WAAW;QACxB,YAAY,EAAE,CAAC,sBAAsB,EAAE,qBAAqB,CAAC;KAC9D;IACD;QACE,WAAW,EAAE,WAAW;QACxB,WAAW,EAAE,WAAW;QACxB,YAAY,EAAE,CAAC,4BAA4B,EAAE,0BAA0B,CAAC;KACzE;IACD;QACE,WAAW,EAAE,wBAAwB;QACrC,WAAW,EAAE,OAAO;QACpB,YAAY,EAAE,CAAC,qBAAqB,EAAE,2BAA2B,CAAC;KACnE;CACF,CAAC;AAEF,MAAM,UAAU,wBAAwB,CAAC,IAA4B;IACnE,OAAO,kBAAkB,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,SAAS,CAAC,CAAC;AAC/E,CAAC"}

package/dist/src/analysis/feature-flags.d.ts

@@ -0,0 +1,35 @@
+export type FlagKind = 'EnvironmentVariable' | 'SdkCall' | 'ConfigObject';
+export type FlagConfidence = 'High' | 'Medium' | 'Low';
+export interface FeatureFlag {
+    filePath: string;
+    flagName: string;
+    kind: FlagKind;
+    confidence: FlagConfidence;
+    line: number;
+    col: number;
+    sdkName?: string;
+    guardLineStart?: number;
+    guardLineEnd?: number;
+    guardedDeadExports?: string[];
+}
+export interface FlagsConfig {
+    sdkPatterns: string[];
+    envPrefixes: string[];
+}
+export declare const DEFAULT_FLAGS_CONFIG: FlagsConfig;
+export declare function analyzeFeatureFlags(rootDir: string, config?: FlagsConfig): FeatureFlag[];
+export declare function crossReferenceWithDeadCode(flags: FeatureFlag[], deadExports: Array<{
+    filePath: string;
+    name: string;
+    line: number;
+}>): FeatureFlag[];
+export interface FlagsSummary {
+    totalFlags: number;
+    byKind: Record<FlagKind, number>;
+    byConfidence: Record<FlagConfidence, number>;
+    uniqueFlagNames: number;
+    filesWithFlags: number;
+    deadCodeOverlaps: number;
+}
+export declare function summarizeFlags(flags: FeatureFlag[]): FlagsSummary;
+//# sourceMappingURL=feature-flags.d.ts.map

package/dist/src/analysis/feature-flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flags.d.ts","sourceRoot":"","sources":["../../../src/analysis/feature-flags.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,QAAQ,GAAG,qBAAqB,GAAG,SAAS,GAAG,cAAc,CAAC;AAC1E,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEvD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,cAAc,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,eAAO,MAAM,oBAAoB,EAAE,WAWlC,CAAC;AA0FF,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,WAAkC,GACzC,WAAW,EAAE,CAaf;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,WAAW,EAAE,EACpB,WAAW,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GACnE,WAAW,EAAE,CAuBf;AAeD,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IAC7C,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,YAAY,CAwBjE"}

package/dist/src/analysis/feature-flags.js

@@ -0,0 +1,190 @@
+import { readFileSync, readdirSync, statSync } from 'fs';
+import { join, extname } from 'path';
+export const DEFAULT_FLAGS_CONFIG = {
+    envPrefixes: ['FEATURE_', 'FF_', 'FLAG_', 'ENABLE_', 'DISABLE_', 'AB_', 'EXP_', 'EXPERIMENT_'],
+    sdkPatterns: [
+        'launchdarkly', 'ld-client', '@launchdarkly',
+        'statsig', '@statsig',
+        'unleash', 'unleash-client',
+        'growthbook', '@growthbook',
+        'configcat', 'config-cat',
+        'flagsmith',
+        'split-io', '@splitsoftware',
+    ],
+};
+// SDK method patterns that signal flag evaluation
+const SDK_CALL_PATTERNS = [
+    /\.variation\s*\(/,
+    /\.isEnabled\s*\(/,
+    /\.checkGate\s*\(/,
+    /\.getExperiment\s*\(/,
+    /\.isOn\s*\(/,
+    /\.getFeature\s*\(/,
+    /\.getTreatment\s*\(/,
+    /\.evaluate\s*\(/,
+    /featureIsEnabled\s*\(/,
+    /getFlag\s*\(/,
+    /flagEnabled\s*\(/,
+];
+const ENV_VAR_RE = /process\.env\.([A-Z][A-Z0-9_]+)/g;
+const CONFIG_OBJECT_RE = /(?:featureFlags?|flags?|features?)\s*[\[.]\s*['"]([A-Za-z][A-Za-z0-9_-]*)['"]|(?:isEnabled|isActive|isOn)\s*\(\s*['"]([A-Za-z][A-Za-z0-9_-]*)['"]/g;
+function isSourceFile(filePath) {
+    const ext = extname(filePath).toLowerCase();
+    return ['.ts', '.tsx', '.js', '.jsx', '.mts', '.mjs', '.cts', '.cjs'].includes(ext);
+}
+function detectFlagsInLine(line, lineNum, filePath, config) {
+    const found = [];
+    // Environment variable flags
+    let m;
+    const envRe = new RegExp(ENV_VAR_RE.source, 'g');
+    while ((m = envRe.exec(line)) !== null) {
+        const varName = m[1];
+        const isFlag = config.envPrefixes.some(p => varName.startsWith(p));
+        if (isFlag) {
+            found.push({
+                filePath, flagName: varName, kind: 'EnvironmentVariable',
+                confidence: 'High', line: lineNum, col: m.index + 1,
+            });
+        }
+    }
+    // SDK call patterns
+    for (const pattern of SDK_CALL_PATTERNS) {
+        const sdkMatch = pattern.exec(line);
+        if (sdkMatch) {
+            // Try to extract the flag name from the first string argument
+            const argMatch = line.slice(sdkMatch.index).match(/\(\s*['"]([^'"]+)['"]/);
+            if (argMatch) {
+                found.push({
+                    filePath, flagName: argMatch[1], kind: 'SdkCall',
+                    confidence: 'High', line: lineNum, col: sdkMatch.index + 1,
+                    sdkName: detectSdkName(line),
+                });
+            }
+        }
+    }
+    // Config object heuristics
+    const configRe = new RegExp(CONFIG_OBJECT_RE.source, 'g');
+    while ((m = configRe.exec(line)) !== null) {
+        const flagName = m[1] ?? m[2];
+        if (flagName) {
+            found.push({
+                filePath, flagName, kind: 'ConfigObject',
+                confidence: 'Medium', line: lineNum, col: m.index + 1,
+            });
+        }
+    }
+    return found;
+}
+function detectSdkName(line) {
+    const lower = line.toLowerCase();
+    if (lower.includes('launchdarkly') || lower.includes('ldclient'))
+        return 'LaunchDarkly';
+    if (lower.includes('statsig'))
+        return 'Statsig';
+    if (lower.includes('unleash'))
+        return 'Unleash';
+    if (lower.includes('growthbook'))
+        return 'GrowthBook';
+    if (lower.includes('configcat'))
+        return 'ConfigCat';
+    if (lower.includes('flagsmith'))
+        return 'Flagsmith';
+    if (lower.includes('split'))
+        return 'Split';
+    return 'unknown';
+}
+export function analyzeFeatureFlags(rootDir, config = DEFAULT_FLAGS_CONFIG) {
+    const flags = [];
+    walkDir(rootDir, filePath => {
+        if (!isSourceFile(filePath))
+            return;
+        let content;
+        try {
+            content = readFileSync(filePath, 'utf8');
+        }
+        catch {
+            return;
+        }
+        const lines = content.split('\n');
+        for (let i = 0; i < lines.length; i++) {
+            const detected = detectFlagsInLine(lines[i], i + 1, filePath, config);
+            flags.push(...detected);
+        }
+    });
+    return flags;
+}
+export function crossReferenceWithDeadCode(flags, deadExports) {
+    // Pregroup dead exports by filePath to avoid O(F*D) nested scan
+    const deadByFile = new Map();
+    for (const e of deadExports) {
+        let arr = deadByFile.get(e.filePath);
+        if (!arr) {
+            arr = [];
+            deadByFile.set(e.filePath, arr);
+        }
+        arr.push({ name: e.name, line: e.line });
+    }
+    return flags.map(flag => {
+        if (flag.guardLineStart == null || flag.guardLineEnd == null)
+            return flag;
+        const fileDeads = deadByFile.get(flag.filePath);
+        if (!fileDeads)
+            return flag;
+        const start = flag.guardLineStart ?? 0;
+        const end = flag.guardLineEnd ?? Infinity;
+        const guarded = fileDeads
+            .filter(e => e.line >= start && e.line <= end)
+            .map(e => e.name);
+        return guarded.length > 0 ? { ...flag, guardedDeadExports: guarded } : flag;
+    });
+}
+function walkDir(dir, fn) {
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (entry === 'node_modules' || entry === '.git' || entry === 'dist' || entry === 'build')
+            continue;
+        const full = join(dir, entry);
+        let st;
+        try {
+            st = statSync(full);
+        }
+        catch {
+            continue;
+        }
+        if (st.isDirectory())
+            walkDir(full, fn);
+        else if (st.isFile())
+            fn(full);
+    }
+}
+export function summarizeFlags(flags) {
+    // Single pass over flags instead of 7 separate filter/map passes
+    const byKind = { EnvironmentVariable: 0, SdkCall: 0, ConfigObject: 0 };
+    const byConfidence = { High: 0, Medium: 0, Low: 0 };
+    const flagNames = new Set();
+    const filePaths = new Set();
+    let deadCodeOverlaps = 0;
+    for (const f of flags) {
+        byKind[f.kind]++;
+        byConfidence[f.confidence]++;
+        flagNames.add(f.flagName);
+        filePaths.add(f.filePath);
+        if ((f.guardedDeadExports?.length ?? 0) > 0)
+            deadCodeOverlaps++;
+    }
+    return {
+        totalFlags: flags.length,
+        byKind,
+        byConfidence,
+        uniqueFlagNames: flagNames.size,
+        filesWithFlags: filePaths.size,
+        deadCodeOverlaps,
+    };
+}
+//# sourceMappingURL=feature-flags.js.map

package/dist/src/analysis/feature-flags.js.map

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

package/dist/src/analysis/file-classifier.d.ts

@@ -0,0 +1,4 @@
+export type FileType = 'CODE' | 'DOCUMENT' | 'PAPER' | 'IMAGE' | 'VIDEO';
+export declare function classifyFile(pathOrUrl: string): FileType;
+export declare function classifyContent(text: string): FileType;
+//# sourceMappingURL=file-classifier.d.ts.map

package/dist/src/analysis/file-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-classifier.d.ts","sourceRoot":"","sources":["../../../src/analysis/file-classifier.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AA0CzE,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,CAgBxD;AAmBD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAItD"}