@flagshark/core 1.2.0 → 1.3.1

package/README.md

@@ -1,8 +1,8 @@
 # @flagshark/core
 
-The detection engine behind [FlagShark](https://github.com/FlagShark/flagshark) — finds feature flag references across 13 languages and 12+ providers, and identifies stale flags via git blame.
+The detection engine behind [FlagShark](https://github.com/FlagShark/flagshark) — finds feature flag references across 13 languages and 13 providers, and identifies stale flags via git blame.
 
-This is the **library**. If you want a CLI or GitHub Action, install [`flagshark`](https://www.npmjs.com/package/flagshark) instead.
+This is the **library**. For a CLI or GitHub Action, install [`flagshark`](https://www.npmjs.com/package/flagshark) instead.
 
 ## Install
 
@@ -25,18 +25,26 @@ console.log(`Health score: ${result.healthScore}/100`)
 console.log(`Languages: ${Object.keys(result.languageBreakdown).join(', ')}`)
 ```
 
+## Detection
+
+For tier-1 languages (TypeScript, JavaScript, Go, Python), detection uses [tree-sitter](https://tree-sitter.github.io/) (via WASM) to parse files into a real AST. That eliminates the false-positive class where regex matched flag-shaped strings inside comments, string literals, or unrelated call expressions. It also handles multi-line calls and resolves const-bound flag keys (`const FLAG = 'X'; client.variation(FLAG, …)`) in TS/JS.
+
+The remaining 9 languages currently use regex-based detection; each migrates to tree-sitter in future releases (no API break).
+
+The engine is a runtime concern, not a public API surface. Consumers calling `scanRepo()` or `createDefaultRegistry()` get the right engine per-language automatically. Override per-detector if needed (see below).
+
 ## API
 
 ### `scanRepo(options) → Promise<ScanRepoResult>`
 
-Top-level orchestrator. Walks a checked-out repository, detects flags, and runs staleness analysis.
+Top-level orchestrator. Walks a checked-out repository, detects flags, runs staleness analysis, and returns a summary.
 
 ```ts
 interface ScanRepoOptions {
   /** Absolute path to the repository being scanned. */
   cwd: string
 
-  /** Staleness threshold in months. Default: 6. */
+  /** Staleness threshold in months. Overridden by `config.threshold` if config is supplied. */
   threshold?: number
 
   /** If set, only scan files changed since this git ref (e.g. `origin/main`). */
@@ -48,20 +56,85 @@ interface ScanRepoOptions {
 
   /** Optional `{ debug, info, warn, error }` logger. Defaults to no-op. */
   logger?: ScanLogger
+
+  /** Explicit FlagsharkConfig. If undefined, scanRepo auto-discovers
+   *  `.flagshark.yml` walking upward from `cwd`. */
+  config?: FlagsharkConfig
+
+  /** Skip `.flagshark.yml` discovery entirely. */
+  noConfig?: boolean
+
+  /** Skip `.flagsharkignore` discovery entirely. */
+  noIgnoreFile?: boolean
+
+  /** Populate `result.excludedPaths` with the full list of skipped file paths.
+   *  Off by default — counts only. */
+  collectExcludedPaths?: boolean
 }
 
 interface ScanRepoResult {
   totalFlags: number
-  filesScanned: number
   staleFlags: StaleFlag[]
   detectedProviders: string[]
   languageBreakdown: Record<string, number>
-  healthScore: number       // 0–100
-  scanDuration: number      // ms
+  healthScore: number              // 0–100
+  scanDuration: number             // ms
+  excludedCount?: number           // files skipped by config + .flagsharkignore
+  excludedPaths?: string[]         // set when collectExcludedPaths: true
+  effectiveExcludes?: EffectiveRules  // for debug/verbose output
 }
 ```
 
-`scanRepo` walks the local filesystem. If you can't run a git checkout (e.g., serverless function reading from an API), use the lower-level primitives below.
+`scanRepo` walks the local filesystem. If you can't run a git checkout (e.g., a serverless function reading from an API), use the lower-level primitives below.
+
+### Config module
+
+The same config used by the CLI is exported as a building block:
+
+```ts
+import {
+  buildDefaultConfig,
+  loadConfigFile,
+  loadIgnoreFile,
+  buildExcluder,
+  expandPresets,
+  PRESETS,
+  FlagsharkConfigSchema,
+  type FlagsharkConfig,
+} from '@flagshark/core'
+
+// Load a .flagshark.yml from disk (validated via zod)
+const loaded = await loadConfigFile('/path/to/repo')
+const config = loaded?.config ?? buildDefaultConfig()
+
+// Load a .flagsharkignore (separate file at repo root)
+const ignoreFile = await loadIgnoreFile('/path/to/repo')
+
+// Build a unified excluder from all sources
+const excluder = buildExcluder({
+  config,
+  ignoreFilePatterns: ignoreFile?.patterns ?? [],
+})
+
+// Use it directly:
+excluder.shouldExclude('examples/demo.ts')  // true
+```
+
+The schema accepts:
+
+```yaml
+threshold: 6
+excludes:
+  paths: []        # gitignore-style globs
+  files: []        # same — split is purely organizational
+  presets: []      # ['test-files', 'snapshots', 'examples', 'stories', 'fixtures', 'generated']
+suppress:
+  flags: []        # flag-name globs (post-detection filter)
+paths:
+  - match: 'src/critical/**'
+    threshold: 3
+providers: []      # custom provider definitions (see Custom Detectors)
+```
 
 ### Lower-level primitives
 
@@ -71,7 +144,7 @@ For consumers that fetch file contents elsewhere (GitHub API, S3, in-memory, etc
 import { createDefaultRegistry, PolyglotAnalyzer } from '@flagshark/core'
 
 const registry = createDefaultRegistry()           // 13 detectors pre-registered
-const analyzer = new PolyglotAnalyzer(registry)
+const analyzer = new PolyglotAnalyzer(registry, logger)
 
 // `files` is a Map<filePath, content>
 const result = await analyzer.analyzeFiles(files)
@@ -101,34 +174,43 @@ const registry = createDefaultRegistry()
 registry.register(new MyCustomDetector())
 ```
 
-Or import individual detectors and compose your own registry:
+Or import individual detectors and compose your own registry. Each tier-1 detector accepts `{ engine: 'regex' | 'tree-sitter' }`:
 
 ```ts
-import { LanguageRegistry, GoDetector, TypeScriptDetector } from '@flagshark/core'
+import {
+  LanguageRegistry,
+  TypeScriptDetector,
+  GoDetector,
+  type DetectorEngine,
+} from '@flagshark/core'
 
 const registry = new LanguageRegistry()
-registry.register(new GoDetector())
-registry.register(new TypeScriptDetector())
+registry.register(new TypeScriptDetector({ engine: 'tree-sitter' }))
+registry.register(new GoDetector({ engine: 'regex' }))  // opt back to regex
 ```
 
 ## Supported languages
 
-TypeScript/JavaScript, Go, Python, Java, Kotlin, Swift, Ruby, C#, PHP, Rust, C/C++, Objective-C.
+TypeScript, JavaScript, Go, Python, Java, Kotlin, Swift, Ruby, C#, PHP, Rust, C/C++, Objective-C.
 
 ## Supported providers
 
-Auto-detected from imports — no configuration needed: LaunchDarkly, Unleash, Flipt, Split.io, PostHog, Flagsmith, ConfigCat, Statsig, GrowthBook, DevCycle, Eppo, Optimizely, plus generic custom-flag patterns.
+Auto-detected from imports — no configuration needed:
+
+LaunchDarkly · Unleash · Flipt · Split.io · PostHog · Flagsmith · ConfigCat · Statsig · GrowthBook · DevCycle · Eppo · Optimizely · plus generic custom-flag patterns.
 
 ## How detection works
 
-For each file, FlagShark looks for an import of a flag SDK. If none is found, the file is skipped — this prevents false positives from generic functions named `isEnabled()` etc. Once a file qualifies, language-specific regex patterns extract flag references along with provider attribution and source location.
+FlagShark only scans files that actually import a flag SDK. A function called `isEnabled()` in a file that doesn't import LaunchDarkly/Unleash/etc. won't be flagged — this prevents false positives from generic identifier names.
+
+Once a file qualifies, the engine (tree-sitter for tier-1, regex for the rest) walks call expressions and extracts the flag-key argument at the configured position for each provider's method signatures. Provider attribution and source location come along automatically.
 
 ## How staleness works
 
 A flag is marked stale if **any** signal fires:
 
-1. **Age:** `git blame` says the flag was added more than `threshold` months ago.
-2. **Single file:** The flag name appears in only one file across the repo, suggesting a completed rollout.
+1. **`age`** — `git blame` shows the flag's line was last modified more than `threshold` months ago.
+2. **`low-usage`** — The flag name appears in only one file across the repo, suggesting a completed rollout.
 
 ## License
 

package/dist/config/defaults.d.ts

@@ -0,0 +1,3 @@
+import { type FlagsharkConfig } from './schema.js';
+export declare function buildDefaultConfig(): FlagsharkConfig;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/config/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAA;AAEzE,wBAAgB,kBAAkB,IAAI,eAAe,CAGpD"}

package/dist/config/defaults.js

@@ -0,0 +1,6 @@
+import { FlagsharkConfigSchema } from './schema.js';
+export function buildDefaultConfig() {
+    // Parse an empty object — schema fills in all defaults.
+    return FlagsharkConfigSchema.parse({});
+}
+//# sourceMappingURL=defaults.js.map

package/dist/config/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAwB,MAAM,aAAa,CAAA;AAEzE,MAAM,UAAU,kBAAkB;IAChC,wDAAwD;IACxD,OAAO,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;AACxC,CAAC"}

package/dist/config/excluder.d.ts

@@ -0,0 +1,18 @@
+import type { FlagsharkConfig } from './schema.js';
+export interface EffectiveRules {
+    paths: string[];
+    files: string[];
+    presets: string[];
+    presetPatterns: string[];
+    ignoreFile: string[];
+}
+export interface Excluder {
+    shouldExclude(path: string): boolean;
+    effectiveRules: EffectiveRules;
+}
+export interface BuildExcluderInput {
+    config: FlagsharkConfig;
+    ignoreFilePatterns: string[];
+}
+export declare function buildExcluder(input: BuildExcluderInput): Excluder;
+//# sourceMappingURL=excluder.d.ts.map

package/dist/config/excluder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"excluder.d.ts","sourceRoot":"","sources":["../../src/config/excluder.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAIlD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,UAAU,EAAE,MAAM,EAAE,CAAA;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;IACpC,cAAc,EAAE,cAAc,CAAA;CAC/B;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,eAAe,CAAA;IACvB,kBAAkB,EAAE,MAAM,EAAE,CAAA;CAC7B;AAwBD,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,QAAQ,CA4BjE"}

package/dist/config/excluder.js

@@ -0,0 +1,51 @@
+import ignoreModule from 'ignore';
+import { expandPresets } from './presets.js';
+const ignore = ignoreModule.default ?? ignoreModule;
+/**
+ * Convert trailing-slash directory patterns (`examples/`) to recursive globs
+ * (`examples/**`) so that `!`-negation works downstream.
+ *
+ * The `ignore@5` package follows the strict gitignore spec: once a parent
+ * directory is excluded via a trailing-slash pattern, files inside it cannot
+ * be re-included via `!`. Converting to `examples/**` bypasses this restriction
+ * by treating the pattern as a glob rather than a directory match.
+ *
+ * Trade-off: `examples/**` is anchored to the repo root, while gitignore's
+ * `examples/` is unanchored (matches `examples/` anywhere in the tree).
+ * In practice the scanner's hardcoded SKIP_DIRS already filters node_modules,
+ * vendor, etc., so this anchoring change rarely affects real users — but it
+ * is a deliberate departure from strict gitignore semantics.
+ */
+function normalisePattern(p) {
+    if (!p.startsWith('!') && p.endsWith('/')) {
+        return p + '**';
+    }
+    return p;
+}
+export function buildExcluder(input) {
+    const { config, ignoreFilePatterns } = input;
+    const presetPatterns = expandPresets(config.excludes.presets);
+    const allPatterns = [
+        ...config.excludes.paths,
+        ...config.excludes.files,
+        ...presetPatterns,
+        ...ignoreFilePatterns,
+    ];
+    const matcher = ignore().add(allPatterns.map(normalisePattern));
+    return {
+        shouldExclude(path) {
+            if (allPatterns.length === 0)
+                return false;
+            const normalised = path.startsWith('./') ? path.slice(2) : path;
+            return matcher.ignores(normalised);
+        },
+        effectiveRules: {
+            paths: [...config.excludes.paths],
+            files: [...config.excludes.files],
+            presets: [...config.excludes.presets],
+            presetPatterns,
+            ignoreFile: [...ignoreFilePatterns],
+        },
+    };
+}
+//# sourceMappingURL=excluder.js.map

package/dist/config/excluder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"excluder.js","sourceRoot":"","sources":["../../src/config/excluder.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,QAAQ,CAAA;AAEjC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAI5C,MAAM,MAAM,GAAI,YAA6D,CAAC,OAAO,IAAI,YAAY,CAAA;AAoBrG;;;;;;;;;;;;;;GAcG;AACH,SAAS,gBAAgB,CAAC,CAAS;IACjC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1C,OAAO,CAAC,GAAG,IAAI,CAAA;IACjB,CAAC;IACD,OAAO,CAAC,CAAA;AACV,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAyB;IACrD,MAAM,EAAE,MAAM,EAAE,kBAAkB,EAAE,GAAG,KAAK,CAAA;IAE5C,MAAM,cAAc,GAAG,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;IAE7D,MAAM,WAAW,GAAa;QAC5B,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK;QACxB,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK;QACxB,GAAG,cAAc;QACjB,GAAG,kBAAkB;KACtB,CAAA;IAED,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAA;IAE/D,OAAO;QACL,aAAa,CAAC,IAAY;YACxB,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,KAAK,CAAA;YAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;YAC/D,OAAO,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;QACpC,CAAC;QACD,cAAc,EAAE;YACd,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YACjC,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YACjC,OAAO,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;YACrC,cAAc;YACd,UAAU,EAAE,CAAC,GAAG,kBAAkB,CAAC;SACpC;KACF,CAAA;AACH,CAAC"}

package/dist/config/ignore-file.d.ts

@@ -0,0 +1,6 @@
+export interface LoadedIgnore {
+    patterns: string[];
+    path: string;
+}
+export declare function loadIgnoreFile(startDir: string): Promise<LoadedIgnore | null>;
+//# sourceMappingURL=ignore-file.d.ts.map

package/dist/config/ignore-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignore-file.d.ts","sourceRoot":"","sources":["../../src/config/ignore-file.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAkBnF"}

package/dist/config/ignore-file.js

@@ -0,0 +1,23 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join, resolve } from 'node:path';
+export async function loadIgnoreFile(startDir) {
+    const home = homedir();
+    let dir = resolve(startDir);
+    for (;;) {
+        const candidate = join(dir, '.flagsharkignore');
+        if (existsSync(candidate)) {
+            const raw = readFileSync(candidate, 'utf-8');
+            const patterns = raw
+                .split('\n')
+                .map((line) => line.trim())
+                .filter((line) => line.length > 0 && !line.startsWith('#'));
+            return { patterns, path: candidate };
+        }
+        const parent = dirname(dir);
+        if (parent === dir || dir === home || dir === '/')
+            return null;
+        dir = parent;
+    }
+}
+//# sourceMappingURL=ignore-file.js.map

package/dist/config/ignore-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignore-file.js","sourceRoot":"","sources":["../../src/config/ignore-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAOlD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAgB;IACnD,MAAM,IAAI,GAAG,OAAO,EAAE,CAAA;IACtB,IAAI,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAE3B,SAAS,CAAC;QACR,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAA;QAC/C,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,MAAM,GAAG,GAAG,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;YAC5C,MAAM,QAAQ,GAAG,GAAG;iBACjB,KAAK,CAAC,IAAI,CAAC;iBACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;iBAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAA;YAC7D,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,CAAA;QACtC,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;QAC3B,IAAI,MAAM,KAAK,GAAG,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,GAAG;YAAE,OAAO,IAAI,CAAA;QAC9D,GAAG,GAAG,MAAM,CAAA;IACd,CAAC;AACH,CAAC"}

package/dist/config/index.d.ts

@@ -0,0 +1,7 @@
+export { buildDefaultConfig } from './defaults.js';
+export { loadConfigFile, type LoadedConfig } from './loader.js';
+export { loadIgnoreFile, type LoadedIgnore } from './ignore-file.js';
+export { buildExcluder, type Excluder, type EffectiveRules, type BuildExcluderInput } from './excluder.js';
+export { expandPresets, PRESETS } from './presets.js';
+export { FlagsharkConfigSchema, type FlagsharkConfig, type ExcludesConfig, type SuppressConfig, type PathRuleConfig, type OutputConfig, type PresetName, } from './schema.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/D,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACpE,OAAO,EAAE,aAAa,EAAE,KAAK,QAAQ,EAAE,KAAK,cAAc,EAAE,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAC1G,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACrD,OAAO,EACL,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,UAAU,GAChB,MAAM,aAAa,CAAA"}

package/dist/config/index.js

@@ -0,0 +1,7 @@
+export { buildDefaultConfig } from './defaults.js';
+export { loadConfigFile } from './loader.js';
+export { loadIgnoreFile } from './ignore-file.js';
+export { buildExcluder } from './excluder.js';
+export { expandPresets, PRESETS } from './presets.js';
+export { FlagsharkConfigSchema, } from './schema.js';
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,EAAE,cAAc,EAAqB,MAAM,aAAa,CAAA;AAC/D,OAAO,EAAE,cAAc,EAAqB,MAAM,kBAAkB,CAAA;AACpE,OAAO,EAAE,aAAa,EAA+D,MAAM,eAAe,CAAA;AAC1G,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACrD,OAAO,EACL,qBAAqB,GAOtB,MAAM,aAAa,CAAA"}

package/dist/config/loader.d.ts

@@ -0,0 +1,7 @@
+import { type FlagsharkConfig } from './schema.js';
+export interface LoadedConfig {
+    config: FlagsharkConfig;
+    path: string;
+}
+export declare function loadConfigFile(startDir: string): Promise<LoadedConfig | null>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAMA,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAA;AAIzE,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,eAAe,CAAA;IACvB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAenF"}

package/dist/config/loader.js

@@ -0,0 +1,47 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join, resolve } from 'node:path';
+import { parse as parseYaml, YAMLParseError } from 'yaml';
+import { FlagsharkConfigSchema } from './schema.js';
+const FILENAMES = ['.flagshark.yml', '.flagshark.yaml'];
+export async function loadConfigFile(startDir) {
+    const home = homedir();
+    let dir = resolve(startDir);
+    for (;;) {
+        for (const name of FILENAMES) {
+            const candidate = join(dir, name);
+            if (existsSync(candidate)) {
+                return readAndValidate(candidate);
+            }
+        }
+        const parent = dirname(dir);
+        if (parent === dir || dir === home || dir === '/')
+            return null;
+        dir = parent;
+    }
+}
+function readAndValidate(path) {
+    const raw = readFileSync(path, 'utf-8');
+    let parsed;
+    try {
+        parsed = parseYaml(raw);
+    }
+    catch (err) {
+        if (err instanceof YAMLParseError) {
+            throw new Error(`Invalid YAML in ${path}: ${err.message}`);
+        }
+        throw err;
+    }
+    if (parsed == null || typeof parsed !== 'object') {
+        return { config: FlagsharkConfigSchema.parse({}), path };
+    }
+    const result = FlagsharkConfigSchema.safeParse(parsed);
+    if (!result.success) {
+        const issues = result.error.issues
+            .map((i) => `${i.path.join('.') || '(root)'}: ${i.message}`)
+            .join('; ');
+        throw new Error(`Invalid .flagshark.yml at ${path}: ${issues}`);
+    }
+    return { config: result.data, path };
+}
+//# sourceMappingURL=loader.js.map

package/dist/config/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAElD,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,cAAc,EAAE,MAAM,MAAM,CAAA;AAEzD,OAAO,EAAE,qBAAqB,EAAwB,MAAM,aAAa,CAAA;AAEzE,MAAM,SAAS,GAAG,CAAC,gBAAgB,EAAE,iBAAiB,CAAC,CAAA;AAOvD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAgB;IACnD,MAAM,IAAI,GAAG,OAAO,EAAE,CAAA;IACtB,IAAI,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAE3B,SAAS,CAAC;QACR,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;YACjC,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC1B,OAAO,eAAe,CAAC,SAAS,CAAC,CAAA;YACnC,CAAC;QACH,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;QAC3B,IAAI,MAAM,KAAK,GAAG,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,GAAG;YAAE,OAAO,IAAI,CAAA;QAC9D,GAAG,GAAG,MAAM,CAAA;IACd,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IAEvC,IAAI,MAAe,CAAA;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAA;IACzB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,cAAc,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAA;QAC5D,CAAC;QACD,MAAM,GAAG,CAAA;IACX,CAAC;IAED,IAAI,MAAM,IAAI,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACjD,OAAO,EAAE,MAAM,EAAE,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAA;IAC1D,CAAC;IAED,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IACtD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM;aAC/B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;aAC3D,IAAI,CAAC,IAAI,CAAC,CAAA;QACb,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,KAAK,MAAM,EAAE,CAAC,CAAA;IACjE,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAA;AACtC,CAAC"}

package/dist/config/presets.d.ts

@@ -0,0 +1,11 @@
+import type { PresetName } from './schema.js';
+/**
+ * Built-in exclude presets. Each preset expands to a list of gitignore-style
+ * glob patterns that match common conventions for that category.
+ *
+ * Test-files patterns are derived from the private flag-shark monorepo's
+ * `packages/shared/lib/test-files.ts` `isTestFile()` helper — credit there.
+ */
+export declare const PRESETS: Readonly<Record<PresetName, readonly string[]>>;
+export declare function expandPresets(names: readonly PresetName[]): string[];
+//# sourceMappingURL=presets.d.ts.map

package/dist/config/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../src/config/presets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC,CA6ClE,CAAA;AAEF,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,EAAE,CAcpE"}

package/dist/config/presets.js

@@ -0,0 +1,70 @@
+/**
+ * Built-in exclude presets. Each preset expands to a list of gitignore-style
+ * glob patterns that match common conventions for that category.
+ *
+ * Test-files patterns are derived from the private flag-shark monorepo's
+ * `packages/shared/lib/test-files.ts` `isTestFile()` helper — credit there.
+ */
+export const PRESETS = Object.freeze({
+    'test-files': Object.freeze([
+        // JavaScript / TypeScript
+        '**/*.test.ts', '**/*.test.tsx', '**/*.test.js', '**/*.test.jsx',
+        '**/*.test.mjs', '**/*.test.cjs',
+        '**/*.spec.ts', '**/*.spec.tsx', '**/*.spec.js', '**/*.spec.jsx',
+        // Go
+        '**/*_test.go',
+        // Python
+        '**/*_test.py', '**/test_*.py',
+        // Java / Kotlin
+        '**/*Test.java', '**/*Tests.java', '**/*Test.kt', '**/*Tests.kt',
+        // Swift
+        '**/*Tests.swift',
+        // Ruby
+        '**/*_spec.rb', '**/spec/**/*.rb',
+        // C# / .NET
+        '**/*Test.cs', '**/*Tests.cs',
+        // PHP
+        '**/*Test.php',
+        // Rust
+        '**/tests/**',
+        // Directories that always indicate tests
+        '**/__tests__/**', '**/test/**',
+    ]),
+    'snapshots': Object.freeze([
+        '**/*.snap',
+        '**/__snapshots__/**',
+    ]),
+    'examples': Object.freeze([
+        'examples/**', 'example/**',
+        'demo/**', 'demos/**',
+    ]),
+    'stories': Object.freeze([
+        '**/*.stories.ts', '**/*.stories.tsx',
+        '**/*.stories.js', '**/*.stories.jsx',
+        '**/*.story.ts', '**/*.story.tsx',
+    ]),
+    'fixtures': Object.freeze([
+        '**/__fixtures__/**', '**/fixtures/**',
+    ]),
+    'generated': Object.freeze([
+        '**/*.generated.ts', '**/*.generated.js',
+        '**/*.gen.go', '**/generated/**',
+    ]),
+});
+export function expandPresets(names) {
+    const seen = new Set();
+    const out = [];
+    for (const name of names) {
+        const patterns = PRESETS[name];
+        if (!patterns)
+            continue;
+        for (const pattern of patterns) {
+            if (!seen.has(pattern)) {
+                seen.add(pattern);
+                out.push(pattern);
+            }
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=presets.js.map

package/dist/config/presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../../src/config/presets.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,OAAO,GAAoD,MAAM,CAAC,MAAM,CAAC;IACpF,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC;QAC1B,0BAA0B;QAC1B,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,eAAe;QAChE,eAAe,EAAE,eAAe;QAChC,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,eAAe;QAChE,KAAK;QACL,cAAc;QACd,SAAS;QACT,cAAc,EAAE,cAAc;QAC9B,gBAAgB;QAChB,eAAe,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc;QAChE,QAAQ;QACR,iBAAiB;QACjB,OAAO;QACP,cAAc,EAAE,iBAAiB;QACjC,YAAY;QACZ,aAAa,EAAE,cAAc;QAC7B,MAAM;QACN,cAAc;QACd,OAAO;QACP,aAAa;QACb,yCAAyC;QACzC,iBAAiB,EAAE,YAAY;KAChC,CAAC;IACF,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC;QACzB,WAAW;QACX,qBAAqB;KACtB,CAAC;IACF,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC;QACxB,aAAa,EAAE,YAAY;QAC3B,SAAS,EAAE,UAAU;KACtB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC;QACvB,iBAAiB,EAAE,kBAAkB;QACrC,iBAAiB,EAAE,kBAAkB;QACrC,eAAe,EAAE,gBAAgB;KAClC,CAAC;IACF,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC;QACxB,oBAAoB,EAAE,gBAAgB;KACvC,CAAC;IACF,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC;QACzB,mBAAmB,EAAE,mBAAmB;QACxC,aAAa,EAAE,iBAAiB;KACjC,CAAC;CACH,CAAC,CAAA;AAEF,MAAM,UAAU,aAAa,CAAC,KAA4B;IACxD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,MAAM,GAAG,GAAa,EAAE,CAAA;IACxB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;QAC9B,IAAI,CAAC,QAAQ;YAAE,SAAQ;QACvB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBACvB,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;gBACjB,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YACnB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}