@0xbigboss/gh-pulse-core 1.0.0

package/dist/config.d.cts

@@ -0,0 +1,248 @@
+import { z } from 'zod';
+declare const ResolvedConfigSchema: z.ZodObject<{
+    linear_api_key: z.ZodOptional<z.ZodString>;
+    orgs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    repos: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    team: z.ZodDefault<z.ZodObject<{
+        strategy: z.ZodDefault<z.ZodEnum<["org_members", "config_list", "repo_contributors"]>>;
+        members: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        strategy: "org_members" | "config_list" | "repo_contributors";
+        members: string[];
+    }, {
+        strategy?: "org_members" | "config_list" | "repo_contributors" | undefined;
+        members?: string[] | undefined;
+    }>>;
+    exclude: z.ZodDefault<z.ZodObject<{
+        bots: z.ZodDefault<z.ZodBoolean>;
+        forks: z.ZodDefault<z.ZodBoolean>;
+        archived: z.ZodDefault<z.ZodBoolean>;
+        authors: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        bots: boolean;
+        forks: boolean;
+        archived: boolean;
+        authors: string[];
+    }, {
+        bots?: boolean | undefined;
+        forks?: boolean | undefined;
+        archived?: boolean | undefined;
+        authors?: string[] | undefined;
+    }>>;
+    thresholds: z.ZodDefault<z.ZodObject<{
+        stale_days: z.ZodDefault<z.ZodNumber>;
+        stuck_days: z.ZodDefault<z.ZodNumber>;
+        large_pr_lines: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        stale_days: number;
+        stuck_days: number;
+        large_pr_lines: number;
+    }, {
+        stale_days?: number | undefined;
+        stuck_days?: number | undefined;
+        large_pr_lines?: number | undefined;
+    }>>;
+    timezone: z.ZodDefault<z.ZodString>;
+    cache: z.ZodDefault<z.ZodObject<{
+        path: z.ZodDefault<z.ZodString>;
+        ttl_hours: z.ZodDefault<z.ZodNumber>;
+        sync_ttl_hours: z.ZodDefault<z.ZodNumber>;
+        concurrency: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        ttl_hours: number;
+        sync_ttl_hours: number;
+        concurrency: number;
+    }, {
+        path?: string | undefined;
+        ttl_hours?: number | undefined;
+        sync_ttl_hours?: number | undefined;
+        concurrency?: number | undefined;
+    }>>;
+} & {
+    github_token: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    github_token: string;
+    orgs: string[];
+    repos: string[];
+    team: {
+        strategy: "org_members" | "config_list" | "repo_contributors";
+        members: string[];
+    };
+    exclude: {
+        bots: boolean;
+        forks: boolean;
+        archived: boolean;
+        authors: string[];
+    };
+    thresholds: {
+        stale_days: number;
+        stuck_days: number;
+        large_pr_lines: number;
+    };
+    timezone: string;
+    cache: {
+        path: string;
+        ttl_hours: number;
+        sync_ttl_hours: number;
+        concurrency: number;
+    };
+    linear_api_key?: string | undefined;
+}, {
+    github_token: string;
+    linear_api_key?: string | undefined;
+    orgs?: string[] | undefined;
+    repos?: string[] | undefined;
+    team?: {
+        strategy?: "org_members" | "config_list" | "repo_contributors" | undefined;
+        members?: string[] | undefined;
+    } | undefined;
+    exclude?: {
+        bots?: boolean | undefined;
+        forks?: boolean | undefined;
+        archived?: boolean | undefined;
+        authors?: string[] | undefined;
+    } | undefined;
+    thresholds?: {
+        stale_days?: number | undefined;
+        stuck_days?: number | undefined;
+        large_pr_lines?: number | undefined;
+    } | undefined;
+    timezone?: string | undefined;
+    cache?: {
+        path?: string | undefined;
+        ttl_hours?: number | undefined;
+        sync_ttl_hours?: number | undefined;
+        concurrency?: number | undefined;
+    } | undefined;
+}>;
+export type Config = z.infer<typeof ResolvedConfigSchema>;
+export declare const DEFAULT_CONFIG_ENV = "GH_PULSE_CONFIG";
+/**
+ * Try to get GitHub token from `gh` CLI.
+ * Returns undefined if gh is not available or not authenticated.
+ */
+export declare function getGhCliToken(): string | undefined;
+export declare function resolveConfigPath(providedPath?: string, env?: NodeJS.ProcessEnv): string;
+export declare function resolveCachePath(configuredPath: string | undefined, env?: NodeJS.ProcessEnv): string;
+export declare function loadConfig(options?: {
+    path?: string;
+    env?: NodeJS.ProcessEnv;
+}): Promise<Config>;
+export declare const CONFIG_SCHEMA: z.ZodObject<{
+    github_token: z.ZodOptional<z.ZodString>;
+    linear_api_key: z.ZodOptional<z.ZodString>;
+    orgs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    repos: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    team: z.ZodDefault<z.ZodObject<{
+        strategy: z.ZodDefault<z.ZodEnum<["org_members", "config_list", "repo_contributors"]>>;
+        members: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        strategy: "org_members" | "config_list" | "repo_contributors";
+        members: string[];
+    }, {
+        strategy?: "org_members" | "config_list" | "repo_contributors" | undefined;
+        members?: string[] | undefined;
+    }>>;
+    exclude: z.ZodDefault<z.ZodObject<{
+        bots: z.ZodDefault<z.ZodBoolean>;
+        forks: z.ZodDefault<z.ZodBoolean>;
+        archived: z.ZodDefault<z.ZodBoolean>;
+        authors: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        bots: boolean;
+        forks: boolean;
+        archived: boolean;
+        authors: string[];
+    }, {
+        bots?: boolean | undefined;
+        forks?: boolean | undefined;
+        archived?: boolean | undefined;
+        authors?: string[] | undefined;
+    }>>;
+    thresholds: z.ZodDefault<z.ZodObject<{
+        stale_days: z.ZodDefault<z.ZodNumber>;
+        stuck_days: z.ZodDefault<z.ZodNumber>;
+        large_pr_lines: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        stale_days: number;
+        stuck_days: number;
+        large_pr_lines: number;
+    }, {
+        stale_days?: number | undefined;
+        stuck_days?: number | undefined;
+        large_pr_lines?: number | undefined;
+    }>>;
+    timezone: z.ZodDefault<z.ZodString>;
+    cache: z.ZodDefault<z.ZodObject<{
+        path: z.ZodDefault<z.ZodString>;
+        ttl_hours: z.ZodDefault<z.ZodNumber>;
+        sync_ttl_hours: z.ZodDefault<z.ZodNumber>;
+        concurrency: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        ttl_hours: number;
+        sync_ttl_hours: number;
+        concurrency: number;
+    }, {
+        path?: string | undefined;
+        ttl_hours?: number | undefined;
+        sync_ttl_hours?: number | undefined;
+        concurrency?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    orgs: string[];
+    repos: string[];
+    team: {
+        strategy: "org_members" | "config_list" | "repo_contributors";
+        members: string[];
+    };
+    exclude: {
+        bots: boolean;
+        forks: boolean;
+        archived: boolean;
+        authors: string[];
+    };
+    thresholds: {
+        stale_days: number;
+        stuck_days: number;
+        large_pr_lines: number;
+    };
+    timezone: string;
+    cache: {
+        path: string;
+        ttl_hours: number;
+        sync_ttl_hours: number;
+        concurrency: number;
+    };
+    github_token?: string | undefined;
+    linear_api_key?: string | undefined;
+}, {
+    github_token?: string | undefined;
+    linear_api_key?: string | undefined;
+    orgs?: string[] | undefined;
+    repos?: string[] | undefined;
+    team?: {
+        strategy?: "org_members" | "config_list" | "repo_contributors" | undefined;
+        members?: string[] | undefined;
+    } | undefined;
+    exclude?: {
+        bots?: boolean | undefined;
+        forks?: boolean | undefined;
+        archived?: boolean | undefined;
+        authors?: string[] | undefined;
+    } | undefined;
+    thresholds?: {
+        stale_days?: number | undefined;
+        stuck_days?: number | undefined;
+        large_pr_lines?: number | undefined;
+    } | undefined;
+    timezone?: string | undefined;
+    cache?: {
+        path?: string | undefined;
+        ttl_hours?: number | undefined;
+        sync_ttl_hours?: number | undefined;
+        concurrency?: number | undefined;
+    } | undefined;
+}>;
+export {};

package/dist/config.d.ts

@@ -0,0 +1,248 @@
+import { z } from 'zod';
+declare const ResolvedConfigSchema: z.ZodObject<{
+    linear_api_key: z.ZodOptional<z.ZodString>;
+    orgs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    repos: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    team: z.ZodDefault<z.ZodObject<{
+        strategy: z.ZodDefault<z.ZodEnum<["org_members", "config_list", "repo_contributors"]>>;
+        members: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        strategy: "org_members" | "config_list" | "repo_contributors";
+        members: string[];
+    }, {
+        strategy?: "org_members" | "config_list" | "repo_contributors" | undefined;
+        members?: string[] | undefined;
+    }>>;
+    exclude: z.ZodDefault<z.ZodObject<{
+        bots: z.ZodDefault<z.ZodBoolean>;
+        forks: z.ZodDefault<z.ZodBoolean>;
+        archived: z.ZodDefault<z.ZodBoolean>;
+        authors: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        bots: boolean;
+        forks: boolean;
+        archived: boolean;
+        authors: string[];
+    }, {
+        bots?: boolean | undefined;
+        forks?: boolean | undefined;
+        archived?: boolean | undefined;
+        authors?: string[] | undefined;
+    }>>;
+    thresholds: z.ZodDefault<z.ZodObject<{
+        stale_days: z.ZodDefault<z.ZodNumber>;
+        stuck_days: z.ZodDefault<z.ZodNumber>;
+        large_pr_lines: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        stale_days: number;
+        stuck_days: number;
+        large_pr_lines: number;
+    }, {
+        stale_days?: number | undefined;
+        stuck_days?: number | undefined;
+        large_pr_lines?: number | undefined;
+    }>>;
+    timezone: z.ZodDefault<z.ZodString>;
+    cache: z.ZodDefault<z.ZodObject<{
+        path: z.ZodDefault<z.ZodString>;
+        ttl_hours: z.ZodDefault<z.ZodNumber>;
+        sync_ttl_hours: z.ZodDefault<z.ZodNumber>;
+        concurrency: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        ttl_hours: number;
+        sync_ttl_hours: number;
+        concurrency: number;
+    }, {
+        path?: string | undefined;
+        ttl_hours?: number | undefined;
+        sync_ttl_hours?: number | undefined;
+        concurrency?: number | undefined;
+    }>>;
+} & {
+    github_token: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    github_token: string;
+    orgs: string[];
+    repos: string[];
+    team: {
+        strategy: "org_members" | "config_list" | "repo_contributors";
+        members: string[];
+    };
+    exclude: {
+        bots: boolean;
+        forks: boolean;
+        archived: boolean;
+        authors: string[];
+    };
+    thresholds: {
+        stale_days: number;
+        stuck_days: number;
+        large_pr_lines: number;
+    };
+    timezone: string;
+    cache: {
+        path: string;
+        ttl_hours: number;
+        sync_ttl_hours: number;
+        concurrency: number;
+    };
+    linear_api_key?: string | undefined;
+}, {
+    github_token: string;
+    linear_api_key?: string | undefined;
+    orgs?: string[] | undefined;
+    repos?: string[] | undefined;
+    team?: {
+        strategy?: "org_members" | "config_list" | "repo_contributors" | undefined;
+        members?: string[] | undefined;
+    } | undefined;
+    exclude?: {
+        bots?: boolean | undefined;
+        forks?: boolean | undefined;
+        archived?: boolean | undefined;
+        authors?: string[] | undefined;
+    } | undefined;
+    thresholds?: {
+        stale_days?: number | undefined;
+        stuck_days?: number | undefined;
+        large_pr_lines?: number | undefined;
+    } | undefined;
+    timezone?: string | undefined;
+    cache?: {
+        path?: string | undefined;
+        ttl_hours?: number | undefined;
+        sync_ttl_hours?: number | undefined;
+        concurrency?: number | undefined;
+    } | undefined;
+}>;
+export type Config = z.infer<typeof ResolvedConfigSchema>;
+export declare const DEFAULT_CONFIG_ENV = "GH_PULSE_CONFIG";
+/**
+ * Try to get GitHub token from `gh` CLI.
+ * Returns undefined if gh is not available or not authenticated.
+ */
+export declare function getGhCliToken(): string | undefined;
+export declare function resolveConfigPath(providedPath?: string, env?: NodeJS.ProcessEnv): string;
+export declare function resolveCachePath(configuredPath: string | undefined, env?: NodeJS.ProcessEnv): string;
+export declare function loadConfig(options?: {
+    path?: string;
+    env?: NodeJS.ProcessEnv;
+}): Promise<Config>;
+export declare const CONFIG_SCHEMA: z.ZodObject<{
+    github_token: z.ZodOptional<z.ZodString>;
+    linear_api_key: z.ZodOptional<z.ZodString>;
+    orgs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    repos: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    team: z.ZodDefault<z.ZodObject<{
+        strategy: z.ZodDefault<z.ZodEnum<["org_members", "config_list", "repo_contributors"]>>;
+        members: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        strategy: "org_members" | "config_list" | "repo_contributors";
+        members: string[];
+    }, {
+        strategy?: "org_members" | "config_list" | "repo_contributors" | undefined;
+        members?: string[] | undefined;
+    }>>;
+    exclude: z.ZodDefault<z.ZodObject<{
+        bots: z.ZodDefault<z.ZodBoolean>;
+        forks: z.ZodDefault<z.ZodBoolean>;
+        archived: z.ZodDefault<z.ZodBoolean>;
+        authors: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        bots: boolean;
+        forks: boolean;
+        archived: boolean;
+        authors: string[];
+    }, {
+        bots?: boolean | undefined;
+        forks?: boolean | undefined;
+        archived?: boolean | undefined;
+        authors?: string[] | undefined;
+    }>>;
+    thresholds: z.ZodDefault<z.ZodObject<{
+        stale_days: z.ZodDefault<z.ZodNumber>;
+        stuck_days: z.ZodDefault<z.ZodNumber>;
+        large_pr_lines: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        stale_days: number;
+        stuck_days: number;
+        large_pr_lines: number;
+    }, {
+        stale_days?: number | undefined;
+        stuck_days?: number | undefined;
+        large_pr_lines?: number | undefined;
+    }>>;
+    timezone: z.ZodDefault<z.ZodString>;
+    cache: z.ZodDefault<z.ZodObject<{
+        path: z.ZodDefault<z.ZodString>;
+        ttl_hours: z.ZodDefault<z.ZodNumber>;
+        sync_ttl_hours: z.ZodDefault<z.ZodNumber>;
+        concurrency: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        ttl_hours: number;
+        sync_ttl_hours: number;
+        concurrency: number;
+    }, {
+        path?: string | undefined;
+        ttl_hours?: number | undefined;
+        sync_ttl_hours?: number | undefined;
+        concurrency?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    orgs: string[];
+    repos: string[];
+    team: {
+        strategy: "org_members" | "config_list" | "repo_contributors";
+        members: string[];
+    };
+    exclude: {
+        bots: boolean;
+        forks: boolean;
+        archived: boolean;
+        authors: string[];
+    };
+    thresholds: {
+        stale_days: number;
+        stuck_days: number;
+        large_pr_lines: number;
+    };
+    timezone: string;
+    cache: {
+        path: string;
+        ttl_hours: number;
+        sync_ttl_hours: number;
+        concurrency: number;
+    };
+    github_token?: string | undefined;
+    linear_api_key?: string | undefined;
+}, {
+    github_token?: string | undefined;
+    linear_api_key?: string | undefined;
+    orgs?: string[] | undefined;
+    repos?: string[] | undefined;
+    team?: {
+        strategy?: "org_members" | "config_list" | "repo_contributors" | undefined;
+        members?: string[] | undefined;
+    } | undefined;
+    exclude?: {
+        bots?: boolean | undefined;
+        forks?: boolean | undefined;
+        archived?: boolean | undefined;
+        authors?: string[] | undefined;
+    } | undefined;
+    thresholds?: {
+        stale_days?: number | undefined;
+        stuck_days?: number | undefined;
+        large_pr_lines?: number | undefined;
+    } | undefined;
+    timezone?: string | undefined;
+    cache?: {
+        path?: string | undefined;
+        ttl_hours?: number | undefined;
+        sync_ttl_hours?: number | undefined;
+        concurrency?: number | undefined;
+    } | undefined;
+}>;
+export {};

package/dist/config.js

@@ -0,0 +1,172 @@
+import { promises as fs } from 'node:fs';
+import { execSync } from 'node:child_process';
+import path from 'node:path';
+import os from 'node:os';
+import { z } from 'zod';
+import YAML from 'yaml';
+const TeamStrategySchema = z.enum(['org_members', 'config_list', 'repo_contributors']);
+const ExcludeSchema = z
+    .object({
+    bots: z.boolean().default(true),
+    forks: z.boolean().default(true),
+    archived: z.boolean().default(true),
+    authors: z.array(z.string().min(1)).default([]),
+})
+    .default({
+    bots: true,
+    forks: true,
+    archived: true,
+    authors: [],
+});
+const ThresholdsSchema = z
+    .object({
+    stale_days: z.number().int().positive().default(2),
+    stuck_days: z.number().int().positive().default(4),
+    large_pr_lines: z.number().int().positive().default(500),
+})
+    .default({
+    stale_days: 2,
+    stuck_days: 4,
+    large_pr_lines: 500,
+});
+const CacheSchema = z
+    .object({
+    path: z.string().default(''),
+    ttl_hours: z.number().int().positive().default(1),
+    sync_ttl_hours: z.number().int().nonnegative().default(24),
+    concurrency: z.number().int().positive().default(5),
+})
+    .default({
+    path: '',
+    ttl_hours: 1,
+    sync_ttl_hours: 24,
+    concurrency: 5,
+});
+const TeamSchema = z
+    .object({
+    strategy: TeamStrategySchema.default('org_members'),
+    members: z.array(z.string().min(1)).default([]),
+})
+    .default({
+    strategy: 'org_members',
+    members: [],
+});
+const ConfigSchema = z.object({
+    github_token: z.string().optional(),
+    linear_api_key: z.string().min(1).optional(),
+    orgs: z.array(z.string().min(1)).default([]),
+    repos: z.array(z.string().min(1)).default([]),
+    team: TeamSchema,
+    exclude: ExcludeSchema,
+    thresholds: ThresholdsSchema,
+    timezone: z.string().default(''),
+    cache: CacheSchema,
+});
+// Internal schema with required token (after resolution)
+const ResolvedConfigSchema = ConfigSchema.extend({
+    github_token: z.string().min(1),
+});
+export const DEFAULT_CONFIG_ENV = 'GH_PULSE_CONFIG';
+/**
+ * Try to get GitHub token from `gh` CLI.
+ * Returns undefined if gh is not available or not authenticated.
+ */
+export function getGhCliToken() {
+    try {
+        const token = execSync('gh auth token', {
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+            timeout: 5000,
+        }).trim();
+        return token.length > 0 ? token : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function resolveConfigPath(providedPath, env = process.env) {
+    if (providedPath) {
+        return expandHome(providedPath);
+    }
+    const envPath = env[DEFAULT_CONFIG_ENV];
+    if (envPath && envPath.trim().length > 0) {
+        return expandHome(envPath.trim());
+    }
+    const xdgConfigHome = env.XDG_CONFIG_HOME;
+    const base = xdgConfigHome && xdgConfigHome.trim().length > 0
+        ? xdgConfigHome.trim()
+        : path.join(os.homedir(), '.config');
+    return path.join(base, 'gh-pulse', 'config.yaml');
+}
+export function resolveCachePath(configuredPath, env = process.env) {
+    if (configuredPath && configuredPath.trim().length > 0) {
+        return expandHome(configuredPath.trim());
+    }
+    const xdgCacheHome = env.XDG_CACHE_HOME;
+    const base = xdgCacheHome && xdgCacheHome.trim().length > 0
+        ? xdgCacheHome.trim()
+        : path.join(os.homedir(), '.cache');
+    return path.join(base, 'gh-pulse', 'cache.db');
+}
+export async function loadConfig(options = {}) {
+    const env = options.env ?? process.env;
+    const configPath = resolveConfigPath(options.path, env);
+    const rawText = await fs.readFile(configPath, 'utf8');
+    const parsed = YAML.parse(rawText) ?? {};
+    // Resolve env placeholders, allowing GITHUB_TOKEN to be missing
+    const resolved = resolveEnvPlaceholders(parsed, env, ['GITHUB_TOKEN']);
+    const parsedConfig = ConfigSchema.parse(resolved);
+    // Resolve GitHub token: config > env > gh CLI
+    let githubToken = parsedConfig.github_token;
+    if (!githubToken || githubToken.trim().length === 0) {
+        // Try gh CLI as fallback
+        githubToken = getGhCliToken();
+    }
+    if (!githubToken || githubToken.trim().length === 0) {
+        throw new Error('GitHub token not found. Provide github_token in config, set GITHUB_TOKEN env var, or authenticate with `gh auth login`');
+    }
+    const timezone = parsedConfig.timezone.trim().length > 0
+        ? parsedConfig.timezone
+        : Intl.DateTimeFormat().resolvedOptions().timeZone || 'UTC';
+    return ResolvedConfigSchema.parse({
+        ...parsedConfig,
+        github_token: githubToken,
+        timezone,
+        cache: {
+            ...parsedConfig.cache,
+            path: resolveCachePath(parsedConfig.cache.path, env),
+        },
+    });
+}
+function resolveEnvPlaceholders(value, env, allowMissing = []) {
+    if (Array.isArray(value)) {
+        return value.map((item) => resolveEnvPlaceholders(item, env, allowMissing));
+    }
+    if (value && typeof value === 'object') {
+        const entries = Object.entries(value);
+        return Object.fromEntries(entries.map(([key, val]) => [key, resolveEnvPlaceholders(val, env, allowMissing)]));
+    }
+    if (typeof value === 'string') {
+        return substituteEnv(value, env, allowMissing);
+    }
+    return value;
+}
+function substituteEnv(value, env, allowMissing = []) {
+    return value.replace(/\$\{([A-Z0-9_]+)\}/gi, (_, name) => {
+        const replacement = env[name];
+        if (!replacement || replacement.trim().length === 0) {
+            if (allowMissing.includes(name)) {
+                return ''; // Return empty string, will be handled by fallback logic
+            }
+            throw new Error(`Missing environment variable for ${name}`);
+        }
+        return replacement;
+    });
+}
+function expandHome(value) {
+    if (!value.startsWith('~')) {
+        return value;
+    }
+    return path.join(os.homedir(), value.slice(1));
+}
+export const CONFIG_SCHEMA = ConfigSchema;

package/dist/filters.cjs

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isBotUsername = isBotUsername;
+exports.isExcludedAuthor = isExcludedAuthor;
+function isBotUsername(username) {
+    return /\[bot\]$/i.test(username);
+}
+function isExcludedAuthor(username, exclude, excludeBots) {
+    if (exclude.has(username)) {
+        return true;
+    }
+    if (excludeBots && isBotUsername(username)) {
+        return true;
+    }
+    return false;
+}

package/dist/filters.d.cts

@@ -0,0 +1,3 @@
+import type { GitHubUsername } from "./types.cjs";
+export declare function isBotUsername(username: GitHubUsername): boolean;
+export declare function isExcludedAuthor(username: GitHubUsername, exclude: Set<GitHubUsername>, excludeBots: boolean): boolean;

package/dist/filters.d.ts

@@ -0,0 +1,3 @@
+import type { GitHubUsername } from "./types.js";
+export declare function isBotUsername(username: GitHubUsername): boolean;
+export declare function isExcludedAuthor(username: GitHubUsername, exclude: Set<GitHubUsername>, excludeBots: boolean): boolean;