@ai-agent-context/core 0.1.0

package/dist/pipeline/scan-pipeline.js

@@ -0,0 +1,270 @@
+import { loadConfig } from "../config/load.js";
+import { DiagnosticsCollector, Logger } from "../logging/diagnostics.js";
+import { SCHEMA_VERSION } from "../model/schema.js";
+import { compareStrings } from "../model/canonical.js";
+import { FileSystemAdapter } from "../adapters/filesystem/fs-adapter.js";
+import { GitAdapter } from "../adapters/git/git-adapter.js";
+import { scanRepository } from "../core/scanner/scanner.js";
+import { LocalStateStore, ParseCache } from "../core/scanner/cache.js";
+import { detectWorkspace } from "../core/workspace/workspace.js";
+import { packageFactsFromParsed } from "../core/workspace/package-facts.js";
+import { buildKnowledgeGraph } from "../core/graph/knowledge-graph.js";
+import { applyArchitectureDetection } from "../core/architecture/detector.js";
+import { computeGitActivity, applyGitSignals } from "../core/git-analysis/activity.js";
+import { detectConventions } from "../core/conventions/detector.js";
+import { detectDecisions } from "../core/decisions/detector.js";
+import { buildContextDocuments } from "../core/serialization/documents.js";
+import { readPersistedContext } from "../core/serialization/reader.js";
+import { writeContext } from "../core/serialization/writer.js";
+import { diffContext, hashDocuments } from "../core/diff/differ.js";
+import { transitiveDependents } from "../core/context/explain.js";
+/** Rebuilds the workspace model from the parsed `package.json` files. */
+export function detectWorkspaceFromScan(scan) {
+    const packageJsonFiles = [];
+    for (const [filePath, parsed] of scan.parsed) {
+        const facts = packageFactsFromParsed(parsed);
+        if (facts === null)
+            continue;
+        const isEmpty = facts.name === null &&
+            facts.entries.length === 0 &&
+            facts.dependencies.length === 0 &&
+            Object.keys(facts.scripts).length === 0;
+        if (isEmpty)
+            continue;
+        packageJsonFiles.push({ path: filePath, facts });
+    }
+    packageJsonFiles.sort((a, b) => compareStrings(a.path, b.path));
+    return detectWorkspace({
+        packageJsonFiles,
+        presentFiles: scan.presentFiles,
+        pnpmWorkspaceYaml: scan.pnpmWorkspaceYaml,
+    });
+}
+function buildReport(options) {
+    const { scan, graph, diagnostics } = options;
+    const moduleByFile = new Map(scan.files.map((file) => [file.path, file.moduleId]));
+    const changedFiles = [...scan.changes.added, ...scan.changes.modified].sort(compareStrings);
+    const affectedModules = new Set();
+    const dependents = new Set();
+    for (const file of changedFiles) {
+        const moduleId = moduleByFile.get(file) ?? null;
+        if (moduleId === null)
+            continue;
+        affectedModules.add(moduleId);
+        for (const dependent of transitiveDependents(graph, moduleId, 1))
+            dependents.add(dependent);
+    }
+    const files = scan.files;
+    return {
+        changes: scan.changes,
+        files: {
+            total: files.length,
+            source: files.filter((file) => file.kind === 'source').length,
+            tests: files.filter((file) => file.kind === 'test').length,
+            skipped: files.filter((file) => file.parseStatus === 'skipped').length,
+            failed: files.filter((file) => file.parseStatus === 'failed').length,
+        },
+        modules: graph.repository.modules.length,
+        dependencies: graph.repository.dependencies.length,
+        externalDependencies: graph.repository.externalDependencies.length,
+        entryPoints: graph.repository.entryPoints.length,
+        conventions: graph.repository.conventions.length,
+        decisions: graph.repository.decisions.length,
+        parsed: options.parsedNow,
+        reused: options.reused,
+        affected: {
+            files: changedFiles,
+            modules: [...affectedModules].sort(compareStrings),
+            dependents: [...dependents].sort(compareStrings),
+        },
+        durationMs: options.durationMs,
+        warnings: diagnostics.list(),
+    };
+}
+function emptyState(configHash, counts) {
+    return {
+        schemaVersion: SCHEMA_VERSION,
+        generatedBy: 'ai-agent-context',
+        toolVersion: '0.0.0',
+        lastScanAt: null,
+        configHash,
+        counts,
+        files: {},
+        canonical: {},
+    };
+}
+/** Runs the whole pipeline. */
+export async function runPipeline(options) {
+    const startedAt = options.now?.() ?? Date.now();
+    const logger = options.logger ?? new Logger({ level: 'warn' });
+    const diagnostics = new DiagnosticsCollector({ logger });
+    const now = options.now ?? (() => Date.now());
+    const loaded = await loadConfig({
+        root: options.root,
+        ...(options.overrides === undefined ? {} : { overrides: options.overrides }),
+        ...(options.configPath === undefined ? {} : { configPath: options.configPath }),
+    });
+    for (const warning of loaded.warnings)
+        diagnostics.warn('WARN_CONFIG', warning);
+    const root = options.root;
+    const stateStore = new LocalStateStore(root);
+    const cache = new ParseCache(root);
+    const previousState = options.force === true ? null : await stateStore.read();
+    const persisted = await readPersistedContext(root);
+    for (const invalid of persisted.invalid) {
+        diagnostics.warn('WARN_CONTEXT_FILE', `${invalid.file}: ${invalid.reason}`, {
+            hint: 'Run: agent-context scan to regenerate the context.',
+        });
+    }
+    const fsAdapter = new FileSystemAdapter(root);
+    options.progress?.({ phase: 'start', message: 'Scanning repository...' });
+    const scan = await scanRepository({
+        root,
+        config: loaded.config,
+        configHash: loaded.hash,
+        ...(options.registry === undefined ? {} : { registry: options.registry }),
+        fsAdapter,
+        state: previousState,
+        cache,
+        diagnostics,
+        logger,
+        ...(options.progress === undefined ? {} : { progress: options.progress }),
+    });
+    const workspace = detectWorkspaceFromScan(scan);
+    const graph = buildKnowledgeGraph({
+        root,
+        repositoryName: fsAdapter.basename,
+        scan,
+        workspace,
+        moduleDepth: loaded.config.analysis.moduleDepth,
+        schemaVersion: SCHEMA_VERSION,
+        languages: loaded.config.languages,
+    });
+    options.progress?.({ phase: 'architecture', message: 'Detecting modules, entry points and roles...' });
+    applyArchitectureDetection(graph, scan.parsed);
+    const gitResult = await analyzeGit({
+        graph,
+        config: loaded.config,
+        root,
+        now,
+        logger,
+        diagnostics,
+        ...(options.gitAdapter === undefined ? {} : { gitAdapter: options.gitAdapter }),
+    });
+    if (loaded.config.features.conventions) {
+        graph.repository.conventions = detectConventions({
+            repository: graph.repository,
+            parsed: scan.parsed,
+            aliases: graph.aliases,
+        });
+    }
+    if (loaded.config.features.decisions) {
+        graph.repository.decisions = detectDecisions({
+            repository: graph.repository,
+            parsed: scan.parsed,
+            gitCommits: gitResult.commits,
+            architectureSignalPatterns: loaded.config.features.git
+                ? loaded.config.analysis.git.architectureSignalPatterns
+                : [],
+        });
+    }
+    const generatedAt = loaded.config.output.includeTimestamp ? new Date(now()).toISOString() : undefined;
+    const documents = buildContextDocuments(graph, scan.parsed, loaded.config, {
+        ...(generatedAt === undefined ? {} : { generatedAt }),
+        diagnostics: diagnostics.list(),
+        commitsAnalyzed: gitResult.commits.length,
+    });
+    const diff = diffContext({
+        previous: persisted,
+        current: documents,
+        baselineHash: previousState?.canonical['index.json'] ?? null,
+    });
+    let written = null;
+    if (options.dryRun !== true)
+        written = await writeContext(root, documents, loaded.config);
+    const report = buildReport({
+        scan,
+        graph,
+        parsedNow: scan.parsedNow,
+        reused: scan.reused,
+        diagnostics,
+        durationMs: Math.max(0, (options.now?.() ?? Date.now()) - startedAt),
+    });
+    const counts = {
+        files: report.files.total,
+        modules: report.modules,
+        dependencies: report.dependencies,
+        entryPoints: report.entryPoints,
+        conventions: report.conventions,
+        decisions: report.decisions,
+    };
+    const state = previousState === null ? emptyState(loaded.hash, counts) : { ...previousState };
+    state.schemaVersion = SCHEMA_VERSION;
+    state.configHash = loaded.hash;
+    state.counts = counts;
+    state.lastScanAt = new Date(now()).toISOString();
+    state.files = {};
+    for (const file of graph.repository.files) {
+        if (file.sensitive)
+            continue;
+        state.files[file.path] = {
+            hash: file.hash,
+            size: file.size,
+            mtimeMs: file.mtimeMs,
+            language: file.language,
+            kind: file.kind,
+        };
+    }
+    if (options.dryRun !== true) {
+        state.canonical = written === null ? state.canonical : { ...state.canonical, ...written.hashes };
+        await stateStore.write(state);
+    }
+    options.progress?.({ phase: 'done', message: 'Context updated.' });
+    return {
+        config: loaded.config,
+        configHash: loaded.hash,
+        graph,
+        parsed: scan.parsed,
+        documents,
+        report,
+        diff,
+        persisted,
+        written,
+        state,
+        workspace,
+        git: { availability: gitResult.availability, commitsAnalyzed: gitResult.commits.length },
+        diagnostics,
+    };
+}
+/** Optional git enrichment; never fails the scan. */
+async function analyzeGit(options) {
+    if (!options.config.features.git) {
+        return { availability: { available: false, reason: 'feature disabled in .agent/config.json' }, commits: [] };
+    }
+    const adapter = options.gitAdapter ?? new GitAdapter(options.root);
+    const availability = await adapter.probe();
+    if (availability.available !== true) {
+        options.diagnostics.info('INFO_GIT_UNAVAILABLE', `git signals unavailable: ${availability.reason ?? 'not a git repository'}`, { hint: 'Analysis continues without git activity data.' });
+        return { availability, commits: [] };
+    }
+    const commits = await adapter.log({
+        windowDays: options.config.analysis.git.windowDays,
+        maxCommits: options.config.analysis.git.maxCommits,
+    });
+    const activity = computeGitActivity({
+        commits,
+        files: options.graph.repository.files,
+        modules: options.graph.repository.modules,
+        recentDays: options.config.analysis.git.recentDays,
+        architectureSignalPatterns: options.config.analysis.git.architectureSignalPatterns,
+        now: options.now(),
+    });
+    applyGitSignals(options.graph.repository.modules, activity);
+    options.logger.verbose(`git: analyzed ${activity.commitCount} commit(s) from the last ${options.config.analysis.git.windowDays} days`);
+    return { availability, commits };
+}
+/** Stable hash of the canonical documents; used by `status`. */
+export function documentHash(documents) {
+    return hashDocuments(documents);
+}
+//# sourceMappingURL=scan-pipeline.js.map

package/dist/pipeline/scan-pipeline.js.map

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

package/dist/util/concurrency.d.ts

@@ -0,0 +1,17 @@
+export declare function defaultConcurrency(): number;
+export interface ConcurrencyResult<T> {
+    items: T[];
+    errors: Array<{
+        index: number;
+        error: unknown;
+    }>;
+}
+/**
+ * Maps items with a bounded number of in-flight tasks, preserving input order in
+ * the result. Failures are collected instead of aborting the run: one unreadable
+ * file must never break a repository scan.
+ */
+export declare function mapWithConcurrency<TInput, TOutput>(items: readonly TInput[], limit: number, mapper: (item: TInput, index: number) => Promise<TOutput>): Promise<ConcurrencyResult<TOutput>>;
+/** Runs tasks with bounded concurrency, ignoring the results. */
+export declare function runWithConcurrency(limit: number, tasks: Array<() => Promise<void>>): Promise<void>;
+//# sourceMappingURL=concurrency.d.ts.map

package/dist/util/concurrency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.d.ts","sourceRoot":"","sources":["../../src/util/concurrency.ts"],"names":[],"mappings":"AASA,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAClD;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,OAAO,EACtD,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GACxD,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAqBrC;AAED,iEAAiE;AACjE,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAKxG"}

package/dist/util/concurrency.js

@@ -0,0 +1,46 @@
+/**
+ * Bounded concurrency helpers.
+ *
+ * The scanner must handle repositories with 100k+ files without opening all of
+ * them at once, so every I/O fan-out goes through {@link mapWithConcurrency}
+ * with a configurable limit (default: min(cpus, 8)).
+ */
+import { availableParallelism } from 'node:os';
+export function defaultConcurrency() {
+    return Math.max(1, Math.min(availableParallelism() - 1, 8));
+}
+/**
+ * Maps items with a bounded number of in-flight tasks, preserving input order in
+ * the result. Failures are collected instead of aborting the run: one unreadable
+ * file must never break a repository scan.
+ */
+export async function mapWithConcurrency(items, limit, mapper) {
+    const effectiveLimit = Math.max(1, Math.min(limit, items.length || 1));
+    const results = new Array(items.length);
+    const errors = [];
+    let cursor = 0;
+    async function worker() {
+        for (;;) {
+            const index = cursor;
+            cursor += 1;
+            if (index >= items.length)
+                return;
+            try {
+                results[index] = await mapper(items[index], index);
+            }
+            catch (error) {
+                errors.push({ index, error });
+            }
+        }
+    }
+    await Promise.all(Array.from({ length: effectiveLimit }, () => worker()));
+    return { items: results.filter((item) => item !== undefined), errors };
+}
+/** Runs tasks with bounded concurrency, ignoring the results. */
+export async function runWithConcurrency(limit, tasks) {
+    await mapWithConcurrency(tasks, limit, async (task) => {
+        await task();
+        return undefined;
+    });
+}
+//# sourceMappingURL=concurrency.js.map

package/dist/util/concurrency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.js","sourceRoot":"","sources":["../../src/util/concurrency.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAE/C,MAAM,UAAU,kBAAkB;IAChC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,oBAAoB,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAC9D,CAAC;AAOD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAwB,EACxB,KAAa,EACb,MAAyD;IAEzD,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC;IACvE,MAAM,OAAO,GAAG,IAAI,KAAK,CAAU,KAAK,CAAC,MAAM,CAAC,CAAC;IACjD,MAAM,MAAM,GAA6C,EAAE,CAAC;IAC5D,IAAI,MAAM,GAAG,CAAC,CAAC;IAEf,KAAK,UAAU,MAAM;QACnB,SAAS,CAAC;YACR,MAAM,KAAK,GAAG,MAAM,CAAC;YACrB,MAAM,IAAI,CAAC,CAAC;YACZ,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM;gBAAE,OAAO;YAClC,IAAI,CAAC;gBACH,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,KAAK,CAAE,EAAE,KAAK,CAAC,CAAC;YACtD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC1E,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;AACzE,CAAC;AAED,iEAAiE;AACjE,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,KAAa,EAAE,KAAiC;IACvF,MAAM,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACpD,MAAM,IAAI,EAAE,CAAC;QACb,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/util/glob.d.ts

@@ -0,0 +1,26 @@
+export interface CompiledRule {
+    raw: string;
+    negated: boolean;
+    /** `true` when the rule also matches paths below a matched directory. */
+    directoryScoped: boolean;
+    regex: RegExp;
+}
+export declare function compileRule(rawPattern: string): CompiledRule;
+/** Ordered set of include/exclude glob rules with `.gitignore`-like semantics. */
+export declare class PatternSet {
+    readonly rules: CompiledRule[];
+    constructor(patterns?: readonly string[]);
+    get isEmpty(): boolean;
+    /**
+     * Evaluates rules in declaration order; the last matching rule wins (as in
+     * `.gitignore`). Directory-scoped rules also match descendants.
+     */
+    test(path: string, isDirectory?: boolean): boolean;
+    /** `true` when at least one positive pattern matches the path. */
+    matchesAny(path: string): boolean;
+    /** Sorted, deduplicated list of the configured patterns. */
+    toArray(): string[];
+}
+/** Convenience wrapper returning a single-pattern predicate. */
+export declare function compileGlob(pattern: string): (path: string) => boolean;
+//# sourceMappingURL=glob.d.ts.map

package/dist/util/glob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.d.ts","sourceRoot":"","sources":["../../src/util/glob.ts"],"names":[],"mappings":"AAkHA,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,yEAAyE;IACzE,eAAe,EAAE,OAAO,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;CACf;AAMD,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,CA0B5D;AAWD,kFAAkF;AAClF,qBAAa,UAAU;IACrB,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,CAAC;gBAEnB,QAAQ,GAAE,SAAS,MAAM,EAAO;IAI5C,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,UAAQ,GAAG,OAAO;IAgBhD,kEAAkE;IAClE,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAKjC,4DAA4D;IAC5D,OAAO,IAAI,MAAM,EAAE;CAGpB;AAED,gEAAgE;AAChE,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAGtE"}

package/dist/util/glob.js

@@ -0,0 +1,198 @@
+/**
+ * Minimal, dependency-free glob engine.
+ *
+ * Supported syntax (a documented subset of gitignore/minimatch semantics):
+ *
+ * | Pattern         | Meaning                                                       |
+ * | --------------- | ------------------------------------------------------------- |
+ * | `*`             | any characters inside a single path segment                    |
+ * | `**`            | any number of path segments                                    |
+ * | `?`             | a single character inside a segment                            |
+ * | `[abc]`/`[!ab]` | character class / negated character class                      |
+ * | `{a,b}`         | alternation                                                    |
+ * | `prefix/**`     | everything below `prefix`, including the directory itself      |
+ * | `name/`         | the directory `name` and everything below it                   |
+ * | `!pattern`      | negation; the last matching rule wins (see {@link PatternSet}) |
+ *
+ * Patterns without a `/` match by basename at any depth.
+ */
+import { compareStrings } from "../model/canonical.js";
+const REGEXP_SPECIALS = new Set(['.', '+', '(', ')', '|', '^', '$', '\\', '/']);
+function escapeLiteral(character) {
+    return REGEXP_SPECIALS.has(character) ? `\\${character}` : character;
+}
+function findMatchingBrace(pattern, openIndex) {
+    let depth = 0;
+    for (let index = openIndex; index < pattern.length; index += 1) {
+        const character = pattern[index];
+        if (character === '{')
+            depth += 1;
+        else if (character === '}') {
+            depth -= 1;
+            if (depth === 0)
+                return index;
+        }
+    }
+    return -1;
+}
+function splitAlternatives(body) {
+    const parts = [];
+    let depth = 0;
+    let current = '';
+    for (const character of body) {
+        if (character === '{')
+            depth += 1;
+        if (character === '}')
+            depth -= 1;
+        if (character === ',' && depth === 0) {
+            parts.push(current);
+            current = '';
+            continue;
+        }
+        current += character;
+    }
+    parts.push(current);
+    return parts;
+}
+function translatePattern(pattern) {
+    let output = '';
+    let index = 0;
+    while (index < pattern.length) {
+        const character = pattern[index];
+        if (character === '*') {
+            if (pattern[index + 1] === '*') {
+                index += 2;
+                // `**/` and `a/**/b` mean "zero or more segments"
+                if (pattern[index] === '/') {
+                    output += '(?:[^/]*/)*';
+                    index += 1;
+                }
+                else {
+                    output += '.*';
+                }
+                continue;
+            }
+            output += '[^/]*';
+            index += 1;
+            continue;
+        }
+        if (character === '?') {
+            output += '[^/]';
+            index += 1;
+            continue;
+        }
+        if (character === '[') {
+            const closing = pattern.indexOf(']', index + 1);
+            if (closing === -1) {
+                output += '\\[';
+                index += 1;
+                continue;
+            }
+            let body = pattern.slice(index + 1, closing);
+            if (body.startsWith('!'))
+                body = `^${body.slice(1)}`;
+            output += `[${body.replace(/\\/g, '\\\\')}]`;
+            index = closing + 1;
+            continue;
+        }
+        if (character === '{') {
+            const closing = findMatchingBrace(pattern, index);
+            if (closing !== -1) {
+                const alternatives = splitAlternatives(pattern.slice(index + 1, closing));
+                output += `(?:${alternatives.map((alternative) => translatePattern(alternative)).join('|')})`;
+                index = closing + 1;
+                continue;
+            }
+            output += '\\{';
+            index += 1;
+            continue;
+        }
+        output += escapeLiteral(character);
+        index += 1;
+    }
+    return output;
+}
+function normalizePatternPath(path) {
+    return path.replace(/\\/g, '/').replace(/^\.\//, '').replace(/^\/+/, '').replace(/\/+$/, '');
+}
+export function compileRule(rawPattern) {
+    let pattern = rawPattern.trim();
+    let negated = false;
+    if (pattern.startsWith('!')) {
+        negated = true;
+        pattern = pattern.slice(1);
+    }
+    let directoryScoped = false;
+    if (pattern.endsWith('/')) {
+        pattern = pattern.slice(0, -1);
+        directoryScoped = true;
+    }
+    if (pattern.endsWith('/**')) {
+        pattern = pattern.slice(0, -3);
+        directoryScoped = true;
+    }
+    const hasSlash = pattern.includes('/');
+    const body = translatePattern(pattern);
+    const prefix = hasSlash ? '^' : '^(?:.*/)?';
+    const suffix = directoryScoped ? '(?:/.*)?$' : '$';
+    return {
+        raw: rawPattern,
+        negated,
+        directoryScoped,
+        regex: new RegExp(`${prefix}${body}${suffix}`),
+    };
+}
+function ancestorPaths(path) {
+    const parts = path.split('/').filter((segment) => segment.length > 0);
+    const result = [];
+    for (let index = 1; index < parts.length; index += 1) {
+        result.push(parts.slice(0, index).join('/'));
+    }
+    return result;
+}
+/** Ordered set of include/exclude glob rules with `.gitignore`-like semantics. */
+export class PatternSet {
+    rules;
+    constructor(patterns = []) {
+        this.rules = patterns.filter((pattern) => pattern.trim().length > 0).map(compileRule);
+    }
+    get isEmpty() {
+        return this.rules.length === 0;
+    }
+    /**
+     * Evaluates rules in declaration order; the last matching rule wins (as in
+     * `.gitignore`). Directory-scoped rules also match descendants.
+     */
+    test(path, isDirectory = false) {
+        const normalized = normalizePatternPath(path);
+        if (normalized.length === 0)
+            return false;
+        const parents = ancestorPaths(normalized);
+        let ignored = false;
+        for (const rule of this.rules) {
+            let matched = rule.regex.test(normalized);
+            if (!matched && rule.directoryScoped) {
+                matched = parents.some((ancestor) => rule.regex.test(ancestor));
+            }
+            if (matched)
+                ignored = !rule.negated;
+        }
+        void isDirectory;
+        return ignored;
+    }
+    /** `true` when at least one positive pattern matches the path. */
+    matchesAny(path) {
+        const normalized = normalizePatternPath(path);
+        return this.rules.some((rule) => !rule.negated && rule.regex.test(normalized));
+    }
+    /** Sorted, deduplicated list of the configured patterns. */
+    toArray() {
+        return [...new Set(this.rules.map((rule) => rule.raw))].sort(compareStrings);
+    }
+}
+/** Convenience wrapper returning a single-pattern predicate. */
+export function compileGlob(pattern) {
+    const rule = compileRule(pattern);
+    return (path) => rule.regex.test(normalizePatternPath(path));
+}
+//# sourceMappingURL=glob.js.map

package/dist/util/glob.js.map

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

package/dist/util/paths.d.ts

@@ -0,0 +1,23 @@
+export declare function toPosix(path: string): string;
+export declare function normalizeRelative(path: string): string;
+export declare function dirname(path: string): string;
+export declare function basename(path: string): string;
+export declare function extname(path: string): string;
+export declare function stem(path: string): string;
+export declare function join(...parts: string[]): string;
+export declare function segments(path: string): string[];
+/** `true` when `child` is `parent` itself or lives below it. */
+export declare function isInside(parent: string, child: string): boolean;
+export declare function depth(path: string): number;
+/** Path relative to `parent`, or `null` when `child` is outside of `parent`. */
+export declare function relativeTo(parent: string, child: string): string | null;
+/** All ancestor directories of a path, from the shallowest to the deepest. */
+export declare function ancestors(path: string): string[];
+/** Longest shared directory prefix of two paths. */
+export declare function commonPrefix(paths: readonly string[]): string;
+/**
+ * Derives a stable, human readable module id from a directory path, for example
+ * `src/payments` -> `payments`.
+ */
+export declare function moduleIdFromPath(path: string, sourceRoots?: readonly string[]): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/util/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/util/paths.ts"],"names":[],"mappings":"AASA,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOtD;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI5C;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI7C;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK5C;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIzC;AAED,wBAAgB,IAAI,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAG/C;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAG/C;AAED,gEAAgE;AAChE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAM/D;AAED,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED,gFAAgF;AAChF,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOvE;AAED,8EAA8E;AAC9E,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAOhD;AAED,oDAAoD;AACpD,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAW7D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,GAAE,SAAS,MAAM,EAAO,GAAG,MAAM,CAU1F"}