@flagshark/core 1.5.0 → 2.1.0

package/dist/providers/orchestrate.d.ts

@@ -10,15 +10,47 @@ export interface OrchestratePlatformsOptions {
     /** When true, skip cache for this run. */
     noCache?: boolean;
     signal?: AbortSignal;
+    /**
+     * Staleness threshold in days. Passed through to cross-reference so it
+     * can emit `platform-too-old` for flags whose platform-side creationDate
+     * exceeds the threshold. When omitted, the platform-too-old signal is
+     * never emitted.
+     */
+    thresholdDays?: number;
     /**
      * @internal — test seam. When set, used instead of platform.listFlags().
      * Allows tests to bypass network without monkey-patching globalThis.fetch.
      */
     listFlagsOverride?: (signal?: AbortSignal) => Promise<PlatformFlag[]>;
 }
+/**
+ * Returned alongside platform signals: the names of flags excluded from
+ * staleness checks because a platform marked them permanent, indexed by
+ * the platform's displayName. Output formatters surface this directly
+ * so users see WHY a permanent flag isn't in the stale table.
+ */
+export interface OrchestrateResult {
+    signals: Map<string, PlatformSignal[]>;
+    permanentByPlatform: Record<string, string[]>;
+    /**
+     * Per-flag platform-side metadata (tags, maintainer, status). Keyed
+     * by detected flag name. Populated only for flags that matched a
+     * platform integration AND the platform exposed the data. When
+     * multiple platforms report different metadata for the same flag,
+     * the LAST platform processed wins — the typical case is one
+     * platform per project anyway.
+     */
+    metadataByFlag: Map<string, {
+        tags?: string[];
+        maintainer?: string;
+        status?: 'new' | 'active' | 'inactive' | 'launched';
+    }>;
+}
 /**
  * Runs each configured platform integration. Logs warnings on individual
- * platform failures and continues. Returns merged signals keyed by flag name.
+ * platform failures and continues. Returns merged signals keyed by flag name
+ * plus a per-platform record of flags marked permanent (suppressed from
+ * staleness; surfaced separately so users see what was excluded and why).
  */
-export declare function orchestratePlatforms(opts: OrchestratePlatformsOptions): Promise<Map<string, PlatformSignal[]>>;
+export declare function orchestratePlatforms(opts: OrchestratePlatformsOptions): Promise<OrchestrateResult>;
 //# sourceMappingURL=orchestrate.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"orchestrate.d.ts","sourceRoot":"","sources":["../../src/providers/orchestrate.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,MAAM,WAAW,2BAA2B;IAC1C,iFAAiF;IACjF,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;IACpD,4CAA4C;IAC5C,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAA;IACzC,MAAM,EAAE,UAAU,CAAA;IAClB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;CACtE;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,2BAA2B,GAChC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC,CAsCxC"}
+{"version":3,"file":"orchestrate.d.ts","sourceRoot":"","sources":["../../src/providers/orchestrate.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,MAAM,WAAW,2BAA2B;IAC1C,iFAAiF;IACjF,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;IACpD,4CAA4C;IAC5C,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAA;IACzC,MAAM,EAAE,UAAU,CAAA;IAClB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;CACtE;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,CAAA;IACtC,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IAC7C;;;;;;;OAOG;IACH,cAAc,EAAE,GAAG,CACjB,MAAM,EACN;QAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAA;KAAE,CAC9F,CAAA;CACF;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,2BAA2B,GAChC,OAAO,CAAC,iBAAiB,CAAC,CA8F5B"}

package/dist/providers/orchestrate.js

@@ -3,12 +3,17 @@ import { crossReference, mergePlatformSignals } from './cross-reference.js';
 import { computeCacheKey, loadPlatformFlagsCached } from './cache.js';
 /**
  * Runs each configured platform integration. Logs warnings on individual
- * platform failures and continues. Returns merged signals keyed by flag name.
+ * platform failures and continues. Returns merged signals keyed by flag name
+ * plus a per-platform record of flags marked permanent (suppressed from
+ * staleness; surfaced separately so users see what was excluded and why).
  */
 export async function orchestratePlatforms(opts) {
     const out = new Map();
-    if (!opts.platformsConfig)
-        return out;
+    const permanentByPlatform = {};
+    const metadataByFlag = new Map();
+    if (!opts.platformsConfig) {
+        return { signals: out, permanentByPlatform, metadataByFlag };
+    }
     for (const [name, rawConfig] of Object.entries(opts.platformsConfig)) {
         const def = findPlatform(name);
         if (!def) {
@@ -21,7 +26,13 @@ export async function orchestratePlatforms(opts) {
             continue;
         }
         const tokenEnv = rawConfig.token_env ?? def.defaultTokenEnv;
-        const token = process.env[tokenEnv];
+        // Trim whitespace before passing to the auth header. A common foot-gun:
+        // tokens copied from a UI or sourced via `.env`/`export` end up with a
+        // trailing newline or leading space, which fetch propagates verbatim
+        // into `Authorization:` and the platform rejects as 401. Trim once
+        // here so every platform's createClient sees a clean string.
+        const rawToken = process.env[tokenEnv];
+        const token = rawToken?.trim() ?? '';
         if (!token) {
             opts.logger.warn(`${def.displayName}: missing ${tokenEnv}; skipping platform integration`);
             continue;
@@ -32,13 +43,54 @@ export async function orchestratePlatforms(opts) {
             const flags = opts.listFlagsOverride
                 ? await opts.listFlagsOverride(opts.signal)
                 : await loadPlatformFlagsCached(client, cacheKey, { noCache: opts.noCache, signal: opts.signal });
-            const signals = crossReference(opts.detectedFlags, flags, def.displayName);
+            const signals = crossReference(opts.detectedFlags, flags, def.displayName, {
+                thresholdDays: opts.thresholdDays,
+            });
             mergePlatformSignals(out, signals);
+            // Track which flags this platform marked permanent so output
+            // formatters can show 'N flag(s) excluded as permanent in
+            // <Platform>: a, b, c'. Read the signals MAP we just merged in
+            // (not `signals` directly — same content, but consistent source).
+            const platformPermanent = [];
+            for (const [flagName, sigList] of signals) {
+                if (sigList.some((s) => s.type === 'platform-permanent')) {
+                    platformPermanent.push(flagName);
+                }
+            }
+            if (platformPermanent.length > 0) {
+                permanentByPlatform[def.displayName] = platformPermanent.sort();
+            }
+            // Surface platform-side metadata (tags, maintainer, activity
+            // status) for every detected flag that matched this platform.
+            // Output formatters consume this to enrich the per-row display
+            // without re-querying the platform.
+            for (const flag of flags) {
+                if (!opts.detectedFlags.has(flag.key))
+                    continue;
+                const hasMetadata = (flag.tags && flag.tags.length > 0) || flag.maintainer || flag.status;
+                if (!hasMetadata)
+                    continue;
+                metadataByFlag.set(flag.key, {
+                    tags: flag.tags && flag.tags.length > 0 ? flag.tags : undefined,
+                    maintainer: flag.maintainer,
+                    status: flag.status,
+                });
+            }
         }
         catch (err) {
-            opts.logger.warn(`${def.displayName}: ${err.message}. Continuing with code-only signals.`);
+            // 401/403 are by far the most common failure mode here and the cause
+            // is almost always confusable token shapes (SDK key vs. API access
+            // token, project-scoped token pointed at the wrong project, project
+            // KEY vs. project NAME in the YAML). Surface a hint inline so users
+            // don't have to guess.
+            const message = err.message;
+            const isAuthError = /\b(401|403|Unauthorized|Forbidden)\b/i.test(message);
+            const hint = isAuthError
+                ? ` (check token type — API access tokens, not SDK keys, and the project key matches a project the token can read)`
+                : '';
+            opts.logger.warn(`${def.displayName}: ${message}${hint}. Continuing with code-only signals.`);
         }
     }
-    return out;
+    return { signals: out, permanentByPlatform, metadataByFlag };
 }
 //# sourceMappingURL=orchestrate.js.map

package/dist/providers/orchestrate.js.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrate.js","sourceRoot":"","sources":["../../src/providers/orchestrate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAC3E,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAA;AAqBrE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAAiC;IAEjC,MAAM,GAAG,GAAG,IAAI,GAAG,EAA4B,CAAA;IAC/C,IAAI,CAAC,IAAI,CAAC,eAAe;QAAE,OAAO,GAAG,CAAA;IAErC,KAAK,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;QACrE,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;QAC9B,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,qBAAqB,IAAI,cAAc,CAAC,CAAA;YACzD,SAAQ;QACV,CAAC;QAED,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,SAAS,CAAC,SAAS,CAAC,CAAA;QACpD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gCAAgC,IAAI,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;YAClF,SAAQ;QACV,CAAC;QAED,MAAM,QAAQ,GAAI,SAAoC,CAAC,SAAS,IAAI,GAAG,CAAC,eAAe,CAAA;QACvF,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QACnC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,WAAW,aAAa,QAAQ,iCAAiC,CAAC,CAAA;YAC1F,SAAQ;QACV,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;YACnD,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;YAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,iBAAiB;gBAClC,CAAC,CAAC,MAAM,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC;gBAC3C,CAAC,CAAC,MAAM,uBAAuB,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;YACnG,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,EAAE,GAAG,CAAC,WAAW,CAAC,CAAA;YAC1E,oBAAoB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QACpC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,WAAW,KAAM,GAAa,CAAC,OAAO,sCAAsC,CAAC,CAAA;QACvG,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAA;AACZ,CAAC"}
+{"version":3,"file":"orchestrate.js","sourceRoot":"","sources":["../../src/providers/orchestrate.ts"],"names":[],"mappings":"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"}

package/dist/scan-repo.d.ts

@@ -19,8 +19,8 @@ export interface ScanRepoOptions {
      */
     cwd: string;
     /**
-     * Staleness threshold in months. A flag is considered stale if its
-     * git-blame age exceeds this value. Default: 6.
+     * Staleness threshold in days. A flag is considered stale if its
+     * git-blame age exceeds this value. Default: 30.
      */
     threshold?: number;
     /**
@@ -89,6 +89,34 @@ export interface ScanRepoResult {
     excludedCount?: number;
     /** Relative paths of excluded files. Only populated when collectExcludedPaths is true. */
     excludedPaths?: string[];
+    /**
+     * Count of files where the detector raised at least one parse error
+     * (i.e. the file was scanned but the tree-sitter/regex pass bailed). Mirrors
+     * `RepositoryAnalysisResult.parseErrorCount` and is exposed here so output
+     * formatters (text, json, markdown) can tell the user up front when a
+     * non-trivial slice of their code couldn't be analysed. Optional for
+     * backward compatibility with test fixtures and external callers that
+     * construct ScanRepoResult by hand; treat absent as `0`.
+     */
+    parseErrorCount?: number;
+    /**
+     * Flag names that were detected in code AND found in a platform but
+     * marked as permanent (LD's `temporary: false`, or equivalent on other
+     * platforms). These are filtered out of `staleFlags` because they're
+     * intentionally long-lived; surfacing them here lets output formatters
+     * show users WHY a flag they expected to see in the table isn't there.
+     * Empty array (not undefined) when no platforms are configured or no
+     * matches were permanent. Per-platform breakdown lives in the
+     * `permanentByPlatform` field below.
+     */
+    excludedPermanent?: string[];
+    /**
+     * Per-platform breakdown of `excludedPermanent`. Keyed by the
+     * platform's displayName (e.g. 'LaunchDarkly'). Lets the output
+     * formatter print 'X flags excluded as permanent in LaunchDarkly'
+     * (not just 'in some platform somewhere').
+     */
+    permanentByPlatform?: Record<string, string[]>;
     /** Diagnostic — populated only when logger.debug level is active or callers explicitly opt in. */
     effectiveExcludes?: EffectiveRules;
 }

package/dist/scan-repo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scan-repo.d.ts","sourceRoot":"","sources":["../src/scan-repo.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;IACnC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;IAClC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;IAClC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;CACpC;AAED,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAA;IAEX;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAA;IAEpB;;OAEG;IACH,MAAM,CAAC,EAAE,UAAU,CAAA;IAEnB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,OAAO,GAAG,aAAa,CAAA;IAEhC;;;OAGG;IACH,MAAM,CAAC,EAAE,eAAe,CAAA;IAExB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAElB;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IAEtB;;OAEG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAE9B,qDAAqD;IACrD,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,UAAU,EAAE,MAAM,CAAA;IAElB,yDAAyD;IACzD,YAAY,EAAE,MAAM,CAAA;IAEpB;;;;OAIG;IACH,UAAU,EAAE,SAAS,EAAE,CAAA;IAEvB;;;OAGG;IACH,iBAAiB,EAAE,MAAM,EAAE,CAAA;IAE3B,0EAA0E;IAC1E,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAEzC;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAA;IAEnB,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAA;IAEpB,uFAAuF;IACvF,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB,0FAA0F;IAC1F,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IAExB,kGAAkG;IAClG,iBAAiB,CAAC,EAAE,cAAc,CAAA;CACnC;AAUD,wBAAsB,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAmF7E"}
+{"version":3,"file":"scan-repo.d.ts","sourceRoot":"","sources":["../src/scan-repo.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgBH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;IACnC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;IAClC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;IAClC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;CACpC;AAED,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAA;IAEX;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAA;IAEpB;;OAEG;IACH,MAAM,CAAC,EAAE,UAAU,CAAA;IAEnB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,OAAO,GAAG,aAAa,CAAA;IAEhC;;;OAGG;IACH,MAAM,CAAC,EAAE,eAAe,CAAA;IAExB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAElB;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IAEtB;;OAEG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAE9B,qDAAqD;IACrD,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,UAAU,EAAE,MAAM,CAAA;IAElB,yDAAyD;IACzD,YAAY,EAAE,MAAM,CAAA;IAEpB;;;;OAIG;IACH,UAAU,EAAE,SAAS,EAAE,CAAA;IAEvB;;;OAGG;IACH,iBAAiB,EAAE,MAAM,EAAE,CAAA;IAE3B,0EAA0E;IAC1E,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAEzC;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAA;IAEnB,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAA;IAEpB,uFAAuF;IACvF,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB,0FAA0F;IAC1F,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IAExB;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IAExB;;;;;;;;;OASG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;IAE5B;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IAE9C,kGAAkG;IAClG,iBAAiB,CAAC,EAAE,cAAc,CAAA;CACnC;AAUD,wBAAsB,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAkK7E"}

package/dist/scan-repo.js

@@ -4,6 +4,8 @@
  */
 import { collectFiles } from './scanner.js';
 import { createDefaultRegistry, createRegistryWithEngine } from './detection/index.js';
+import { buildImportGraph, isScannedSourceFile, loadTsconfigAliases } from './detection/import-graph.js';
+import { Languages, getImportPattern } from './detection/interface.js';
 import { PolyglotAnalyzer } from './detection/polyglot-analyzer.js';
 import { analyzeStaleness } from './staleness.js';
 import { buildDefaultConfig } from './config/defaults.js';
@@ -47,15 +49,55 @@ export async function scanRepo(opts) {
     });
     logger.debug(`Detected ${files.size} candidate files (excluded ${excludedCount})`);
     const filesScanned = files.size;
-    const analysisResult = await analyzer.analyzeFiles(files, opts.signal);
-    const platformSignals = await orchestratePlatforms({
+    // Wrapper-aware detection: build the TS/JS import graph and "lift" the SDK
+    // gate for any file that transitively reaches a known SDK through 1-N hops
+    // of relative imports. We do this by appending a single-line comment to
+    // the file content that mentions every reachable SDK pattern; the per-
+    // provider import gate (a substring check in helpers.ts / engine.ts) then
+    // passes for wrapper-consumer files. Appending to the END of content keeps
+    // every flag's line number correct.
+    //
+    // Direct importers already pass the gate, so the appended marker is a
+    // no-op for them. Files with no SDK reach are untouched.
+    //
+    // Why scan-repo.ts and not PolyglotAnalyzer: PolyglotAnalyzer is a generic
+    // multi-language coordinator. The graph is TS/JS-only and SDK-aware; that
+    // knowledge lives at the orchestrator layer where we also know the registry.
+    const tsJsSdkPatterns = collectSdkPatterns(registry);
+    const filesForAnalysis = augmentForWrapperDetection(files, tsJsSdkPatterns, logger, opts.cwd);
+    const analysisResult = await analyzer.analyzeFiles(filesForAnalysis, opts.signal);
+    // B3: user-configured custom detectors (struct-field-access only today).
+    // Layered on top of the standard detection so it never reduces recall,
+    // only adds matches — typically for codebases whose flag system bypasses
+    // the SDK model entirely (e.g. Mattermost's typed Config().FeatureFlags.X).
+    // Detected flags are tagged confidence: 'low' so cleanup pipelines route
+    // them to manual review rather than auto-merge.
+    if (config.custom_detectors && config.custom_detectors.length > 0) {
+        applyCustomDetectors(files, config.custom_detectors, analysisResult.totalFlags, logger);
+    }
+    const { signals: platformSignals, permanentByPlatform, metadataByFlag, } = await orchestratePlatforms({
         platformsConfig: config.platforms,
         detectedFlags: analysisResult.totalFlags,
         logger,
         noCache: opts.noCache,
         signal: opts.signal,
+        // Threshold drives the platform-too-old signal in cross-reference.
+        // Same threshold the staleness engine uses for code-age, so the two
+        // dimensions stay aligned ("if code older than N is stale, so is a
+        // platform record older than N").
+        thresholdDays: threshold,
+    });
+    const staleFlags = await analyzeStaleness(analysisResult.totalFlags, {
+        thresholdDays: threshold,
+        repoRoot: opts.cwd,
+        platformSignals,
+        platformMetadata: metadataByFlag,
     });
-    const staleFlags = await analyzeStaleness(analysisResult.totalFlags, { thresholdMonths: threshold, repoRoot: opts.cwd, platformSignals });
+    // Flatten the per-platform breakdown into a single sorted, deduplicated
+    // list so callers that only want "did anything get excluded?" don't
+    // have to walk the platform record themselves. The per-platform record
+    // is retained for output formatters that want to attribute correctly.
+    const excludedPermanent = Array.from(new Set(Object.values(permanentByPlatform).flat())).sort();
     const totalFlags = analysisResult.totalFlags.size;
     const uniqueStaleNames = new Set(staleFlags.map((f) => f.name)).size;
     const healthScore = totalFlags === 0 ? 100 : Math.round(((totalFlags - uniqueStaleNames) / totalFlags) * 100);
@@ -68,6 +110,30 @@ export async function scanRepo(opts) {
             .map((f) => f.provider)
             .filter((p) => p != null && p !== '')),
     ];
+    const scanDuration = Math.round(performance.now() - start);
+    // Structured metric line — one per scan, info-level. Same shape as the
+    // SaaS-side piranha_metric events so a single dashboard can join them.
+    // CloudWatch Logs Insights query: `filter event="flagshark_scan_complete"`.
+    // Off by default at debug-only loggers (e.g. the no-op logger used in
+    // tests); info-level loggers (CLI, Action) surface them.
+    logger.info('flagshark_scan_complete', {
+        event: 'flagshark_scan_complete',
+        durationMs: scanDuration,
+        filesScanned,
+        // Defensive ?? 0 fallbacks: collectFiles always returns excludedCount as
+        // a number and PolyglotAnalyzer always populates parseErrorCount, so the
+        // RHS of these expressions is unreachable today — kept for type safety
+        // against future refactors.
+        /* v8 ignore next 2 */
+        excludedCount: excludedCount ?? 0,
+        parseErrorCount: analysisResult.parseErrorCount ?? 0,
+        totalFlags,
+        staleFlags: uniqueStaleNames,
+        healthScore,
+        detectedProviders: detectedProviders.length,
+        languages: Object.keys(analysisResult.languages).length,
+        detectionEngine: opts.engine ?? 'regex',
+    });
     return {
         totalFlags,
         filesScanned,
@@ -76,10 +142,230 @@ export async function scanRepo(opts) {
         // analysisResult.languages is Map<Language, number> — convert to plain object
         languageBreakdown: Object.fromEntries(analysisResult.languages),
         healthScore,
-        scanDuration: Math.round(performance.now() - start),
+        scanDuration,
         excludedCount,
         excludedPaths,
+        parseErrorCount: analysisResult.parseErrorCount,
+        excludedPermanent,
+        permanentByPlatform,
         effectiveExcludes: excluder.effectiveRules,
     };
 }
+// -- Wrapper-aware detection helpers ------------------------------------------
+/**
+ * Pulls every `importPattern` string registered on the language detectors
+ * the import graph supports today (TS/JS + Python). These are the seed
+ * packages for the graph — a file is "in SDK scope" iff its imports reach
+ * one of these via 1-N hops of relative imports.
+ *
+ * We pull TS/JS and Python together because the seed list is matched
+ * substring-style on each spec and both languages share the same matching
+ * surface inside the graph. Python-only seeds (`posthog`, `ldclient`) and
+ * TS-only seeds (`@launchdarkly/node-server-sdk`) never collide because
+ * their syntactic shapes are different.
+ */
+function collectSdkPatterns(registry) {
+    const patterns = new Set();
+    for (const lang of [Languages.TypeScript, Languages.JavaScript, Languages.Python]) {
+        const detector = registry.getDetector(lang);
+        // Defensive skip: the default registry always populates TS/JS/Python
+        // detectors. Custom engines could theoretically omit one, hence the guard.
+        /* v8 ignore next */
+        if (!detector)
+            continue;
+        for (const provider of detector.getProviders()) {
+            const pat = getImportPattern(provider);
+            if (pat)
+                patterns.add(pat);
+        }
+    }
+    return [...patterns];
+}
+/**
+ * Marker comment appended to TS/JS files that transitively reach an SDK. The
+ * existing per-provider import gate is a `content.includes(importPat)` check;
+ * mentioning the SDK pattern in this comment satisfies the gate without
+ * touching the detector interface or shifting any line numbers (the marker
+ * goes at end-of-file, after the last line of real code).
+ *
+ * The marker text is recognisable so an operator inspecting an instrumented
+ * file or a debug log can tell the difference between a real import and our
+ * post-hoc marker.
+ */
+const WRAPPER_MARKER_PREFIX = '// flagshark-internal: transitively reaches';
+/**
+ * Same marker semantics but in Python comment syntax (`#`). When wrapper
+ * augmentation extended to .py files (B4), appending a `//` line would
+ * make the file unparseable — Python doesn't have `//` comments. The
+ * detector's import-gate is a substring `content.includes(importPat)`
+ * check that doesn't care WHICH comment syntax wraps the SDK pattern,
+ * so language-appropriate markers work transparently.
+ */
+const WRAPPER_MARKER_PREFIX_PYTHON = '# flagshark-internal: transitively reaches';
+/**
+ * Returns a new Map<filePath, content> where TS/JS files with transitive SDK
+ * reach have a single comment line appended that mentions each reachable SDK
+ * pattern. Returns the original Map unchanged if no SDK seeds exist (e.g.
+ * registry was constructed without TS/JS detectors).
+ *
+ * Non-TS/JS files are passed through untouched.
+ */
+function augmentForWrapperDetection(files, tsJsSdkPatterns, logger, cwd) {
+    // Defensive early-return: every default registry contributes at least
+    // one SDK pattern, so this branch only fires for hand-built empty
+    // registries — not reachable from public scan paths.
+    /* v8 ignore next */
+    if (tsJsSdkPatterns.length === 0)
+        return files;
+    // Load tsconfig path aliases from the scan root, then pass them to the
+    // graph builder. Most TS monorepos use `@/foo`-style aliases; without
+    // this, the transitive wrapper detection stops at every aliased
+    // boundary and under-counts. Falls back gracefully — `loadTsconfigAliases`
+    // returns null when there's no tsconfig or no aliases declared, in which
+    // case the graph behaves exactly as before.
+    const aliases = loadTsconfigAliases(cwd);
+    if (aliases) {
+        logger.debug('tsconfig path aliases loaded', {
+            baseUrl: aliases.baseUrl,
+            aliasCount: aliases.paths.size,
+        });
+    }
+    const graph = buildImportGraph(files, {
+        seedSdkPatterns: tsJsSdkPatterns,
+        // Polyglot scope — graph now walks TS/JS *and* Python wrappers so a
+        // Python consumer file that does `from .feature_flags import is_enabled`
+        // (where feature_flags.py imports `posthog`) is in scope. The option
+        // name is legacy from when TS/JS was the only surface; the helper
+        // returns true for .py files too. See B4 in the bug inventory.
+        isTsJs: isScannedSourceFile,
+        aliases: aliases ?? undefined,
+    });
+    logger.debug('Import graph built', graph.stats);
+    // No transitive reach (seeds didn't propagate beyond themselves, or no seeds
+    // at all) -> return the original map. Avoids a wasted clone on repos that
+    // don't use any flag SDK.
+    if (graph.stats.inScopeFiles === 0) {
+        return files;
+    }
+    const augmented = new Map();
+    let augmentedCount = 0;
+    for (const [filePath, content] of files) {
+        const sdks = graph.transitiveSdks.get(filePath);
+        if (!sdks || sdks.size === 0) {
+            augmented.set(filePath, content);
+            continue;
+        }
+        // Append at end-of-file with a leading newline so we never glue onto a
+        // partial last line. Sorting the SDK list keeps the marker deterministic
+        // across runs (useful when diffing logs). Use Python comment syntax for
+        // .py files; the substring-based import gate doesn't care which prefix
+        // wraps the SDK pattern, so language-appropriate markers stay parseable.
+        const sdkList = [...sdks].sort().join(' ');
+        const prefix = filePath.toLowerCase().endsWith('.py')
+            ? WRAPPER_MARKER_PREFIX_PYTHON
+            : WRAPPER_MARKER_PREFIX;
+        augmented.set(filePath, `${content}\n${prefix} ${sdkList}\n`);
+        augmentedCount++;
+    }
+    logger.debug(`Wrapper-aware detection augmented ${augmentedCount} files`);
+    return augmented;
+}
+// -- Custom detector application (B3) -----------------------------------------
+/**
+ * File extensions per language, for routing custom detectors to the right
+ * files. Kept in sync with the language detector registry; we duplicate
+ * the table here rather than pulling from the registry because the
+ * registry is awareness-of-detector, not awareness-of-extensions, and
+ * the registry's API is method-call-shaped (asks "do you support this
+ * file" per detector) rather than data-shaped.
+ */
+const LANGUAGE_EXTENSIONS = {
+    go: ['.go'],
+    python: ['.py', '.pyx', '.pyi'],
+    typescript: ['.ts', '.tsx'],
+    javascript: ['.js', '.jsx', '.mjs', '.cjs'],
+    java: ['.java'],
+    kotlin: ['.kt', '.kts'],
+    swift: ['.swift'],
+    ruby: ['.rb'],
+    csharp: ['.cs'],
+    php: ['.php'],
+    rust: ['.rs'],
+    cpp: ['.c', '.cc', '.cpp', '.h', '.hpp'],
+    objc: ['.m', '.mm'],
+};
+/**
+ * Runs each configured custom detector over the appropriate file subset
+ * and adds matches to `totalFlags`. Mutates the map in place — same shape
+ * as the polyglot analyzer's output, so downstream staleness + JSON
+ * surfacing pick the new flags up without further wiring.
+ *
+ * Each match becomes a FeatureFlag with `confidence: 'low'` to signal
+ * that the detection came from a user-declared regex rather than a
+ * disciplined SDK gate. The legacy `'high'`/`'medium'` flags from the
+ * standard detector are left untouched.
+ */
+function applyCustomDetectors(files, detectors, totalFlags, logger) {
+    for (const detector of detectors) {
+        let regex;
+        try {
+            regex = new RegExp(detector.access_pattern, 'g');
+        }
+        catch (err) {
+            logger.warn(`custom_detector regex failed to compile`, {
+                access_pattern: detector.access_pattern,
+                /* v8 ignore next */
+                error: err instanceof Error ? err.message : String(err),
+            });
+            continue;
+        }
+        const allowedExts = LANGUAGE_EXTENSIONS[detector.language] ?? [];
+        if (allowedExts.length === 0) {
+            logger.warn(`custom_detector skipped — unknown language`, {
+                language: detector.language,
+            });
+            continue;
+        }
+        const providerName = detector.name ?? 'Custom struct-field detector';
+        let matchCount = 0;
+        for (const [filePath, content] of files) {
+            const lower = filePath.toLowerCase();
+            if (!allowedExts.some((ext) => lower.endsWith(ext)))
+                continue;
+            // Walk every match in the file. Each must capture exactly one
+            // group (the flag name) — schemas validated at load time, but we
+            // defensively skip captureless matches at runtime too.
+            regex.lastIndex = 0;
+            let m;
+            while ((m = regex.exec(content)) !== null) {
+                const flagName = m[1];
+                /* v8 ignore next */
+                if (!flagName)
+                    continue;
+                // Resolve line number from the match offset. Cheap: count
+                // newlines up to the match. Files are typically <10k lines so
+                // O(n) per match is fine.
+                const lineNumber = content.slice(0, m.index).split('\n').length;
+                const existing = totalFlags.get(flagName) ?? [];
+                existing.push({
+                    name: flagName,
+                    filePath,
+                    lineNumber,
+                    language: detector.language,
+                    provider: providerName,
+                    confidence: 'low',
+                });
+                totalFlags.set(flagName, existing);
+                matchCount++;
+            }
+        }
+        if (matchCount > 0) {
+            logger.debug(`custom_detector matched`, {
+                language: detector.language,
+                matchCount,
+                provider: providerName,
+            });
+        }
+    }
+}
 //# sourceMappingURL=scan-repo.js.map

package/dist/scan-repo.js.map

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

package/dist/staleness.d.ts

@@ -1,6 +1,6 @@
 import { type FeatureFlag } from './detection/feature-flag.js';
 export interface StalenessSignal {
-    type: 'age' | 'hardcoded' | 'low-usage' | 'missing-in-platform' | 'archived-in-platform';
+    type: 'age' | 'hardcoded' | 'low-usage' | 'missing-in-platform' | 'archived-in-platform' | 'platform-too-old' | 'platform-inactive' | 'platform-launched';
     severity: 'error' | 'warning';
     description: string;
 }
@@ -13,14 +13,44 @@ export interface StaleFlag {
     signals: StalenessSignal[];
     /** Human-readable age, e.g. "14 months ago" */
     age?: string;
+    /**
+     * Detection-quality tier inherited from the underlying FeatureFlag.
+     * See FlagConfidence in detection/feature-flag.ts for what the values
+     * mean. Absent = `'high'`. Surfaced here so consumers of the stale-flag
+     * list (the JSON output, the GitHub Action's PR comment) can route
+     * medium-confidence flags to manual review rather than auto-cleanup.
+     */
+    confidence?: 'high' | 'medium' | 'low';
+    /**
+     * Platform-side metadata propagated through from the cross-reference
+     * layer. Populated only when a platform integration is active AND the
+     * platform exposed the data. Output formatters surface these
+     * alongside each flag so reviewers see who owns it and how the
+     * platform classifies it without a context switch.
+     */
+    tags?: string[];
+    maintainer?: string;
+    /** LD's per-environment activity verdict; see PlatformFlag.status. */
+    platformStatus?: 'new' | 'active' | 'inactive' | 'launched';
 }
 export interface StalenessOptions {
-    /** Flag lines older than this are considered stale. Default: 6. */
-    thresholdMonths: number;
+    /** Flag lines older than this are considered stale. Default: 30. */
+    thresholdDays: number;
     /** Absolute path to the git repository root. */
     repoRoot: string;
     /** Optional: pre-computed platform signals keyed by flag name. */
     platformSignals?: Map<string, import('./providers/interface.js').PlatformSignal[]>;
+    /**
+     * Optional: per-flag platform metadata surfaced by the orchestrator.
+     * Drives the tags / maintainer / platformStatus fields on each
+     * emitted StaleFlag. Keyed by detected flag name; values come
+     * straight from the matched PlatformFlag.
+     */
+    platformMetadata?: Map<string, {
+        tags?: string[];
+        maintainer?: string;
+        status?: 'new' | 'active' | 'inactive' | 'launched';
+    }>;
 }
 /**
  * Analyze a set of detected feature flags for staleness signals.