@aicqtools/guardrail 1.0.0-alpha.10

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/dist/sync/index.d.ts

@@ -0,0 +1,5 @@
+export { renderRules, injectIntoMarkdown, MARKER_START, MARKER_END, } from './render.js';
+export type { RenderOptions } from './render.js';
+export { syncAiRules } from './sync-files.js';
+export type { SyncOptions, SyncTarget } from './sync-files.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/sync/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,UAAU,GACX,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/sync/index.js

@@ -0,0 +1,3 @@
+export { renderRules, injectIntoMarkdown, MARKER_START, MARKER_END, } from './render.js';
+export { syncAiRules } from './sync-files.js';
+//# sourceMappingURL=index.js.map

package/dist/sync/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,UAAU,GACX,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/sync/render.d.ts

@@ -0,0 +1,9 @@
+import type { Rule } from '@aicqtools/rule-sdk';
+export interface RenderOptions {
+    readonly locale: 'ko' | 'en';
+}
+export declare function renderRules(rules: readonly Rule[], opts: RenderOptions): string;
+export declare const MARKER_START = "<!-- aicq:rules:start -->";
+export declare const MARKER_END = "<!-- aicq:rules:end -->";
+export declare function injectIntoMarkdown(existing: string | null, body: string): string;
+//# sourceMappingURL=render.d.ts.map

package/dist/sync/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/sync/render.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEhD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI,CAAC;CAC9B;AAoCD,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,EAAE,IAAI,EAAE,aAAa,GAAG,MAAM,CAmB/E;AAED,eAAO,MAAM,YAAY,8BAA8B,CAAC;AACxD,eAAO,MAAM,UAAU,4BAA4B,CAAC;AAEpD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAUhF"}

package/dist/sync/render.js

@@ -0,0 +1,70 @@
+function severityOrder(s) {
+    if (s === 'error')
+        return 0;
+    if (s === 'warning')
+        return 1;
+    return 2;
+}
+function sectionTitle(locale, s) {
+    if (locale === 'ko') {
+        if (s === 'error')
+            return '## 오류 (반드시 지킬 것)';
+        if (s === 'warning')
+            return '## 경고';
+        return '## 정보';
+    }
+    if (s === 'error')
+        return '## Errors (must not violate)';
+    if (s === 'warning')
+        return '## Warnings';
+    return '## Info';
+}
+function header(locale) {
+    if (locale === 'ko') {
+        return `# AI 코딩 가이드라인\n\n아래 규칙은 aicq가 커밋 단계에서 강제합니다. 자동 생성된 내용 — 수정은 \`aicq/rules/\` 에서.`;
+    }
+    return `# AI Coding Guidelines\n\nThe rules below are enforced by aicq at commit time. Generated automatically — edit \`aicq/rules/\` to change.`;
+}
+function getMessage(rule, locale) {
+    if (locale === 'ko' && rule.messageKo)
+        return rule.messageKo;
+    return rule.message;
+}
+function renderRule(rule, locale) {
+    const langs = Array.isArray(rule.language) ? rule.language : [rule.language];
+    return `### ${rule.id}\n${getMessage(rule, locale)}\n- Languages: ${langs.join(', ')}`;
+}
+export function renderRules(rules, opts) {
+    const sorted = [...rules].sort((a, b) => {
+        const sev = severityOrder(a.severity) - severityOrder(b.severity);
+        return sev !== 0 ? sev : a.id.localeCompare(b.id);
+    });
+    const lines = [header(opts.locale), ''];
+    let lastSeverity = null;
+    for (const rule of sorted) {
+        if (rule.severity !== lastSeverity) {
+            lines.push('');
+            lines.push(sectionTitle(opts.locale, rule.severity));
+            lines.push('');
+            lastSeverity = rule.severity;
+        }
+        lines.push(renderRule(rule, opts.locale));
+        lines.push('');
+    }
+    return lines.join('\n').trimEnd() + '\n';
+}
+export const MARKER_START = '<!-- aicq:rules:start -->';
+export const MARKER_END = '<!-- aicq:rules:end -->';
+export function injectIntoMarkdown(existing, body) {
+    const block = `${MARKER_START}\n${body}${MARKER_END}\n`;
+    if (existing === null || existing.length === 0)
+        return block;
+    const startIdx = existing.indexOf(MARKER_START);
+    const endIdx = existing.indexOf(MARKER_END);
+    if (startIdx === -1 || endIdx === -1 || endIdx < startIdx) {
+        const sep = existing.endsWith('\n') ? '\n' : '\n\n';
+        return `${existing}${sep}${block}`;
+    }
+    return `${existing.slice(0, startIdx)}${block}${existing.slice(endIdx + MARKER_END.length).replace(/^\n/, '')}`;
+}
+//# sourceMappingURL=render.js.map

package/dist/sync/render.js.map

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

package/dist/sync/sync-files.d.ts

@@ -0,0 +1,12 @@
+import type { Rule } from '@aicqtools/rule-sdk';
+export interface SyncTarget {
+    readonly path: string;
+    readonly markdown: boolean;
+}
+export interface SyncOptions {
+    readonly cwd: string;
+    readonly locale: 'ko' | 'en';
+    readonly targets?: readonly SyncTarget[];
+}
+export declare function syncAiRules(rules: readonly Rule[], opts: SyncOptions): Promise<string[]>;
+//# sourceMappingURL=sync-files.d.ts.map

package/dist/sync/sync-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-files.d.ts","sourceRoot":"","sources":["../../src/sync/sync-files.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAGhD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;CAC1C;AAOD,wBAAsB,WAAW,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAmB9F"}

package/dist/sync/sync-files.js

@@ -0,0 +1,29 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { injectIntoMarkdown, renderRules } from './render.js';
+const DEFAULT_TARGETS = [
+    { path: '.cursorrules', markdown: false },
+    { path: 'CLAUDE.md', markdown: true },
+];
+export async function syncAiRules(rules, opts) {
+    const cwd = resolve(opts.cwd);
+    const body = renderRules(rules, { locale: opts.locale });
+    const targets = opts.targets ?? DEFAULT_TARGETS;
+    const written = [];
+    for (const t of targets) {
+        const fullPath = resolve(cwd, t.path);
+        let next;
+        if (t.markdown) {
+            const existing = existsSync(fullPath) ? await readFile(fullPath, 'utf-8') : null;
+            next = injectIntoMarkdown(existing, body);
+        }
+        else {
+            next = body;
+        }
+        await writeFile(fullPath, next, 'utf-8');
+        written.push(fullPath);
+    }
+    return written;
+}
+//# sourceMappingURL=sync-files.js.map

package/dist/sync/sync-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-files.js","sourceRoot":"","sources":["../../src/sync/sync-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAa9D,MAAM,eAAe,GAA0B;IAC7C,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,KAAK,EAAE;IACzC,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE;CACtC,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAsB,EAAE,IAAiB;IACzE,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,eAAe,CAAC;IAChD,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,IAAY,CAAC;QACjB,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;YACf,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACjF,IAAI,GAAG,kBAAkB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC5C,CAAC;aAAM,CAAC;YACN,IAAI,GAAG,IAAI,CAAC;QACd,CAAC;QACD,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QACzC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@aicqtools/guardrail",
+  "version": "1.0.0-alpha.10",
+  "type": "module",
+  "description": "Deterministic AI code guardrail engine — 37 built-in rules, hybrid YAML/function DSL, MCP server, .cursorrules sync, sqlite cache.",
+  "keywords": [
+    "aicq",
+    "aicqtools",
+    "guardrail",
+    "ai-code-quality",
+    "tree-sitter",
+    "linter",
+    "mcp",
+    "code-review"
+  ],
+  "homepage": "https://github.com/aicqtools/aicqtools/tree/main/modules/guardrail",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aicqtools/aicqtools.git",
+    "directory": "modules/guardrail"
+  },
+  "bugs": "https://github.com/aicqtools/aicqtools/issues",
+  "author": "Eom Sik <neuralflux3@gmail.com>",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./runner": "./dist/runner/index.js",
+    "./matcher": "./dist/matcher/index.js",
+    "./mcp": "./dist/mcp/index.js",
+    "./sync": "./dist/sync/index.js"
+  },
+  "files": [
+    "dist/",
+    "scripts/",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "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.10",
+    "@aicqtools/rule-sdk": "1.0.0-alpha.10"
+  },
+  "peerDependencies": {
+    "tree-sitter": "~0.22.4"
+  },
+  "peerDependenciesMeta": {
+    "tree-sitter": {
+      "optional": false
+    }
+  },
+  "devDependencies": {
+    "@types/micromatch": "^4.0.9",
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "scripts": {
+    "build": "tsc && node scripts/copy-yaml-rules.mjs",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist .turbo"
+  }
+}

package/scripts/copy-yaml-rules.mjs

@@ -0,0 +1,19 @@
+import { readdir, mkdir, copyFile } from 'node:fs/promises';
+import { dirname, extname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const here = dirname(fileURLToPath(import.meta.url));
+const src = resolve(here, '../src/rules-default');
+const dest = resolve(here, '../dist/rules-default');
+
+await mkdir(dest, { recursive: true });
+const entries = await readdir(src);
+let copied = 0;
+for (const entry of entries) {
+  const ext = extname(entry);
+  if (ext === '.yaml' || ext === '.yml') {
+    await copyFile(join(src, entry), join(dest, entry));
+    copied += 1;
+  }
+}
+process.stdout.write(`copy-yaml-rules: ${copied} file(s)\n`);