@agentsmd/core 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 이태경
+
+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/README.md

@@ -1,3 +1,13 @@
-# Temporary Holding Version
+# @agentsmd/core
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[`agentsmd`](https://www.npmjs.com/package/agentsmd) CLI의 검사 로직과 프리셋 설치 로직입니다.
+CLI 없이 코드에서 검사하고 싶을 때 씁니다.
+
+```ts
+import { checkRepository } from "@agentsmd/core";
+
+const findings = await checkRepository({ root: process.cwd() });
+// [{ ruleId: 'broken-link', file: 'AGENTS.md', line: 12, message: '링크 대상이 없습니다: docs/api.md' }]
+```
+
+검사 규칙은 [docs/rules.md](https://github.com/xoruddl/agentsmd-kit/blob/main/docs/rules.md)를 참고하세요.

package/dist/check.d.ts

@@ -0,0 +1,20 @@
+import type { Finding } from "./types.js";
+export interface CheckOptions {
+    /** 검사할 저장소의 루트 디렉터리. */
+    readonly root: string;
+    /** 문서 지도 파일. 루트 기준 상대 경로. 기본값 `AGENTS.md` */
+    readonly agentsFile?: string;
+    /** 지도에 모두 올라 있어야 하는 문서 디렉터리. 루트 기준 상대 경로. 기본값 `docs` */
+    readonly docsDir?: string;
+    /** Claude Code용 지침 파일. 루트 기준 상대 경로. 기본값 `CLAUDE.md` */
+    readonly claudeFile?: string;
+}
+/**
+ * 저장소의 AI 작업 지침을 검사하고, 찾은 문제를 파일·줄 순서로 돌려준다.
+ *
+ * 규칙들은 파일 시스템을 모르는 순수 함수이고, 파일을 읽는 일은 이 함수가 모두 맡는다.
+ *
+ * @throws {DocMapNotFoundError} 문서 지도 파일이 없을 때
+ */
+export declare function checkRepository(options: CheckOptions): Promise<Finding[]>;
+//# sourceMappingURL=check.d.ts.map

package/dist/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../src/check.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,wDAAwD;IACxD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,uDAAuD;IACvD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAgB/E"}

package/dist/check.js

@@ -0,0 +1,67 @@
+import { existsSync } from "node:fs";
+import { readFile, readdir } from "node:fs/promises";
+import { join, posix, sep } from "node:path";
+import { DocMapNotFoundError } from "./errors.js";
+import { parseDocMap } from "./parse-doc-map.js";
+import { findBrokenLinks } from "./rules/broken-link.js";
+import { findMissingClaudeImport } from "./rules/claude-import.js";
+import { findUnlistedDocs } from "./rules/unlisted-doc.js";
+/**
+ * 저장소의 AI 작업 지침을 검사하고, 찾은 문제를 파일·줄 순서로 돌려준다.
+ *
+ * 규칙들은 파일 시스템을 모르는 순수 함수이고, 파일을 읽는 일은 이 함수가 모두 맡는다.
+ *
+ * @throws {DocMapNotFoundError} 문서 지도 파일이 없을 때
+ */
+export async function checkRepository(options) {
+    const { root, agentsFile = "AGENTS.md", docsDir = "docs", claudeFile = "CLAUDE.md" } = options;
+    const agentsContent = await readOptional(join(root, agentsFile));
+    if (agentsContent === undefined) {
+        throw new DocMapNotFoundError(agentsFile);
+    }
+    const map = parseDocMap(agentsFile, agentsContent);
+    const exists = (repoPath) => existsSync(join(root, repoPath));
+    const findings = [
+        ...findBrokenLinks(map, exists),
+        ...findUnlistedDocs([map], await listMarkdownFiles(root, docsDir)),
+        ...findMissingClaudeImport(claudeFile, await readOptional(join(root, claudeFile)), agentsFile),
+    ];
+    return findings.sort(byLocation);
+}
+async function readOptional(path) {
+    try {
+        return await readFile(path, "utf8");
+    }
+    catch (error) {
+        if (isNotFound(error)) {
+            return undefined;
+        }
+        throw error;
+    }
+}
+/** 문서 디렉터리 아래의 .md 파일을 루트 기준 posix 경로로 모은다. 디렉터리가 없으면 빈 목록이다. */
+async function listMarkdownFiles(root, docsDir) {
+    try {
+        const entries = await readdir(join(root, docsDir), { recursive: true, withFileTypes: true });
+        return entries
+            .filter((entry) => entry.isFile() && entry.name.endsWith(".md"))
+            .map((entry) => toRepoPath(root, join(entry.parentPath, entry.name)))
+            .sort();
+    }
+    catch (error) {
+        if (isNotFound(error)) {
+            return [];
+        }
+        throw error;
+    }
+}
+function toRepoPath(root, absolutePath) {
+    return posix.normalize(absolutePath.slice(join(root, sep).length).split(sep).join("/"));
+}
+function isNotFound(error) {
+    return error instanceof Error && "code" in error && error.code === "ENOENT";
+}
+function byLocation(a, b) {
+    return a.file.localeCompare(b.file) || (a.line ?? 0) - (b.line ?? 0);
+}
+//# sourceMappingURL=check.js.map

package/dist/check.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,7 @@
+/** 검사의 출발점인 문서 지도 파일이 없을 때. 규칙 위반이 아니라 검사를 시작할 수 없는 상황이다. */
+export declare class DocMapNotFoundError extends Error {
+    readonly path: string;
+    readonly name = "DocMapNotFoundError";
+    constructor(path: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,qBAAa,mBAAoB,SAAQ,KAAK;IAGhC,QAAQ,CAAC,IAAI,EAAE,MAAM;IAFjC,SAAkB,IAAI,yBAAyB;gBAE1B,IAAI,EAAE,MAAM;CAGlC"}

package/dist/errors.js

@@ -0,0 +1,10 @@
+/** 검사의 출발점인 문서 지도 파일이 없을 때. 규칙 위반이 아니라 검사를 시작할 수 없는 상황이다. */
+export class DocMapNotFoundError extends Error {
+    path;
+    name = "DocMapNotFoundError";
+    constructor(path) {
+        super(`문서 지도를 찾을 수 없습니다: ${path}`);
+        this.path = path;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAGvB;IAFH,IAAI,GAAG,qBAAqB,CAAC;IAE/C,YAAqB,IAAY;QAC/B,KAAK,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAC;QADhB,SAAI,GAAJ,IAAI,CAAQ;IAEjC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { checkRepository } from "./check.js";
+export type { CheckOptions } from "./check.js";
+export { DocMapNotFoundError } from "./errors.js";
+export { installPreset } from "./install.js";
+export type { InstallOptions, InstallResult } from "./install.js";
+export type { Preset } from "./preset.js";
+export { resolvePresets } from "./resolve-presets.js";
+export type { DocLink, DocMap, Finding, RuleId } from "./types.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,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClE,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { checkRepository } from "./check.js";
+export { DocMapNotFoundError } from "./errors.js";
+export { installPreset } from "./install.js";
+export { resolvePresets } from "./resolve-presets.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,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/install.d.ts

@@ -0,0 +1,19 @@
+import type { Preset } from "./preset.js";
+export interface InstallOptions {
+    /** 이미 있는 파일도 덮어쓴다. 기본값 false. */
+    readonly force?: boolean;
+}
+export interface InstallResult {
+    /** 새로 만들었거나 덮어쓴 파일. 대상 디렉터리 기준 posix 경로. */
+    readonly written: readonly string[];
+    /** 이미 있어서 건드리지 않은 파일. 대상 디렉터리 기준 posix 경로. */
+    readonly skipped: readonly string[];
+}
+/**
+ * 프리셋 파일을 대상 디렉터리에 복사한다.
+ *
+ * 기존 저장소에 적용할 때 사람이 다듬어 둔 지침을 지우지 않도록, 기본으로는 이미 있는 파일을 건너뛴다.
+ * 파일 권한도 함께 복사되므로 Git 훅의 실행 권한이 유지된다.
+ */
+export declare function installPreset(preset: Preset, targetDir: string, options?: InstallOptions): Promise<InstallResult>;
+//# sourceMappingURL=install.d.ts.map

package/dist/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,8CAA8C;IAC9C,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC,CAgBxB"}

package/dist/install.js

@@ -0,0 +1,33 @@
+import { copyFile, mkdir, readdir } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { dirname, join, relative, sep } from "node:path";
+/**
+ * 프리셋 파일을 대상 디렉터리에 복사한다.
+ *
+ * 기존 저장소에 적용할 때 사람이 다듬어 둔 지침을 지우지 않도록, 기본으로는 이미 있는 파일을 건너뛴다.
+ * 파일 권한도 함께 복사되므로 Git 훅의 실행 권한이 유지된다.
+ */
+export async function installPreset(preset, targetDir, options = {}) {
+    const written = [];
+    const skipped = [];
+    for (const file of await listFiles(preset.filesDir)) {
+        const destination = join(targetDir, file);
+        if (options.force !== true && existsSync(destination)) {
+            skipped.push(file);
+            continue;
+        }
+        await mkdir(dirname(destination), { recursive: true });
+        await copyFile(join(preset.filesDir, file), destination);
+        written.push(file);
+    }
+    return { written, skipped };
+}
+/** 디렉터리 아래 모든 파일을 posix 상대 경로로, 정렬해서 돌려준다. */
+async function listFiles(dir) {
+    const entries = await readdir(dir, { recursive: true, withFileTypes: true });
+    return entries
+        .filter((entry) => entry.isFile())
+        .map((entry) => relative(dir, join(entry.parentPath, entry.name)).split(sep).join("/"))
+        .sort();
+}
+//# sourceMappingURL=install.js.map

package/dist/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAezD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAc,EACd,SAAiB,EACjB,UAA0B,EAAE;IAE5B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,IAAI,IAAI,MAAM,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC1C,IAAI,OAAO,CAAC,KAAK,KAAK,IAAI,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YACtD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,SAAS;QACX,CAAC;QACD,MAAM,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,MAAM,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,WAAW,CAAC,CAAC;QACzD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC9B,CAAC;AAED,8CAA8C;AAC9C,KAAK,UAAU,SAAS,CAAC,GAAW;IAClC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7E,OAAO,OAAO;SACX,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;SACjC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;SACtF,IAAI,EAAE,CAAC;AACZ,CAAC"}

package/dist/parse-doc-map.d.ts

@@ -0,0 +1,9 @@
+import type { DocMap } from "./types.js";
+/**
+ * 문서 지도(AGENTS.md 등)에서 저장소 안의 파일을 가리키는 링크를 모은다.
+ *
+ * 코드 블록과 인라인 코드 안의 링크는 예시일 수 있으므로 세지 않는다.
+ * 경로가 실제로 있는지, 저장소 밖을 가리키는지는 여기서 판단하지 않고 규칙에 맡긴다.
+ */
+export declare function parseDocMap(file: string, markdown: string): DocMap;
+//# sourceMappingURL=parse-doc-map.d.ts.map

package/dist/parse-doc-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-doc-map.d.ts","sourceRoot":"","sources":["../src/parse-doc-map.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,MAAM,EAAE,MAAM,YAAY,CAAC;AAYlD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAwBlE"}

package/dist/parse-doc-map.js

@@ -0,0 +1,73 @@
+// [텍스트](경로) 또는 ![대체 텍스트](경로). 뒤에 "제목"이 올 수 있다.
+// 공백이 든 경로는 <...>로 감싸야 하므로 꺾쇠 형식(1번 그룹)과 일반 형식(2번 그룹)을 나눠 받는다.
+const INLINE_LINK = /!?\[(?:[^\]\\]|\\.)*\]\(\s*(?:<([^>\n]+)>|([^)\s]+))(?:\s+"[^"]*")?\s*\)/g;
+// [이름]: 경로  (참조형 링크 정의)
+const REFERENCE_DEFINITION = /^\s{0,3}\[[^\]]+\]:\s*<?(\S+?)>?(?:\s|$)/;
+// http:, mailto: 처럼 스킴이 붙은 주소는 저장소 안의 파일이 아니다.
+const URL_SCHEME = /^[a-z][a-z0-9+.-]*:/i;
+const FENCE = /^\s{0,3}(`{3,}|~{3,})/;
+const INLINE_CODE = /`+[^`]*`+/g;
+/**
+ * 문서 지도(AGENTS.md 등)에서 저장소 안의 파일을 가리키는 링크를 모은다.
+ *
+ * 코드 블록과 인라인 코드 안의 링크는 예시일 수 있으므로 세지 않는다.
+ * 경로가 실제로 있는지, 저장소 밖을 가리키는지는 여기서 판단하지 않고 규칙에 맡긴다.
+ */
+export function parseDocMap(file, markdown) {
+    const links = [];
+    let openFence;
+    markdown.split(/\r?\n/).forEach((rawLine, index) => {
+        const fence = FENCE.exec(rawLine)?.[1];
+        if (fence !== undefined) {
+            openFence = nextFenceState(openFence, fence);
+            return;
+        }
+        if (openFence !== undefined) {
+            return;
+        }
+        const line = index + 1;
+        for (const target of extractTargets(rawLine.replace(INLINE_CODE, ""))) {
+            const normalized = normalizeTarget(target);
+            if (normalized !== undefined) {
+                links.push({ target: normalized, line });
+            }
+        }
+    });
+    return { file, links };
+}
+/** 같은 문자로 같은 길이 이상인 펜스가 와야 코드 블록이 닫힌다 (CommonMark 규칙). */
+function nextFenceState(openFence, fence) {
+    if (openFence === undefined) {
+        return fence;
+    }
+    const closes = fence.startsWith(openFence.charAt(0)) && fence.length >= openFence.length;
+    return closes ? undefined : openFence;
+}
+function extractTargets(line) {
+    const definition = REFERENCE_DEFINITION.exec(line)?.[1];
+    if (definition !== undefined) {
+        return [definition];
+    }
+    return Array.from(line.matchAll(INLINE_LINK), (match) => match[1] ?? match[2] ?? "");
+}
+/** 앵커와 쿼리를 떼고, 외부 주소나 같은 문서 안의 앵커면 undefined를 돌려준다. */
+function normalizeTarget(target) {
+    if (target === "" || target.startsWith("#") || URL_SCHEME.test(target)) {
+        return undefined;
+    }
+    const path = target.split(/[#?]/, 1)[0] ?? "";
+    if (path === "") {
+        return undefined;
+    }
+    return safeDecode(path);
+}
+/** `%20` 같은 인코딩을 풀되, 잘못된 인코딩이면 적힌 그대로 둔다. */
+function safeDecode(path) {
+    try {
+        return decodeURI(path);
+    }
+    catch {
+        return path;
+    }
+}
+//# sourceMappingURL=parse-doc-map.js.map

package/dist/parse-doc-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-doc-map.js","sourceRoot":"","sources":["../src/parse-doc-map.ts"],"names":[],"mappings":"AAEA,+CAA+C;AAC/C,+DAA+D;AAC/D,MAAM,WAAW,GAAG,2EAA2E,CAAC;AAChG,wBAAwB;AACxB,MAAM,oBAAoB,GAAG,0CAA0C,CAAC;AACxE,+CAA+C;AAC/C,MAAM,UAAU,GAAG,sBAAsB,CAAC;AAC1C,MAAM,KAAK,GAAG,uBAAuB,CAAC;AACtC,MAAM,WAAW,GAAG,YAAY,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,QAAgB;IACxD,MAAM,KAAK,GAAc,EAAE,CAAC;IAC5B,IAAI,SAA6B,CAAC;IAElC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;QACjD,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACvC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,SAAS,GAAG,cAAc,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YAC7C,OAAO;QACT,CAAC;QACD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO;QACT,CAAC;QAED,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC,CAAC;QACvB,KAAK,MAAM,MAAM,IAAI,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;YACtE,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;YAC3C,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;gBAC7B,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACzB,CAAC;AAED,0DAA0D;AAC1D,SAAS,cAAc,CAAC,SAA6B,EAAE,KAAa;IAClE,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,SAAS,CAAC,MAAM,CAAC;IACzF,OAAO,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AACxC,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,MAAM,UAAU,GAAG,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACxD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,CAAC,UAAU,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AACvF,CAAC;AAED,uDAAuD;AACvD,SAAS,eAAe,CAAC,MAAc;IACrC,IAAI,MAAM,KAAK,EAAE,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACvE,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9C,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;QAChB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,6CAA6C;AAC7C,SAAS,UAAU,CAAC,IAAY;IAC9B,IAAI,CAAC;QACH,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/preset.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `init`으로 설치할 수 있는 지침 파일 묶음.
+ *
+ * 프리셋 패키지는 이 형태의 객체 하나를 내보낸다. 파일 내용은 `filesDir` 아래에 설치될 경로 그대로 둔다.
+ */
+export interface Preset {
+    /** `--preset` 옵션에 쓰는 이름. 예: `java` */
+    readonly name: string;
+    /** 도움말에 보여 줄 한 줄 설명. */
+    readonly description: string;
+    /** 설치할 파일들이 있는 디렉터리의 절대 경로. */
+    readonly filesDir: string;
+    /** 프리셋에 Git 훅이 있으면 그 디렉터리. 설치 대상 기준 상대 경로. `core.hooksPath`로 연결한다. */
+    readonly hooksPath?: string;
+    /** 파일을 설치한 뒤 사람이 직접 해야 하는 일. 설치 결과 끝에 안내한다. */
+    readonly nextSteps?: readonly string[];
+    /** 이 프리셋보다 먼저 설치해야 하는 프리셋. 예: 언어 프리셋이 공통 Git 프리셋을 요구한다. */
+    readonly requires?: readonly Preset[];
+}
+//# sourceMappingURL=preset.d.ts.map

package/dist/preset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset.d.ts","sourceRoot":"","sources":["../src/preset.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,MAAM;IACrB,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wBAAwB;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,+BAA+B;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,sEAAsE;IACtE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,+CAA+C;IAC/C,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC"}

package/dist/preset.js

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

package/dist/preset.js.map

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

package/dist/resolve-link.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 문서 안의 링크를 저장소 루트 기준 경로로 바꾼다.
+ *
+ * 링크는 그 링크가 적힌 문서의 위치를 기준으로 풀린다. `/`로 시작하면 GitHub처럼 저장소 루트 기준으로 본다.
+ * 저장소 밖을 가리키면(예: `../menu-pick-frontend`) 이 저장소만으로는 확인할 수 없으므로 undefined를 돌려준다.
+ *
+ * @param fromFile 링크가 적힌 문서. 저장소 루트 기준 상대 경로.
+ * @param target 링크에 적힌 경로.
+ */
+export declare function resolveLink(fromFile: string, target: string): string | undefined;
+//# sourceMappingURL=resolve-link.d.ts.map

package/dist/resolve-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-link.d.ts","sourceRoot":"","sources":["../src/resolve-link.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAUhF"}

package/dist/resolve-link.js

@@ -0,0 +1,21 @@
+import { posix } from "node:path";
+/**
+ * 문서 안의 링크를 저장소 루트 기준 경로로 바꾼다.
+ *
+ * 링크는 그 링크가 적힌 문서의 위치를 기준으로 풀린다. `/`로 시작하면 GitHub처럼 저장소 루트 기준으로 본다.
+ * 저장소 밖을 가리키면(예: `../menu-pick-frontend`) 이 저장소만으로는 확인할 수 없으므로 undefined를 돌려준다.
+ *
+ * @param fromFile 링크가 적힌 문서. 저장소 루트 기준 상대 경로.
+ * @param target 링크에 적힌 경로.
+ */
+export function resolveLink(fromFile, target) {
+    const joined = target.startsWith("/")
+        ? target.slice(1)
+        : posix.join(posix.dirname(fromFile), target);
+    const normalized = posix.normalize(joined).replace(/\/+$/, "");
+    if (normalized === ".." || normalized.startsWith("../")) {
+        return undefined;
+    }
+    return normalized === "" ? "." : normalized;
+}
+//# sourceMappingURL=resolve-link.js.map

package/dist/resolve-link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-link.js","sourceRoot":"","sources":["../src/resolve-link.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAElC;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,MAAc;IAC1D,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC;QACnC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACjB,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;IAChD,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAE/D,IAAI,UAAU,KAAK,IAAI,IAAI,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACxD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC;AAC9C,CAAC"}

package/dist/resolve-presets.d.ts

@@ -0,0 +1,9 @@
+import type { Preset } from "./preset.js";
+/**
+ * 프리셋과 그 프리셋이 요구하는 프리셋을 설치 순서대로 펼친다.
+ *
+ * 요구되는 프리셋이 먼저 오고, 여러 경로로 요구돼도 한 번만 들어간다 (이름 기준).
+ * 순환 요구는 설치 순서를 정할 수 없으므로 오류로 알린다.
+ */
+export declare function resolvePresets(preset: Preset): Preset[];
+//# sourceMappingURL=resolve-presets.d.ts.map

package/dist/resolve-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-presets.d.ts","sourceRoot":"","sources":["../src/resolve-presets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAoBvD"}

package/dist/resolve-presets.js

@@ -0,0 +1,26 @@
+/**
+ * 프리셋과 그 프리셋이 요구하는 프리셋을 설치 순서대로 펼친다.
+ *
+ * 요구되는 프리셋이 먼저 오고, 여러 경로로 요구돼도 한 번만 들어간다 (이름 기준).
+ * 순환 요구는 설치 순서를 정할 수 없으므로 오류로 알린다.
+ */
+export function resolvePresets(preset) {
+    const ordered = [];
+    const done = new Set();
+    const visit = (current, path) => {
+        if (path.includes(current.name)) {
+            throw new Error(`프리셋 요구 관계가 순환합니다: ${[...path, current.name].join(" → ")}`);
+        }
+        if (done.has(current.name)) {
+            return;
+        }
+        for (const required of current.requires ?? []) {
+            visit(required, [...path, current.name]);
+        }
+        done.add(current.name);
+        ordered.push(current);
+    };
+    visit(preset, []);
+    return ordered;
+}
+//# sourceMappingURL=resolve-presets.js.map

package/dist/resolve-presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-presets.js","sourceRoot":"","sources":["../src/resolve-presets.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,MAAM,KAAK,GAAG,CAAC,OAAe,EAAE,IAAuB,EAAQ,EAAE;QAC/D,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC9E,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,OAAO;QACT,CAAC;QACD,KAAK,MAAM,QAAQ,IAAI,OAAO,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;YAC9C,KAAK,CAAC,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACvB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC,CAAC;IAEF,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAClB,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/rules/broken-link.d.ts

@@ -0,0 +1,11 @@
+import type { DocMap, Finding } from "../types.js";
+/**
+ * 문서 지도가 가리키는 파일·디렉터리가 실제로 있는지 검사한다.
+ *
+ * 문서를 옮기거나 지운 뒤 지도를 고치지 않으면, 에이전트는 없는 문서를 찾다가 추측으로 작업하게 된다.
+ * 저장소 밖을 가리키는 링크는 확인할 수 없으므로 건너뛴다.
+ *
+ * @param exists 저장소 루트 기준 경로가 있는지 알려 주는 함수. 파일 시스템 접근은 호출하는 쪽이 맡는다.
+ */
+export declare function findBrokenLinks(map: DocMap, exists: (repoPath: string) => boolean): Finding[];
+//# sourceMappingURL=broken-link.d.ts.map

package/dist/rules/broken-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broken-link.d.ts","sourceRoot":"","sources":["../../src/rules/broken-link.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEnD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,EAAE,CAe7F"}

package/dist/rules/broken-link.js

@@ -0,0 +1,26 @@
+import { resolveLink } from "../resolve-link.js";
+/**
+ * 문서 지도가 가리키는 파일·디렉터리가 실제로 있는지 검사한다.
+ *
+ * 문서를 옮기거나 지운 뒤 지도를 고치지 않으면, 에이전트는 없는 문서를 찾다가 추측으로 작업하게 된다.
+ * 저장소 밖을 가리키는 링크는 확인할 수 없으므로 건너뛴다.
+ *
+ * @param exists 저장소 루트 기준 경로가 있는지 알려 주는 함수. 파일 시스템 접근은 호출하는 쪽이 맡는다.
+ */
+export function findBrokenLinks(map, exists) {
+    return map.links.flatMap((link) => {
+        const repoPath = resolveLink(map.file, link.target);
+        if (repoPath === undefined || exists(repoPath)) {
+            return [];
+        }
+        return [
+            {
+                ruleId: "broken-link",
+                file: map.file,
+                line: link.line,
+                message: `링크 대상이 없습니다: ${link.target}`,
+            },
+        ];
+    });
+}
+//# sourceMappingURL=broken-link.js.map

package/dist/rules/broken-link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"broken-link.js","sourceRoot":"","sources":["../../src/rules/broken-link.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,MAAqC;IAChF,OAAO,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAChC,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACpD,IAAI,QAAQ,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/C,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO;YACL;gBACE,MAAM,EAAE,aAAa;gBACrB,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,OAAO,EAAE,gBAAgB,IAAI,CAAC,MAAM,EAAE;aACvC;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/rules/claude-import.d.ts

@@ -0,0 +1,13 @@
+import type { Finding } from "../types.js";
+/**
+ * CLAUDE.md가 AGENTS.md를 `@` 문법으로 불러오는지 검사한다.
+ *
+ * Claude Code는 CLAUDE.md를 읽으므로, 지침의 원본을 AGENTS.md 하나로 두려면 CLAUDE.md가 그 파일을 불러와야 한다.
+ * 그렇지 않으면 두 파일의 지침이 따로 자라거나, Claude Code만 지침을 읽지 못한다.
+ *
+ * @param claudeFile CLAUDE.md의 저장소 루트 기준 경로.
+ * @param content CLAUDE.md 내용. 파일이 없으면 undefined이고, 이때는 검사할 대상이 없다.
+ * @param agentsFile 불러와야 하는 문서 지도의 저장소 루트 기준 경로.
+ */
+export declare function findMissingClaudeImport(claudeFile: string, content: string | undefined, agentsFile: string): Finding[];
+//# sourceMappingURL=claude-import.d.ts.map

package/dist/rules/claude-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-import.d.ts","sourceRoot":"","sources":["../../src/rules/claude-import.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,UAAU,EAAE,MAAM,GACjB,OAAO,EAAE,CAeX"}

package/dist/rules/claude-import.js

@@ -0,0 +1,46 @@
+import { posix } from "node:path";
+/**
+ * CLAUDE.md가 AGENTS.md를 `@` 문법으로 불러오는지 검사한다.
+ *
+ * Claude Code는 CLAUDE.md를 읽으므로, 지침의 원본을 AGENTS.md 하나로 두려면 CLAUDE.md가 그 파일을 불러와야 한다.
+ * 그렇지 않으면 두 파일의 지침이 따로 자라거나, Claude Code만 지침을 읽지 못한다.
+ *
+ * @param claudeFile CLAUDE.md의 저장소 루트 기준 경로.
+ * @param content CLAUDE.md 내용. 파일이 없으면 undefined이고, 이때는 검사할 대상이 없다.
+ * @param agentsFile 불러와야 하는 문서 지도의 저장소 루트 기준 경로.
+ */
+export function findMissingClaudeImport(claudeFile, content, agentsFile) {
+    if (content === undefined) {
+        return [];
+    }
+    const importPath = posix.relative(posix.dirname(claudeFile), agentsFile);
+    if (importsFile(content, importPath)) {
+        return [];
+    }
+    return [
+        {
+            ruleId: "claude-import",
+            file: claudeFile,
+            message: `@${importPath} 로 문서 지도를 불러오지 않습니다`,
+        },
+    ];
+}
+/** `@AGENTS.md`, `@./AGENTS.md` 모두 인정한다. 코드 블록 안의 예시는 인정하지 않는다. */
+function importsFile(content, importPath) {
+    let inFence = false;
+    for (const line of content.split(/\r?\n/)) {
+        if (/^\s{0,3}(`{3,}|~{3,})/.test(line)) {
+            inFence = !inFence;
+            continue;
+        }
+        if (inFence) {
+            continue;
+        }
+        const imports = line.match(/(?:^|\s)@(\S+)/g) ?? [];
+        if (imports.some((token) => posix.normalize(token.trim().slice(1)) === importPath)) {
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=claude-import.js.map

package/dist/rules/claude-import.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-import.js","sourceRoot":"","sources":["../../src/rules/claude-import.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAGlC;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB,CACrC,UAAkB,EAClB,OAA2B,EAC3B,UAAkB;IAElB,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,UAAU,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC,CAAC;IACzE,IAAI,WAAW,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC;QACrC,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO;QACL;YACE,MAAM,EAAE,eAAe;YACvB,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,IAAI,UAAU,qBAAqB;SAC7C;KACF,CAAC;AACJ,CAAC;AAED,mEAAmE;AACnE,SAAS,WAAW,CAAC,OAAe,EAAE,UAAkB;IACtD,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1C,IAAI,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACvC,OAAO,GAAG,CAAC,OAAO,CAAC;YACnB,SAAS;QACX,CAAC;QACD,IAAI,OAAO,EAAE,CAAC;YACZ,SAAS;QACX,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC;QACpD,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,EAAE,CAAC;YACnF,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/rules/unlisted-doc.d.ts

@@ -0,0 +1,12 @@
+import type { DocMap, Finding } from "../types.js";
+/**
+ * 문서 디렉터리에 있지만 어떤 문서 지도에서도 안내하지 않는 문서를 찾는다.
+ *
+ * 에이전트는 지도에 없는 문서를 읽을 이유가 없으므로, 새 문서를 만들고 지도를 고치지 않으면
+ * 그 문서의 규칙은 없는 것과 같다. 지도가 디렉터리를 가리키면 그 아래 문서는 모두 안내된 것으로 본다.
+ *
+ * @param maps 문서 지도들. 하나라도 가리키면 안내된 것으로 본다.
+ * @param docFiles 검사할 문서 목록. 저장소 루트 기준 상대 경로.
+ */
+export declare function findUnlistedDocs(maps: readonly DocMap[], docFiles: readonly string[]): Finding[];
+//# sourceMappingURL=unlisted-doc.d.ts.map

package/dist/rules/unlisted-doc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unlisted-doc.d.ts","sourceRoot":"","sources":["../../src/rules/unlisted-doc.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEnD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,EAAE,CAahG"}

package/dist/rules/unlisted-doc.js

@@ -0,0 +1,27 @@
+import { resolveLink } from "../resolve-link.js";
+/**
+ * 문서 디렉터리에 있지만 어떤 문서 지도에서도 안내하지 않는 문서를 찾는다.
+ *
+ * 에이전트는 지도에 없는 문서를 읽을 이유가 없으므로, 새 문서를 만들고 지도를 고치지 않으면
+ * 그 문서의 규칙은 없는 것과 같다. 지도가 디렉터리를 가리키면 그 아래 문서는 모두 안내된 것으로 본다.
+ *
+ * @param maps 문서 지도들. 하나라도 가리키면 안내된 것으로 본다.
+ * @param docFiles 검사할 문서 목록. 저장소 루트 기준 상대 경로.
+ */
+export function findUnlistedDocs(maps, docFiles) {
+    const listed = new Set(maps.flatMap((map) => map.links.flatMap((link) => resolveLink(map.file, link.target) ?? [])));
+    const mapNames = maps.map((map) => map.file).join(", ");
+    return docFiles
+        .filter((docFile) => !isListed(docFile, listed))
+        .map((docFile) => ({
+        ruleId: "unlisted-doc",
+        file: docFile,
+        message: `문서 지도(${mapNames})에서 안내하지 않는 문서입니다`,
+    }));
+}
+/** 파일 자체나 그 파일을 담은 상위 디렉터리 중 하나가 지도에 있으면 안내된 것이다. */
+function isListed(docFile, listed) {
+    const parts = docFile.split("/");
+    return parts.some((_, index) => listed.has(parts.slice(0, index + 1).join("/")));
+}
+//# sourceMappingURL=unlisted-doc.js.map

package/dist/rules/unlisted-doc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unlisted-doc.js","sourceRoot":"","sources":["../../src/rules/unlisted-doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAuB,EAAE,QAA2B;IACnF,MAAM,MAAM,GAAG,IAAI,GAAG,CACpB,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAC7F,CAAC;IACF,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAExD,OAAO,QAAQ;SACZ,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;SAC/C,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACjB,MAAM,EAAE,cAAc;QACtB,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,SAAS,QAAQ,mBAAmB;KAC9C,CAAC,CAAC,CAAC;AACR,CAAC;AAED,qDAAqD;AACrD,SAAS,QAAQ,CAAC,OAAe,EAAE,MAA2B;IAC5D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACnF,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,25 @@
+/** AGENTS.md 안에서 찾은 상대 경로 링크 하나. */
+export interface DocLink {
+    /** 링크에 적힌 경로. `#` 뒤의 앵커는 뺀 값이다. */
+    readonly target: string;
+    /** 링크가 있는 줄 번호 (1부터 시작). */
+    readonly line: number;
+}
+/** 검사 대상이 되는 문서 지도 파일 하나. */
+export interface DocMap {
+    /** 저장소 루트 기준 상대 경로. 예: `AGENTS.md` */
+    readonly file: string;
+    readonly links: readonly DocLink[];
+}
+/** 규칙 식별자. 출력과 문서에서 이 이름으로 규칙을 가리킨다. */
+export type RuleId = "broken-link" | "unlisted-doc" | "claude-import";
+/** 규칙 하나가 찾은 문제. */
+export interface Finding {
+    readonly ruleId: RuleId;
+    /** 문제가 있는 파일. 저장소 루트 기준 상대 경로. */
+    readonly file: string;
+    /** 줄을 특정할 수 있을 때만 있다. */
+    readonly line?: number;
+    readonly message: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,MAAM,WAAW,OAAO;IACtB,mCAAmC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,4BAA4B;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,6BAA6B;AAC7B,MAAM,WAAW,MAAM;IACrB,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,CAAC;CACpC;AAED,wCAAwC;AACxC,MAAM,MAAM,MAAM,GAAG,aAAa,GAAG,cAAc,GAAG,eAAe,CAAC;AAEtE,oBAAoB;AACpB,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B"}

package/dist/types.js

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

package/dist/types.js.map

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

package/package.json

@@ -1,6 +1,41 @@
 {
   "name": "@agentsmd/core",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "AGENTS.md 문서 지도를 읽고 검사하는 규칙 모음",
+  "keywords": [
+    "agents.md",
+    "ai-agent",
+    "lint",
+    "documentation"
+  ],
+  "homepage": "https://github.com/xoruddl/agentsmd-kit#readme",
+  "bugs": "https://github.com/xoruddl/agentsmd-kit/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xoruddl/agentsmd-kit.git",
+    "directory": "packages/core"
+  },
+  "license": "MIT",
+  "author": "이태경 (https://github.com/xoruddl)",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json",
+    "test": "vitest run"
+  }
 }