@lucasviola/specwiki 1.0.0

package/dist/commands/generate.js

@@ -0,0 +1,197 @@
+import chalk from "chalk";
+import path from "node:path";
+import { DEFAULT_SPEC_PATTERNS } from "../config/patterns.js";
+import { log } from "../core/Logger.js";
+import { PathEscapeError, resolveOutputWithinProject } from "../core/paths.js";
+import { discoverSpecs } from "../discover/specs.js";
+import { parseSpecFile } from "../parse/markdown.js";
+import { writeLlmsTxt } from "../output/llms.js";
+import { buildWiki, writeHtmlWiki, writeWiki } from "../output/wiki.js";
+const ZERO_SPECS_TIP = "Tip: specwiki discovers .md and .mdc files anywhere in your project — AGENTS.md, .cursor/rules/, specs/, README.md, and similar paths.";
+function printZeroSpecsMessage() {
+    console.log(chalk.yellow("No spec files found."));
+    console.log(chalk.dim(ZERO_SPECS_TIP));
+}
+function createListJsonResult(specFiles) {
+    const categories = new Map();
+    for (const file of specFiles) {
+        const category = categories.get(file.category) ?? {
+            name: file.category,
+            files: [],
+        };
+        category.files.push({
+            relativePath: file.relativePath,
+            title: file.title,
+            category: file.category,
+        });
+        categories.set(file.category, category);
+    }
+    return {
+        categories: [...categories.values()].sort((left, right) => left.name.localeCompare(right.name)),
+    };
+}
+function createGenerateJsonResult(outputDir, pages) {
+    return {
+        specCount: pages.length,
+        outputDir,
+        pages: pages.map(({ slug, title, category, sourcePath, description }) => ({
+            slug,
+            title,
+            category,
+            sourcePath,
+            description,
+        })),
+    };
+}
+function printJsonResult(command, result) {
+    if ("categories" in result) {
+        log.info("output.json", {
+            command,
+            categoryCount: result.categories.length,
+            specCount: result.categories.reduce((count, category) => count + category.files.length, 0),
+        });
+    }
+    else {
+        log.info("output.json", {
+            command,
+            pageCount: result.pages.length,
+            specCount: result.specCount,
+        });
+    }
+    console.log(JSON.stringify(result));
+}
+function emitCliCommand(command, options) {
+    const patterns = options.patterns ?? DEFAULT_SPEC_PATTERNS;
+    const projectRoot = path.resolve(options.projectRoot);
+    log.info("cli.command", {
+        command,
+        projectRoot,
+        ...(command === "generate"
+            ? { outputDir: path.resolve(projectRoot, options.outputDir) }
+            : {}),
+        verbose: Boolean(options.verbose),
+        patternCount: patterns.length,
+    });
+}
+function propagateCliError(command, err) {
+    const message = err instanceof Error ? err.message : String(err);
+    log.error("cli.error", { command, message });
+    const error = err instanceof Error ? err : new Error(message);
+    error.cliErrorLogged = true;
+    throw error;
+}
+export async function generateWiki(options) {
+    log.setVerbose(Boolean(options.verbose));
+    const { projectRoot, outputDir } = options;
+    const resolvedProjectRoot = path.resolve(projectRoot);
+    emitCliCommand("generate", {
+        ...options,
+        projectRoot: resolvedProjectRoot,
+    });
+    try {
+        let resolvedOutput;
+        try {
+            resolvedOutput = await resolveOutputWithinProject(resolvedProjectRoot, outputDir);
+        }
+        catch (err) {
+            if (err instanceof PathEscapeError) {
+                log.error("output.error", { message: err.message });
+                propagateCliError("generate", err);
+            }
+            throw err;
+        }
+        const relativeOutput = path.relative(resolvedProjectRoot, resolvedOutput);
+        const outputIgnorePath = relativeOutput.length > 0 && !relativeOutput.startsWith("..")
+            ? relativeOutput
+            : undefined;
+        const specFiles = await discoverSpecs({
+            projectRoot: resolvedProjectRoot,
+            patterns: options.patterns,
+            ignorePaths: outputIgnorePath ? [outputIgnorePath] : undefined,
+        });
+        if (specFiles.length === 0) {
+            if (options.json) {
+                printJsonResult("generate", {
+                    specCount: 0,
+                    outputDir: resolvedOutput,
+                    pages: [],
+                });
+                return;
+            }
+            printZeroSpecsMessage();
+            return;
+        }
+        const parsed = await Promise.all(specFiles.map(parseSpecFile));
+        const wiki = buildWiki(parsed);
+        const written = await writeWiki(resolvedOutput, wiki);
+        const htmlWritten = await writeHtmlWiki(resolvedOutput, wiki, {
+            noSearch: options.noSearch,
+        });
+        if (options.emitLlmsTxt) {
+            await writeLlmsTxt(resolvedOutput, wiki.pages);
+        }
+        log.info("generate.summary", {
+            pageCount: wiki.pages.length,
+            markdownFiles: written.length,
+            htmlFiles: htmlWritten.length,
+        });
+        if (options.json) {
+            printJsonResult("generate", createGenerateJsonResult(resolvedOutput, wiki.pages));
+            return;
+        }
+        console.log(chalk.green(`✓ Generated wiki with ${wiki.pages.length} page(s)`));
+        console.log(chalk.dim(`  Markdown: ${resolvedOutput}/`));
+        console.log(chalk.dim(`  HTML:     ${resolvedOutput}/html/`));
+        console.log(chalk.dim(`  ${written.length + htmlWritten.length} files written`));
+    }
+    catch (err) {
+        propagateCliError("generate", err);
+    }
+}
+export async function listSpecs(options) {
+    log.setVerbose(Boolean(options.verbose));
+    const resolvedProjectRoot = path.resolve(options.projectRoot);
+    emitCliCommand("list", {
+        ...options,
+        projectRoot: resolvedProjectRoot,
+    });
+    try {
+        const specFiles = await discoverSpecs({
+            projectRoot: resolvedProjectRoot,
+            patterns: options.patterns,
+        });
+        if (specFiles.length === 0) {
+            if (options.json) {
+                printJsonResult("list", { categories: [] });
+                return;
+            }
+            printZeroSpecsMessage();
+            return;
+        }
+        if (options.json) {
+            printJsonResult("list", createListJsonResult(specFiles));
+            return;
+        }
+        const byCategory = new Map();
+        for (const file of specFiles) {
+            const list = byCategory.get(file.category) ?? [];
+            list.push(file);
+            byCategory.set(file.category, list);
+        }
+        console.log(chalk.bold(`Found ${specFiles.length} spec file(s):\n`));
+        for (const [category, files] of [...byCategory.entries()].sort()) {
+            console.log(chalk.cyan(category));
+            for (const file of files) {
+                console.log(`  ${file.title} — ${file.relativePath}`);
+            }
+            console.log();
+        }
+    }
+    catch (err) {
+        propagateCliError("list", err);
+    }
+}
+export function isCliErrorLogged(err) {
+    return err instanceof Error && err.cliErrorLogged === true;
+}
+//# sourceMappingURL=generate.js.map

package/dist/commands/generate.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,5 @@
+import type { InitOptions } from "../types.js";
+export declare function initConfig(options: InitOptions): Promise<void>;
+export declare function isInitErrorLogged(err: unknown): boolean;
+export declare function getInitExitCode(err: unknown): number;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AA6C/C,wBAAsB,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAsDpE;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAEvD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAKpD"}

package/dist/commands/init.js

@@ -0,0 +1,91 @@
+import chalk from "chalk";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { DEFAULT_SPEC_PATTERNS, validatePatternList, } from "../config/patterns.js";
+import { log } from "../core/Logger.js";
+const CONFIG_JSON = "specwiki.config.json";
+const CONFIG_JS = "specwiki.config.js";
+const CONFIG_EXISTS_MESSAGE = "Config file already exists. Use --force to overwrite specwiki.config.json.";
+const CONFIG_JS_EXISTS_MESSAGE = "specwiki.config.js already exists. Edit it manually or remove it before running --force.";
+function throwInitError(message, exitCode = 2) {
+    console.log(chalk.yellow(message));
+    log.error("init.error", { message });
+    const error = new Error(message);
+    error.exitCode = exitCode;
+    error.cliErrorLogged = true;
+    throw error;
+}
+function assertConfinedUnderProject(projectRoot, targetPath) {
+    const relative = path.relative(projectRoot, targetPath);
+    if (relative.startsWith("..") || path.isAbsolute(relative)) {
+        throwInitError("Config file must stay within the project root");
+    }
+}
+async function fileExists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function buildScaffoldContent() {
+    const patterns = validatePatternList([...DEFAULT_SPEC_PATTERNS]);
+    return `${JSON.stringify({ patterns }, null, 2)}\n`;
+}
+export async function initConfig(options) {
+    log.setVerbose(Boolean(options.verbose));
+    const resolvedProjectRoot = path.resolve(options.projectRoot);
+    if (options.verbose) {
+        log.info("cli.command", {
+            command: "init",
+            projectRoot: resolvedProjectRoot,
+            force: Boolean(options.force),
+            verbose: true,
+        });
+    }
+    const jsonPath = path.join(resolvedProjectRoot, CONFIG_JSON);
+    const jsPath = path.join(resolvedProjectRoot, CONFIG_JS);
+    assertConfinedUnderProject(resolvedProjectRoot, jsonPath);
+    const jsExists = await fileExists(jsPath);
+    const jsonExists = await fileExists(jsonPath);
+    if (jsExists) {
+        throwInitError(CONFIG_JS_EXISTS_MESSAGE);
+    }
+    if (jsonExists && !options.force) {
+        throwInitError(CONFIG_EXISTS_MESSAGE);
+    }
+    let content;
+    try {
+        content = buildScaffoldContent();
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : "Failed to build config scaffold";
+        throwInitError(message);
+    }
+    try {
+        await fs.mkdir(resolvedProjectRoot, { recursive: true });
+        await fs.writeFile(jsonPath, content, "utf-8");
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : "Failed to write config file";
+        throwInitError(message, 1);
+    }
+    if (options.verbose) {
+        log.info("init.write", { sourcePath: CONFIG_JSON });
+    }
+    console.log(chalk.green(`Created ${CONFIG_JSON}`));
+    console.log(chalk.dim(`  ${jsonPath}`));
+    console.log(chalk.dim("Next: specwiki list, then specwiki generate"));
+}
+export function isInitErrorLogged(err) {
+    return err instanceof Error && err.cliErrorLogged === true;
+}
+export function getInitExitCode(err) {
+    if (err instanceof Error && typeof err.exitCode === "number") {
+        return err.exitCode;
+    }
+    return 1;
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/open.d.ts

@@ -0,0 +1,8 @@
+import type { OpenOptions } from "../types.js";
+type LaunchHandler = (command: string, args: string[]) => Promise<void>;
+export declare function setLaunchHandlerForTests(handler: LaunchHandler): void;
+export declare function resetLaunchHandlerForTests(): void;
+export declare function openWiki(options: OpenOptions): Promise<void>;
+export declare function isOpenErrorLogged(err: unknown): boolean;
+export {};
+//# sourceMappingURL=open.d.ts.map

package/dist/commands/open.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open.d.ts","sourceRoot":"","sources":["../../src/commands/open.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAQ/C,KAAK,aAAa,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAOxE,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAErE;AAED,wBAAgB,0BAA0B,IAAI,IAAI,CAIjD;AA2FD,wBAAsB,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA6DlE;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAEvD"}

package/dist/commands/open.js

@@ -0,0 +1,150 @@
+import chalk from "chalk";
+import { execFile } from "node:child_process";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { promisify } from "node:util";
+import { log } from "../core/Logger.js";
+import { assertConfinedUnder as assertConfinedUnderPath, assertRealpathConfinedUnder as assertRealpathConfinedUnderPath, PathEscapeError, resolveOutputWithinProject, } from "../core/paths.js";
+const execFileAsync = promisify(execFile);
+const INDEX_RELATIVE_PATH = path.join("html", "index.html");
+const MISSING_INDEX_MESSAGE = "Wiki index not found. Run `specwiki generate` first.";
+let launchHandler = async (command, args) => {
+    await execFileAsync(command, args);
+};
+export function setLaunchHandlerForTests(handler) {
+    launchHandler = handler;
+}
+export function resetLaunchHandlerForTests() {
+    launchHandler = async (command, args) => {
+        await execFileAsync(command, args);
+    };
+}
+function throwOpenError(message) {
+    console.log(chalk.yellow(message));
+    const error = new Error(message);
+    error.cliErrorLogged = true;
+    throw error;
+}
+function handlePathEscape(label, err) {
+    if (err instanceof PathEscapeError) {
+        log.error("open.error", {
+            message: `Path escapes allowed directory: ${label}`,
+        });
+        throwOpenError(err.message);
+    }
+    throw err;
+}
+function assertConfinedUnder(root, target, label) {
+    try {
+        assertConfinedUnderPath(root, target, label);
+    }
+    catch (err) {
+        handlePathEscape(label, err);
+    }
+}
+async function assertRealpathConfinedUnder(root, target, label) {
+    try {
+        await assertRealpathConfinedUnderPath(root, target, label);
+    }
+    catch (err) {
+        if (err.code === "ENOENT") {
+            return;
+        }
+        if (err instanceof Error && err.cliErrorLogged) {
+            throw err;
+        }
+        if (err instanceof PathEscapeError) {
+            handlePathEscape(label, err);
+        }
+        const message = err instanceof Error ? err.message : String(err);
+        log.error("open.error", { message });
+        throwOpenError(message);
+    }
+}
+async function resolveIndexPath(projectRoot, outputDir) {
+    let resolvedOutput;
+    try {
+        resolvedOutput = await resolveOutputWithinProject(projectRoot, outputDir);
+    }
+    catch (err) {
+        handlePathEscape("output directory", err);
+    }
+    const indexPath = path.join(resolvedOutput, INDEX_RELATIVE_PATH);
+    assertConfinedUnder(resolvedOutput, indexPath, INDEX_RELATIVE_PATH);
+    return indexPath;
+}
+function getBrowserLauncher() {
+    switch (process.platform) {
+        case "darwin":
+            return { command: "open", buildArgs: (indexPath) => [indexPath] };
+        case "win32":
+            return {
+                command: "cmd",
+                buildArgs: (indexPath) => ["/c", "start", "", indexPath],
+            };
+        default:
+            return {
+                command: "xdg-open",
+                buildArgs: (indexPath) => [indexPath],
+            };
+    }
+}
+export async function openWiki(options) {
+    log.setVerbose(Boolean(options.verbose));
+    const resolvedProjectRoot = path.resolve(options.projectRoot);
+    const resolvedOutput = path.resolve(resolvedProjectRoot, options.outputDir);
+    log.info("cli.command", {
+        command: "open",
+        projectRoot: resolvedProjectRoot,
+        outputDir: resolvedOutput,
+        verbose: Boolean(options.verbose),
+    });
+    let indexPath;
+    try {
+        indexPath = await resolveIndexPath(resolvedProjectRoot, options.outputDir);
+    }
+    catch (err) {
+        if (err instanceof Error && err.cliErrorLogged) {
+            throw err;
+        }
+        const message = err instanceof Error ? err.message : String(err);
+        log.error("open.error", { message });
+        throwOpenError(message);
+    }
+    try {
+        await fs.access(indexPath);
+        await assertRealpathConfinedUnder(resolvedProjectRoot, indexPath, INDEX_RELATIVE_PATH);
+    }
+    catch (err) {
+        if (err instanceof Error && err.cliErrorLogged) {
+            throw err;
+        }
+        const code = err.code;
+        if (code === "ENOENT") {
+            log.error("open.error", {
+                message: MISSING_INDEX_MESSAGE,
+                indexPath,
+            });
+            throwOpenError(MISSING_INDEX_MESSAGE);
+        }
+        const message = err instanceof Error ? err.message : String(err);
+        log.error("open.error", { message, indexPath });
+        throwOpenError(`Cannot access wiki index: ${message}`);
+    }
+    const { command, buildArgs } = getBrowserLauncher();
+    try {
+        await launchHandler(command, buildArgs(indexPath));
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        log.error("open.error", { message, indexPath });
+        throwOpenError(`Failed to open browser: ${message}`);
+    }
+    log.info("open.launch", { indexPath });
+    console.log(chalk.green("Opened wiki in browser"));
+    console.log(chalk.dim(`  ${indexPath}`));
+}
+export function isOpenErrorLogged(err) {
+    return err instanceof Error && err.cliErrorLogged === true;
+}
+//# sourceMappingURL=open.js.map

package/dist/commands/open.js.map

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

package/dist/config/loader.d.ts

@@ -0,0 +1,20 @@
+export interface SpecwikiConfig {
+    patterns?: string[];
+}
+export interface ResolvedPatterns {
+    patterns?: string[];
+    configSource?: string;
+}
+export declare class ConfigError extends Error {
+    constructor(message: string);
+}
+export declare function loadProjectConfig(projectRoot: string): Promise<{
+    config: SpecwikiConfig;
+    sourcePath: string;
+} | null>;
+export declare function resolvePatternsFromEnv(): string[] | undefined;
+export declare function resolveEffectivePatterns(options: {
+    projectRoot: string;
+    cliPatterns?: string[];
+}): Promise<ResolvedPatterns>;
+//# 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":"AAKA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AA4CD,qBAAa,WAAY,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM;CAI5B;AA6BD,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAwDhE;AAED,wBAAgB,sBAAsB,IAAI,MAAM,EAAE,GAAG,SAAS,CAa7D;AAED,wBAAsB,wBAAwB,CAAC,OAAO,EAAE;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAmB5B"}

package/dist/config/loader.js

@@ -0,0 +1,143 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import { parsePatternList, validatePatternList } from "./patterns.js";
+const CONFIG_CANDIDATES = [
+    "specwiki.config.js",
+    "specwiki.config.json",
+];
+function assertConfigPathWithinProject(projectRoot, configPath, realConfigPath) {
+    const relative = path.relative(projectRoot, realConfigPath);
+    if (relative.startsWith("..") || path.isAbsolute(relative)) {
+        throw new ConfigError("Config file must stay within the project root");
+    }
+    if (path.basename(realConfigPath) !== path.basename(configPath)) {
+        throw new ConfigError("Config file must stay within the project root");
+    }
+}
+async function resolveConfigPath(projectRoot, filename) {
+    const resolvedProjectRoot = path.resolve(projectRoot);
+    const configPath = path.join(resolvedProjectRoot, filename);
+    const realProjectRoot = await fs.realpath(resolvedProjectRoot);
+    const realConfigPath = await fs.realpath(configPath);
+    assertConfigPathWithinProject(realProjectRoot, configPath, realConfigPath);
+    return realConfigPath;
+}
+function loadConfigFailureMessage(filename, kind) {
+    if (kind === "json") {
+        return `Invalid JSON in ${filename}`;
+    }
+    return `Failed to load ${filename}`;
+}
+export class ConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ConfigError";
+    }
+}
+function normalizeConfig(raw) {
+    if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
+        throw new ConfigError("Config must export a plain object");
+    }
+    const config = raw;
+    if (config.patterns === undefined) {
+        return {};
+    }
+    if (!Array.isArray(config.patterns)) {
+        throw new ConfigError("Config patterns must be an array of glob strings");
+    }
+    if (!config.patterns.every((pattern) => typeof pattern === "string")) {
+        throw new ConfigError("Config patterns must be an array of glob strings");
+    }
+    try {
+        return { patterns: validatePatternList(config.patterns) };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : "Invalid config patterns";
+        throw new ConfigError(message);
+    }
+}
+export async function loadProjectConfig(projectRoot) {
+    for (const filename of CONFIG_CANDIDATES) {
+        const configPath = path.join(projectRoot, filename);
+        try {
+            await fs.access(configPath);
+        }
+        catch {
+            continue;
+        }
+        try {
+            const resolvedConfigPath = await resolveConfigPath(projectRoot, filename);
+            if (filename.endsWith(".json")) {
+                let raw;
+                try {
+                    raw = JSON.parse(await fs.readFile(resolvedConfigPath, "utf-8"));
+                }
+                catch (err) {
+                    if (err instanceof SyntaxError) {
+                        throw new ConfigError(loadConfigFailureMessage(filename, "json"));
+                    }
+                    throw new ConfigError(loadConfigFailureMessage(filename, "json"));
+                }
+                return {
+                    config: normalizeConfig(raw),
+                    sourcePath: filename,
+                };
+            }
+            let module;
+            try {
+                module = await import(pathToFileURL(resolvedConfigPath).href);
+            }
+            catch (err) {
+                if (err instanceof SyntaxError) {
+                    throw new ConfigError(`Invalid JavaScript in ${filename}`);
+                }
+                throw new ConfigError(loadConfigFailureMessage(filename, "js"));
+            }
+            const exported = module.default ?? module;
+            return {
+                config: normalizeConfig(exported),
+                sourcePath: filename,
+            };
+        }
+        catch (err) {
+            if (err instanceof ConfigError) {
+                throw err;
+            }
+            const kind = filename.endsWith(".json") ? "json" : "js";
+            throw new ConfigError(loadConfigFailureMessage(filename, kind));
+        }
+    }
+    return null;
+}
+export function resolvePatternsFromEnv() {
+    const value = process.env.SPECWIKI_PATTERNS;
+    if (value === undefined || value.trim().length === 0) {
+        return undefined;
+    }
+    try {
+        return parsePatternList(value);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : "Invalid SPECWIKI_PATTERNS";
+        throw new ConfigError(message);
+    }
+}
+export async function resolveEffectivePatterns(options) {
+    if (options.cliPatterns) {
+        return { patterns: options.cliPatterns };
+    }
+    const envPatterns = resolvePatternsFromEnv();
+    if (envPatterns) {
+        return { patterns: envPatterns };
+    }
+    const loaded = await loadProjectConfig(options.projectRoot);
+    if (loaded) {
+        return {
+            patterns: loaded.config.patterns,
+            configSource: loaded.sourcePath,
+        };
+    }
+    return {};
+}
+//# sourceMappingURL=loader.js.map