@aicqtools/guardrail 1.0.0-alpha.10

package/dist/runner/run-file.js

@@ -0,0 +1,48 @@
+import { readFile } from 'node:fs/promises';
+import { detectLanguage, parseSource } from '@aicqtools/core';
+import { runRule } from './run-rule.js';
+import { applySuppressions, parseSuppressions } from './suppressions.js';
+export async function runFile(filePath, rules) {
+    const language = detectLanguage(filePath);
+    if (!language)
+        return { filePath, language: null, diagnostics: [] };
+    const source = await readFile(filePath, 'utf-8');
+    return runFileWithSource(filePath, source, language, rules);
+}
+export function runFileWithSource(filePath, source, language, rules) {
+    const tree = parseSource(language, source);
+    const diagnostics = [];
+    const run = { filePath, source, language, diagnostics };
+    for (const rule of rules) {
+        try {
+            runRule(rule, run, tree);
+        }
+        catch (err) {
+            diagnostics.push(ruleFailedDiagnostic(filePath, rule.id, err));
+        }
+    }
+    // Apply inline-suppression directives last so they catch diagnostics from every rule
+    // (function rules, YAML pattern rules, and synthetic `@aicq/parse-failed`/rule-failed).
+    let suppressed = diagnostics;
+    try {
+        const suppressions = parseSuppressions(tree, source, language);
+        suppressed = applySuppressions(diagnostics, suppressions);
+    }
+    catch {
+        // Suppression parsing must never abort a run. If the tree shape surprises us,
+        // fall through with the unfiltered diagnostics.
+    }
+    return { filePath, language, diagnostics: suppressed };
+}
+function ruleFailedDiagnostic(filePath, ruleId, err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return {
+        ruleId: '@aicq/parse-failed',
+        severity: 'warning',
+        message: `parser failed in rule ${ruleId}: ${message}`,
+        messageKo: `파서 실패 (룰 ${ruleId}): ${message}`,
+        file: filePath,
+        range: { start: { line: 1, column: 1 }, end: { line: 1, column: 1 } },
+    };
+}
+//# sourceMappingURL=run-file.js.map

package/dist/runner/run-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-file.js","sourceRoot":"","sources":["../../src/runner/run-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9D,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAQzE,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,QAAgB,EAAE,KAAsB;IACpE,MAAM,QAAQ,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC1C,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;IAEpE,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACjD,OAAO,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,QAAgB,EAChB,MAAc,EACd,QAAkB,EAClB,KAAsB;IAEtB,MAAM,IAAI,GAAG,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC3C,MAAM,WAAW,GAAiB,EAAE,CAAC;IACrC,MAAM,GAAG,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAC3B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,WAAW,CAAC,IAAI,CAAC,oBAAoB,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IACD,qFAAqF;IACrF,wFAAwF;IACxF,IAAI,UAAU,GAA0B,WAAW,CAAC;IACpD,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC/D,UAAU,GAAG,iBAAiB,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,8EAA8E;QAC9E,gDAAgD;IAClD,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;AACzD,CAAC;AAED,SAAS,oBAAoB,CAAC,QAAgB,EAAE,MAAc,EAAE,GAAY;IAC1E,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO;QACL,MAAM,EAAE,oBAAoB;QAC5B,QAAQ,EAAE,SAAS;QACnB,OAAO,EAAE,yBAAyB,MAAM,KAAK,OAAO,EAAE;QACtD,SAAS,EAAE,YAAY,MAAM,MAAM,OAAO,EAAE;QAC5C,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE;KACtE,CAAC;AACJ,CAAC"}

package/dist/runner/run-project.d.ts

@@ -0,0 +1,30 @@
+import type { CheckResult, RuleOverride } from '@aicqtools/core';
+import { FileCache } from '@aicqtools/core';
+import type { Rule } from '@aicqtools/rule-sdk';
+export interface RunProjectOptions {
+    readonly cwd: string;
+    readonly include: readonly string[];
+    readonly exclude: readonly string[];
+    readonly rules: readonly Rule[];
+    readonly cache?: FileCache;
+    /**
+     * When true, the file walker appends entries from the repo-root `.gitignore` to the effective
+     * exclude list. Unreadable / missing / malformed `.gitignore` is silently ignored (never throws).
+     * Defaults to false to keep behavior deterministic across projects.
+     */
+    readonly respectGitignore?: boolean;
+    /**
+     * Per-path rule overrides (alpha.8). When set, each file's rule set is re-resolved against
+     * matching `overrides` entries on top of the globally-resolved `rules` baseline. Empty array
+     * (or omitted) is the fast path — runner falls back to the baseline list unchanged.
+     */
+    readonly overrides?: readonly RuleOverride[];
+}
+export declare function runProject(opts: RunProjectOptions): Promise<CheckResult>;
+/**
+ * Build the final ignore list for `fast-glob`. Always starts from the configured `exclude`;
+ * when `respectGitignore` is true, parses the root `.gitignore` (best-effort) and appends its
+ * entries. Negation (`!pattern`) and trailing-slash directory entries are honored.
+ */
+export declare function resolveIgnores(cwd: string, exclude: readonly string[], respectGitignore: boolean): Promise<string[]>;
+//# sourceMappingURL=run-project.d.ts.map

package/dist/runner/run-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-project.d.ts","sourceRoot":"","sources":["../../src/runner/run-project.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAc,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAwB,MAAM,iBAAiB,CAAC;AAClE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAKhD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;CAC9C;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAmE9E;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,gBAAgB,EAAE,OAAO,GACxB,OAAO,CAAC,MAAM,EAAE,CAAC,CAyBnB"}

package/dist/runner/run-project.js

@@ -0,0 +1,118 @@
+import fastGlob from 'fast-glob';
+import { readFile, stat } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { FileCache, hashRulesetSignature } from '@aicqtools/core';
+import { applyOverridesForFile } from './apply-rule-config.js';
+import { runFile } from './run-file.js';
+import { rulesetSignature } from './ruleset-signature.js';
+export async function runProject(opts) {
+    const start = Date.now();
+    const ignore = await resolveIgnores(opts.cwd, opts.exclude, opts.respectGitignore ?? false);
+    const files = await fastGlob([...opts.include], {
+        cwd: opts.cwd,
+        ignore,
+        absolute: true,
+        onlyFiles: true,
+        dot: false,
+    });
+    const cache = opts.cache;
+    const overrides = opts.overrides ?? [];
+    // Per-entry match counters (alpha.10). Allocated only when overrides is non-empty so the
+    // unused-feature fast path stays allocation-free. Slots that remain 0 after the scan are
+    // reported by the CLI as "matched no files — ignored." warnings.
+    const matchCounts = overrides.length > 0 ? new Array(overrides.length).fill(0) : undefined;
+    // The ruleset hash mixes in the overrides shape so cache entries invalidate when a user adds,
+    // removes, or edits override paths/rules. Without this, a stale entry could survive a config
+    // change that should have flipped a diagnostic on or off.
+    const rulesHash = cache
+        ? hashRulesetSignature([
+            ...rulesetSignature(opts.rules),
+            'overrides=' + JSON.stringify(overrides),
+        ])
+        : '';
+    const diagnostics = [];
+    for (const file of files) {
+        try {
+            const fileRules = applyOverridesForFile(opts.rules, overrides, file, matchCounts);
+            if (cache) {
+                const st = await stat(file);
+                const cached = cache.get({
+                    filePath: file,
+                    mtime: Math.floor(st.mtimeMs),
+                    size: st.size,
+                    rulesHash,
+                });
+                if (cached) {
+                    diagnostics.push(...cached);
+                    continue;
+                }
+                const result = await runFile(file, fileRules);
+                cache.set({ filePath: file, mtime: Math.floor(st.mtimeMs), size: st.size, rulesHash }, result.diagnostics);
+                diagnostics.push(...result.diagnostics);
+            }
+            else {
+                const result = await runFile(file, fileRules);
+                diagnostics.push(...result.diagnostics);
+            }
+        }
+        catch (err) {
+            // Per-file isolation: a parser crash or rule throw on one file must not abort the whole run.
+            // Skip cache.set on failure so the next run retries instead of caching the error.
+            diagnostics.push(parseFailedDiagnostic(file, err));
+        }
+    }
+    return {
+        diagnostics,
+        filesScanned: files.length,
+        durationMs: Date.now() - start,
+        ...(matchCounts ? { overrideMatchCounts: matchCounts } : {}),
+    };
+}
+/**
+ * Build the final ignore list for `fast-glob`. Always starts from the configured `exclude`;
+ * when `respectGitignore` is true, parses the root `.gitignore` (best-effort) and appends its
+ * entries. Negation (`!pattern`) and trailing-slash directory entries are honored.
+ */
+export async function resolveIgnores(cwd, exclude, respectGitignore) {
+    const ignores = [...exclude];
+    if (!respectGitignore)
+        return ignores;
+    try {
+        const gitignorePath = resolve(cwd, '.gitignore');
+        const st = await stat(gitignorePath);
+        if (!st.isFile())
+            return ignores;
+        const text = await readFile(gitignorePath, 'utf-8');
+        for (const raw of text.split(/\r?\n/)) {
+            const line = raw.trim();
+            if (line.length === 0 || line.startsWith('#'))
+                continue;
+            // We intentionally don't try to fully emulate gitignore semantics — just translate the
+            // common shapes into fast-glob globs. Anything we can't reason about we leave as-is.
+            const negated = line.startsWith('!');
+            const body = (negated ? line.slice(1) : line).trim();
+            if (body.length === 0)
+                continue;
+            // Directory entry like `out/` → `**/out/**`
+            const cleaned = body.replace(/\/$/, '');
+            const glob = cleaned.includes('/') ? cleaned : `**/${cleaned}/**`;
+            ignores.push(negated ? `!${glob}` : glob);
+        }
+    }
+    catch {
+        // `.gitignore` missing / unreadable / not a regular file — fall through with static excludes.
+    }
+    return ignores;
+}
+function parseFailedDiagnostic(file, err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return {
+        ruleId: '@aicq/parse-failed',
+        severity: 'warning',
+        message: `parser failed during file parse: ${message}`,
+        messageKo: `파서 실패 (파일 파싱 단계): ${message}`,
+        file,
+        range: { start: { line: 1, column: 1 }, end: { line: 1, column: 1 } },
+    };
+}
+//# sourceMappingURL=run-project.js.map

package/dist/runner/run-project.js.map

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

package/dist/runner/run-rule.d.ts

@@ -0,0 +1,5 @@
+import Parser from 'tree-sitter';
+import type { Rule } from '@aicqtools/rule-sdk';
+import { type RunContext } from './context.js';
+export declare function runRule(rule: Rule, run: RunContext, tree: Parser.Tree): void;
+//# sourceMappingURL=run-rule.d.ts.map

package/dist/runner/run-rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-rule.d.ts","sourceRoot":"","sources":["../../src/runner/run-rule.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AAGjC,OAAO,KAAK,EAAE,IAAI,EAA6B,MAAM,qBAAqB,CAAC;AAE3E,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAyChE,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAK5E"}

package/dist/runner/run-rule.js

@@ -0,0 +1,53 @@
+import Parser from 'tree-sitter';
+import micromatch from 'micromatch';
+import { traverse } from '../matcher/traverse.js';
+import { makeRuleContext } from './context.js';
+import { loadLanguage } from '@aicqtools/core';
+function ruleAppliesTo(rule, language) {
+    const langs = Array.isArray(rule.language) ? rule.language : [rule.language];
+    return langs.includes(language);
+}
+/**
+ * Honor `rule.pathExclude` — a list of micromatch globs. Matching is performed against the
+ * file path as supplied (absolute by default in normal runs, fixture-relative in unit tests),
+ * and also against the path with backslashes normalized to forward slashes so authors can write
+ * `**\/llm/client.*` without worrying about Windows separators. The match is "any glob" — one
+ * match is enough to skip the rule for the file.
+ */
+function isPathExcluded(rule, filePath) {
+    if (!rule.pathExclude || rule.pathExclude.length === 0)
+        return false;
+    const globs = [...rule.pathExclude];
+    const normalized = filePath.replace(/\\/g, '/');
+    return micromatch.isMatch(normalized, globs, { dot: true }) || micromatch.isMatch(filePath, globs, { dot: true });
+}
+function runFunctionRule(rule, run, tree) {
+    const ctx = makeRuleContext(run, rule);
+    traverse(tree.rootNode, (node) => {
+        const visitor = rule.visitors[node.type];
+        if (visitor)
+            visitor(node, ctx);
+    });
+}
+function runPatternRule(rule, run, tree) {
+    const lang = loadLanguage(run.language);
+    const query = new Parser.Query(lang, rule.query);
+    const matches = query.matches(tree.rootNode);
+    const ctx = makeRuleContext(run, rule);
+    for (const match of matches) {
+        const target = match.captures[0]?.node;
+        if (target)
+            ctx.report({ node: target });
+    }
+}
+export function runRule(rule, run, tree) {
+    if (!ruleAppliesTo(rule, run.language))
+        return;
+    if (isPathExcluded(rule, run.filePath))
+        return;
+    if (rule.kind === 'function')
+        runFunctionRule(rule, run, tree);
+    else
+        runPatternRule(rule, run, tree);
+}
+//# sourceMappingURL=run-rule.js.map

package/dist/runner/run-rule.js.map

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

package/dist/runner/suppressions.d.ts

@@ -0,0 +1,37 @@
+import type Parser from 'tree-sitter';
+import type { Diagnostic, Language } from '@aicqtools/core';
+/**
+ * Inline suppression directives — ESLint-style comment markers that suppress diagnostics
+ * for a specific line, the next line, or the entire file. Supported syntaxes:
+ *
+ *   // aicq-disable-next-line <rule-id>[, <rule-id>...]
+ *   // aicq-disable-line       <rule-id>[, ...]
+ *   // aicq-disable-file       <rule-id>[, ...]
+ *
+ * Python uses `#` instead of `//`. Block comments (`/* ...\*\/`) are also recognized.
+ * The trailing rule-id list may be omitted — a bare directive suppresses *all* rules for that
+ * scope. Multiple ids may be separated by commas, whitespace, or both. Unknown ids are silently
+ * accepted (a project may rename rules; we don't want a stale directive to crash the run).
+ */
+export type Scope = number | 'file';
+export interface Suppressions {
+    /** Per-line maps: line number → set of rule ids ('*' = all). */
+    readonly byLine: Map<number, Set<string> | '*'>;
+    /** File-wide suppressions. */
+    readonly fileLevel: Set<string> | '*' | null;
+}
+/**
+ * Walk the tree's comment nodes and produce a Suppressions map. Never throws — if the grammar
+ * yields no comment nodes for a given language, the result is empty (and applySuppressions is
+ * a no-op). The `language` parameter is reserved for future per-language tweaks; today it's
+ * only used to recognize that block comments may span multiple lines.
+ */
+export declare function parseSuppressions(tree: Parser.Tree, source: string, language: Language): Suppressions;
+/**
+ * Filter diagnostics through the parsed suppressions. Diagnostics whose `ruleId` is suppressed
+ * either file-wide or on its specific line are removed. `@aicq/parse-failed` (and any other
+ * synthetic diagnostic emitted by the runner) is treated like any other rule and can be
+ * suppressed by id or with a bare directive.
+ */
+export declare function applySuppressions(diagnostics: readonly Diagnostic[], suppressions: Suppressions): Diagnostic[];
+//# sourceMappingURL=suppressions.d.ts.map

package/dist/runner/suppressions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suppressions.d.ts","sourceRoot":"","sources":["../../src/runner/suppressions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAG5D;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAEpC,MAAM,WAAW,YAAY;IAC3B,gEAAgE;IAChE,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC;IAChD,8BAA8B;IAC9B,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC;CAC9C;AAMD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,CAAC,IAAI,EACjB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,GACjB,YAAY,CA0Dd;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,SAAS,UAAU,EAAE,EAClC,YAAY,EAAE,YAAY,GACzB,UAAU,EAAE,CAed"}

package/dist/runner/suppressions.js

@@ -0,0 +1,127 @@
+import { traverse } from '../matcher/traverse.js';
+const COMMENT_NODE_TYPES = new Set(['comment', 'block_comment', 'line_comment']);
+// Capture group 1: directive verb. Group 2: optional rule-id list.
+const DIRECTIVE_RE = /aicq-disable-(next-line|line|file)\b\s*(.*)/i;
+/**
+ * Walk the tree's comment nodes and produce a Suppressions map. Never throws — if the grammar
+ * yields no comment nodes for a given language, the result is empty (and applySuppressions is
+ * a no-op). The `language` parameter is reserved for future per-language tweaks; today it's
+ * only used to recognize that block comments may span multiple lines.
+ */
+export function parseSuppressions(tree, source, language) {
+    void language; // currently uniform across supported languages
+    const byLine = new Map();
+    let fileLevel = null;
+    const mergeAtLine = (line, ids) => {
+        const existing = byLine.get(line);
+        if (existing === undefined) {
+            byLine.set(line, ids === '*' ? '*' : new Set(ids));
+            return;
+        }
+        if (existing === '*' || ids === '*') {
+            byLine.set(line, '*');
+            return;
+        }
+        for (const id of ids)
+            existing.add(id);
+    };
+    const mergeFile = (ids) => {
+        if (fileLevel === '*' || ids === '*') {
+            fileLevel = '*';
+            return;
+        }
+        if (fileLevel === null) {
+            fileLevel = new Set(ids);
+            return;
+        }
+        for (const id of ids)
+            fileLevel.add(id);
+    };
+    traverse(tree.rootNode, (node) => {
+        if (!COMMENT_NODE_TYPES.has(node.type))
+            return;
+        const raw = source.slice(node.startIndex, node.endIndex);
+        // Strip comment delimiters before regex match so the body is what we scan.
+        const body = stripCommentDelimiters(raw);
+        const m = DIRECTIVE_RE.exec(body);
+        if (!m)
+            return;
+        const verb = m[1]?.toLowerCase();
+        if (!verb)
+            return;
+        const ids = parseRuleIds(m[2] ?? '');
+        if (verb === 'file') {
+            mergeFile(ids);
+            return;
+        }
+        // Lines are 1-based to match Diagnostic.range.start.line
+        const startLine = node.startPosition.row + 1;
+        const endLine = node.endPosition.row + 1;
+        if (verb === 'next-line') {
+            mergeAtLine(endLine + 1, ids);
+        }
+        else {
+            // 'line' — for a leading standalone comment, apply to the comment's own line(s).
+            // For a trailing comment (e.g. `code; // aicq-disable-line`), the comment is on the
+            // same line as the code, so this also applies correctly.
+            for (let l = startLine; l <= endLine; l++)
+                mergeAtLine(l, ids);
+        }
+    });
+    return { byLine, fileLevel };
+}
+/**
+ * Filter diagnostics through the parsed suppressions. Diagnostics whose `ruleId` is suppressed
+ * either file-wide or on its specific line are removed. `@aicq/parse-failed` (and any other
+ * synthetic diagnostic emitted by the runner) is treated like any other rule and can be
+ * suppressed by id or with a bare directive.
+ */
+export function applySuppressions(diagnostics, suppressions) {
+    if (suppressions.fileLevel === '*')
+        return [];
+    const fileSet = suppressions.fileLevel instanceof Set ? suppressions.fileLevel : null;
+    const hasAnyLine = suppressions.byLine.size > 0;
+    if (!fileSet && !hasAnyLine)
+        return [...diagnostics];
+    const out = [];
+    for (const d of diagnostics) {
+        if (fileSet && fileSet.has(d.ruleId))
+            continue;
+        const lineMap = suppressions.byLine.get(d.range.start.line);
+        if (lineMap === '*')
+            continue;
+        if (lineMap && lineMap.has(d.ruleId))
+            continue;
+        out.push(d);
+    }
+    return out;
+}
+function stripCommentDelimiters(raw) {
+    // `//foo` → `foo`, `# foo` → `foo`, `/* foo */` → `foo`, `<!-- foo -->` (just in case) → `foo`
+    return raw
+        .replace(/^\s*\/\*/, '')
+        .replace(/\*\/\s*$/, '')
+        .replace(/^\s*\/\//, '')
+        .replace(/^\s*#/, '')
+        .replace(/^\s*<!--/, '')
+        .replace(/-->\s*$/, '')
+        .trim();
+}
+/**
+ * Split the directive tail into a set of rule ids. Empty tail → '*' (bare directive).
+ * Accepts commas, whitespace, or both as separators; ignores empty tokens; lowercases nothing
+ * (rule ids are case-sensitive). Returns `'*'` when the tail is empty.
+ */
+function parseRuleIds(tail) {
+    const trimmed = tail.trim();
+    if (trimmed.length === 0)
+        return '*';
+    const tokens = trimmed
+        .split(/[,\s]+/)
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0);
+    if (tokens.length === 0)
+        return '*';
+    return new Set(tokens);
+}
+//# sourceMappingURL=suppressions.js.map

package/dist/runner/suppressions.js.map

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

package/dist/suggest/analyze.d.ts

@@ -0,0 +1,10 @@
+import type { AnalyzeRepoOptions, RuleSuggestionReport } from './types.js';
+/**
+ * Approach A — built-in rule recommender. Scans the repo with all supplied rules,
+ * ranks them by how many violations they would flag, and emits a paste-ready
+ * `aicq.config.yaml` enable-snippet. Also reads `package.json` / `requirements.txt`
+ * (no AST) and flags built-in rules whose id/docs/message mentions a declared
+ * dependency ("stack match").
+ */
+export declare function analyzeRepo(opts: AnalyzeRepoOptions): Promise<RuleSuggestionReport>;
+//# sourceMappingURL=analyze.d.ts.map

package/dist/suggest/analyze.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../src/suggest/analyze.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,kBAAkB,EAGlB,oBAAoB,EAErB,MAAM,YAAY,CAAC;AAiBpB;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAmFzF"}