@ai-agent-context/core 0.1.0

package/dist/adapters/filesystem/fs-adapter.js

@@ -0,0 +1,168 @@
+/**
+ * File system adapter.
+ *
+ * Responsibilities:
+ * - deterministic, streaming directory traversal (never loads file contents here);
+ * - include/exclude/ignore glob evaluation with safe directory pruning;
+ * - bounded concurrency for stat/hash/read work is owned by the callers.
+ *
+ * The rest of the pipeline only talks to this adapter, so swapping in a virtual
+ * file system (or a remote checkout) later does not touch the analysis core.
+ */
+import { readdir, readFile, stat } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { toPosix, normalizeRelative } from "../../util/paths.js";
+import { compareStrings } from "../../model/canonical.js";
+import { PatternSet } from "../../util/glob.js";
+const DEFAULT_MAX_FILES = 500_000;
+/** Leading literal directory of a glob pattern, used for directory pruning. */
+function literalPrefix(pattern) {
+    const segments = pattern.replace(/\\/g, '/').split('/');
+    const literal = [];
+    for (const segment of segments) {
+        if (/[*?[{]/.test(segment))
+            break;
+        literal.push(segment);
+    }
+    return literal.join('/');
+}
+export class FileSystemAdapter {
+    root;
+    prefixes = [];
+    constructor(root) {
+        this.root = path.resolve(root);
+    }
+    /**
+     * Traverses the repository, returning files sorted by path.
+     *
+     * Traversal is breadth-first with an explicit queue, so deep trees cannot blow
+     * the call stack, and directory entries are read in sorted order so that the
+     * resulting context does not depend on file system ordering.
+     */
+    async walk(options = {}) {
+        const files = [];
+        const maxFiles = options.maxFiles ?? DEFAULT_MAX_FILES;
+        const canPrune = this.canPrune(options.include);
+        const queue = [''];
+        while (queue.length > 0) {
+            const relativeDir = queue.shift();
+            const absoluteDir = relativeDir.length === 0 ? this.root : path.join(this.root, relativeDir);
+            let entries;
+            try {
+                entries = await readdir(absoluteDir, { withFileTypes: true });
+            }
+            catch {
+                // Unreadable directory: analysis continues and the caller reports a warning.
+                continue;
+            }
+            entries.sort((a, b) => compareStrings(a.name, b.name));
+            for (const entry of entries) {
+                const relativePath = relativeDir.length === 0 ? entry.name : `${relativeDir}/${entry.name}`;
+                const absolutePath = path.join(absoluteDir, entry.name);
+                const isSymbolicLink = entry.isSymbolicLink();
+                if (entry.isDirectory() || isSymbolicLink) {
+                    if (isSymbolicLink && options.followSymlinks !== true)
+                        continue;
+                    if (this.isExcludedDirectory(relativePath, options))
+                        continue;
+                    if (canPrune && !this.canContainIncluded(relativePath, options.include))
+                        continue;
+                    options.onDirectory?.(relativePath);
+                    queue.push(relativePath);
+                    continue;
+                }
+                if (!entry.isFile())
+                    continue;
+                if (this.isExcludedFile(relativePath, options))
+                    continue;
+                if (!this.matchesInclude(relativePath, options.include))
+                    continue;
+                let stats;
+                try {
+                    stats = await stat(absolutePath);
+                }
+                catch {
+                    continue;
+                }
+                const walked = {
+                    path: relativePath,
+                    absolutePath,
+                    size: stats.size,
+                    mtimeMs: Math.round(stats.mtimeMs),
+                    isSymbolicLink,
+                };
+                files.push(walked);
+                options.onFile?.(walked);
+                if (files.length >= maxFiles)
+                    return files;
+            }
+        }
+        files.sort((a, b) => compareStrings(a.path, b.path));
+        return files;
+    }
+    isExcludedDirectory(relativePath, options) {
+        if (options.exclude?.test(relativePath, true))
+            return true;
+        if (options.ignore?.test(relativePath, true))
+            return true;
+        return false;
+    }
+    isExcludedFile(relativePath, options) {
+        if (options.exclude?.test(relativePath, false))
+            return true;
+        if (options.ignore?.test(relativePath, false))
+            return true;
+        return false;
+    }
+    matchesInclude(relativePath, include) {
+        if (!include || include.isEmpty)
+            return true;
+        return include.matchesAny(relativePath);
+    }
+    /** `true` when directory pruning is safe for the configured include patterns. */
+    canPrune(include) {
+        if (!include || include.isEmpty)
+            return false;
+        const prefixes = include.rules.filter((rule) => !rule.negated).map((rule) => literalPrefix(rule.raw));
+        if (prefixes.length === 0 || prefixes.some((prefix) => prefix.length === 0))
+            return false;
+        this.prefixes.length = 0;
+        this.prefixes.push(...new Set(prefixes));
+        return true;
+    }
+    canContainIncluded(relativeDir, include) {
+        if (!include || this.prefixes.length === 0)
+            return true;
+        const normalized = normalizeRelative(relativeDir);
+        return this.prefixes.some((prefix) => prefix === normalized || prefix.startsWith(`${normalized}/`) || normalized.startsWith(`${prefix}/`));
+    }
+    exists(relativePath) {
+        return existsSync(path.join(this.root, relativePath));
+    }
+    async readText(relativePath) {
+        return readFile(path.join(this.root, relativePath), 'utf8');
+    }
+    async readJson(relativePath) {
+        const contents = await this.readText(relativePath);
+        return JSON.parse(contents);
+    }
+    async tryReadText(relativePath) {
+        try {
+            return await this.readText(relativePath);
+        }
+        catch {
+            return null;
+        }
+    }
+    toRelative(absolutePath) {
+        return toPosix(path.relative(this.root, absolutePath));
+    }
+    toAbsolute(relativePath) {
+        return path.join(this.root, relativePath);
+    }
+    get basename() {
+        return path.basename(this.root);
+    }
+}
+//# sourceMappingURL=fs-adapter.js.map

package/dist/adapters/filesystem/fs-adapter.js.map

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

package/dist/adapters/filesystem/sensitive.d.ts

@@ -0,0 +1,26 @@
+export declare const REDACTED = "[REDACTED]";
+interface SecretPattern {
+    name: string;
+    regex: RegExp;
+}
+/** Value-level patterns used to detect and redact secret material. */
+export declare const SECRET_VALUE_PATTERNS: SecretPattern[];
+/** `true` when the text appears to contain secret material. */
+export declare function containsSecret(text: string): boolean;
+/** Replaces secret-looking values with `[REDACTED]`, keeping the surrounding text. */
+export declare function redactSecrets(text: string): string;
+export interface SensitiveFilterOptions {
+    allowSensitiveFiles: boolean;
+    extraSensitivePatterns?: string[];
+}
+/** Path-level filter; checked before any file content is read. */
+export declare class SensitivePathFilter {
+    private readonly patterns;
+    private readonly allow;
+    constructor(options: SensitiveFilterOptions);
+    /** `true` when the file must not be read. */
+    isBlocked(relativePath: string): boolean;
+    toArray(): string[];
+}
+export {};
+//# sourceMappingURL=sensitive.d.ts.map

package/dist/adapters/filesystem/sensitive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sensitive.d.ts","sourceRoot":"","sources":["../../../src/adapters/filesystem/sensitive.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,QAAQ,eAAe,CAAC;AAErC,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,sEAAsE;AACtE,eAAO,MAAM,qBAAqB,EAAE,aAAa,EAchD,CAAC;AAEF,+DAA+D;AAC/D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKpD;AAED,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASlD;AAED,MAAM,WAAW,sBAAsB;IACrC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;CACnC;AAED,kEAAkE;AAClE,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAa;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;gBAEpB,OAAO,EAAE,sBAAsB;IAK3C,6CAA6C;IAC7C,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAKxC,OAAO,IAAI,MAAM,EAAE;CAGpB"}

package/dist/adapters/filesystem/sensitive.js

@@ -0,0 +1,67 @@
+/**
+ * Secret handling.
+ *
+ * Two guarantees:
+ * 1. Sensitive *files* are never read (`.env`, keys, certificates, credentials).
+ * 2. Any text copied into the generated context (ADR excerpts, commit subjects)
+ *    is passed through {@link redactSecrets} first, so a secret accidentally
+ *    committed to the repository cannot leak into `.agent/`.
+ *
+ * The package performs no network calls and sends nothing anywhere.
+ */
+import { PatternSet } from "../../util/glob.js";
+import { DEFAULT_SENSITIVE_PATTERNS } from "../../config/defaults.js";
+export const REDACTED = '[REDACTED]';
+/** Value-level patterns used to detect and redact secret material. */
+export const SECRET_VALUE_PATTERNS = [
+    { name: 'private-key-block', regex: /-----BEGIN [A-Z ]*PRIVATE KEY-----[\s\S]*?-----END [A-Z ]*PRIVATE KEY-----/g },
+    {
+        name: 'assigned-secret',
+        regex: /\b(api[_-]?key|secret|token|password|passwd|pwd|private[_-]?key|access[_-]?key|client[_-]?secret|auth[_-]?token)\b\s*[:=]\s*["']?([A-Za-z0-9_\-./+]{8,})["']?/gi,
+    },
+    { name: 'openai-key', regex: /\bsk-[A-Za-z0-9_-]{16,}\b/g },
+    { name: 'anthropic-key', regex: /\bsk-ant-[A-Za-z0-9_-]{16,}\b/g },
+    { name: 'github-token', regex: /\b(gh[pousr]_[A-Za-z0-9]{20,})\b/g },
+    { name: 'aws-access-key', regex: /\b(AKIA|ASIA)[0-9A-Z]{16}\b/g },
+    { name: 'slack-token', regex: /\bxox[baprs]-[A-Za-z0-9-]{10,}\b/g },
+    { name: 'google-api-key', regex: /\bAIza[0-9A-Za-z_-]{35}\b/g },
+    { name: 'jwt', regex: /\beyJ[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]{8,}\b/g },
+    { name: 'credentials-in-url', regex: /\/\/[A-Za-z0-9._%-]+:[^\s@/]+@/g },
+];
+/** `true` when the text appears to contain secret material. */
+export function containsSecret(text) {
+    return SECRET_VALUE_PATTERNS.some((pattern) => {
+        pattern.regex.lastIndex = 0;
+        return pattern.regex.test(text);
+    });
+}
+/** Replaces secret-looking values with `[REDACTED]`, keeping the surrounding text. */
+export function redactSecrets(text) {
+    let output = text;
+    output = output.replace(SECRET_VALUE_PATTERNS[0].regex, `${REDACTED} private key`);
+    output = output.replace(SECRET_VALUE_PATTERNS[1].regex, (_match, key) => `${key}: "${REDACTED}"`);
+    for (const pattern of SECRET_VALUE_PATTERNS.slice(2, 8)) {
+        output = output.replace(pattern.regex, REDACTED);
+    }
+    output = output.replace(SECRET_VALUE_PATTERNS[8].regex, `//${REDACTED}@`);
+    return output;
+}
+/** Path-level filter; checked before any file content is read. */
+export class SensitivePathFilter {
+    patterns;
+    allow;
+    constructor(options) {
+        this.allow = options.allowSensitiveFiles;
+        this.patterns = new PatternSet([...DEFAULT_SENSITIVE_PATTERNS, ...(options.extraSensitivePatterns ?? [])]);
+    }
+    /** `true` when the file must not be read. */
+    isBlocked(relativePath) {
+        if (this.allow)
+            return false;
+        return this.patterns.test(relativePath, false);
+    }
+    toArray() {
+        return this.patterns.toArray();
+    }
+}
+//# sourceMappingURL=sensitive.js.map

package/dist/adapters/filesystem/sensitive.js.map

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

package/dist/adapters/git/git-adapter.d.ts

@@ -0,0 +1,47 @@
+export interface GitCommit {
+    sha: string;
+    /** Author name as recorded by git (neutral ownership signal). */
+    author: string;
+    /** ISO 8601 author date. */
+    date: string;
+    /** Author date in milliseconds since epoch. */
+    dateMs: number;
+    subject: string;
+    /** Repository-relative POSIX paths touched by the commit. */
+    files: string[];
+}
+export interface GitLogOptions {
+    windowDays: number;
+    maxCommits: number;
+}
+export interface GitAvailability {
+    available: boolean;
+    /** Reason why git signals are unavailable, when `available === false`. */
+    reason?: string;
+    /** Absolute path of the repository top level. */
+    toplevel?: string;
+    /** Current branch name, when resolvable. */
+    branch?: string | null;
+    head?: string | null;
+}
+export interface GitAdapterOptions {
+    /** Path or name of the git binary. */
+    gitBinary?: string;
+    /** Hard timeout for every git invocation, in milliseconds. */
+    timeoutMs?: number;
+}
+export declare class GitAdapter {
+    private readonly root;
+    private readonly binary;
+    private readonly timeoutMs;
+    private availability;
+    constructor(root: string, options?: GitAdapterOptions);
+    private run;
+    /** Detects whether git signals can be produced for this repository. */
+    probe(): Promise<GitAvailability>;
+    /** Reads the commit history inside the configured window. */
+    log(options: GitLogOptions): Promise<GitCommit[]>;
+}
+/** Parses the output produced by {@link LOG_FORMAT} combined with `--name-only`. */
+export declare function parseGitLog(output: string): GitCommit[];
+//# sourceMappingURL=git-adapter.d.ts.map

package/dist/adapters/git/git-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/git/git-adapter.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAYD,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,YAAY,CAAgC;gBAExC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB;YAM3C,GAAG;IAajB,uEAAuE;IACjE,KAAK,IAAI,OAAO,CAAC,eAAe,CAAC;IAwBvC,6DAA6D;IACvD,GAAG,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;CAcxD;AAED,oFAAoF;AACpF,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,CA0BvD"}

package/dist/adapters/git/git-adapter.js

@@ -0,0 +1,109 @@
+/**
+ * Git adapter.
+ *
+ * Git is part of the core functionality (recently changed files, commit counts,
+ * ownership signals, architectural change history), but it is strictly optional
+ * at runtime: when `git` is missing or the directory is not a repository, the
+ * adapter reports that and analysis continues without git signals.
+ *
+ * Nothing leaves the machine: `git` is invoked locally through `child_process`.
+ */
+import { execFile } from 'node:child_process';
+const RECORD_SEPARATOR = '\u001e';
+const FIELD_SEPARATOR = '\u001f';
+const LOG_FORMAT = `%x1e%H%x1f%an%x1f%aI%x1f%s%x1e`;
+export class GitAdapter {
+    root;
+    binary;
+    timeoutMs;
+    availability = null;
+    constructor(root, options = {}) {
+        this.root = root;
+        this.binary = options.gitBinary ?? 'git';
+        this.timeoutMs = options.timeoutMs ?? 20_000;
+    }
+    async run(args) {
+        return new Promise((resolve) => {
+            execFile(this.binary, ['--no-pager', '-c', 'core.quotepath=false', ...args], { cwd: this.root, timeout: this.timeoutMs, windowsHide: true, maxBuffer: 64 * 1024 * 1024 }, (error, stdout, stderr) => {
+                resolve({ ok: error === null, stdout: stdout?.toString() ?? '', stderr: stderr?.toString() ?? '' });
+            });
+        });
+    }
+    /** Detects whether git signals can be produced for this repository. */
+    async probe() {
+        if (this.availability !== null)
+            return this.availability;
+        const inside = await this.run(['rev-parse', '--is-inside-work-tree']);
+        if (!inside.ok) {
+            this.availability = {
+                available: false,
+                reason: inside.stderr.trim().length > 0 ? inside.stderr.trim() : 'not a git repository',
+            };
+            return this.availability;
+        }
+        const toplevel = await this.run(['rev-parse', '--show-toplevel']);
+        const branch = await this.run(['rev-parse', '--abbrev-ref', 'HEAD']);
+        const head = await this.run(['rev-parse', 'HEAD']);
+        const hasCommits = head.ok;
+        this.availability = {
+            available: hasCommits,
+            reason: hasCommits ? undefined : 'repository has no commits yet',
+            toplevel: toplevel.ok ? toplevel.stdout.trim() : undefined,
+            branch: branch.ok ? branch.stdout.trim() : null,
+            head: hasCommits ? head.stdout.trim() : null,
+        };
+        return this.availability;
+    }
+    /** Reads the commit history inside the configured window. */
+    async log(options) {
+        const availability = await this.probe();
+        if (!availability?.available)
+            return [];
+        const result = await this.run([
+            'log',
+            `--since=${options.windowDays}.days.ago`,
+            `--max-count=${options.maxCommits}`,
+            '--name-only',
+            `--format=${LOG_FORMAT}`,
+            '--date-order',
+        ]);
+        if (!result.ok)
+            return [];
+        return parseGitLog(result.stdout);
+    }
+}
+/** Parses the output produced by {@link LOG_FORMAT} combined with `--name-only`. */
+export function parseGitLog(output) {
+    const commits = [];
+    const chunks = output.split(RECORD_SEPARATOR);
+    for (const chunk of chunks) {
+        const trimmed = chunk.replace(/^\s+/, '');
+        if (trimmed.length === 0)
+            continue;
+        const lines = trimmed.split('\n');
+        const header = lines.shift();
+        if (header === undefined)
+            continue;
+        const [sha, author, date, ...subjectParts] = header.split(FIELD_SEPARATOR);
+        if (sha === undefined || author === undefined || date === undefined)
+            continue;
+        const dateMs = Date.parse(date);
+        const files = lines
+            .map((line) => line.trim())
+            .filter((line) => line.length > 0 && !line.startsWith(FIELD_SEPARATOR))
+            .map((line) => line.replace(/\\/g, '/'));
+        commits.push({
+            sha: sha.trim(),
+            author: author.trim(),
+            date,
+            dateMs: Number.isNaN(dateMs) ? 0 : dateMs,
+            subject: subjectPartIsEmpty(subjectParts) ? '' : subjectParts.join(FIELD_SEPARATOR).trim(),
+            files,
+        });
+    }
+    return commits;
+}
+function subjectPartIsEmpty(parts) {
+    return parts.length === 0 || parts.join('').trim().length === 0;
+}
+//# sourceMappingURL=git-adapter.js.map

package/dist/adapters/git/git-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-adapter.js","sourceRoot":"","sources":["../../../src/adapters/git/git-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAsC9C,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AAClC,MAAM,eAAe,GAAG,QAAQ,CAAC;AACjC,MAAM,UAAU,GAAG,gCAAgC,CAAC;AAQpD,MAAM,OAAO,UAAU;IACJ,IAAI,CAAS;IACb,MAAM,CAAS;IACf,SAAS,CAAS;IAC3B,YAAY,GAA2B,IAAI,CAAC;IAEpD,YAAY,IAAY,EAAE,UAA6B,EAAE;QACvD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;QACzC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC;IAC/C,CAAC;IAEO,KAAK,CAAC,GAAG,CAAC,IAAc;QAC9B,OAAO,IAAI,OAAO,CAAY,CAAC,OAAO,EAAE,EAAE;YACxC,QAAQ,CACN,IAAI,CAAC,MAAM,EACX,CAAC,YAAY,EAAE,IAAI,EAAE,sBAAsB,EAAE,GAAG,IAAI,CAAC,EACrD,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,EAC3F,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;gBACxB,OAAO,CAAC,EAAE,EAAE,EAAE,KAAK,KAAK,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;YACtG,CAAC,CACF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED,uEAAuE;IACvE,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,YAAY,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC,YAAY,CAAC;QACzD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,uBAAuB,CAAC,CAAC,CAAC;QACtE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,IAAI,CAAC,YAAY,GAAG;gBAClB,SAAS,EAAE,KAAK;gBAChB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,sBAAsB;aACxF,CAAC;YACF,OAAO,IAAI,CAAC,YAAY,CAAC;QAC3B,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC;QAClE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;QACrE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;QACnD,MAAM,UAAU,GAAG,IAAI,CAAC,EAAE,CAAC;QAC3B,IAAI,CAAC,YAAY,GAAG;YAClB,SAAS,EAAE,UAAU;YACrB,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,+BAA+B;YAChE,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;YAC1D,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI;YAC/C,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI;SAC7C,CAAC;QACF,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,6DAA6D;IAC7D,KAAK,CAAC,GAAG,CAAC,OAAsB;QAC9B,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACxC,IAAI,CAAC,YAAY,EAAE,SAAS;YAAE,OAAO,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC;YAC5B,KAAK;YACL,WAAW,OAAO,CAAC,UAAU,WAAW;YACxC,eAAe,OAAO,CAAC,UAAU,EAAE;YACnC,aAAa;YACb,YAAY,UAAU,EAAE;YACxB,cAAc;SACf,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,EAAE,CAAC;QAC1B,OAAO,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;CACF;AAED,oFAAoF;AACpF,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,MAAM,OAAO,GAAgB,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAC9C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC1C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACnC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;QAC7B,IAAI,MAAM,KAAK,SAAS;YAAE,SAAS;QACnC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,YAAY,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAC3E,IAAI,GAAG,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS;YAAE,SAAS;QAC9E,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,KAAK,GAAG,KAAK;aAChB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;aAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;aACtE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;QAC3C,OAAO,CAAC,IAAI,CAAC;YACX,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE;YACf,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE;YACrB,IAAI;YACJ,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM;YACzC,OAAO,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,IAAI,EAAE;YAC1F,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAe;IACzC,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC;AAClE,CAAC"}

package/dist/adapters/language/json/adapter.d.ts

@@ -0,0 +1,24 @@
+/**
+ * JSON adapter — structural facts only (top-level keys, validity).
+ *
+ * Invalid JSON is a warning, never a fatal error: the scan continues and the
+ * remaining files are still analyzed.
+ */
+import { type FileDescriptor, type LanguageAdapter, type ParsedFile } from '../types.ts';
+export declare class JsonAdapter implements LanguageAdapter {
+    readonly id = "json";
+    readonly displayName = "JSON";
+    readonly languageIds: readonly string[];
+    /** Structural files are analyzed regardless of the `languages` setting. */
+    readonly alwaysEnabled = true;
+    handles(file: FileDescriptor): boolean;
+    parse(input: {
+        path: string;
+        language: string;
+        contents: string;
+    }): ParsedFile;
+}
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+/** Removes a UTF-8 BOM so that JSON.parse does not fail on Windows checkouts. */
+export declare function stripJsonPreamble(contents: string): string;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapters/language/json/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../src/adapters/language/json/adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAoB,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAE3G,qBAAa,WAAY,YAAW,eAAe;IACjD,QAAQ,CAAC,EAAE,UAAU;IACrB,QAAQ,CAAC,WAAW,UAAU;IAC9B,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAY;IACnD,2EAA2E;IAC3E,QAAQ,CAAC,aAAa,QAAQ;IAE9B,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO;IAItC,KAAK,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,UAAU;CA4B/E;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE9E;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE1D"}

package/dist/adapters/language/json/adapter.js

@@ -0,0 +1,54 @@
+/**
+ * JSON adapter — structural facts only (top-level keys, validity).
+ *
+ * Invalid JSON is a warning, never a fatal error: the scan continues and the
+ * remaining files are still analyzed.
+ */
+import { createParsedFile } from "../types.js";
+export class JsonAdapter {
+    id = 'json';
+    displayName = 'JSON';
+    languageIds = ['json'];
+    /** Structural files are analyzed regardless of the `languages` setting. */
+    alwaysEnabled = true;
+    handles(file) {
+        return file.extension === '.json';
+    }
+    parse(input) {
+        try {
+            const value = JSON.parse(stripJsonPreamble(input.contents));
+            const keys = isPlainObject(value) ? Object.keys(value).sort() : [];
+            return createParsedFile(input.path, 'json', {
+                metadata: {
+                    'json.valid': true,
+                    'json.topLevelKeys': keys,
+                    'json.rootType': Array.isArray(value) ? 'array' : value === null ? 'null' : typeof value,
+                },
+            });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return createParsedFile(input.path, 'json', {
+                parseStatus: 'partial',
+                metadata: { 'json.valid': false },
+                diagnostics: [
+                    {
+                        code: 'WARN_JSON_INVALID',
+                        severity: 'warning',
+                        message: `failed to parse ${input.path}`,
+                        source: input.path,
+                        hint: message,
+                    },
+                ],
+            });
+        }
+    }
+}
+export function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** Removes a UTF-8 BOM so that JSON.parse does not fail on Windows checkouts. */
+export function stripJsonPreamble(contents) {
+    return contents.charCodeAt(0) === 0xfeff ? contents.slice(1) : contents;
+}
+//# sourceMappingURL=adapter.js.map

package/dist/adapters/language/json/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../../src/adapters/language/json/adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,gBAAgB,EAA8D,MAAM,aAAa,CAAC;AAE3G,MAAM,OAAO,WAAW;IACb,EAAE,GAAG,MAAM,CAAC;IACZ,WAAW,GAAG,MAAM,CAAC;IACrB,WAAW,GAAsB,CAAC,MAAM,CAAC,CAAC;IACnD,2EAA2E;IAClE,aAAa,GAAG,IAAI,CAAC;IAE9B,OAAO,CAAC,IAAoB;QAC1B,OAAO,IAAI,CAAC,SAAS,KAAK,OAAO,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,KAA2D;QAC/D,IAAI,CAAC;YACH,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;YACrE,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,OAAO,gBAAgB,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE;gBAC1C,QAAQ,EAAE;oBACR,YAAY,EAAE,IAAI;oBAClB,mBAAmB,EAAE,IAAI;oBACzB,eAAe,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,KAAK;iBACzF;aACF,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO,gBAAgB,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE;gBAC1C,WAAW,EAAE,SAAS;gBACtB,QAAQ,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE;gBACjC,WAAW,EAAE;oBACX;wBACE,IAAI,EAAE,mBAAmB;wBACzB,QAAQ,EAAE,SAAS;wBACnB,OAAO,EAAE,mBAAmB,KAAK,CAAC,IAAI,EAAE;wBACxC,MAAM,EAAE,KAAK,CAAC,IAAI;wBAClB,IAAI,EAAE,OAAO;qBACd;iBACF;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,OAAO,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC1E,CAAC"}

package/dist/adapters/language/markdown/adapter.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Markdown adapter.
+ *
+ * Markdown is where repositories already document their conventions, decisions
+ * and architecture. The adapter extracts structure (headings, links, section
+ * positions) so that the decision and convention detectors can attach evidence
+ * to real documents instead of guessing.
+ */
+import { type FileDescriptor, type LanguageAdapter, type ParsedFile } from '../types.ts';
+export interface MarkdownHeading {
+    level: number;
+    title: string;
+    line: number;
+    /** Heading text in lowercase, for cheap section matching. */
+    normalized: string;
+}
+export interface MarkdownLink {
+    text: string;
+    target: string;
+    line: number;
+}
+export declare function extractHeadings(contents: string): MarkdownHeading[];
+export declare function extractMarkdownLinks(contents: string): MarkdownLink[];
+/** First non-empty paragraph after the front matter, used as a short excerpt. */
+export declare function firstParagraph(contents: string): string;
+/** Removes a YAML front matter block, when present. */
+export declare function stripFrontMatter(contents: string): string;
+export declare function extractFrontMatter(contents: string): Record<string, string>;
+export declare class MarkdownAdapter implements LanguageAdapter {
+    readonly id = "markdown";
+    readonly displayName = "Markdown";
+    readonly languageIds: readonly string[];
+    readonly alwaysEnabled = true;
+    handles(file: FileDescriptor): boolean;
+    parse(input: {
+        path: string;
+        language: string;
+        contents: string;
+    }): ParsedFile;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapters/language/markdown/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../src/adapters/language/markdown/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAoB,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAE3G,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,EAAE,CAsBnE;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,EAAE,CAarE;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAiBvD;AAED,uDAAuD;AACvD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKzD;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAY3E;AAED,qBAAa,eAAgB,YAAW,eAAe;IACrD,QAAQ,CAAC,EAAE,cAAc;IACzB,QAAQ,CAAC,WAAW,cAAc;IAClC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAsB;IAC7D,QAAQ,CAAC,aAAa,QAAQ;IAE9B,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO;IAItC,KAAK,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,UAAU;CAoB/E"}