@billwgong/contextlint 0.1.0

package/dist/parser.js

@@ -0,0 +1,106 @@
+export function estimateTokens(text) {
+    const nonAscii = [...text].filter(c => c.charCodeAt(0) > 127).length;
+    return Math.ceil((text.length - nonAscii) / 4 + nonAscii);
+}
+export function normalize(text) {
+    return text.replace(/^[\s]*(?:[-*+]\s+|\d+[.)]\s+)/, '').trim()
+        .replace(/\s+/g, ' ').replace(/[.!。！]+$/, '');
+}
+export function parse(content, source) {
+    const lines = content.replace(/^\uFEFF/, '').split(/\r?\n/);
+    let start = 0;
+    if (lines[0]?.trim() === '---') {
+        const close = lines.findIndex((line, i) => i > 0 && line.trim() === '---');
+        if (close < 0) {
+            source.activation = 'unknown';
+            return [];
+        }
+        const metadata = lines.slice(1, close).join('\n');
+        if (source.agents.includes('cursor')) {
+            source.activation = /^alwaysApply:\s*true\s*$/m.test(metadata) && !/^globs:\s*\S/m.test(metadata)
+                ? 'directory' : 'conditional';
+        }
+        else if (source.agents.includes('copilot') && /^applyTo:/m.test(metadata)) {
+            source.activation = 'conditional';
+        }
+        else if (metadata.trim())
+            source.activation = 'unknown';
+        start = close + 1;
+    }
+    let fence = null;
+    let comment = false;
+    let quoted = false;
+    const rules = [];
+    let paragraph = [];
+    let paragraphStart = 0;
+    const headings = [];
+    let conditionalIntro = false;
+    const isConditional = (text) => /\b(if|unless|except|when|fallback|example|examples|for example|prefer)\b|如果|除非|例如|示例|优先|失败时|仅在|情况下|当.+时/i.test(text);
+    const flush = () => {
+        if (!paragraph.length)
+            return;
+        const text = paragraph.join(' ').trim();
+        if (text)
+            rules.push({ text, normalized: normalize(text), line: paragraphStart + 1,
+                endLine: paragraphStart + paragraph.length, source,
+                conditional: headings.some(h => h.conditional) || conditionalIntro || isConditional(text),
+                context: headings.map(h => h.text).join(' / ') });
+        if (isConditional(text) && /[:：]$/.test(text))
+            conditionalIntro = true;
+        paragraph = [];
+    };
+    for (let i = start; i < lines.length; i++) {
+        const line = lines[i];
+        if (/^\s*>/.test(line)) {
+            flush();
+            quoted = true;
+            continue;
+        }
+        if (quoted && line.trim() && !/^\s{0,3}(?:#{1,6}\s|[-*+]\s|\d+[.)]\s|`{3,}|~{3,})/.test(line))
+            continue;
+        quoted = false;
+        const marker = line.match(/^\s{0,3}(`{3,}|~{3,})/);
+        if (marker) {
+            flush();
+            if (!fence)
+                fence = { char: marker[1][0], length: marker[1].length };
+            else if (marker[1][0] === fence.char && marker[1].length >= fence.length && /^\s*(?:`+|~+)\s*$/.test(line))
+                fence = null;
+            continue;
+        }
+        if (fence)
+            continue;
+        // Top-level indented code is data, not an instruction. Wrapped list prose is preserved.
+        if (/^(?: {4}|\t)/.test(line) && (!paragraph.length || !/^\s*(?:[-*+]\s+|\d+[.)]\s+)/.test(paragraph[0]))) {
+            flush();
+            continue;
+        }
+        if (comment || line.includes('<!--')) {
+            flush();
+            comment = !line.includes('-->');
+            continue;
+        }
+        if (/^\s*#/.test(line)) {
+            flush();
+            const heading = line.match(/^\s*(#+)\s*(.*?)\s*#*$/);
+            const level = heading[1].length;
+            while (headings.length && headings[headings.length - 1].level >= level)
+                headings.pop();
+            headings.push({ level, text: heading[2], conditional: isConditional(line) || /conditional|例外/i.test(line) });
+            conditionalIntro = false;
+            continue;
+        }
+        if (!line.trim() || /^\s*(>|\||[-*_]{3,}\s*$)/.test(line)) {
+            flush();
+            continue;
+        }
+        if (/^\s*(?:[-*+]\s+|\d+[.)]\s+)/.test(line))
+            flush();
+        if (!paragraph.length)
+            paragraphStart = i;
+        paragraph.push(line.trim());
+    }
+    flush();
+    return rules;
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

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

package/dist/report-storage.d.ts

@@ -0,0 +1,5 @@
+/** Keep independent private history. Replace regular output copies atomically, never link targets. */
+export declare function saveHtmlReport(root: string, content: string, requestedPath?: string): Promise<{
+    outputPath: string;
+    archivePath: string;
+}>;

package/dist/report-storage.js

@@ -0,0 +1,80 @@
+import { mkdir, writeFile, lstat, realpath, rename, rm } from 'node:fs/promises';
+import { randomUUID } from 'node:crypto';
+import path from 'node:path';
+import { isWithin } from './safe-io.js';
+async function historyDirectory(root) {
+    let directory = await realpath(root);
+    for (const part of ['.contextlint', 'reports']) {
+        directory = path.join(directory, part);
+        try {
+            await mkdir(directory, { mode: 0o700 });
+        }
+        catch (error) {
+            if (error.code !== 'EEXIST')
+                throw error;
+        }
+        const info = await lstat(directory);
+        if (info.isSymbolicLink() || !info.isDirectory())
+            throw new Error('Report history must use real directories, not symbolic links');
+    }
+    return directory;
+}
+/** Keep independent private history. Replace regular output copies atomically, never link targets. */
+export async function saveHtmlReport(root, content, requestedPath) {
+    const directory = await historyDirectory(root);
+    const stamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const archivePath = path.join(directory, `report-${stamp}-${randomUUID()}.html`);
+    await writeFile(archivePath, content, { encoding: 'utf8', flag: 'wx', mode: 0o600 });
+    const outputPath = requestedPath ? path.resolve(requestedPath) : archivePath;
+    if (outputPath !== archivePath) {
+        let temporary;
+        try {
+            const canonicalRoot = await realpath(root);
+            let ancestor = path.dirname(outputPath);
+            while (true) {
+                try {
+                    const resolved = await realpath(ancestor);
+                    if (isWithin(path.resolve(root), outputPath) && !isWithin(canonicalRoot, resolved)) {
+                        throw new Error('Report output directory escapes scan root through a symbolic link');
+                    }
+                    break;
+                }
+                catch (error) {
+                    if (error.code !== 'ENOENT')
+                        throw error;
+                    const parent = path.dirname(ancestor);
+                    if (parent === ancestor)
+                        throw error;
+                    ancestor = parent;
+                }
+            }
+            await mkdir(path.dirname(outputPath), { recursive: true });
+            // Resolve the parent once; atomic rename replaces the entry rather than following it.
+            const parent = await realpath(path.dirname(outputPath));
+            if (isWithin(path.resolve(root), outputPath) && !isWithin(canonicalRoot, parent))
+                throw new Error('Report output directory escapes scan root');
+            const destination = path.join(parent, path.basename(outputPath));
+            try {
+                const info = await lstat(destination);
+                if (info.isSymbolicLink() || !info.isFile())
+                    throw new Error('Report output must be a regular file, not a symbolic link');
+            }
+            catch (error) {
+                if (error.code !== 'ENOENT')
+                    throw error;
+            }
+            temporary = path.join(parent, `.contextlint-${randomUUID()}.tmp`);
+            await writeFile(temporary, content, { encoding: 'utf8', flag: 'wx', mode: 0o600 });
+            await rename(temporary, destination);
+        }
+        catch (error) {
+            throw new Error(`Output copy failed (${error instanceof Error ? error.message : String(error)}). Report retained: ${archivePath}`);
+        }
+        finally {
+            if (temporary)
+                await rm(temporary, { force: true });
+        }
+    }
+    return { outputPath, archivePath };
+}
+//# sourceMappingURL=report-storage.js.map

package/dist/report-storage.js.map

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

package/dist/reporter.d.ts

@@ -0,0 +1,3 @@
+import type { Report } from './types.js';
+import { type Language } from './i18n.js';
+export declare function render(report: Report, language?: Language): string;

package/dist/reporter.js

@@ -0,0 +1,29 @@
+import { terminalText } from './safe-io.js';
+import { describeFinding, skipReason, words } from './i18n.js';
+export function render(report, language = 'en') {
+    const s = report.summary, w = words(language);
+    const lines = ['ContextLint', '', `${w.found} ${s.files} ${w.files} · ~${s.estimatedTokens.toLocaleString('en-US')} ${w.tokens}`,
+        `${s.conflicts} ${w.conflicts} · ${s.duplicates} ${w.duplicates} · ${s.brokenReferences} ${w.references}`, ''];
+    lines.splice(1, 0, terminalText(report.projectName ?? report.root));
+    if (!s.files)
+        lines.push(w.noSourcesHeadline, w.noSourcesHint);
+    if (report.status === 'limited')
+        lines.push(w.limitedNotice);
+    for (const source of report.sources)
+        lines.push(`  ${source.path}  ~${source.estimatedTokens} tokens · ${source.ruleCount} ${w.ruleCount} · ${source.agents.join(', ')} · ${source.activation === 'directory' ? w.directory : w.conditional}`);
+    for (const finding of report.findings) {
+        const description = describeFinding(finding.id, language);
+        lines.push('', `[${w[finding.severity]}] ${finding.id} (${finding.agents.join(', ')})`, description.title);
+        for (const loc of finding.locations)
+            lines.push(`  ${loc.path}:${loc.line}${loc.endLine !== loc.line ? '-' + loc.endLine : ''}  ${loc.text}`);
+        lines.push(`  ${w.reason}: ${description.reason}`, `  ${w.fix}: ${description.fix}`);
+    }
+    if (report.skipped.length) {
+        lines.push('', w.skipped + ':');
+        for (const item of report.skipped)
+            lines.push(`  ${item.path}: ${skipReason(item.reason, language)}`);
+    }
+    lines.push('', w.terminalFooter);
+    return lines.map(terminalText).join('\n');
+}
+//# sourceMappingURL=reporter.js.map

package/dist/reporter.js.map

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

package/dist/safe-io.d.ts

@@ -0,0 +1,8 @@
+export declare function isWithin(root: string, target: string): boolean;
+/** Never execute repository content; bound reads and refuse linked/non-regular files. */
+export declare function readLocalFile(root: string, filename: string, limit: number): Promise<{
+    text: string;
+    bytes: number;
+}>;
+/** Display controls visibly, so untrusted filenames/instructions cannot operate a terminal. */
+export declare function terminalText(value: string): string;

package/dist/safe-io.js

@@ -0,0 +1,41 @@
+import { constants } from 'node:fs';
+import { open, realpath, lstat } from 'node:fs/promises';
+import path from 'node:path';
+export function isWithin(root, target) {
+    const relative = path.relative(root, target);
+    return relative !== '..' && !relative.startsWith('..' + path.sep) && !path.isAbsolute(relative);
+}
+/** Never execute repository content; bound reads and refuse linked/non-regular files. */
+export async function readLocalFile(root, filename, limit) {
+    if (!isWithin(root, await realpath(path.dirname(filename))))
+        throw new Error('File directory escapes scan root');
+    if ((await lstat(filename)).isSymbolicLink())
+        throw new Error('Symbolic links are not followed');
+    const handle = await open(filename, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0) | (constants.O_NONBLOCK ?? 0));
+    try {
+        const info = await handle.stat();
+        if (!info.isFile())
+            throw new Error('Not a regular file');
+        if (info.size > limit)
+            throw new Error('File size limit exceeded');
+        const buffer = Buffer.alloc(limit + 1);
+        let bytes = 0;
+        while (bytes < buffer.length) {
+            const chunk = await handle.read(buffer, bytes, buffer.length - bytes, null);
+            if (!chunk.bytesRead)
+                break;
+            bytes += chunk.bytesRead;
+        }
+        if (bytes > limit)
+            throw new Error('File size limit exceeded');
+        return { text: buffer.subarray(0, bytes).toString('utf8'), bytes };
+    }
+    finally {
+        await handle.close();
+    }
+}
+/** Display controls visibly, so untrusted filenames/instructions cannot operate a terminal. */
+export function terminalText(value) {
+    return value.replace(/[\x00-\x1f\x7f-\x9f\u202a-\u202e\u2066-\u2069]/g, c => `\\u${c.charCodeAt(0).toString(16).padStart(4, '0')}`);
+}
+//# sourceMappingURL=safe-io.js.map

package/dist/safe-io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-io.js","sourceRoot":"","sources":["../src/safe-io.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,MAAc;IACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7C,OAAO,QAAQ,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;AAClG,CAAC;AAED,yFAAyF;AACzF,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY,EAAE,QAAgB,EAAE,KAAa;IAC/E,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACjH,IAAI,CAAC,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAc,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACjG,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,QAAQ,GAAG,CAAC,SAAS,CAAC,UAAU,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC;IACpH,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACjC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAC1D,IAAI,IAAI,CAAC,IAAI,GAAG,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QACnE,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACvC,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,OAAO,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC;YAC5E,IAAI,CAAC,KAAK,CAAC,SAAS;gBAAE,MAAM;YAC5B,KAAK,IAAI,KAAK,CAAC,SAAS,CAAC;QAC3B,CAAC;QACD,IAAI,KAAK,GAAG,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;IACrE,CAAC;YAAS,CAAC;QAAC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IAAC,CAAC;AACrC,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,KAAK,CAAC,OAAO,CAAC,iDAAiD,EACpE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;AAChE,CAAC"}

package/dist/scanner.d.ts

@@ -0,0 +1,11 @@
+import type { Source, Rule, ScanOptions } from './types.js';
+export declare function describe(file: string): Omit<Source, 'bytes' | 'estimatedTokens' | 'ruleCount'> | null;
+export declare function scan(rootInput: string, options: ScanOptions): Promise<{
+    root: string;
+    sources: Source[];
+    rules: Rule[];
+    skipped: {
+        path: string;
+        reason: string;
+    }[];
+}>;

package/dist/scanner.js

@@ -0,0 +1,127 @@
+import { opendir, lstat, stat, realpath } from 'node:fs/promises';
+import path from 'node:path';
+import { isWithin, readLocalFile } from './safe-io.js';
+import { estimateTokens, parse } from './parser.js';
+const ignored = new Set(['.git', '.contextlint', 'node_modules', 'dist', 'build', 'coverage', '.next', '.venv', 'vendor']);
+const slash = (p) => p.split(path.sep).join('/');
+export function describe(file) {
+    const parent = path.posix.dirname(file);
+    if (path.posix.basename(file) === 'AGENTS.md')
+        return { path: file, agents: ['codex', 'copilot'], scope: parent, activation: 'directory' };
+    if (path.posix.basename(file) === 'CLAUDE.md')
+        return { path: file, agents: ['claude'], scope: parent, activation: 'directory' };
+    const match = file.match(/^(?:(.*)\/)?(\.claude\/rules\/.*\.md|\.cursor\/rules\/.*\.(?:mdc|md)|\.github\/copilot-instructions\.md|\.github\/instructions\/.*\.instructions\.md)$/);
+    if (!match)
+        return null;
+    const kind = match[2];
+    return { path: file, scope: match[1] || '.', agents: [kind.startsWith('.claude') ? 'claude' : kind.startsWith('.cursor') ? 'cursor' : 'copilot'],
+        activation: kind.includes('/rules/') || kind.includes('/instructions/') ? 'conditional' : 'directory' };
+}
+export async function scan(rootInput, options) {
+    const root = await realpath(path.resolve(rootInput));
+    if (!(await stat(root)).isDirectory())
+        throw new Error('Scan target must be a directory');
+    const sources = [], rules = [];
+    const skipped = [];
+    const excludes = (options.exclude ?? []).map(p => p.replace(/\\/g, '/').replace(/^\.\//, '').replace(/\/$/, ''));
+    if (excludes.some(p => !p || path.isAbsolute(p) || /^[a-z]:/i.test(p) || p.split('/').includes('..') || /[*?]/.test(p))) {
+        throw new Error('--exclude requires a relative literal file or directory path (no globs)');
+    }
+    let entriesVisited = 0, totalBytes = 0, halted = false;
+    const limited = (file, reason) => {
+        if (skipped.length < 1000)
+            skipped.push({ path: file || '.', reason });
+        else if (skipped.length === 1000)
+            skipped.push({ path: '.', reason: 'Skipped-item detail limit reached; additional paths omitted' });
+    };
+    async function walk(relative, depth = 0) {
+        if (halted)
+            return;
+        if (depth > 64) {
+            limited(relative, 'Directory depth limit reached');
+            return;
+        }
+        const directory = path.join(root, relative);
+        const entries = [];
+        try {
+            const info = await lstat(directory);
+            if (info.isSymbolicLink() || !isWithin(root, await realpath(directory))) {
+                limited(relative, 'Symbolic links are not followed');
+                return;
+            }
+            const handle = await opendir(directory);
+            for await (const entry of handle) {
+                if (++entriesVisited > 100000) {
+                    limited(relative, 'Scan entry limit reached');
+                    halted = true;
+                    break;
+                }
+                entries.push(entry);
+            }
+        }
+        catch (error) {
+            if (!relative)
+                throw error;
+            limited(relative, `Directory could not be read (${error.code ?? 'unknown'})`);
+            return;
+        }
+        entries.sort((a, b) => a.name.localeCompare(b.name, 'en'));
+        for (const entry of entries) {
+            if (halted)
+                break;
+            const file = slash(path.join(relative, entry.name));
+            if (excludes.some(p => file === p || file.startsWith(p + '/'))) {
+                limited(file, 'Explicitly excluded');
+                continue;
+            }
+            if (entry.isSymbolicLink()) {
+                limited(file, 'Symbolic links are not followed');
+                continue;
+            }
+            if (entry.isDirectory()) {
+                if (!ignored.has(entry.name))
+                    await walk(file, depth + 1);
+                continue;
+            }
+            const metadata = describe(file);
+            if (!entry.isFile() || !metadata || (options.agent && !metadata.agents.includes(options.agent)))
+                continue;
+            if (sources.length >= 1000 || totalBytes >= 8 * 1024 * 1024 || rules.length >= 10000) {
+                limited(file, 'Scan file, byte or rule limit reached');
+                halted = true;
+                break;
+            }
+            let content, bytes;
+            try {
+                const read = await readLocalFile(root, path.join(root, file), Math.min(1024 * 1024, 8 * 1024 * 1024 - totalBytes));
+                content = read.text;
+                bytes = read.bytes;
+            }
+            catch (error) {
+                const message = error.message;
+                limited(file, message === 'File size limit exceeded' ? 'Instruction file exceeds 1 MiB or remaining scan byte limit' : `Instruction file could not be read (${error.code ?? message})`);
+                continue;
+            }
+            totalBytes += bytes;
+            const source = { ...metadata, bytes, estimatedTokens: estimateTokens(content), ruleCount: 0 };
+            const extracted = parse(content, source);
+            const supported = extracted.filter(r => r.text.length <= 8192);
+            if (supported.length !== extracted.length)
+                limited(file, 'Instruction paragraph exceeds 8192 character limit');
+            const remaining = 10000 - rules.length;
+            if (supported.length > remaining) {
+                limited(file, 'Scan rule limit reached');
+                halted = true;
+            }
+            const accepted = supported.slice(0, remaining);
+            source.ruleCount = accepted.length;
+            if (source.activation !== 'directory')
+                limited(file, 'Activation conditions are not resolved; cross-file comparisons disabled');
+            sources.push(source);
+            rules.push(...accepted);
+        }
+    }
+    await walk('');
+    return { root, sources, rules, skipped };
+}
+//# sourceMappingURL=scanner.js.map

package/dist/scanner.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,64 @@
+export declare const agents: readonly ["claude", "codex", "cursor", "copilot"];
+export type Agent = typeof agents[number];
+export interface Source {
+    path: string;
+    agents: Agent[];
+    scope: string;
+    activation: 'directory' | 'conditional' | 'unknown';
+    estimatedTokens: number;
+    bytes: number;
+    ruleCount: number;
+}
+export interface Rule {
+    text: string;
+    normalized: string;
+    line: number;
+    endLine: number;
+    source: Source;
+    conditional: boolean;
+    context: string;
+}
+export interface Location {
+    path: string;
+    line: number;
+    endLine: number;
+    text: string;
+}
+export interface Finding {
+    id: 'DUPLICATE_RULE' | 'PACKAGE_MANAGER_CONFLICT' | 'POLARITY_CONFLICT' | 'BROKEN_REFERENCE';
+    severity: 'info' | 'warning';
+    confidence: 'high' | 'medium';
+    message: string;
+    reason: string;
+    agents: Agent[];
+    locations: Location[];
+}
+export interface Report {
+    schemaVersion: '1.0';
+    root: string;
+    projectName?: string;
+    status?: 'complete' | 'limited' | 'no-sources';
+    options: {
+        agent: Agent | null;
+        exclude: string[];
+    };
+    tokenEstimation: string;
+    sources: Source[];
+    findings: Finding[];
+    skipped: {
+        path: string;
+        reason: string;
+    }[];
+    summary: {
+        files: number;
+        rules: number;
+        estimatedTokens: number;
+        conflicts: number;
+        duplicates: number;
+        brokenReferences: number;
+    };
+}
+export interface ScanOptions {
+    agent?: Agent;
+    exclude?: string[];
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export const agents = ['claude', 'codex', 'cursor', 'copilot'];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAC"}

package/docs/report.schema.json

@@ -0,0 +1,68 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "ContextLint report v1.0",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "root", "options", "tokenEstimation", "sources", "findings", "skipped", "summary"],
+  "properties": {
+    "schemaVersion": { "const": "1.0" },
+    "root": { "type": "string" },
+    "projectName": { "type": "string", "minLength": 1 },
+    "status": { "enum": ["complete", "limited", "no-sources"] },
+    "options": {
+      "type": "object", "additionalProperties": false, "required": ["agent", "exclude"],
+      "properties": {
+        "agent": { "enum": [null, "claude", "codex", "cursor", "copilot"] },
+        "exclude": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "tokenEstimation": { "type": "string" },
+    "sources": { "type": "array", "items": { "$ref": "#/$defs/source" } },
+    "findings": { "type": "array", "items": { "$ref": "#/$defs/finding" } },
+    "skipped": {
+      "type": "array", "items": {
+        "type": "object", "additionalProperties": false, "required": ["path", "reason"],
+        "properties": { "path": { "type": "string" }, "reason": { "type": "string" } }
+      }
+    },
+    "summary": {
+      "type": "object", "additionalProperties": false,
+      "required": ["files", "rules", "estimatedTokens", "conflicts", "duplicates", "brokenReferences"],
+      "properties": {
+        "files": { "$ref": "#/$defs/count" }, "rules": { "$ref": "#/$defs/count" },
+        "estimatedTokens": { "$ref": "#/$defs/count" }, "conflicts": { "$ref": "#/$defs/count" },
+        "duplicates": { "$ref": "#/$defs/count" }, "brokenReferences": { "$ref": "#/$defs/count" }
+      }
+    }
+  },
+  "$defs": {
+    "count": { "type": "integer", "minimum": 0 },
+    "agents": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "enum": ["claude", "codex", "cursor", "copilot"] } },
+    "source": {
+      "type": "object", "additionalProperties": false,
+      "required": ["path", "agents", "scope", "activation", "estimatedTokens", "bytes", "ruleCount"],
+      "properties": {
+        "path": { "type": "string" }, "agents": { "$ref": "#/$defs/agents" }, "scope": { "type": "string" },
+        "activation": { "enum": ["directory", "conditional", "unknown"] },
+        "estimatedTokens": { "$ref": "#/$defs/count" }, "bytes": { "$ref": "#/$defs/count" }, "ruleCount": { "$ref": "#/$defs/count" }
+      }
+    },
+    "location": {
+      "type": "object", "additionalProperties": false, "required": ["path", "line", "endLine", "text"],
+      "properties": {
+        "path": { "type": "string" }, "line": { "type": "integer", "minimum": 1 },
+        "endLine": { "type": "integer", "minimum": 1 }, "text": { "type": "string" }
+      }
+    },
+    "finding": {
+      "type": "object", "additionalProperties": false,
+      "required": ["id", "severity", "confidence", "message", "reason", "agents", "locations"],
+      "properties": {
+        "id": { "enum": ["DUPLICATE_RULE", "PACKAGE_MANAGER_CONFLICT", "POLARITY_CONFLICT", "BROKEN_REFERENCE"] },
+        "severity": { "enum": ["info", "warning"] }, "confidence": { "enum": ["high", "medium"] },
+        "message": { "type": "string" }, "reason": { "type": "string" }, "agents": { "$ref": "#/$defs/agents" },
+        "locations": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/location" } }
+      }
+    }
+  }
+}