intentpatch 0.0.0-stage → 0.1.0

package/dist/application/services/path-pattern.js

@@ -0,0 +1,34 @@
+/** Git 경로용 최소 glob 문법(*, **, ?)을 정규식으로 변환해 전체 경로를 비교한다. */
+export function matchesPathPattern(path, pattern) {
+    return new RegExp(`^${toRegularExpression(pattern)}$`, "u").test(path);
+}
+function toRegularExpression(pattern) {
+    let expression = "";
+    for (let index = 0; index < pattern.length; index += 1) {
+        const character = pattern[index];
+        if (character === "*" && pattern[index + 1] === "*" && pattern[index + 2] === "/") {
+            expression += "(?:.*/)?";
+            index += 2;
+            continue;
+        }
+        if (character === "*" && pattern[index + 1] === "*") {
+            expression += ".*";
+            index += 1;
+            continue;
+        }
+        if (character === "*") {
+            expression += "[^/]*";
+            continue;
+        }
+        if (character === "?") {
+            expression += "[^/]";
+            continue;
+        }
+        expression += escapeRegularExpression(character ?? "");
+    }
+    return expression;
+}
+function escapeRegularExpression(value) {
+    return /[\\^$.*+?()[\]{}|]/u.test(value) ? `\\${value}` : value;
+}
+//# sourceMappingURL=path-pattern.js.map

package/dist/application/services/path-pattern.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-pattern.js","sourceRoot":"","sources":["../../../src/application/services/path-pattern.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,OAAe;IAC9D,OAAO,IAAI,MAAM,CAAC,IAAI,mBAAmB,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzE,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAe;IAC1C,IAAI,UAAU,GAAG,EAAE,CAAC;IAEpB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACvD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,SAAS,KAAK,GAAG,IAAI,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,IAAI,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YAClF,UAAU,IAAI,UAAU,CAAC;YACzB,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QACD,IAAI,SAAS,KAAK,GAAG,IAAI,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YACpD,UAAU,IAAI,IAAI,CAAC;YACnB,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QACD,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;YACtB,UAAU,IAAI,OAAO,CAAC;YACtB,SAAS;QACX,CAAC;QACD,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;YACtB,UAAU,IAAI,MAAM,CAAC;YACrB,SAAS;QACX,CAAC;QACD,UAAU,IAAI,uBAAuB,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAa;IAC5C,OAAO,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AAClE,CAAC"}

package/dist/application/services/rule-engine.d.ts

@@ -0,0 +1,9 @@
+import { type FindingSet } from "../../domain/finding.js";
+import type { AnalysisContext, AnalysisRule } from "../ports/analysis-rule.js";
+/** 독립 규칙을 병렬 실행하고 결과 순서를 도메인 팩토리에 맡긴다. */
+export declare class RuleEngine {
+    private readonly rules;
+    constructor(rules: readonly AnalysisRule[]);
+    run(context: AnalysisContext): Promise<FindingSet>;
+}
+//# sourceMappingURL=rule-engine.d.ts.map

package/dist/application/services/rule-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-engine.d.ts","sourceRoot":"","sources":["../../../src/application/services/rule-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC5E,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE/E,0CAA0C;AAC1C,qBAAa,UAAU;IACF,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,SAAS,YAAY,EAAE;IAErD,GAAG,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;CAIhE"}

package/dist/application/services/rule-engine.js

@@ -0,0 +1,13 @@
+import { createFindingSet } from "../../domain/finding.js";
+/** 독립 규칙을 병렬 실행하고 결과 순서를 도메인 팩토리에 맡긴다. */
+export class RuleEngine {
+    rules;
+    constructor(rules) {
+        this.rules = rules;
+    }
+    async run(context) {
+        const results = await Promise.all(this.rules.map((rule) => rule.analyze(context)));
+        return createFindingSet(results.flat());
+    }
+}
+//# sourceMappingURL=rule-engine.js.map

package/dist/application/services/rule-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-engine.js","sourceRoot":"","sources":["../../../src/application/services/rule-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAmB,MAAM,yBAAyB,CAAC;AAG5E,0CAA0C;AAC1C,MAAM,OAAO,UAAU;IACe;IAApC,YAAoC,KAA8B;QAA9B,UAAK,GAAL,KAAK,CAAyB;IAAG,CAAC;IAE/D,KAAK,CAAC,GAAG,CAAC,OAAwB;QACvC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACnF,OAAO,gBAAgB,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;CACF"}

package/dist/application/use-cases/analyze-changes.d.ts

@@ -0,0 +1,28 @@
+import type { ChangeContract } from "../../domain/change-contract.js";
+import type { ChangeReport } from "../../domain/report.js";
+import type { ChangeImpactAnalyzer } from "../ports/change-impact-analyzer.js";
+import type { ChangeSource } from "../ports/change-source.js";
+import type { CodeStructureAnalyzer } from "../ports/code-structure-analyzer.js";
+import type { SymbolChangeAnalyzer } from "../ports/symbol-change-analyzer.js";
+import type { TestChangeAnalyzer } from "../ports/test-change-analyzer.js";
+import { RuleEngine } from "../services/rule-engine.js";
+export interface AnalyzeChangesInput {
+    readonly baseRef?: string;
+    readonly headRef?: string;
+    readonly contract?: ChangeContract;
+}
+/**
+ * 분석 입력을 정규화하고 변경사항 수집을 조율하는 유스케이스다.
+ * Git 명령이나 출력 형식은 외부 계층에 위임해 핵심 흐름을 기술 세부사항과 분리한다.
+ */
+export declare class AnalyzeChanges {
+    private readonly changeSource;
+    private readonly ruleEngine;
+    private readonly symbolChangeAnalyzer;
+    private readonly impactAnalyzer;
+    private readonly testChangeAnalyzer;
+    private readonly codeStructureAnalyzer;
+    constructor(changeSource: ChangeSource, ruleEngine?: RuleEngine, symbolChangeAnalyzer?: SymbolChangeAnalyzer, impactAnalyzer?: ChangeImpactAnalyzer, testChangeAnalyzer?: TestChangeAnalyzer, codeStructureAnalyzer?: CodeStructureAnalyzer);
+    execute(input?: AnalyzeChangesInput): Promise<ChangeReport>;
+}
+//# sourceMappingURL=analyze-changes.d.ts.map

package/dist/application/use-cases/analyze-changes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-changes.d.ts","sourceRoot":"","sources":["../../../src/application/use-cases/analyze-changes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAGtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAG3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AACjF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAExD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC;CACpC;AA6BD;;;GAGG;AACH,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IACnC,OAAO,CAAC,QAAQ,CAAC,qBAAqB;gBALrB,YAAY,EAAE,YAAY,EAC1B,UAAU,GAAE,UAA+B,EAC3C,oBAAoB,GAAE,oBAAgD,EACtE,cAAc,GAAE,oBAA0C,EAC1D,kBAAkB,GAAE,kBAA4C,EAChE,qBAAqB,GAAE,qBAAkD;IAG/E,OAAO,CAAC,KAAK,GAAE,mBAAwB,GAAG,OAAO,CAAC,YAAY,CAAC;CAsC7E"}

package/dist/application/use-cases/analyze-changes.js

@@ -0,0 +1,88 @@
+import { createCodeStructureAnalysis } from "../../domain/code-structure.js";
+import { createImpactAnalysis } from "../../domain/impact.js";
+import { createSymbolChangeSet } from "../../domain/symbol-change.js";
+import { createTestChangeAnalysis } from "../../domain/test-change.js";
+import { RuleEngine } from "../services/rule-engine.js";
+const emptySymbolChangeAnalyzer = {
+    analyze: async () => createSymbolChangeSet([]),
+};
+const emptyImpactAnalyzer = {
+    analyze: async () => createImpactAnalysis({
+        sourceFiles: 0,
+        changedModules: [],
+        dependencies: [],
+        impactedFiles: [],
+    }),
+};
+const emptyTestChangeAnalyzer = {
+    analyze: async () => createTestChangeAnalysis({ testFiles: [], sourceCoverage: [] }),
+};
+const emptyCodeStructureAnalyzer = {
+    analyze: async () => createCodeStructureAnalysis({
+        sourceFiles: 0,
+        duplicateCandidates: [],
+        singleImplementationAbstractions: [],
+    }),
+};
+/**
+ * 분석 입력을 정규화하고 변경사항 수집을 조율하는 유스케이스다.
+ * Git 명령이나 출력 형식은 외부 계층에 위임해 핵심 흐름을 기술 세부사항과 분리한다.
+ */
+export class AnalyzeChanges {
+    changeSource;
+    ruleEngine;
+    symbolChangeAnalyzer;
+    impactAnalyzer;
+    testChangeAnalyzer;
+    codeStructureAnalyzer;
+    constructor(changeSource, ruleEngine = new RuleEngine([]), symbolChangeAnalyzer = emptySymbolChangeAnalyzer, impactAnalyzer = emptyImpactAnalyzer, testChangeAnalyzer = emptyTestChangeAnalyzer, codeStructureAnalyzer = emptyCodeStructureAnalyzer) {
+        this.changeSource = changeSource;
+        this.ruleEngine = ruleEngine;
+        this.symbolChangeAnalyzer = symbolChangeAnalyzer;
+        this.impactAnalyzer = impactAnalyzer;
+        this.testChangeAnalyzer = testChangeAnalyzer;
+        this.codeStructureAnalyzer = codeStructureAnalyzer;
+    }
+    async execute(input = {}) {
+        const baseRef = input.baseRef?.trim() || "HEAD";
+        const headRef = input.headRef?.trim() || undefined;
+        assertSafeGitRef(baseRef);
+        if (headRef !== undefined) {
+            assertSafeGitRef(headRef);
+        }
+        const target = headRef === undefined ? { baseRef } : { baseRef, headRef };
+        const changes = await this.changeSource.collect(target);
+        const initialContext = {
+            target,
+            changes,
+            ...(input.contract === undefined ? {} : { contract: input.contract }),
+        };
+        const [testChanges, symbolChanges] = await Promise.all([
+            this.testChangeAnalyzer.analyze(initialContext),
+            this.symbolChangeAnalyzer.analyze(initialContext),
+        ]);
+        const factContext = { ...initialContext, testChanges, symbolChanges };
+        const [codeStructure, impact] = await Promise.all([
+            this.codeStructureAnalyzer.analyze(factContext),
+            this.impactAnalyzer.analyze(factContext),
+        ]);
+        const context = { ...factContext, codeStructure };
+        const findings = await this.ruleEngine.run(context);
+        return {
+            target,
+            ...(input.contract === undefined ? {} : { contract: input.contract }),
+            changes,
+            findings,
+            symbolChanges,
+            codeStructure,
+            impact,
+            testChanges,
+        };
+    }
+}
+function assertSafeGitRef(ref) {
+    if (ref.startsWith("-")) {
+        throw new Error(`Git references must not start with a hyphen: ${ref}`);
+    }
+}
+//# sourceMappingURL=analyze-changes.js.map

package/dist/application/use-cases/analyze-changes.js.map

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

package/dist/domain/change-contract.d.ts

@@ -0,0 +1,33 @@
+export interface ChangeScope {
+    readonly include: readonly string[];
+    readonly allow: readonly string[];
+    readonly maxFiles?: number;
+    readonly maxLines?: number;
+}
+export interface TestChangePolicy {
+    readonly requireFor: readonly string[];
+    readonly include: readonly string[];
+    readonly exclude: readonly string[];
+}
+export interface ChangeContract {
+    readonly intent?: string;
+    readonly scope: ChangeScope;
+    readonly tests?: TestChangePolicy;
+}
+export interface CreateChangeContractInput {
+    readonly intent?: string;
+    readonly scope?: Readonly<{
+        include?: readonly string[];
+        allow?: readonly string[];
+        maxFiles?: number;
+        maxLines?: number;
+    }>;
+    readonly tests?: Readonly<{
+        requireFor?: readonly string[];
+        include?: readonly string[];
+        exclude?: readonly string[];
+    }>;
+}
+/** 사용자 기대 범위를 정규화해 규칙마다 설정 해석이 달라지지 않게 한다. */
+export declare function createChangeContract(input: CreateChangeContractInput): ChangeContract;
+//# sourceMappingURL=change-contract.d.ts.map

package/dist/domain/change-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-contract.d.ts","sourceRoot":"","sources":["../../src/domain/change-contract.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;CACnC;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;QACxB,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAC5B,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;QACxB,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAC/B,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAC5B,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;KAC7B,CAAC,CAAC;CACJ;AAED,8CAA8C;AAC9C,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,GAAG,cAAc,CAmBrF"}

package/dist/domain/change-contract.js

@@ -0,0 +1,76 @@
+/** 사용자 기대 범위를 정규화해 규칙마다 설정 해석이 달라지지 않게 한다. */
+export function createChangeContract(input) {
+    const intent = normalizeIntent(input.intent);
+    const scope = input.scope ?? {};
+    const include = normalizePatterns(scope.include ?? [], "scope.include");
+    const allow = normalizePatterns(scope.allow ?? [], "scope.allow");
+    const maxFiles = normalizeBudget(scope.maxFiles, "maxFiles");
+    const maxLines = normalizeBudget(scope.maxLines, "maxLines");
+    const tests = normalizeTestPolicy(input.tests);
+    return Object.freeze({
+        ...(intent === undefined ? {} : { intent }),
+        scope: Object.freeze({
+            include: Object.freeze(include),
+            allow: Object.freeze(allow),
+            ...(maxFiles === undefined ? {} : { maxFiles }),
+            ...(maxLines === undefined ? {} : { maxLines }),
+        }),
+        ...(tests === undefined ? {} : { tests }),
+    });
+}
+function normalizeTestPolicy(input) {
+    if (input === undefined) {
+        return undefined;
+    }
+    const requireFor = normalizePatterns(input.requireFor ?? [], "tests.requireFor");
+    const include = normalizePatterns(input.include ?? [], "tests.include");
+    const exclude = normalizePatterns(input.exclude ?? [], "tests.exclude");
+    if (requireFor.length === 0) {
+        throw new Error("Change contract tests.requireFor must contain at least one pattern.");
+    }
+    if (include.length === 0) {
+        throw new Error("Change contract tests.include must contain at least one pattern.");
+    }
+    return Object.freeze({
+        requireFor: Object.freeze(requireFor),
+        include: Object.freeze(include),
+        exclude: Object.freeze(exclude),
+    });
+}
+function normalizeIntent(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    const intent = value.trim();
+    if (intent.length === 0) {
+        throw new Error("Change contract intent must not be blank.");
+    }
+    return intent;
+}
+function normalizePatterns(values, field) {
+    const patterns = values.map((value) => normalizePattern(value, field));
+    return [...new Set(patterns)].sort((left, right) => left.localeCompare(right));
+}
+function normalizePattern(value, field) {
+    let pattern = value.trim().replaceAll("\\", "/");
+    while (pattern.startsWith("./")) {
+        pattern = pattern.slice(2);
+    }
+    if (pattern.length === 0) {
+        throw new Error(`Change contract ${field} must not contain a blank pattern.`);
+    }
+    if (pattern.startsWith("/") || pattern.split("/").includes("..")) {
+        throw new Error(`Change contract patterns must be repository-relative: ${value}`);
+    }
+    return pattern;
+}
+function normalizeBudget(value, field) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (!Number.isSafeInteger(value) || value < 0) {
+        throw new Error(`Change contract scope.${field} must be a non-negative integer.`);
+    }
+    return value;
+}
+//# sourceMappingURL=change-contract.js.map

package/dist/domain/change-contract.js.map

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

package/dist/domain/change.d.ts

@@ -0,0 +1,37 @@
+export declare const fileChangeKinds: readonly ["added", "modified", "deleted", "renamed", "copied", "type-changed", "unmerged", "unknown"];
+export type FileChangeKind = (typeof fileChangeKinds)[number];
+/** 라인 수 0과 측정 불가 상태를 혼동하지 않도록 구별된 유니온으로 표현한다. */
+export type LineDelta = Readonly<{
+    kind: "measured";
+    additions: number;
+    deletions: number;
+}> | Readonly<{
+    kind: "binary";
+}> | Readonly<{
+    kind: "unavailable";
+    reason: string;
+}>;
+export interface FileChange {
+    readonly path: string;
+    readonly previousPath?: string;
+    readonly kind: FileChangeKind;
+    readonly lines: LineDelta;
+}
+export interface ChangeSummary {
+    readonly filesChanged: number;
+    readonly additions: number;
+    readonly deletions: number;
+    readonly binaryFiles: number;
+    readonly unmeasuredFiles: number;
+    readonly filesByKind: Readonly<Record<FileChangeKind, number>>;
+}
+export interface ChangeSet {
+    readonly files: readonly FileChange[];
+    readonly summary: ChangeSummary;
+}
+/**
+ * 파일 단위 변경을 정렬하고 보고서에서 재사용할 요약 통계를 한 번만 계산한다.
+ * 같은 결과 경로가 두 번 들어오면 분석 결과가 모호해지므로 도메인 경계에서 거부한다.
+ */
+export declare function createChangeSet(changes: readonly FileChange[]): ChangeSet;
+//# sourceMappingURL=change.d.ts.map

package/dist/domain/change.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change.d.ts","sourceRoot":"","sources":["../../src/domain/change.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,uGASlB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D,iDAAiD;AACjD,MAAM,MAAM,SAAS,GACjB,QAAQ,CAAC;IACP,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,GACF,QAAQ,CAAC;IACP,IAAI,EAAE,QAAQ,CAAC;CAChB,CAAC,GACF,QAAQ,CAAC;IACP,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAAC;AAEP,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;CAChE;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;CACjC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,GAAG,SAAS,CA6CzE"}

package/dist/domain/change.js

@@ -0,0 +1,61 @@
+export const fileChangeKinds = [
+    "added",
+    "modified",
+    "deleted",
+    "renamed",
+    "copied",
+    "type-changed",
+    "unmerged",
+    "unknown",
+];
+/**
+ * 파일 단위 변경을 정렬하고 보고서에서 재사용할 요약 통계를 한 번만 계산한다.
+ * 같은 결과 경로가 두 번 들어오면 분석 결과가 모호해지므로 도메인 경계에서 거부한다.
+ */
+export function createChangeSet(changes) {
+    assertUniquePaths(changes);
+    const files = [...changes]
+        .map((change) => Object.freeze({ ...change, lines: Object.freeze({ ...change.lines }) }))
+        .sort((left, right) => left.path.localeCompare(right.path));
+    const filesByKind = Object.fromEntries(fileChangeKinds.map((kind) => [kind, 0]));
+    let additions = 0;
+    let deletions = 0;
+    let binaryFiles = 0;
+    let unmeasuredFiles = 0;
+    for (const file of files) {
+        filesByKind[file.kind] += 1;
+        switch (file.lines.kind) {
+            case "measured":
+                additions += file.lines.additions;
+                deletions += file.lines.deletions;
+                break;
+            case "binary":
+                binaryFiles += 1;
+                break;
+            case "unavailable":
+                unmeasuredFiles += 1;
+                break;
+        }
+    }
+    return Object.freeze({
+        files: Object.freeze(files),
+        summary: Object.freeze({
+            filesChanged: files.length,
+            additions,
+            deletions,
+            binaryFiles,
+            unmeasuredFiles,
+            filesByKind: Object.freeze(filesByKind),
+        }),
+    });
+}
+function assertUniquePaths(changes) {
+    const paths = new Set();
+    for (const change of changes) {
+        if (paths.has(change.path)) {
+            throw new Error(`Duplicate file change path: ${change.path}`);
+        }
+        paths.add(change.path);
+    }
+}
+//# sourceMappingURL=change.js.map

package/dist/domain/change.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"change.js","sourceRoot":"","sources":["../../src/domain/change.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,OAAO;IACP,UAAU;IACV,SAAS;IACT,SAAS;IACT,QAAQ;IACR,cAAc;IACd,UAAU;IACV,SAAS;CACD,CAAC;AAwCX;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAA8B;IAC5D,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAE3B,MAAM,KAAK,GAAG,CAAC,GAAG,OAAO,CAAC;SACvB,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;SACxF,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAE9D,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAG9E,CAAC;IAEF,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,eAAe,GAAG,CAAC,CAAC;IAExB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE5B,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YACxB,KAAK,UAAU;gBACb,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;gBAClC,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;gBAClC,MAAM;YACR,KAAK,QAAQ;gBACX,WAAW,IAAI,CAAC,CAAC;gBACjB,MAAM;YACR,KAAK,aAAa;gBAChB,eAAe,IAAI,CAAC,CAAC;gBACrB,MAAM;QACV,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;QAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC;YACrB,YAAY,EAAE,KAAK,CAAC,MAAM;YAC1B,SAAS;YACT,SAAS;YACT,WAAW;YACX,eAAe;YACf,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC;SACxC,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAED,SAAS,iBAAiB,CAAC,OAA8B;IACvD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAEhC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,+BAA+B,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAChE,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;AACH,CAAC"}

package/dist/domain/code-structure.d.ts

@@ -0,0 +1,38 @@
+export interface CodeSymbolLocation {
+    readonly path: string;
+    readonly name: string;
+    readonly line: number;
+}
+export interface DuplicateImplementationCandidate {
+    readonly added: CodeSymbolLocation;
+    readonly existing: CodeSymbolLocation;
+}
+export interface SingleImplementationAbstraction {
+    readonly abstraction: CodeSymbolLocation;
+    readonly implementation: CodeSymbolLocation;
+}
+export interface CodeStructureAnalysisIssue {
+    readonly path: string;
+    readonly reason: string;
+}
+export interface CodeStructureAnalysisSummary {
+    readonly sourceFiles: number;
+    readonly filesUnavailable: number;
+    readonly duplicateCandidates: number;
+    readonly singleImplementationAbstractions: number;
+}
+export interface CodeStructureAnalysis {
+    readonly duplicateCandidates: readonly DuplicateImplementationCandidate[];
+    readonly singleImplementationAbstractions: readonly SingleImplementationAbstraction[];
+    readonly issues: readonly CodeStructureAnalysisIssue[];
+    readonly summary: CodeStructureAnalysisSummary;
+}
+export interface CodeStructureAnalysisInput {
+    readonly sourceFiles: number;
+    readonly duplicateCandidates: readonly DuplicateImplementationCandidate[];
+    readonly singleImplementationAbstractions: readonly SingleImplementationAbstraction[];
+    readonly issues?: readonly CodeStructureAnalysisIssue[];
+}
+/** 구조 분석 근거를 안정적으로 정렬하고 외부에서 변경할 수 없는 결과로 만든다. */
+export declare function createCodeStructureAnalysis(input: CodeStructureAnalysisInput): CodeStructureAnalysis;
+//# sourceMappingURL=code-structure.d.ts.map

package/dist/domain/code-structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-structure.d.ts","sourceRoot":"","sources":["../../src/domain/code-structure.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;CACvC;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,cAAc,EAAE,kBAAkB,CAAC;CAC7C;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,gCAAgC,EAAE,MAAM,CAAC;CACnD;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,mBAAmB,EAAE,SAAS,gCAAgC,EAAE,CAAC;IAC1E,QAAQ,CAAC,gCAAgC,EAAE,SAAS,+BAA+B,EAAE,CAAC;IACtF,QAAQ,CAAC,MAAM,EAAE,SAAS,0BAA0B,EAAE,CAAC;IACvD,QAAQ,CAAC,OAAO,EAAE,4BAA4B,CAAC;CAChD;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,mBAAmB,EAAE,SAAS,gCAAgC,EAAE,CAAC;IAC1E,QAAQ,CAAC,gCAAgC,EAAE,SAAS,+BAA+B,EAAE,CAAC;IACtF,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,0BAA0B,EAAE,CAAC;CACzD;AAED,kDAAkD;AAClD,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,0BAA0B,GAChC,qBAAqB,CAsCvB"}

package/dist/domain/code-structure.js

@@ -0,0 +1,63 @@
+/** 구조 분석 근거를 안정적으로 정렬하고 외부에서 변경할 수 없는 결과로 만든다. */
+export function createCodeStructureAnalysis(input) {
+    if (!Number.isInteger(input.sourceFiles) || input.sourceFiles < 0) {
+        throw new Error("Code structure source file count must be a non-negative integer");
+    }
+    assertUniqueDuplicateCandidates(input.duplicateCandidates);
+    assertUniqueAbstractions(input.singleImplementationAbstractions);
+    const duplicateCandidates = input.duplicateCandidates
+        .map((candidate) => Object.freeze({
+        added: freezeLocation(candidate.added),
+        existing: freezeLocation(candidate.existing),
+    }))
+        .sort(compareDuplicateCandidates);
+    const singleImplementationAbstractions = input.singleImplementationAbstractions
+        .map((candidate) => Object.freeze({
+        abstraction: freezeLocation(candidate.abstraction),
+        implementation: freezeLocation(candidate.implementation),
+    }))
+        .sort((left, right) => compareLocations(left.abstraction, right.abstraction));
+    const issues = [...(input.issues ?? [])]
+        .map((issue) => Object.freeze({ ...issue }))
+        .sort((left, right) => left.path.localeCompare(right.path));
+    return Object.freeze({
+        duplicateCandidates: Object.freeze(duplicateCandidates),
+        singleImplementationAbstractions: Object.freeze(singleImplementationAbstractions),
+        issues: Object.freeze(issues),
+        summary: Object.freeze({
+            sourceFiles: input.sourceFiles,
+            filesUnavailable: issues.length,
+            duplicateCandidates: duplicateCandidates.length,
+            singleImplementationAbstractions: singleImplementationAbstractions.length,
+        }),
+    });
+}
+function freezeLocation(location) {
+    return Object.freeze({ ...location });
+}
+function compareDuplicateCandidates(left, right) {
+    return (compareLocations(left.added, right.added) || compareLocations(left.existing, right.existing));
+}
+function compareLocations(left, right) {
+    return (left.path.localeCompare(right.path) ||
+        left.line - right.line ||
+        left.name.localeCompare(right.name));
+}
+function assertUniqueDuplicateCandidates(candidates) {
+    assertUnique(candidates.map((candidate) => [
+        candidate.added.path,
+        candidate.added.name,
+        candidate.existing.path,
+        candidate.existing.name,
+    ].join("\0")), "duplicate implementation candidate");
+}
+function assertUniqueAbstractions(candidates) {
+    assertUnique(candidates.map((candidate) => [candidate.abstraction.path, candidate.abstraction.name].join("\0")), "single-implementation abstraction");
+}
+function assertUnique(identities, label) {
+    const unique = new Set(identities);
+    if (unique.size !== identities.length) {
+        throw new Error(`Duplicate ${label}`);
+    }
+}
+//# sourceMappingURL=code-structure.js.map

package/dist/domain/code-structure.js.map

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

package/dist/domain/finding.d.ts

@@ -0,0 +1,24 @@
+export declare const severities: readonly ["high", "medium", "low"];
+export type Severity = (typeof severities)[number];
+export type FindingEvidenceValue = string | number | boolean;
+/** 분석 규칙이 내린 판단과 재현 가능한 근거를 함께 보존한다. */
+export interface Finding {
+    readonly ruleId: string;
+    readonly severity: Severity;
+    readonly title: string;
+    readonly description: string;
+    readonly file: string;
+    readonly evidence: Readonly<Record<string, FindingEvidenceValue>>;
+}
+export interface FindingSummary {
+    readonly total: number;
+    readonly bySeverity: Readonly<Record<Severity, number>>;
+}
+export interface FindingSet {
+    readonly items: readonly Finding[];
+    readonly summary: FindingSummary;
+}
+/** 규칙 실행 순서와 관계없이 같은 보고서가 나오도록 finding을 정렬하고 집계한다. */
+export declare function createFindingSet(findings: readonly Finding[]): FindingSet;
+export declare function isSeverityAtLeast(severity: Severity, threshold: Severity): boolean;
+//# sourceMappingURL=finding.d.ts.map

package/dist/domain/finding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finding.d.ts","sourceRoot":"","sources":["../../src/domain/finding.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,oCAAqC,CAAC;AAE7D,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE7D,wCAAwC;AACxC,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC;CACnE;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;CAClC;AAQD,sDAAsD;AACtD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,UAAU,CAgBzE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,GAAG,OAAO,CAElF"}

package/dist/domain/finding.js

@@ -0,0 +1,30 @@
+export const severities = ["high", "medium", "low"];
+const severityRank = {
+    high: 3,
+    medium: 2,
+    low: 1,
+};
+/** 규칙 실행 순서와 관계없이 같은 보고서가 나오도록 finding을 정렬하고 집계한다. */
+export function createFindingSet(findings) {
+    const items = findings
+        .map((finding) => Object.freeze({ ...finding, evidence: Object.freeze({ ...finding.evidence }) }))
+        .sort(compareFindings);
+    const bySeverity = { high: 0, medium: 0, low: 0 };
+    for (const finding of items) {
+        bySeverity[finding.severity] += 1;
+    }
+    return Object.freeze({
+        items: Object.freeze(items),
+        summary: Object.freeze({ total: items.length, bySeverity: Object.freeze(bySeverity) }),
+    });
+}
+export function isSeverityAtLeast(severity, threshold) {
+    return severityRank[severity] >= severityRank[threshold];
+}
+function compareFindings(left, right) {
+    return (severityRank[right.severity] - severityRank[left.severity] ||
+        left.file.localeCompare(right.file) ||
+        left.ruleId.localeCompare(right.ruleId) ||
+        left.title.localeCompare(right.title));
+}
+//# sourceMappingURL=finding.js.map

package/dist/domain/finding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"finding.js","sourceRoot":"","sources":["../../src/domain/finding.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAU,CAAC;AA0B7D,MAAM,YAAY,GAAuC;IACvD,IAAI,EAAE,CAAC;IACP,MAAM,EAAE,CAAC;IACT,GAAG,EAAE,CAAC;CACP,CAAC;AAEF,sDAAsD;AACtD,MAAM,UAAU,gBAAgB,CAAC,QAA4B;IAC3D,MAAM,KAAK,GAAG,QAAQ;SACnB,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CACf,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,CAChF;SACA,IAAI,CAAC,eAAe,CAAC,CAAC;IACzB,MAAM,UAAU,GAA6B,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;IAE5E,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;QAC5B,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;QAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;KACvF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAkB,EAAE,SAAmB;IACvE,OAAO,YAAY,CAAC,QAAQ,CAAC,IAAI,YAAY,CAAC,SAAS,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,eAAe,CAAC,IAAa,EAAE,KAAc;IACpD,OAAO,CACL,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC;QAC1D,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC;QACvC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CACtC,CAAC;AACJ,CAAC"}