@aicqtools/guardrail 1.0.0-alpha.5 → 1.0.0-alpha.7

package/dist/suggest/mine.js

@@ -0,0 +1,207 @@
+import { readFile } from 'node:fs/promises';
+import fastGlob from 'fast-glob';
+import Parser from 'tree-sitter';
+import { detectLanguage, loadLanguage, parseSource } from '@aicqtools/core';
+import { traverse } from '../matcher/traverse.js';
+import { resolveIgnores } from '../runner/run-project.js';
+const DEFAULT_MIN_COUNT = 5;
+const DEFAULT_TOP = 10;
+const MAX_FILES = 5000;
+const MAX_SAMPLES = 2;
+const IDENTIFIER_RE = /^[A-Za-z_$][\w$]*$/;
+/**
+ * Common stdlib / global names whose `new X()` and `X.method()` invocations are universal
+ * patterns — they would generate noisy, useless draft rules ("don't construct Map", "don't
+ * call JSON.parse"). Dropping them keeps `--patterns` output focused on genuinely
+ * project-specific shapes.
+ */
+const STDLIB_BLOCKLIST = new Set([
+    'Array', 'Object', 'Map', 'Set', 'WeakMap', 'WeakSet', 'Date', 'Promise', 'RegExp',
+    'Error', 'TypeError', 'RangeError', 'SyntaxError',
+    'JSON', 'console', 'Math', 'process', 'Buffer', 'Symbol', 'Number', 'String', 'Boolean',
+    'Function', 'URL', 'URLSearchParams',
+]);
+/**
+ * Approach B (early prototype) — mine the AST for frequently-occurring
+ * `new X(...)` / `obj.method(...)` shapes and turn the top ones into draft
+ * tree-sitter pattern rules. `severity` is conservatively `info` and the
+ * `message`/`messageKo` are TODO placeholders — these are seeds a human edits,
+ * not finished rules. Every generated query is compiled against the language
+ * grammar before it is emitted; ones that don't compile are dropped.
+ */
+export async function minePatterns(opts) {
+    const minCount = Math.max(1, opts.minCount ?? DEFAULT_MIN_COUNT);
+    const top = Math.max(1, opts.top ?? DEFAULT_TOP);
+    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,
+    })).slice(0, MAX_FILES);
+    const buckets = new Map();
+    for (const file of files) {
+        const language = detectLanguage(file);
+        if (!language)
+            continue;
+        let tree;
+        let source;
+        try {
+            source = await readFile(file, 'utf-8');
+            tree = parseSource(language, source);
+        }
+        catch {
+            continue; // per-file isolation — a broken file must not abort mining
+        }
+        const textOf = (node) => source.slice(node.startIndex, node.endIndex);
+        try {
+            traverse(tree.rootNode, (node) => {
+                const sig = extractSignature(node, language, textOf);
+                if (!sig)
+                    return;
+                const key = `${language}::${sig.signature}`;
+                let bucket = buckets.get(key);
+                if (!bucket) {
+                    bucket = {
+                        signature: sig.signature,
+                        language,
+                        kind: sig.kind,
+                        parts: sig.parts,
+                        count: 0,
+                        files: new Set(),
+                        samples: [],
+                    };
+                    buckets.set(key, bucket);
+                }
+                bucket.count += 1;
+                bucket.files.add(file);
+                if (bucket.samples.length < MAX_SAMPLES) {
+                    bucket.samples.push({
+                        file,
+                        line: node.startPosition.row + 1,
+                        column: node.startPosition.column + 1,
+                    });
+                }
+            });
+        }
+        catch {
+            continue;
+        }
+    }
+    const candidates = [...buckets.values()]
+        .filter((b) => b.count >= minCount)
+        .sort((a, b) => b.count - a.count || a.signature.localeCompare(b.signature));
+    const drafts = [];
+    for (const bucket of candidates) {
+        if (drafts.length >= top)
+            break;
+        const query = buildQuery(bucket);
+        if (!query || !queryCompiles(query, bucket.language))
+            continue;
+        drafts.push(makeDraft(bucket, query));
+    }
+    return drafts;
+}
+function extractSignature(node, language, textOf) {
+    if (language === 'python') {
+        if (node.type !== 'call')
+            return null;
+        const fn = node.childForFieldName('function');
+        if (!fn || fn.type !== 'attribute')
+            return null;
+        const obj = fn.childForFieldName('object');
+        const attr = fn.childForFieldName('attribute');
+        if (!obj || obj.type !== 'identifier' || !attr || attr.type !== 'identifier')
+            return null;
+        const o = textOf(obj);
+        const a = textOf(attr);
+        if (!IDENTIFIER_RE.test(o) || !IDENTIFIER_RE.test(a))
+            return null;
+        if (STDLIB_BLOCKLIST.has(o))
+            return null;
+        return { signature: `call:${o}.${a}`, kind: 'call', parts: [o, a] };
+    }
+    // typescript / tsx / javascript
+    if (node.type === 'new_expression') {
+        const ctor = node.childForFieldName('constructor');
+        if (!ctor || ctor.type !== 'identifier')
+            return null;
+        const name = textOf(ctor);
+        if (!IDENTIFIER_RE.test(name))
+            return null;
+        if (STDLIB_BLOCKLIST.has(name))
+            return null;
+        return { signature: `new:${name}`, kind: 'new', parts: [name] };
+    }
+    if (node.type === 'call_expression') {
+        const fn = node.childForFieldName('function');
+        if (!fn || fn.type !== 'member_expression')
+            return null;
+        const obj = fn.childForFieldName('object');
+        const prop = fn.childForFieldName('property');
+        if (!obj || obj.type !== 'identifier' || !prop || prop.type !== 'property_identifier')
+            return null;
+        const o = textOf(obj);
+        const p = textOf(prop);
+        if (!IDENTIFIER_RE.test(o) || !IDENTIFIER_RE.test(p))
+            return null;
+        if (STDLIB_BLOCKLIST.has(o))
+            return null;
+        return { signature: `call:${o}.${p}`, kind: 'call', parts: [o, p] };
+    }
+    return null;
+}
+function buildQuery(bucket) {
+    if (bucket.kind === 'new') {
+        const name = bucket.parts[0];
+        if (!name)
+            return null;
+        return `(new_expression\n  constructor: (identifier) @ctor\n  (#eq? @ctor "${name}"))`;
+    }
+    const [obj, prop] = bucket.parts;
+    if (!obj || !prop)
+        return null;
+    if (bucket.language === 'python') {
+        return (`(call\n` +
+            `  function: (attribute\n` +
+            `    object: (identifier) @obj\n` +
+            `    attribute: (identifier) @attr)\n` +
+            `  (#eq? @obj "${obj}")\n` +
+            `  (#eq? @attr "${prop}"))`);
+    }
+    return (`(call_expression\n` +
+        `  function: (member_expression\n` +
+        `    object: (identifier) @obj\n` +
+        `    property: (property_identifier) @prop)\n` +
+        `  (#eq? @obj "${obj}")\n` +
+        `  (#eq? @prop "${prop}"))`);
+}
+function queryCompiles(query, language) {
+    try {
+        // eslint-disable-next-line no-new
+        new Parser.Query(loadLanguage(language), query);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function makeDraft(bucket, query) {
+    const slug = bucket.signature
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    const filesN = bucket.files.size;
+    const fileWord = (n, en) => (en ? `file${n === 1 ? '' : 's'}` : '개');
+    return {
+        id: `suggested-${slug}`,
+        language: bucket.language,
+        severity: 'info',
+        message: `TODO: explain why \`${bucket.signature}\` warrants a project rule — auto-suggested, ${bucket.count} occurrences across ${filesN} ${fileWord(filesN, true)}.`,
+        messageKo: `TODO: \`${bucket.signature}\` 사용을 프로젝트 룰로 만들 이유를 설명하세요 — 자동 제안, 파일 ${filesN}${fileWord(filesN, false)}에서 ${bucket.count}회.`,
+        query,
+        meta: { count: bucket.count, files: filesN, sampleLocations: bucket.samples },
+    };
+}
+//# sourceMappingURL=mine.js.map

package/dist/suggest/mine.js.map

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

package/dist/suggest/types.d.ts

@@ -0,0 +1,74 @@
+import type { FileCache, Language, Severity } from '@aicqtools/core';
+import type { Rule } from '@aicqtools/rule-sdk';
+export interface SuggestSampleLocation {
+    readonly file: string;
+    readonly line: number;
+    readonly column: number;
+}
+export interface RuleSuggestion {
+    readonly ruleId: string;
+    readonly hits: number;
+    readonly severity: Severity;
+    readonly message: string;
+    readonly messageKo?: string;
+    readonly docs?: string;
+    readonly sampleLocations: readonly SuggestSampleLocation[];
+    readonly stackMatch?: boolean;
+    /**
+     * True when this rule is highly likely to dominate noise budgets in the suggested config:
+     * either it has substantially more hits than the next rule in the ranking, or it's an
+     * info-severity rule whose hit count exceeds the absolute "obviously noisy" threshold.
+     * Computed by `analyzeRepo`; consumed by both the text reporter (for a flag) and the
+     * YAML config-snippet builder (to emit such rules as commented-out lines).
+     */
+    readonly noisy?: boolean;
+}
+export type DependencySource = 'package.json' | 'requirements.txt';
+export interface DetectedDependency {
+    readonly name: string;
+    readonly source: DependencySource;
+}
+export interface PatternRuleDraft {
+    readonly id: string;
+    readonly language: Language;
+    readonly severity: 'info';
+    readonly message: string;
+    readonly messageKo: string;
+    readonly query: string;
+    readonly meta: {
+        readonly count: number;
+        readonly files: number;
+        readonly sampleLocations: readonly SuggestSampleLocation[];
+    };
+}
+export interface RuleSuggestionReport {
+    readonly filesScanned: number;
+    readonly languagesPresent: readonly Language[];
+    readonly durationMs: number;
+    readonly suggestions: readonly RuleSuggestion[];
+    readonly detectedDependencies: readonly DetectedDependency[];
+    /** A paste-ready `aicq.config.yaml` fragment that enables the suggested rules. */
+    readonly configSnippet: string;
+    readonly patternDrafts?: readonly PatternRuleDraft[];
+}
+export interface AnalyzeRepoOptions {
+    readonly cwd: string;
+    readonly include: readonly string[];
+    readonly exclude: readonly string[];
+    readonly rules: readonly Rule[];
+    readonly cache?: FileCache;
+    readonly top?: number;
+    readonly minHits?: number;
+    /** Mirror of `AicqConfig.respectGitignore`. Default false. */
+    readonly respectGitignore?: boolean;
+}
+export interface MinePatternsOptions {
+    readonly cwd: string;
+    readonly include: readonly string[];
+    readonly exclude: readonly string[];
+    readonly minCount?: number;
+    readonly top?: number;
+    /** Mirror of `AicqConfig.respectGitignore`. Default false. */
+    readonly respectGitignore?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/suggest/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/suggest/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/suggest/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aicqtools/guardrail",
-  "version": "1.0.0-alpha.5",
+  "version": "1.0.0-alpha.7",
   "type": "module",
   "description": "Deterministic AI code guardrail engine — 37 built-in rules, hybrid YAML/function DSL, MCP server, .cursorrules sync, sqlite cache.",
   "keywords": [
@@ -42,10 +42,11 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "fast-glob": "^3.3.2",
+    "micromatch": "^4.0.8",
     "yaml": "^2.6.1",
     "zod": "^3.23.8",
-    "@aicqtools/core": "1.0.0-alpha.5",
-    "@aicqtools/rule-sdk": "1.0.0-alpha.5"
+    "@aicqtools/core": "1.0.0-alpha.7",
+    "@aicqtools/rule-sdk": "1.0.0-alpha.7"
   },
   "peerDependencies": {
     "tree-sitter": "~0.22.4"
@@ -56,6 +57,7 @@
     }
   },
   "devDependencies": {
+    "@types/micromatch": "^4.0.9",
     "@types/node": "^22.10.0",
     "typescript": "^5.7.2",
     "vitest": "^2.1.8"