@flagshark/core 1.3.1 → 1.5.0

package/dist/output/sarif.js

@@ -0,0 +1,104 @@
+/**
+ * SARIF v2.1.0 output for FlagShark scan results.
+ *
+ * Consumable directly by `github/codeql-action/upload-sarif` so stale flags
+ * appear in the repo's Security → Code Scanning tab — same UX as CodeQL,
+ * ESLint with SARIF output, etc.
+ *
+ * Spec: https://docs.oasis-open.org/sarif/sarif/v2.1.0/sarif-v2.1.0.html
+ */
+const RULE_DEFS = {
+    'stale-age': {
+        id: 'stale-age',
+        name: 'Stale by age',
+        shortDescription: { text: 'Flag reference older than the configured threshold' },
+        helpUri: 'https://github.com/FlagShark/flagshark#how-staleness-works',
+    },
+    'stale-low-usage': {
+        id: 'stale-low-usage',
+        name: 'Stale by usage',
+        shortDescription: { text: 'Flag appears in only one file across the repo' },
+        helpUri: 'https://github.com/FlagShark/flagshark#how-staleness-works',
+    },
+    'stale-hardcoded': {
+        id: 'stale-hardcoded',
+        name: 'Stale by hardcoded variation',
+        shortDescription: { text: 'Flag call uses a constant default — the flag may be permanently removed upstream' },
+        helpUri: 'https://github.com/FlagShark/flagshark#how-staleness-works',
+    },
+    'flagshark/missing-in-platform': {
+        id: 'flagshark/missing-in-platform',
+        name: 'Missing in platform',
+        shortDescription: { text: 'Flag is referenced in code but does not exist in the feature flag platform' },
+        helpUri: 'https://github.com/FlagShark/flagshark#how-staleness-works',
+    },
+    'flagshark/archived-in-platform': {
+        id: 'flagshark/archived-in-platform',
+        name: 'Archived in platform',
+        shortDescription: { text: 'Flag is referenced in code but has been archived in the feature flag platform' },
+        helpUri: 'https://github.com/FlagShark/flagshark#how-staleness-works',
+    },
+};
+function signalTypeToRuleId(signalType) {
+    if (signalType === 'age')
+        return 'stale-age';
+    if (signalType === 'low-usage')
+        return 'stale-low-usage';
+    if (signalType === 'missing-in-platform')
+        return 'flagshark/missing-in-platform';
+    if (signalType === 'archived-in-platform')
+        return 'flagshark/archived-in-platform';
+    return 'stale-hardcoded';
+}
+export function formatSarif(result, options) {
+    const results = result.staleFlags.map((flag) => toSarifResult(flag));
+    // Collect only the rule IDs that appear in results
+    const usedRuleIds = new Set(results.map((r) => r.ruleId));
+    const rules = [...usedRuleIds]
+        .filter((id) => id in RULE_DEFS)
+        .map((id) => RULE_DEFS[id]);
+    const envelope = {
+        $schema: 'https://json.schemastore.org/sarif-2.1.0.json',
+        version: '2.1.0',
+        runs: [
+            {
+                tool: {
+                    driver: {
+                        name: 'FlagShark',
+                        version: options.version,
+                        informationUri: 'https://github.com/FlagShark/flagshark',
+                        rules,
+                    },
+                },
+                results,
+            },
+        ],
+    };
+    return JSON.stringify(envelope, null, 2);
+}
+function toSarifResult(flag) {
+    const firstSignal = flag.signals[0];
+    const ruleId = signalTypeToRuleId(firstSignal ? firstSignal.type : '');
+    // Level is based on max severity across all signals
+    const level = flag.signals.some((s) => s.severity === 'error') ? 'error' : 'warning';
+    return {
+        ruleId,
+        level,
+        message: {
+            text: `Flag "${flag.name}" appears stale. ${flag.signals.map((s) => s.description).join('; ')}`,
+        },
+        locations: [{
+                physicalLocation: {
+                    artifactLocation: { uri: flag.filePath.replace(/^\.\//, '') },
+                    region: { startLine: flag.lineNumber },
+                },
+            }],
+        properties: {
+            flag: flag.name,
+            provider: flag.provider,
+            language: flag.language,
+            age: flag.age ?? '',
+        },
+    };
+}
+//# sourceMappingURL=sarif.js.map

package/dist/output/sarif.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sarif.js","sourceRoot":"","sources":["../../src/output/sarif.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAuBH,MAAM,SAAS,GAAsG;IACnH,WAAW,EAAE;QACX,EAAE,EAAE,WAAW;QACf,IAAI,EAAE,cAAc;QACpB,gBAAgB,EAAE,EAAE,IAAI,EAAE,oDAAoD,EAAE;QAChF,OAAO,EAAE,4DAA4D;KACtE;IACD,iBAAiB,EAAE;QACjB,EAAE,EAAE,iBAAiB;QACrB,IAAI,EAAE,gBAAgB;QACtB,gBAAgB,EAAE,EAAE,IAAI,EAAE,+CAA+C,EAAE;QAC3E,OAAO,EAAE,4DAA4D;KACtE;IACD,iBAAiB,EAAE;QACjB,EAAE,EAAE,iBAAiB;QACrB,IAAI,EAAE,8BAA8B;QACpC,gBAAgB,EAAE,EAAE,IAAI,EAAE,kFAAkF,EAAE;QAC9G,OAAO,EAAE,4DAA4D;KACtE;IACD,+BAA+B,EAAE;QAC/B,EAAE,EAAE,+BAA+B;QACnC,IAAI,EAAE,qBAAqB;QAC3B,gBAAgB,EAAE,EAAE,IAAI,EAAE,4EAA4E,EAAE;QACxG,OAAO,EAAE,4DAA4D;KACtE;IACD,gCAAgC,EAAE;QAChC,EAAE,EAAE,gCAAgC;QACpC,IAAI,EAAE,sBAAsB;QAC5B,gBAAgB,EAAE,EAAE,IAAI,EAAE,+EAA+E,EAAE;QAC3G,OAAO,EAAE,4DAA4D;KACtE;CACF,CAAA;AAED,SAAS,kBAAkB,CAAC,UAAkB;IAC5C,IAAI,UAAU,KAAK,KAAK;QAAE,OAAO,WAAW,CAAA;IAC5C,IAAI,UAAU,KAAK,WAAW;QAAE,OAAO,iBAAiB,CAAA;IACxD,IAAI,UAAU,KAAK,qBAAqB;QAAE,OAAO,+BAA+B,CAAA;IAChF,IAAI,UAAU,KAAK,sBAAsB;QAAE,OAAO,gCAAgC,CAAA;IAClF,OAAO,iBAAiB,CAAA;AAC1B,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAsB,EAAE,OAA2B;IAC7E,MAAM,OAAO,GAAkB,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAA;IAEnF,mDAAmD;IACnD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAA;IACzD,MAAM,KAAK,GAAG,CAAC,GAAG,WAAW,CAAC;SAC3B,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,SAAS,CAAC;SAC/B,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAA;IAE7B,MAAM,QAAQ,GAAG;QACf,OAAO,EAAE,+CAA+C;QACxD,OAAO,EAAE,OAAO;QAChB,IAAI,EAAE;YACJ;gBACE,IAAI,EAAE;oBACJ,MAAM,EAAE;wBACN,IAAI,EAAE,WAAW;wBACjB,OAAO,EAAE,OAAO,CAAC,OAAO;wBACxB,cAAc,EAAE,wCAAwC;wBACxD,KAAK;qBACN;iBACF;gBACD,OAAO;aACR;SACF;KACF,CAAA;IAED,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;AAC1C,CAAC;AAED,SAAS,aAAa,CAAC,IAAe;IACpC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IACnC,MAAM,MAAM,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IAEtE,oDAAoD;IACpD,MAAM,KAAK,GAAwB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAA;IAEzG,OAAO;QACL,MAAM;QACN,KAAK;QACL,OAAO,EAAE;YACP,IAAI,EAAE,SAAS,IAAI,CAAC,IAAI,oBAAoB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;SAChG;QACD,SAAS,EAAE,CAAC;gBACV,gBAAgB,EAAE;oBAChB,gBAAgB,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE;oBAC7D,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE;iBACvC;aACF,CAAC;QACF,UAAU,EAAE;YACV,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,EAAE;SACpB;KACF,CAAA;AACH,CAAC"}

package/dist/output/select.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Format-name dispatcher. Returns a unified callable that all formatters
+ * conform to, so CLI/Action callers don't switch on format name themselves.
+ */
+import type { ScanRepoResult } from '../scan-repo.js';
+export type FormatName = 'text' | 'json' | 'markdown' | 'csv' | 'sarif';
+export interface UnifiedFormatOptions {
+    /** Tool version (used by JSON + SARIF envelopes). */
+    version: string;
+    /** Scan mode label (used by markdown). */
+    scanMode: 'full' | 'changed';
+    /** Verbose flag (used by text). Default false. */
+    verbose?: boolean;
+    /** Max stale flags rendered in text/markdown. Default: 10 (text), 20 (markdown). */
+    maxDisplay?: number;
+    /** Link prefix for markdown (Action-context absolute URLs). */
+    linkPrefix?: string;
+    /** Comment marker (Action only). */
+    commentMarker?: string;
+}
+export type Formatter = (result: ScanRepoResult, options: UnifiedFormatOptions) => string;
+export declare function selectFormatter(name: FormatName): Formatter;
+//# sourceMappingURL=select.d.ts.map

package/dist/output/select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../src/output/select.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAQrD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,KAAK,GAAG,OAAO,CAAA;AAEvE,MAAM,WAAW,oBAAoB;IACnC,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAA;IACf,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,kDAAkD;IAClD,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,oBAAoB,KAAK,MAAM,CAAA;AAKzF,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAuB3D"}

package/dist/output/select.js

@@ -0,0 +1,36 @@
+/**
+ * Format-name dispatcher. Returns a unified callable that all formatters
+ * conform to, so CLI/Action callers don't switch on format name themselves.
+ */
+import { formatCsv } from './csv.js';
+import { formatJson } from './json.js';
+import { formatMarkdown } from './markdown.js';
+import { formatSarif } from './sarif.js';
+import { formatText } from './text.js';
+const TEXT_DEFAULT_MAX = 10;
+const MARKDOWN_DEFAULT_MAX = 20;
+export function selectFormatter(name) {
+    switch (name) {
+        case 'text':
+            return (result, opts) => formatText(result, {
+                verbose: opts.verbose ?? false,
+                maxDisplay: opts.maxDisplay ?? TEXT_DEFAULT_MAX,
+            });
+        case 'json':
+            return (result, opts) => formatJson(result, { version: opts.version });
+        case 'markdown':
+            return (result, opts) => formatMarkdown(result, {
+                scanMode: opts.scanMode,
+                linkPrefix: opts.linkPrefix,
+                commentMarker: opts.commentMarker,
+                maxStaleFlags: opts.maxDisplay ?? MARKDOWN_DEFAULT_MAX,
+            });
+        case 'csv':
+            return (result) => formatCsv(result);
+        case 'sarif':
+            return (result, opts) => formatSarif(result, { version: opts.version });
+        default:
+            throw new Error(`Unknown format: ${name}`);
+    }
+}
+//# sourceMappingURL=select.js.map

package/dist/output/select.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.js","sourceRoot":"","sources":["../../src/output/select.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAqBtC,MAAM,gBAAgB,GAAG,EAAE,CAAA;AAC3B,MAAM,oBAAoB,GAAG,EAAE,CAAA;AAE/B,MAAM,UAAU,eAAe,CAAC,IAAgB;IAC9C,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,MAAM;YACT,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE;gBAC1C,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,KAAK;gBAC9B,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,gBAAgB;aAChD,CAAC,CAAA;QACJ,KAAK,MAAM;YACT,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAA;QACxE,KAAK,UAAU;YACb,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE;gBAC9C,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,aAAa,EAAE,IAAI,CAAC,aAAa;gBACjC,aAAa,EAAE,IAAI,CAAC,UAAU,IAAI,oBAAoB;aACvD,CAAC,CAAA;QACJ,KAAK,KAAK;YACR,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;QACtC,KAAK,OAAO;YACV,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAA;QACzE;YACE,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAc,EAAE,CAAC,CAAA;IACxD,CAAC;AACH,CAAC"}

package/dist/output/shared.d.ts

@@ -0,0 +1,13 @@
+import type { StaleFlag } from '../staleness.js';
+/** Returns the count of unique stale flag names (de-duped across occurrences). */
+export declare function uniqueStaleCount(stale: StaleFlag[]): number;
+/** Map health score to an emoji used in markdown + SARIF + Action summary. */
+export declare function healthEmoji(score: number): string;
+/**
+ * SARIF severity level mapping based on number of staleness signals on a flag.
+ *   1 signal  → 'note'
+ *   2 signals → 'warning'
+ *   3+ signals → 'error'
+ */
+export declare function sarifLevel(signalCount: number): 'note' | 'warning' | 'error';
+//# sourceMappingURL=shared.d.ts.map

package/dist/output/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/output/shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEhD,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,CAE3D;AAED,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAI5E"}

package/dist/output/shared.js

@@ -0,0 +1,28 @@
+/** Returns the count of unique stale flag names (de-duped across occurrences). */
+export function uniqueStaleCount(stale) {
+    return new Set(stale.map((f) => f.name)).size;
+}
+/** Map health score to an emoji used in markdown + SARIF + Action summary. */
+export function healthEmoji(score) {
+    if (score >= 90)
+        return '🟢';
+    if (score >= 70)
+        return '🟡';
+    if (score >= 40)
+        return '🟠';
+    return '🔴';
+}
+/**
+ * SARIF severity level mapping based on number of staleness signals on a flag.
+ *   1 signal  → 'note'
+ *   2 signals → 'warning'
+ *   3+ signals → 'error'
+ */
+export function sarifLevel(signalCount) {
+    if (signalCount >= 3)
+        return 'error';
+    if (signalCount === 2)
+        return 'warning';
+    return 'note';
+}
+//# sourceMappingURL=shared.js.map

package/dist/output/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/output/shared.ts"],"names":[],"mappings":"AAEA,kFAAkF;AAClF,MAAM,UAAU,gBAAgB,CAAC,KAAkB;IACjD,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;AAC/C,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,IAAI,CAAA;IAC5B,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,IAAI,CAAA;IAC5B,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,IAAI,CAAA;IAC5B,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,WAAmB;IAC5C,IAAI,WAAW,IAAI,CAAC;QAAE,OAAO,OAAO,CAAA;IACpC,IAAI,WAAW,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IACvC,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/output/text.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Human-readable text output for FlagShark scan results.
+ */
+import type { ScanRepoResult } from '../scan-repo.js';
+export interface TextFormatOptions {
+    verbose: boolean;
+    /** Max stale flags to show before truncating. Default: 10. Ignored if verbose. */
+    maxDisplay: number;
+}
+export declare function formatText(result: ScanRepoResult, options: TextFormatOptions): string;
+//# sourceMappingURL=text.d.ts.map

package/dist/output/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/output/text.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAGrD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAA;IAChB,kFAAkF;IAClF,UAAU,EAAE,MAAM,CAAA;CACnB;AAmDD,wBAAgB,UAAU,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAoErF"}

package/dist/output/text.js

@@ -0,0 +1,104 @@
+/**
+ * Human-readable text output for FlagShark scan results.
+ */
+function maxSeverity(signals) {
+    return signals.some((s) => s.severity === 'error') ? 'error' : 'warning';
+}
+function severityRank(s) {
+    return s === 'error' ? 0 : 1;
+}
+/** Pad a string to a fixed width, truncating with ellipsis if necessary. */
+function pad(str, width) {
+    if (str.length > width) {
+        return str.slice(0, width - 1) + '…';
+    }
+    return str.padEnd(width);
+}
+function buildTable(flags) {
+    const cols = { flag: 16, file: 22, added: 13, signal: 28 };
+    const hBorder = (left, mid, right) => `${left}${'─'.repeat(cols.flag + 2)}${mid}${'─'.repeat(cols.file + 2)}${mid}${'─'.repeat(cols.added + 2)}${mid}${'─'.repeat(cols.signal + 2)}${right}`;
+    const lines = [];
+    lines.push(hBorder('┌', '┬', '┐'));
+    lines.push(`│ ${pad('Flag', cols.flag)} │ ${pad('File', cols.file)} │ ${pad('Added', cols.added)} │ ${pad('Signal', cols.signal)} │`);
+    lines.push(hBorder('├', '┼', '┤'));
+    for (const sf of flags) {
+        const fileRef = `${sf.filePath}:${sf.lineNumber}`;
+        const signalText = sf.signals
+            .map((s) => {
+            if (s.type === 'age')
+                return 'Age > threshold';
+            if (s.type === 'low-usage')
+                return 'Single file';
+            if (s.type === 'missing-in-platform')
+                return 'missing-in-platform';
+            if (s.type === 'archived-in-platform')
+                return 'archived-in-platform';
+            return s.description;
+        })
+            .join(', ');
+        lines.push(`│ ${pad(sf.name, cols.flag)} │ ${pad(fileRef, cols.file)} │ ${pad(sf.age ?? 'unknown', cols.added)} │ ${pad(signalText, cols.signal)} │`);
+    }
+    lines.push(hBorder('└', '┴', '┘'));
+    return lines.join('\n');
+}
+export function formatText(result, options) {
+    const lines = [];
+    lines.push(`\u{1F988} FlagShark`);
+    lines.push('');
+    const langCount = Object.keys(result.languageBreakdown).length;
+    lines.push(`Scanned ${result.filesScanned} files across ${langCount} language${langCount === 1 ? '' : 's'}`);
+    if (result.excludedCount && result.excludedCount > 0) {
+        lines.push(`(${result.excludedCount} excluded via .flagsharkignore + excludes)`);
+    }
+    if (result.totalFlags === 0) {
+        lines.push('No feature flags detected.');
+        lines.push('');
+        lines.push('Supported providers: LaunchDarkly, Unleash, Flipt, Split.io, PostHog, and more.');
+        lines.push('Run flagshark scan --help for configuration options.');
+        return lines.join('\n');
+    }
+    if (result.detectedProviders.length > 0) {
+        lines.push(`Detected providers: ${result.detectedProviders.join(', ')}`);
+    }
+    const uniqueStaleNames = new Set(result.staleFlags.map((f) => f.name));
+    const staleCount = uniqueStaleNames.size;
+    lines.push(`Found ${result.totalFlags} feature flags, ${staleCount} stale`);
+    if (staleCount > 0) {
+        lines.push('');
+        lines.push('Stale flags:');
+        const sorted = [...result.staleFlags].sort((a, b) => {
+            const sevA = severityRank(maxSeverity(a.signals));
+            const sevB = severityRank(maxSeverity(b.signals));
+            if (sevA !== sevB)
+                return sevA - sevB;
+            return 0;
+        });
+        const displayCount = options.verbose ? staleCount : Math.min(staleCount, options.maxDisplay);
+        const displayFlags = sorted.slice(0, displayCount);
+        lines.push(buildTable(displayFlags));
+        const remaining = staleCount - displayCount;
+        if (remaining > 0) {
+            lines.push('');
+            lines.push(`... and ${remaining} more (use --verbose to see all)`);
+        }
+    }
+    lines.push('');
+    if (staleCount === 0) {
+        lines.push(`Flag Health Score: ${result.healthScore}/100 ✓ All flags look healthy!`);
+    }
+    else {
+        lines.push(`Flag Health Score: ${result.healthScore}/100 (${staleCount}/${result.totalFlags} flags are stale)`);
+        lines.push('');
+        lines.push('Automate cleanup → https://flagshark.com');
+        lines.push('Open source CLI  → https://github.com/FlagShark/flagshark');
+    }
+    if (result.excludedPaths && result.excludedPaths.length > 0) {
+        lines.push('');
+        lines.push(`Excluded files (${result.excludedPaths.length}):`);
+        for (const p of result.excludedPaths) {
+            lines.push(`  ${p}`);
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=text.js.map

package/dist/output/text.js.map

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

package/dist/providers/cache.d.ts

@@ -0,0 +1,28 @@
+import type { PlatformClient, PlatformFlag } from './interface.js';
+export interface CacheOptions {
+    /** Override the cache directory. Default: XDG-spec resolution. */
+    cacheDir?: string;
+    /** Time-to-live in milliseconds. Default: 24h. */
+    ttlMs?: number;
+    /** When true, skip the cache entirely. */
+    noCache?: boolean;
+}
+interface CacheReadResult {
+    fetchedAt: Date;
+    flags: PlatformFlag[];
+}
+/**
+ * Build a stable cache key from platform name + non-secret config + token hash.
+ * The raw token is never written to disk.
+ */
+export declare function computeCacheKey(platformName: string, config: unknown, token: string): string;
+/** Returns parsed cache contents, or null on miss / corruption / TTL expiry. */
+export declare function readCache(key: string, opts?: CacheOptions): CacheReadResult | null;
+/** Writes the cache file, creating directories as needed. Silent on error. */
+export declare function writeCache(key: string, flags: PlatformFlag[], opts?: CacheOptions): void;
+/** Reads from cache if fresh; otherwise calls the client and writes the result. */
+export declare function loadPlatformFlagsCached(client: PlatformClient, cacheKey: string, opts?: CacheOptions & {
+    signal?: AbortSignal;
+}): Promise<PlatformFlag[]>;
+export {};
+//# sourceMappingURL=cache.d.ts.map

package/dist/providers/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/providers/cache.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAElE,MAAM,WAAW,YAAY;IAC3B,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,0CAA0C;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAOD,UAAU,eAAe;IACvB,SAAS,EAAE,IAAI,CAAA;IACf,KAAK,EAAE,YAAY,EAAE,CAAA;CACtB;AAWD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,MAAM,GACZ,MAAM,CAIR;AAED,gFAAgF;AAChF,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,eAAe,GAAG,IAAI,CA4BtF;AAED,8EAA8E;AAC9E,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,IAAI,GAAE,YAAiB,GAAG,IAAI,CAgB5F;AAED,mFAAmF;AACnF,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,YAAY,GAAG;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GACjD,OAAO,CAAC,YAAY,EAAE,CAAC,CAQzB"}

package/dist/providers/cache.js

@@ -0,0 +1,84 @@
+import { createHash } from 'node:crypto';
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+const DEFAULT_TTL_MS = 24 * 60 * 60 * 1000;
+function resolveCacheDir(override) {
+    if (override)
+        return override;
+    const xdg = process.env.XDG_CACHE_HOME;
+    const base = xdg && xdg.length > 0 ? xdg : join(homedir(), '.cache');
+    return join(base, 'flagshark');
+}
+/**
+ * Build a stable cache key from platform name + non-secret config + token hash.
+ * The raw token is never written to disk.
+ */
+export function computeCacheKey(platformName, config, token) {
+    const tokenHash = createHash('sha256').update(token).digest('hex').slice(0, 8);
+    const configHash = createHash('sha256').update(JSON.stringify(config)).digest('hex').slice(0, 8);
+    return `v1-${platformName}-${configHash}-${tokenHash}`;
+}
+/** Returns parsed cache contents, or null on miss / corruption / TTL expiry. */
+export function readCache(key, opts = {}) {
+    const dir = resolveCacheDir(opts.cacheDir);
+    const path = join(dir, `${key}.json`);
+    let raw;
+    try {
+        raw = readFileSync(path, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    if (typeof parsed?.fetchedAt !== 'string' || !Array.isArray(parsed.flags)) {
+        return null;
+    }
+    const fetchedAt = new Date(parsed.fetchedAt);
+    const ttl = opts.ttlMs ?? DEFAULT_TTL_MS;
+    if (Date.now() - fetchedAt.getTime() >= ttl)
+        return null;
+    const flags = parsed.flags.map((f) => ({
+        key: f.key,
+        archived: f.archived,
+        lastModified: f.lastModified ? new Date(f.lastModified) : null,
+    }));
+    return { fetchedAt, flags };
+}
+/** Writes the cache file, creating directories as needed. Silent on error. */
+export function writeCache(key, flags, opts = {}) {
+    const dir = resolveCacheDir(opts.cacheDir);
+    try {
+        mkdirSync(dir, { recursive: true });
+        const body = {
+            fetchedAt: new Date().toISOString(),
+            flags: flags.map((f) => ({
+                key: f.key,
+                archived: f.archived,
+                lastModified: f.lastModified ? f.lastModified.toISOString() : null,
+            })),
+        };
+        writeFileSync(join(dir, `${key}.json`), JSON.stringify(body));
+    }
+    catch {
+        // Cache write failure is non-fatal — data is still in memory for this run.
+    }
+}
+/** Reads from cache if fresh; otherwise calls the client and writes the result. */
+export async function loadPlatformFlagsCached(client, cacheKey, opts = {}) {
+    if (!opts.noCache) {
+        const cached = readCache(cacheKey, opts);
+        if (cached)
+            return cached.flags;
+    }
+    const flags = await client.listFlags({ signal: opts.signal });
+    writeCache(cacheKey, flags, opts);
+    return flags;
+}
+//# sourceMappingURL=cache.js.map

package/dist/providers/cache.js.map

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

package/dist/providers/cross-reference.d.ts

@@ -0,0 +1,19 @@
+import type { FeatureFlag } from '../detection/feature-flag.js';
+import type { PlatformFlag, PlatformSignal } from './interface.js';
+/**
+ * Pure function: joins detected flag keys against a platform's flag list,
+ * emits PlatformSignals for keys that are missing (error) or archived (warning).
+ *
+ * Does NOT surface platform flags with no code reference — that's a separate
+ * "orphan platform flags" feature, out of scope.
+ */
+export declare function crossReference(detectedFlags: Map<string, FeatureFlag[]>, platformFlags: PlatformFlag[], platformDisplayName: string): Map<string, PlatformSignal[]>;
+/**
+ * Merge platform signals from multiple platforms into a single per-flag map.
+ * If both LaunchDarkly and Unleash say a flag is missing, the flag's entry
+ * gets two signals (one per platform).
+ *
+ * Source arrays are cloned — subsequent mutations to source don't affect into.
+ */
+export declare function mergePlatformSignals(into: Map<string, PlatformSignal[]>, source: Map<string, PlatformSignal[]>): void;
+//# sourceMappingURL=cross-reference.d.ts.map

package/dist/providers/cross-reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-reference.d.ts","sourceRoot":"","sources":["../../src/providers/cross-reference.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAElE;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,EACzC,aAAa,EAAE,YAAY,EAAE,EAC7B,mBAAmB,EAAE,MAAM,GAC1B,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,CAsB/B;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,EACnC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,GACpC,IAAI,CASN"}

package/dist/providers/cross-reference.js

@@ -0,0 +1,48 @@
+/**
+ * Pure function: joins detected flag keys against a platform's flag list,
+ * emits PlatformSignals for keys that are missing (error) or archived (warning).
+ *
+ * Does NOT surface platform flags with no code reference — that's a separate
+ * "orphan platform flags" feature, out of scope.
+ */
+export function crossReference(detectedFlags, platformFlags, platformDisplayName) {
+    const platformByKey = new Map(platformFlags.map((f) => [f.key, f]));
+    const out = new Map();
+    for (const key of detectedFlags.keys()) {
+        const platform = platformByKey.get(key);
+        if (!platform) {
+            out.set(key, [{
+                    type: 'missing-in-platform',
+                    severity: 'error',
+                    description: `referenced in code but not found in ${platformDisplayName}`,
+                }]);
+        }
+        else if (platform.archived) {
+            out.set(key, [{
+                    type: 'archived-in-platform',
+                    severity: 'warning',
+                    description: `archived in ${platformDisplayName}`,
+                }]);
+        }
+    }
+    return out;
+}
+/**
+ * Merge platform signals from multiple platforms into a single per-flag map.
+ * If both LaunchDarkly and Unleash say a flag is missing, the flag's entry
+ * gets two signals (one per platform).
+ *
+ * Source arrays are cloned — subsequent mutations to source don't affect into.
+ */
+export function mergePlatformSignals(into, source) {
+    for (const [key, signals] of source) {
+        const existing = into.get(key);
+        if (existing) {
+            existing.push(...signals);
+        }
+        else {
+            into.set(key, [...signals]);
+        }
+    }
+}
+//# sourceMappingURL=cross-reference.js.map

package/dist/providers/cross-reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-reference.js","sourceRoot":"","sources":["../../src/providers/cross-reference.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,aAAyC,EACzC,aAA6B,EAC7B,mBAA2B;IAE3B,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;IACnE,MAAM,GAAG,GAAG,IAAI,GAAG,EAA4B,CAAA;IAE/C,KAAK,MAAM,GAAG,IAAI,aAAa,CAAC,IAAI,EAAE,EAAE,CAAC;QACvC,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACvC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;oBACZ,IAAI,EAAE,qBAAqB;oBAC3B,QAAQ,EAAE,OAAO;oBACjB,WAAW,EAAE,uCAAuC,mBAAmB,EAAE;iBAC1E,CAAC,CAAC,CAAA;QACL,CAAC;aAAM,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;YAC7B,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;oBACZ,IAAI,EAAE,sBAAsB;oBAC5B,QAAQ,EAAE,SAAS;oBACnB,WAAW,EAAE,eAAe,mBAAmB,EAAE;iBAClD,CAAC,CAAC,CAAA;QACL,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAAmC,EACnC,MAAqC;IAErC,KAAK,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,MAAM,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAC9B,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAA;QAC3B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAA;QAC7B,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/providers/index.d.ts

@@ -0,0 +1,5 @@
+export type { PlatformFlag, PlatformClient, PlatformDefinition, PlatformSignal, } from './interface.js';
+export { platformRegistry, findPlatform } from './registry.js';
+export { crossReference, mergePlatformSignals } from './cross-reference.js';
+export { computeCacheKey, readCache, writeCache, loadPlatformFlagsCached, type CacheOptions, } from './cache.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,cAAc,GACf,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC9D,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAC3E,OAAO,EACL,eAAe,EACf,SAAS,EACT,UAAU,EACV,uBAAuB,EACvB,KAAK,YAAY,GAClB,MAAM,YAAY,CAAA"}

package/dist/providers/index.js

@@ -0,0 +1,4 @@
+export { platformRegistry, findPlatform } from './registry.js';
+export { crossReference, mergePlatformSignals } from './cross-reference.js';
+export { computeCacheKey, readCache, writeCache, loadPlatformFlagsCached, } from './cache.js';
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC9D,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAC3E,OAAO,EACL,eAAe,EACf,SAAS,EACT,UAAU,EACV,uBAAuB,GAExB,MAAM,YAAY,CAAA"}

package/dist/providers/interface.d.ts

@@ -0,0 +1,37 @@
+import type { ZodType } from 'zod';
+/** A flag entry as reported by a flag-management platform's API. */
+export interface PlatformFlag {
+    key: string;
+    /** Each platform maps its concept (archived/disabled/stale) to this boolean. */
+    archived: boolean;
+    lastModified: Date | null;
+}
+/** Runtime client for a configured platform. Returned by PlatformDefinition.createClient. */
+export interface PlatformClient {
+    /** Registry key, e.g. 'launchdarkly'. */
+    name: string;
+    /** Human-readable name used in signal descriptions, e.g. 'LaunchDarkly'. */
+    displayName: string;
+    listFlags(opts?: {
+        signal?: AbortSignal;
+    }): Promise<PlatformFlag[]>;
+}
+/** Registry entry. Each platform implementation exports exactly one of these. */
+export interface PlatformDefinition<TConfig = unknown> {
+    /** YAML key under `platforms:` and registry lookup key. */
+    name: string;
+    displayName: string;
+    /** Env var read for the secret token. User can override via token_env. */
+    defaultTokenEnv: string;
+    /** Zod schema validating this platform's config block. */
+    configSchema: ZodType<TConfig>;
+    /** Factory — validated config + resolved token → runtime client. No IO until listFlags() is called. */
+    createClient: (config: TConfig, token: string) => PlatformClient;
+}
+/** Signal type emitted by crossReference(). Merged into StaleFlag.signals[] by staleness.ts. */
+export interface PlatformSignal {
+    type: 'missing-in-platform' | 'archived-in-platform';
+    severity: 'error' | 'warning';
+    description: string;
+}
+//# sourceMappingURL=interface.d.ts.map

package/dist/providers/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/providers/interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAA;AAElC,oEAAoE;AACpE,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,gFAAgF;IAChF,QAAQ,EAAE,OAAO,CAAA;IACjB,YAAY,EAAE,IAAI,GAAG,IAAI,CAAA;CAC1B;AAED,6FAA6F;AAC7F,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAA;IACZ,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;CACpE;AAED,iFAAiF;AACjF,MAAM,WAAW,kBAAkB,CAAC,OAAO,GAAG,OAAO;IACnD,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,0EAA0E;IAC1E,eAAe,EAAE,MAAM,CAAA;IACvB,0DAA0D;IAC1D,YAAY,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;IAC9B,uGAAuG;IACvG,YAAY,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,KAAK,cAAc,CAAA;CACjE;AAED,gGAAgG;AAChG,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,qBAAqB,GAAG,sBAAsB,CAAA;IACpD,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAA;IAC7B,WAAW,EAAE,MAAM,CAAA;CACpB"}

package/dist/providers/interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=interface.js.map