@aicqtools/guardrail 1.0.0-alpha.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Eom Sik (aicqtools)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/docs/build.d.ts

@@ -0,0 +1,12 @@
+import type { Rule } from '@aicqtools/rule-sdk';
+export interface BuildDocsOptions {
+    readonly cwd: string;
+    readonly outDir: string;
+    readonly rules: readonly Rule[];
+}
+export interface BuildDocsResult {
+    readonly outDir: string;
+    readonly files: number;
+}
+export declare function buildRuleDocs(opts: BuildDocsOptions): Promise<BuildDocsResult>;
+//# sourceMappingURL=build.d.ts.map

package/dist/docs/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/docs/build.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAGhD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAsBpF"}

package/dist/docs/build.js

@@ -0,0 +1,23 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import { renderRuleMarkdown, renderRulesIndex } from './render-rule-md.js';
+export async function buildRuleDocs(opts) {
+    const out = resolve(opts.cwd, opts.outDir);
+    const dirs = {
+        ko: join(out, 'rules', 'ko'),
+        en: join(out, 'rules', 'en'),
+    };
+    await mkdir(dirs.ko, { recursive: true });
+    await mkdir(dirs.en, { recursive: true });
+    let files = 0;
+    for (const rule of opts.rules) {
+        await writeFile(join(dirs.ko, `${rule.id}.md`), renderRuleMarkdown(rule, 'ko'), 'utf-8');
+        await writeFile(join(dirs.en, `${rule.id}.md`), renderRuleMarkdown(rule, 'en'), 'utf-8');
+        files += 2;
+    }
+    await writeFile(join(dirs.ko, 'index.md'), renderRulesIndex(opts.rules, 'ko'), 'utf-8');
+    await writeFile(join(dirs.en, 'index.md'), renderRulesIndex(opts.rules, 'en'), 'utf-8');
+    files += 2;
+    return { outDir: out, files };
+}
+//# sourceMappingURL=build.js.map

package/dist/docs/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../src/docs/build.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAa3E,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAsB;IACxD,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG;QACX,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC;QAC5B,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC;KACpB,CAAC;IAEX,MAAM,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,MAAM,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1C,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9B,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,EAAE,KAAK,CAAC,EAAE,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;QACzF,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,EAAE,KAAK,CAAC,EAAE,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;QACzF,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IAED,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,UAAU,CAAC,EAAE,gBAAgB,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;IACxF,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,UAAU,CAAC,EAAE,gBAAgB,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;IACxF,KAAK,IAAI,CAAC,CAAC;IAEX,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;AAChC,CAAC"}

package/dist/docs/index.d.ts

@@ -0,0 +1,4 @@
+export { renderRuleMarkdown, renderRulesIndex } from './render-rule-md.js';
+export { buildRuleDocs } from './build.js';
+export type { BuildDocsOptions, BuildDocsResult } from './build.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/docs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/docs/index.js

@@ -0,0 +1,3 @@
+export { renderRuleMarkdown, renderRulesIndex } from './render-rule-md.js';
+export { buildRuleDocs } from './build.js';
+//# sourceMappingURL=index.js.map

package/dist/docs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/docs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/docs/render-rule-md.d.ts

@@ -0,0 +1,4 @@
+import type { Rule } from '@aicqtools/rule-sdk';
+export declare function renderRuleMarkdown(rule: Rule, locale: 'ko' | 'en'): string;
+export declare function renderRulesIndex(rules: readonly Rule[], locale: 'ko' | 'en'): string;
+//# sourceMappingURL=render-rule-md.d.ts.map

package/dist/docs/render-rule-md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-rule-md.d.ts","sourceRoot":"","sources":["../../src/docs/render-rule-md.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAwBhD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,CAsF1E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,CAYpF"}

package/dist/docs/render-rule-md.js

@@ -0,0 +1,117 @@
+const SEVERITY_LABEL_EN = {
+    error: '🔴 error',
+    warning: '🟡 warning',
+    info: 'ℹ️ info',
+};
+const SEVERITY_LABEL_KO = {
+    error: '🔴 오류',
+    warning: '🟡 경고',
+    info: 'ℹ️ 정보',
+};
+function languagesText(rule) {
+    const langs = Array.isArray(rule.language) ? rule.language : [rule.language];
+    return langs.join(', ');
+}
+function ruleKindLabel(rule, locale) {
+    if (rule.kind === 'pattern')
+        return locale === 'ko' ? 'YAML 패턴' : 'YAML pattern';
+    return locale === 'ko' ? 'JS/TS 함수' : 'JS/TS function';
+}
+export function renderRuleMarkdown(rule, locale) {
+    const messages = locale === 'ko' && rule.messageKo ? rule.messageKo : rule.message;
+    const severityLabel = locale === 'ko' ? SEVERITY_LABEL_KO[rule.severity] : SEVERITY_LABEL_EN[rule.severity];
+    const docsLink = rule.docs ? `\n**Docs**: ${rule.docs}` : '';
+    if (locale === 'ko') {
+        return [
+            `# ${rule.id}`,
+            '',
+            `**Severity**: ${severityLabel}  `,
+            `**Languages**: ${languagesText(rule)}  `,
+            `**Kind**: ${ruleKindLabel(rule, 'ko')}${docsLink}`,
+            '',
+            '## 설명',
+            '',
+            messages,
+            '',
+            '## 위반 예시',
+            '',
+            '```typescript',
+            '// 룰별 구체 예제는 추후 추가 (커뮤니티 PR 환영)',
+            '```',
+            '',
+            '## 통과 예시',
+            '',
+            '```typescript',
+            '// 룰별 구체 예제는 추후 추가',
+            '```',
+            '',
+            '## 알려진 한계',
+            '',
+            '- PoC 단계 룰입니다 — false positive 가능성이 있으며, 출시 후 커뮤니티 피드백을 통해 정밀도를 높입니다.',
+            '',
+            '## 비활성화',
+            '',
+            '특정 프로젝트에서 이 룰을 끄려면 `aicq.config.yaml`에:',
+            '',
+            '```yaml',
+            'modules:',
+            '  guardrail:',
+            '    rules:',
+            `      ${rule.id}: off`,
+            '```',
+            '',
+        ].join('\n');
+    }
+    return [
+        `# ${rule.id}`,
+        '',
+        `**Severity**: ${severityLabel}  `,
+        `**Languages**: ${languagesText(rule)}  `,
+        `**Kind**: ${ruleKindLabel(rule, 'en')}${docsLink}`,
+        '',
+        '## Description',
+        '',
+        messages,
+        '',
+        '## Violation example',
+        '',
+        '```typescript',
+        '// Rule-specific examples to be added (community PRs welcome)',
+        '```',
+        '',
+        '## Passing example',
+        '',
+        '```typescript',
+        '// Rule-specific examples to be added',
+        '```',
+        '',
+        '## Known limitations',
+        '',
+        '- PoC-grade rule — false positives possible. Precision will improve via community feedback after release.',
+        '',
+        '## Disabling this rule',
+        '',
+        'In `aicq.config.yaml`:',
+        '',
+        '```yaml',
+        'modules:',
+        '  guardrail:',
+        '    rules:',
+        `      ${rule.id}: off`,
+        '```',
+        '',
+    ].join('\n');
+}
+export function renderRulesIndex(rules, locale) {
+    const sorted = [...rules].sort((a, b) => a.id.localeCompare(b.id));
+    const header = locale === 'ko'
+        ? `# 룰셋 (${rules.length}개)\n\naicq의 빌트인 룰 전체 목록.\n\n| ID | Severity | Languages | 설명 |\n|----|----------|-----------|------|`
+        : `# Ruleset (${rules.length} rules)\n\nAll built-in aicq rules.\n\n| ID | Severity | Languages | Description |\n|----|----------|-----------|-------------|`;
+    const rows = sorted.map((r) => {
+        const langs = Array.isArray(r.language) ? r.language.join(', ') : r.language;
+        const msg = (locale === 'ko' && r.messageKo ? r.messageKo : r.message).replace(/\n/g, ' ').slice(0, 80);
+        return `| [\`${r.id}\`](./${r.id}.md) | ${r.severity} | ${langs} | ${msg} |`;
+    });
+    return [header, ...rows, ''].join('\n');
+}
+//# sourceMappingURL=render-rule-md.js.map

package/dist/docs/render-rule-md.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { runFile, runFileWithSource, runProject, runRule, } from './runner/index.js';
+export type { RunFileResult, RunProjectOptions } from './runner/index.js';
+export { traverse, parseYamlRule } from './matcher/index.js';
+export type { YamlRuleInput } from './matcher/index.js';
+export { builtinFunctionRules, loadBuiltinYamlRules, loadAllBuiltinRules, loadFunctionRulesFromDir, } from './rules-default/index.js';
+export { buildMcpServer, startStdio, handleCheckSnippet, handleListRules, checkSnippetInputSchema, } from './mcp/index.js';
+export { renderRules, injectIntoMarkdown, syncAiRules, MARKER_START, MARKER_END, } from './sync/index.js';
+export type { RenderOptions, SyncOptions, SyncTarget } from './sync/index.js';
+export { renderRuleMarkdown, renderRulesIndex, buildRuleDocs } from './docs/index.js';
+export type { BuildDocsOptions, BuildDocsResult } from './docs/index.js';
+export type { BuildMcpServerOptions, CheckSnippetInput, CheckSnippetResult, ListRulesResult, } from './mcp/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,iBAAiB,EACjB,UAAU,EACV,OAAO,GACR,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE1E,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC7D,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,eAAe,EACf,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,UAAU,GACX,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE9E,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACtF,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACzE,YAAY,EACV,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,GAChB,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { runFile, runFileWithSource, runProject, runRule, } from './runner/index.js';
+export { traverse, parseYamlRule } from './matcher/index.js';
+export { builtinFunctionRules, loadBuiltinYamlRules, loadAllBuiltinRules, loadFunctionRulesFromDir, } from './rules-default/index.js';
+export { buildMcpServer, startStdio, handleCheckSnippet, handleListRules, checkSnippetInputSchema, } from './mcp/index.js';
+export { renderRules, injectIntoMarkdown, syncAiRules, MARKER_START, MARKER_END, } from './sync/index.js';
+export { renderRuleMarkdown, renderRulesIndex, buildRuleDocs } from './docs/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,iBAAiB,EACjB,UAAU,EACV,OAAO,GACR,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAG7D,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,eAAe,EACf,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,UAAU,GACX,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/matcher/index.d.ts

@@ -0,0 +1,4 @@
+export { traverse } from './traverse.js';
+export { parseYamlRule } from './yaml-rule.js';
+export type { YamlRuleInput } from './yaml-rule.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/matcher/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/matcher/index.js

@@ -0,0 +1,3 @@
+export { traverse } from './traverse.js';
+export { parseYamlRule } from './yaml-rule.js';
+//# sourceMappingURL=index.js.map

package/dist/matcher/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/matcher/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/matcher/traverse.d.ts

@@ -0,0 +1,3 @@
+import type Parser from 'tree-sitter';
+export declare function traverse(node: Parser.SyntaxNode, visit: (node: Parser.SyntaxNode) => void): void;
+//# sourceMappingURL=traverse.d.ts.map

package/dist/matcher/traverse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traverse.d.ts","sourceRoot":"","sources":["../../src/matcher/traverse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAEtC,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,CAAC,UAAU,EACvB,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,KAAK,IAAI,GACvC,IAAI,CAMN"}

package/dist/matcher/traverse.js

@@ -0,0 +1,9 @@
+export function traverse(node, visit) {
+    visit(node);
+    for (let i = 0; i < node.namedChildCount; i++) {
+        const child = node.namedChild(i);
+        if (child)
+            traverse(child, visit);
+    }
+}
+//# sourceMappingURL=traverse.js.map

package/dist/matcher/traverse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traverse.js","sourceRoot":"","sources":["../../src/matcher/traverse.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,QAAQ,CACtB,IAAuB,EACvB,KAAwC;IAExC,KAAK,CAAC,IAAI,CAAC,CAAC;IACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACjC,IAAI,KAAK;YAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC;AACH,CAAC"}

package/dist/matcher/yaml-rule.d.ts

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+import type { PatternRule } from '@aicqtools/rule-sdk';
+declare const yamlRuleSchema: z.ZodObject<{
+    id: z.ZodString;
+    language: z.ZodUnion<[z.ZodEnum<["typescript", "javascript", "tsx", "python"]>, z.ZodArray<z.ZodEnum<["typescript", "javascript", "tsx", "python"]>, "many">]>;
+    severity: z.ZodEnum<["error", "warning", "info"]>;
+    message: z.ZodString;
+    messageKo: z.ZodOptional<z.ZodString>;
+    docs: z.ZodOptional<z.ZodString>;
+    query: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    language: "typescript" | "javascript" | "tsx" | "python" | ("typescript" | "javascript" | "tsx" | "python")[];
+    id: string;
+    message: string;
+    severity: "error" | "warning" | "info";
+    query: string;
+    messageKo?: string | undefined;
+    docs?: string | undefined;
+}, {
+    language: "typescript" | "javascript" | "tsx" | "python" | ("typescript" | "javascript" | "tsx" | "python")[];
+    id: string;
+    message: string;
+    severity: "error" | "warning" | "info";
+    query: string;
+    messageKo?: string | undefined;
+    docs?: string | undefined;
+}>;
+export type YamlRuleInput = z.infer<typeof yamlRuleSchema>;
+export declare function parseYamlRule(source: string): PatternRule;
+export {};
+//# sourceMappingURL=yaml-rule.d.ts.map

package/dist/matcher/yaml-rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-rule.d.ts","sourceRoot":"","sources":["../../src/matcher/yaml-rule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAMvD,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;EAQlB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE3D,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAezD"}

package/dist/matcher/yaml-rule.js

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+import { parse as parseYaml } from 'yaml';
+const languageSchema = z.enum(['typescript', 'javascript', 'tsx', 'python']);
+const severitySchema = z.enum(['error', 'warning', 'info']);
+const yamlRuleSchema = z.object({
+    id: z.string().min(1),
+    language: z.union([languageSchema, z.array(languageSchema).min(1)]),
+    severity: severitySchema,
+    message: z.string().min(1),
+    messageKo: z.string().optional(),
+    docs: z.string().url().optional(),
+    query: z.string().min(1),
+});
+export function parseYamlRule(source) {
+    const parsed = yamlRuleSchema.parse(parseYaml(source));
+    const rule = {
+        kind: 'pattern',
+        id: parsed.id,
+        language: parsed.language,
+        severity: parsed.severity,
+        message: parsed.message,
+        query: parsed.query,
+    };
+    return parsed.messageKo !== undefined
+        ? { ...rule, messageKo: parsed.messageKo }
+        : parsed.docs !== undefined
+            ? { ...rule, docs: parsed.docs }
+            : rule;
+}
+//# sourceMappingURL=yaml-rule.js.map

package/dist/matcher/yaml-rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-rule.js","sourceRoot":"","sources":["../../src/matcher/yaml-rule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAI1C,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC7E,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;AAE5D,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACnE,QAAQ,EAAE,cAAc;IACxB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACjC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACzB,CAAC,CAAC;AAIH,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IACvD,MAAM,IAAI,GAAgB;QACxB,IAAI,EAAE,SAAS;QACf,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,QAAQ,EAAE,MAAM,CAAC,QAA0C;QAC3D,QAAQ,EAAE,MAAM,CAAC,QAAoB;QACrC,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC;IACF,OAAO,MAAM,CAAC,SAAS,KAAK,SAAS;QACnC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE;QAC1C,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS;YACzB,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE;YAChC,CAAC,CAAC,IAAI,CAAC;AACb,CAAC"}

package/dist/mcp/handlers.d.ts

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+import type { Rule } from '@aicqtools/rule-sdk';
+export declare const checkSnippetInputSchema: z.ZodObject<{
+    source: z.ZodString;
+    language: z.ZodEnum<["typescript", "javascript", "tsx", "python"]>;
+    filePath: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    language: "typescript" | "javascript" | "tsx" | "python";
+    source: string;
+    filePath?: string | undefined;
+}, {
+    language: "typescript" | "javascript" | "tsx" | "python";
+    source: string;
+    filePath?: string | undefined;
+}>;
+export type CheckSnippetInput = z.infer<typeof checkSnippetInputSchema>;
+export interface CheckSnippetResult {
+    readonly diagnostics: ReadonlyArray<{
+        readonly ruleId: string;
+        readonly severity: string;
+        readonly message: string;
+        readonly line: number;
+        readonly column: number;
+    }>;
+}
+export declare function handleCheckSnippet(input: unknown, rules: readonly Rule[]): CheckSnippetResult;
+export interface ListRulesResult {
+    readonly rules: ReadonlyArray<{
+        readonly id: string;
+        readonly severity: string;
+        readonly languages: readonly string[];
+        readonly message: string;
+    }>;
+}
+export declare function handleListRules(rules: readonly Rule[]): ListRulesResult;
+//# sourceMappingURL=handlers.d.ts.map

package/dist/mcp/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/mcp/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAKhD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;EAIlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC;QAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB,CAAC,CAAC;CACJ;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,IAAI,EAAE,GAAG,kBAAkB,CAiB7F;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;QAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;QACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;KAC1B,CAAC,CAAC;CACJ;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,GAAG,eAAe,CASvE"}

package/dist/mcp/handlers.js

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+import { runFileWithSource } from '../runner/run-file.js';
+const languageSchema = z.enum(['typescript', 'javascript', 'tsx', 'python']);
+export const checkSnippetInputSchema = z.object({
+    source: z.string(),
+    language: languageSchema,
+    filePath: z.string().optional(),
+});
+export function handleCheckSnippet(input, rules) {
+    const parsed = checkSnippetInputSchema.parse(input ?? {});
+    const result = runFileWithSource(parsed.filePath ?? '<snippet>', parsed.source, parsed.language, rules);
+    return {
+        diagnostics: result.diagnostics.map((d) => ({
+            ruleId: d.ruleId,
+            severity: d.severity,
+            message: d.messageKo ?? d.message,
+            line: d.range.start.line,
+            column: d.range.start.column,
+        })),
+    };
+}
+export function handleListRules(rules) {
+    return {
+        rules: rules.map((r) => ({
+            id: r.id,
+            severity: r.severity,
+            languages: Array.isArray(r.language) ? [...r.language] : [r.language],
+            message: r.message,
+        })),
+    };
+}
+//# sourceMappingURL=handlers.js.map

package/dist/mcp/handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../../src/mcp/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE7E,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,QAAQ,EAAE,cAAc;IACxB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAC;AAcH,MAAM,UAAU,kBAAkB,CAAC,KAAc,EAAE,KAAsB;IACvE,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAG,iBAAiB,CAC9B,MAAM,CAAC,QAAQ,IAAI,WAAW,EAC9B,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,QAAoB,EAC3B,KAAK,CACN,CAAC;IACF,OAAO;QACL,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC1C,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,OAAO,EAAE,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,OAAO;YACjC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI;YACxB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM;SAC7B,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC;AAWD,MAAM,UAAU,eAAe,CAAC,KAAsB;IACpD,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACvB,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;YACrE,OAAO,EAAE,CAAC,CAAC,OAAO;SACnB,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}

package/dist/mcp/index.d.ts

@@ -0,0 +1,6 @@
+export { buildMcpServer } from './server.js';
+export type { BuildMcpServerOptions } from './server.js';
+export { startStdio } from './stdio.js';
+export { handleCheckSnippet, handleListRules, checkSnippetInputSchema, } from './handlers.js';
+export type { CheckSnippetInput, CheckSnippetResult, ListRulesResult, } from './handlers.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,uBAAuB,GACxB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,GAChB,MAAM,eAAe,CAAC"}

package/dist/mcp/index.js

@@ -0,0 +1,4 @@
+export { buildMcpServer } from './server.js';
+export { startStdio } from './stdio.js';
+export { handleCheckSnippet, handleListRules, checkSnippetInputSchema, } from './handlers.js';
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,uBAAuB,GACxB,MAAM,eAAe,CAAC"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,9 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { Rule } from '@aicqtools/rule-sdk';
+export interface BuildMcpServerOptions {
+    readonly rules?: readonly Rule[];
+    readonly name?: string;
+    readonly version?: string;
+}
+export declare function buildMcpServer(opts?: BuildMcpServerOptions): Promise<Server>;
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAKnE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAIhD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,IAAI,EAAE,CAAC;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAsB,cAAc,CAAC,IAAI,GAAE,qBAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAuDtF"}

package/dist/mcp/server.js

@@ -0,0 +1,53 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { loadAllBuiltinRules } from '../rules-default/index.js';
+import { handleCheckSnippet, handleListRules } from './handlers.js';
+export async function buildMcpServer(opts = {}) {
+    const rules = opts.rules ?? (await loadAllBuiltinRules());
+    const server = new Server({
+        name: opts.name ?? 'aicq-guardrail',
+        version: opts.version ?? '0.0.0',
+    }, {
+        capabilities: { tools: {} },
+    });
+    server.setRequestHandler(ListToolsRequestSchema, () => ({
+        tools: [
+            {
+                name: 'checkSnippet',
+                description: 'Validate a code snippet against AICQ guardrail rules. Returns diagnostics with rule id, severity, message, line, and column.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        source: { type: 'string', description: 'Source code to check' },
+                        language: {
+                            type: 'string',
+                            enum: ['typescript', 'javascript', 'tsx', 'python'],
+                        },
+                        filePath: { type: 'string', description: 'Optional file path for context' },
+                    },
+                    required: ['source', 'language'],
+                },
+            },
+            {
+                name: 'listRules',
+                description: 'List all loaded guardrail rules with their metadata.',
+                inputSchema: { type: 'object', properties: {} },
+            },
+        ],
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (req) => {
+        const name = req.params.name;
+        const args = req.params.arguments;
+        if (name === 'checkSnippet') {
+            const result = handleCheckSnippet(args, rules);
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        if (name === 'listRules') {
+            const result = handleListRules(rules);
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        throw new Error(`Unknown tool: ${name}`);
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAQpE,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAA8B,EAAE;IACnE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,mBAAmB,EAAE,CAAC,CAAC;IAE1D,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;QACE,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,gBAAgB;QACnC,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,OAAO;KACjC,EACD;QACE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;KAC5B,CACF,CAAC;IAEF,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,GAAG,EAAE,CAAC,CAAC;QACtD,KAAK,EAAE;YACL;gBACE,IAAI,EAAE,cAAc;gBACpB,WAAW,EACT,8HAA8H;gBAChI,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sBAAsB,EAAE;wBAC/D,QAAQ,EAAE;4BACR,IAAI,EAAE,QAAQ;4BACd,IAAI,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,CAAC;yBACpD;wBACD,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gCAAgC,EAAE;qBAC5E;oBACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC;iBACjC;aACF;YACD;gBACE,IAAI,EAAE,WAAW;gBACjB,WAAW,EAAE,sDAAsD;gBACnE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;aAChD;SACF;KACF,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAC5D,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;QAC7B,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC;QAClC,IAAI,IAAI,KAAK,cAAc,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC/C,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QAChF,CAAC;QACD,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;YACtC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QAChF,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/mcp/stdio.d.ts

@@ -0,0 +1,3 @@
+import { type BuildMcpServerOptions } from './server.js';
+export declare function startStdio(opts?: BuildMcpServerOptions): Promise<void>;
+//# sourceMappingURL=stdio.d.ts.map

package/dist/mcp/stdio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../../src/mcp/stdio.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzE,wBAAsB,UAAU,CAAC,IAAI,GAAE,qBAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAIhF"}

package/dist/mcp/stdio.js

@@ -0,0 +1,8 @@
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { buildMcpServer } from './server.js';
+export async function startStdio(opts = {}) {
+    const server = await buildMcpServer(opts);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+//# sourceMappingURL=stdio.js.map

package/dist/mcp/stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../../src/mcp/stdio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,cAAc,EAA8B,MAAM,aAAa,CAAC;AAEzE,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAA8B,EAAE;IAC/D,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC"}

package/dist/rules-default/ai-explainability-metadata.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("@aicqtools/rule-sdk").FunctionRule;
+export default _default;
+//# sourceMappingURL=ai-explainability-metadata.d.ts.map

package/dist/rules-default/ai-explainability-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-explainability-metadata.d.ts","sourceRoot":"","sources":["../../src/rules-default/ai-explainability-metadata.ts"],"names":[],"mappings":";AAiBA,wBAqBG"}

package/dist/rules-default/ai-explainability-metadata.js

@@ -0,0 +1,41 @@
+import { defineRule } from '@aicqtools/rule-sdk';
+/**
+ * FSC AI guideline: when AI-derived results are surfaced to users, the
+ * response should include explainability metadata (reasoning / sources /
+ * model). Detect `res.json(...)` / `res.send(...)` payloads that look
+ * AI-derived (variable name contains `ai`/`model`/`completion`) but lack
+ * an explainability key.
+ *
+ * Limitation: name-based detection misses payloads built from generic
+ * variables. Severity is `info` so existing services don't break.
+ */
+const AI_VAR = /\b(aiResult|aiResponse|completion|prediction|inference|llmResult)\b/;
+const EXPLAIN_KEYS = /\b(reasoning|sources|model|modelVersion|explanation|references)\b/;
+export default defineRule({
+    id: 'ai-explainability-metadata',
+    language: ['typescript', 'tsx'],
+    severity: 'info',
+    message: 'AI-derived response is missing explainability metadata (reasoning/sources/model) — FSC AI guideline — explainability.',
+    messageKo: 'AI 응답에 설명가능성 메타데이터(reasoning/sources/model) 누락 (금감원 AI 가이드라인 — 설명가능성).',
+    docs: 'https://github.com/aicqtools/aicqtools/blob/main/docs/rules/ai-explainability-metadata.md',
+    visitors: {
+        call_expression(node, ctx) {
+            const fnNode = node.childForFieldName('function');
+            if (!fnNode)
+                return;
+            const fnText = ctx.textOf(fnNode);
+            if (!/\b(res|reply)\.(json|send)$/.test(fnText))
+                return;
+            const args = node.childForFieldName('arguments');
+            if (!args)
+                return;
+            const argsText = ctx.textOf(args);
+            if (!AI_VAR.test(argsText))
+                return;
+            if (EXPLAIN_KEYS.test(argsText))
+                return;
+            ctx.report({ node });
+        },
+    },
+});
+//# sourceMappingURL=ai-explainability-metadata.js.map