crumbs-spec 0.0.0-stage → 0.2.0

package/dist/src/cli.js

@@ -0,0 +1,195 @@
+#!/usr/bin/env node
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { parseArgs } from 'node:util';
+import { runCheck } from './check.js';
+import { ConfigError, loadRepoConfig } from './config.js';
+import { isLang } from './headings.js';
+import { runInit } from './init.js';
+import { addLogEntry, assertLogDocument, hasHeadingLine, isLogKind, normalizeLogBody } from './log.js';
+import { MESSAGES } from './messages.js';
+import { formatJson, formatText } from './report.js';
+// 사용법 오류. 메시지 뒤에 한 줄 사용법을 덧붙여 stderr에 낸다(종료 코드 2). lang은 그 줄의 언어다.
+class UsageError extends Error {
+    lang;
+    constructor(message, lang) {
+        super(message);
+        this.lang = lang;
+    }
+}
+const OPTIONS = {
+    root: { type: 'string' },
+    help: { type: 'boolean', short: 'h' },
+    version: { type: 'boolean', short: 'v' },
+    lang: { type: 'string' },
+    'spec-dir': { type: 'string' },
+    format: { type: 'string' },
+    config: { type: 'string' },
+    kind: { type: 'string' },
+    body: { type: 'string' },
+    skills: { type: 'string' },
+};
+// 명령마다 받는 옵션(6.4.4 표). --root와 --lang은 모든 명령이 받으므로 여기에 없다.
+const SCOPED_OPTIONS = ['spec-dir', 'format', 'config', 'kind', 'body', 'skills'];
+const INIT_OPTIONS = ['spec-dir', 'skills'];
+const CHECK_OPTIONS = ['format', 'config'];
+const LOG_ADD_OPTIONS = ['config', 'kind', 'body'];
+function readVersion() {
+    const pkg = JSON.parse(readFileSync(new URL('../../package.json', import.meta.url), 'utf8'));
+    return pkg.version;
+}
+// 설정 파일을 읽기 전의 오류 언어. --lang 값이 ko이면 ko이고, 그 밖에는 en이다.
+function preLang(argv) {
+    for (let i = 0; i < argv.length; i++) {
+        if (argv[i] === '--')
+            break;
+        if (argv[i] === '--lang')
+            return argv[i + 1] === 'ko' ? 'ko' : 'en';
+        if (argv[i].startsWith('--lang='))
+            return argv[i].slice('--lang='.length) === 'ko' ? 'ko' : 'en';
+    }
+    return 'en';
+}
+// parseArgs 오류를 사용법 오류로 바꾼다. 옵션 이름은 오류 메시지에서 꺼낸다.
+function toUsageError(error, lang) {
+    if (!(error instanceof Error))
+        return new UsageError(String(error), lang);
+    const code = error.code;
+    const name = /(--?[A-Za-z][\w-]*)/.exec(error.message)?.[1] ?? error.message;
+    const m = MESSAGES[lang];
+    if (code === 'ERR_PARSE_ARGS_UNKNOWN_OPTION')
+        return new UsageError(m.unknownOption(name), lang);
+    if (code === 'ERR_PARSE_ARGS_INVALID_OPTION_VALUE')
+        return new UsageError(m.optionValue(name), lang);
+    return error;
+}
+function parse(argv, lang) {
+    try {
+        return parseArgs({ args: argv, options: OPTIONS, allowPositionals: true, strict: true });
+    }
+    catch (error) {
+        throw toUsageError(error, lang);
+    }
+}
+// 명령이 받지 않는 옵션을 "알 수 없는 옵션"으로 거부한다.
+function rejectForeignOptions(values, allowed, lang) {
+    for (const name of SCOPED_OPTIONS) {
+        if (values[name] !== undefined && !allowed.includes(name)) {
+            throw new UsageError(MESSAGES[lang].unknownOption(`--${name}`), lang);
+        }
+    }
+}
+// --lang 값을 검사한다. 옵션이 없으면 undefined다.
+function langOption(value, lang) {
+    if (value === undefined)
+        return undefined;
+    if (isLang(value))
+        return value;
+    throw new UsageError(MESSAGES[lang].optionValue('--lang'), lang);
+}
+// --skills 값을 검사한다. 옵션이 없으면 undefined다.
+function skillsOption(value, lang) {
+    if (value === undefined)
+        return undefined;
+    if (value === 'claude' || value === 'codex' || value === 'all')
+        return value;
+    throw new UsageError(MESSAGES[lang].optionValue('--skills'), lang);
+}
+// log add(6.4). 검증은 6.4.2 표의 순서대로 하고, 처음 걸린 조건만 보고한다.
+// 설정을 읽기 전 조건은 명령줄의 언어로, 설정을 읽은 뒤 조건은 설정의 lang으로 낸다.
+function logAdd(root, values, args, lang) {
+    const m = MESSAGES[lang];
+    if (values.kind === undefined)
+        throw new UsageError(m.optionRequired('--kind'), lang);
+    const kind = values.kind;
+    if (!isLogKind(kind))
+        throw new UsageError(m.optionValue('--kind'), lang);
+    if (args.length === 0)
+        throw new UsageError(m.titleMissing, lang);
+    if (args.length > 1)
+        throw new UsageError(m.titleCount, lang);
+    const [rawTitle] = args;
+    if (rawTitle.trim() === '')
+        throw new UsageError(m.titleEmpty, lang);
+    if (/[\r\n]/.test(rawTitle))
+        throw new UsageError(m.titleLineBreak, lang);
+    const body = values.body === undefined ? undefined : normalizeLogBody(values.body);
+    if (body !== undefined && hasHeadingLine(body))
+        throw new UsageError(m.bodyHeading, lang);
+    if (rawTitle.includes('<!--') || (body ?? '').includes('<!--'))
+        throw new UsageError(m.commentForbidden, lang);
+    const config = loadRepoConfig(root, values.config, lang);
+    assertLogDocument(root, config);
+    rejectForeignOptions(values, LOG_ADD_OPTIONS, config.lang);
+    process.stdout.write(`${addLogEntry(root, config, kind, rawTitle.trim(), body)}\n`);
+    return 0;
+}
+function run(argv) {
+    const lang = preLang(argv);
+    const m = MESSAGES[lang];
+    const { values, positionals } = parse(argv, lang);
+    const specLang = langOption(values.lang, lang);
+    if (values.help) {
+        process.stdout.write(m.help);
+        return 0;
+    }
+    if (values.version) {
+        process.stdout.write(`${readVersion()}\n`);
+        return 0;
+    }
+    if (positionals.length === 0)
+        throw new UsageError(m.noCommand, lang);
+    const [command, ...rest] = positionals;
+    if (command === 'log') {
+        if (rest[0] === undefined)
+            throw new UsageError(m.noSubcommand, lang);
+        if (rest[0] !== 'add')
+            throw new UsageError(m.unknownCommand(`log ${rest[0]}`), lang);
+    }
+    else if (command !== 'init' && command !== 'check') {
+        throw new UsageError(m.unknownCommand(command), lang);
+    }
+    else if (rest.length > 0) {
+        throw new UsageError(m.unknownCommand(rest[0]), lang);
+    }
+    if (values.root === '')
+        throw new UsageError(m.optionValue('--root'), lang);
+    const root = resolve(values.root ?? '.');
+    if (command === 'log')
+        return logAdd(root, values, rest.slice(1), lang);
+    if (command === 'init') {
+        rejectForeignOptions(values, INIT_OPTIONS, lang);
+        const skills = skillsOption(values.skills, lang);
+        process.stdout.write(`${runInit(root, values['spec-dir'], skills, specLang).join('\n')}\n`);
+        return 0;
+    }
+    rejectForeignOptions(values, CHECK_OPTIONS, lang);
+    const format = values.format ?? 'text';
+    if (format !== 'text' && format !== 'json')
+        throw new UsageError(m.optionValue('--format'), lang);
+    const config = loadRepoConfig(root, values.config, lang);
+    const report = runCheck(root, config);
+    process.stdout.write(format === 'json' ? formatJson(report) : formatText(report, config.lang));
+    return report.ok ? 0 : 1;
+}
+function main() {
+    let code;
+    try {
+        code = run(process.argv.slice(2));
+    }
+    catch (error) {
+        if (error instanceof UsageError) {
+            process.stderr.write(`crumbs: ${error.message}\n${MESSAGES[error.lang].usage}\n`);
+        }
+        else if (error instanceof ConfigError) {
+            process.stderr.write(`${error.message}\n`);
+        }
+        else {
+            process.stderr.write(`crumbs: ${error instanceof Error ? error.message : String(error)}\n`);
+        }
+        code = 2;
+    }
+    process.exitCode = code;
+}
+main();
+//# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

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

package/dist/src/config.js

@@ -0,0 +1,151 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join, posix, resolve } from 'node:path';
+import { VOCAB_KEYS, isLang } from './headings.js';
+import { MESSAGES } from './messages.js';
+// 설정 오류. 메시지는 사용자에게 그대로 보여 준다(stderr, 종료 코드 2).
+export class ConfigError extends Error {
+}
+const TOP_LEVEL_KEYS = ['version', 'specDir', 'index', 'overview', 'log', 'lang', 'headings', 'exclude', 'codeRoot', 'rawDir'];
+// specDir/rawDir를 저장소 루트 기준 정규화 경로로 만든다. 빈 값과 "."은 "."이 된다.
+function normRel(path) {
+    return posix.normalize(path).replace(/\/+$/, '') || '.';
+}
+// 저장소 루트 밖을 가리키는 값(.., 절대 경로, 드라이브 문자)인지 본다.
+function isOutsideRoot(rel) {
+    return rel === '..' || rel.startsWith('../') || posix.isAbsolute(rel) || /^[A-Za-z]:/.test(rel);
+}
+// exclude 항목을 스펙 루트 기준 정규화 경로로 만든다. 끝의 "/"는 디렉터리 항목이라는 뜻이므로 남긴다.
+function normExclude(m, entry) {
+    const path = posix.normalize(entry).replace(/^(\.\/)+/, '');
+    if (path === '' || path === '.' || isOutsideRoot(path))
+        fail(m, 'exclude', m.reasonRelativePath);
+    return path;
+}
+export function defaultConfig(specDir, lang = 'en') {
+    return {
+        version: 1,
+        specDir: specDir ?? 'docs/specs',
+        index: 'index.md',
+        overview: 'overview.md',
+        log: 'log.md',
+        lang,
+        headings: {},
+        exclude: ['templates/'],
+        codeRoot: '.',
+        rawDir: 'docs/raw',
+    };
+}
+// 설정 값 오류. 메시지 언어는 validate가 정한다.
+function fail(m, key, reason) {
+    throw new ConfigError(m.invalid(key, reason));
+}
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+// 설정 내용의 오류 메시지 언어. 값이 en·ko인 lang을 쓰고, 그 밖이면 호출자가 준 언어(--lang 또는 en)를 쓴다.
+function messageLang(raw, fallback) {
+    if (isPlainObject(raw) && typeof raw.lang === 'string' && isLang(raw.lang))
+        return raw.lang;
+    return fallback;
+}
+function optString(m, obj, key, fallback) {
+    const value = obj[key];
+    if (value === undefined)
+        return fallback;
+    if (typeof value !== 'string')
+        fail(m, key, m.reasonString);
+    return value;
+}
+function validate(raw, fallback) {
+    const m = MESSAGES[messageLang(raw, fallback)];
+    if (!isPlainObject(raw))
+        throw new ConfigError(m.configNotObject);
+    for (const key of Object.keys(raw)) {
+        if (!TOP_LEVEL_KEYS.includes(key))
+            throw new ConfigError(m.unknownKey(key));
+    }
+    const version = raw.version;
+    if (version === undefined)
+        fail(m, 'version', m.reasonOne);
+    if (typeof version !== 'number')
+        fail(m, 'version', m.reasonNumber);
+    if (version !== 1)
+        fail(m, 'version', m.reasonOne);
+    const specDir = normRel(optString(m, raw, 'specDir', 'docs/specs'));
+    if (specDir === '.')
+        fail(m, 'specDir', m.reasonDot);
+    if (isOutsideRoot(specDir))
+        fail(m, 'specDir', m.reasonInsideRoot);
+    const index = optString(m, raw, 'index', 'index.md');
+    const overview = optString(m, raw, 'overview', 'overview.md');
+    const log = optString(m, raw, 'log', 'log.md');
+    const lang = optString(m, raw, 'lang', 'en');
+    if (!isLang(lang))
+        throw new ConfigError(m.langInvalid);
+    const headings = {};
+    if (raw.headings !== undefined) {
+        const overrides = raw.headings;
+        if (!isPlainObject(overrides))
+            fail(m, 'headings', m.reasonObject);
+        for (const [name, text] of Object.entries(overrides)) {
+            if (!VOCAB_KEYS.includes(name))
+                fail(m, 'headings', m.reasonUnknownHeading(name));
+            if (typeof text !== 'string')
+                fail(m, `headings.${name}`, m.reasonString);
+            headings[name] = text;
+        }
+    }
+    let exclude = ['templates/'];
+    if (raw.exclude !== undefined) {
+        const value = raw.exclude;
+        if (!Array.isArray(value) || !value.every((item) => typeof item === 'string')) {
+            fail(m, 'exclude', m.reasonStringArray);
+        }
+        exclude = value.map((entry) => normExclude(m, entry));
+    }
+    const codeRoot = optString(m, raw, 'codeRoot', '.');
+    const rawDir = normRel(optString(m, raw, 'rawDir', 'docs/raw'));
+    if (rawDir === '.')
+        fail(m, 'rawDir', m.reasonDot);
+    if (isOutsideRoot(rawDir))
+        fail(m, 'rawDir', m.reasonInsideRoot);
+    if (rawDir === specDir || rawDir.startsWith(`${specDir}/`))
+        fail(m, 'rawDir', m.reasonInsideSpec);
+    return {
+        version: 1,
+        specDir,
+        index,
+        overview,
+        log,
+        lang,
+        headings,
+        exclude,
+        codeRoot,
+        rawDir,
+    };
+}
+// fallback은 설정 내용이 lang으로 언어를 정하지 못할 때 쓰는 언어다(--lang 값 또는 en).
+export function parseConfig(text, fallback = 'en') {
+    let raw;
+    try {
+        raw = JSON.parse(text);
+    }
+    catch (error) {
+        throw new ConfigError(`crumbs.json: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    return validate(raw, fallback);
+}
+// missingLabel은 파일이 없을 때 메시지 앞에 붙는 위치 표시다(기본 설정이면 저장소 루트).
+export function loadConfig(configPath, missingLabel, fallback = 'en') {
+    if (!existsSync(configPath)) {
+        throw new ConfigError(MESSAGES[fallback].fileMissing(missingLabel));
+    }
+    return parseConfig(readFileSync(configPath, 'utf8'), fallback);
+}
+// 저장소 설정을 읽는다. configPath가 없으면 저장소 루트의 crumbs.json이다(check와 log add가 함께 쓴다).
+export function loadRepoConfig(root, configPath, fallback = 'en') {
+    return configPath === undefined
+        ? loadConfig(join(root, 'crumbs.json'), root, fallback)
+        : loadConfig(resolve(configPath), resolve(configPath), fallback);
+}
+//# sourceMappingURL=config.js.map

package/dist/src/config.js.map

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

package/dist/src/dates.js

@@ -0,0 +1,22 @@
+// 날짜 계산. init과 log add가 함께 쓴다.
+// 로컬 시간대 기준 YYYY-MM-DD.
+export function localDate(now = new Date()) {
+    const pad = (n) => String(n).padStart(2, '0');
+    return `${now.getFullYear()}-${pad(now.getMonth() + 1)}-${pad(now.getDate())}`;
+}
+// YYYY-MM-DD 날짜에서 days일 뒤의 YYYY-MM-DD를 구한다. 시간대와 무관하게 UTC 달력으로 계산한다.
+export function addDays(date, days) {
+    const [year, month, day] = date.split('-').map(Number);
+    const next = new Date(Date.UTC(year, month - 1, day + days));
+    const pad = (n) => String(n).padStart(2, '0');
+    return `${next.getUTCFullYear()}-${pad(next.getUTCMonth() + 1)}-${pad(next.getUTCDate())}`;
+}
+// 윤년을 포함한 실제 달력 날짜인지 본다. Date 객체를 쓰지 않는다(두 자리 연도 보정 같은 함정을 피한다).
+export function isCalendarDate(year, month, day) {
+    if (month < 1 || month > 12 || day < 1)
+        return false;
+    const leap = (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;
+    const daysInMonth = [31, leap ? 29 : 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31][month - 1];
+    return day <= daysInMonth;
+}
+//# sourceMappingURL=dates.js.map

package/dist/src/dates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates.js","sourceRoot":"","sources":["../../src/dates.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAE/B,wBAAwB;AACxB,MAAM,UAAU,SAAS,CAAC,MAAY,IAAI,IAAI,EAAE;IAC9C,MAAM,GAAG,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC9D,OAAO,GAAG,GAAG,CAAC,WAAW,EAAE,IAAI,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;AACjF,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,IAAY;IAChD,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC;IAC7D,MAAM,GAAG,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC9D,OAAO,GAAG,IAAI,CAAC,cAAc,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;AAC7F,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,KAAa,EAAE,GAAW;IACrE,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,EAAE,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACrD,MAAM,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,GAAG,GAAG,KAAK,CAAC,CAAC,IAAI,IAAI,GAAG,GAAG,KAAK,CAAC,CAAC;IACtE,MAAM,WAAW,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAC5F,OAAO,GAAG,IAAI,WAAW,CAAC;AAC5B,CAAC"}

package/dist/src/graph.js

@@ -0,0 +1,241 @@
+import { readdirSync, readFileSync, realpathSync, statSync } from 'node:fs';
+import { basename, dirname, join, relative, resolve, sep } from 'node:path';
+import { VOCAB } from './headings.js';
+import { buildSections, classifyTarget, evidenceCandidates, normTitle, scanMarkdown, } from './markdown.js';
+export function vocabOf(config) {
+    return { ...VOCAB[config.lang], ...config.headings };
+}
+export function relPath(root, abs) {
+    return relative(root, abs).split(sep).join('/');
+}
+export function isFile(path) {
+    try {
+        return statSync(path).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+export function pathExists(path) {
+    try {
+        statSync(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function isMissingDir(error) {
+    const code = typeof error === 'object' && error !== null && 'code' in error ? error.code : undefined;
+    return code === 'ENOENT' || code === 'ENOTDIR';
+}
+function realpathOf(path) {
+    try {
+        return realpathSync.native(path);
+    }
+    catch {
+        return undefined;
+    }
+}
+// specDir 아래 .md 파일을 찾는다. node_modules와 점으로 시작하는 디렉터리는 들어가지 않는다.
+// 심볼릭 링크는 가리키는 대상의 종류로 판정한다. 실제 경로 기준으로 이미 방문한 디렉터리는 다시 들어가지 않아 순환을 끊는다.
+function listSpecFiles(dirAbs, relDir, out, visited = new Set()) {
+    let entries;
+    try {
+        entries = readdirSync(dirAbs, { withFileTypes: true });
+    }
+    catch (error) {
+        if (isMissingDir(error))
+            return;
+        throw error;
+    }
+    const real = realpathOf(dirAbs);
+    if (real === undefined || visited.has(real))
+        return;
+    visited.add(real);
+    entries.sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+    for (const entry of entries) {
+        const rel = relDir === '' ? entry.name : `${relDir}/${entry.name}`;
+        let kind;
+        if (entry.isSymbolicLink()) {
+            try {
+                const target = statSync(join(dirAbs, entry.name));
+                kind = target.isDirectory() ? 'dir' : target.isFile() ? 'file' : undefined;
+            }
+            catch {
+                kind = undefined;
+            }
+        }
+        else if (entry.isDirectory()) {
+            kind = 'dir';
+        }
+        else if (entry.isFile()) {
+            kind = 'file';
+        }
+        if (kind === 'dir') {
+            if (entry.name === 'node_modules' || entry.name.startsWith('.'))
+                continue;
+            listSpecFiles(join(dirAbs, entry.name), rel, out, visited);
+        }
+        else if (kind === 'file' && entry.name.toLowerCase().endsWith('.md')) {
+            out.push(rel);
+        }
+    }
+}
+// exclude 항목은 스펙 루트 기준 경로다. "/"로 끝나면 디렉터리 전체를, 아니면 파일 또는 디렉터리 하나를 가리킨다.
+function isExcluded(rel, exclude) {
+    return exclude.some((entry) => entry.endsWith('/') ? rel.startsWith(entry) : rel === entry || rel.startsWith(`${entry}/`));
+}
+// start 자신(포함 여부는 호출자가 정함)에서 위로 올라가며 specAbs까지의 디렉터리를 가까운 순서로 준다.
+function dirsUpTo(start, specAbs) {
+    const out = [];
+    let current = start;
+    while (current === specAbs || current.startsWith(specAbs + sep)) {
+        out.push(current);
+        if (current === specAbs)
+            break;
+        current = dirname(current);
+    }
+    return out;
+}
+export function buildGraph(root, config) {
+    const specAbs = resolve(root, config.specDir);
+    const indexAbs = join(specAbs, config.index);
+    const logAbs = join(specAbs, config.log);
+    const codeRootAbs = resolve(root, config.codeRoot);
+    const vocab = vocabOf(config);
+    const roleOf = (abs) => {
+        if (abs === indexAbs)
+            return 'index';
+        if (abs === logAbs)
+            return 'log';
+        if (basename(abs) === config.overview)
+            return 'overview';
+        return 'detail';
+    };
+    const relFiles = [];
+    listSpecFiles(specAbs, '', relFiles);
+    const docs = [];
+    for (const rel of relFiles) {
+        if (isExcluded(rel, config.exclude))
+            continue;
+        const abs = join(specAbs, rel);
+        const scan = scanMarkdown(readFileSync(abs, 'utf8'));
+        const sections = buildSections(scan, vocab);
+        // 미확정 정책 마커는 확인 필요 사항 절에 적힌 것을 센다. 그 절에 마커가 없으면 문서 전체의 마커를 센다.
+        const questions = sections.find((section) => section.key === 'questions');
+        const markersInQuestions = questions
+            ? scan.markerLines.filter((line) => line >= questions.startLine && line <= questions.endLine)
+            : [];
+        const markers = markersInQuestions.length > 0 ? markersInQuestions : scan.markerLines;
+        const links = scan.links.map((link) => {
+            const target = classifyTarget(link.rawTarget, abs, root);
+            if (target.kind === 'external') {
+                return { line: link.line, text: link.text, rawTarget: link.rawTarget, kind: 'external' };
+            }
+            return {
+                line: link.line,
+                text: link.text,
+                rawTarget: link.rawTarget,
+                kind: 'internal',
+                path: target.path,
+                fragment: target.fragment,
+            };
+        });
+        const evidencePaths = evidenceCandidates(scan, sections).map((candidate) => ({
+            line: candidate.line,
+            raw: candidate.raw,
+            resolved: resolve(codeRootAbs, candidate.path),
+        }));
+        const policies = sections
+            .filter((section) => section.key === 'policies')
+            .flatMap((section) => section.children
+            .filter((child) => child.level === 3)
+            .map((heading) => ({ heading, normalized: normTitle(heading.text) })));
+        // 흐름 신호는 현재 동작과 흐름 절 안의 줄만 센다(절이 없으면 0).
+        const inRange = (line, s) => s !== undefined && line >= s.startLine && line <= s.endLine;
+        const behavior = sections.find((section) => section.key === 'behavior');
+        const flow = sections.find((section) => section.key === 'flow');
+        const behaviorBullets = scan.bulletLines.filter((line) => inRange(line, behavior)).length;
+        const mermaidFences = scan.mermaidFenceLines.filter((line) => inRange(line, behavior) || inRange(line, flow)).length;
+        const tableRows = scan.tableRuleLines.filter((line) => inRange(line, behavior) || inRange(line, flow)).length;
+        docs.push({
+            file: relPath(root, abs),
+            abs,
+            role: roleOf(abs),
+            title: scan.headings[0]?.level === 1 ? scan.headings[0] : undefined,
+            headings: scan.headings,
+            sections,
+            links,
+            evidencePaths,
+            policies,
+            markerCount: markers.length,
+            firstMarkerLine: markers[0],
+            flow: { mermaidFences, tableRows, behaviorBullets },
+            unterminatedComment: scan.unterminatedComment,
+        });
+    }
+    docs.sort((a, b) => (a.file < b.file ? -1 : a.file > b.file ? 1 : 0));
+    const byAbs = new Map(docs.map((doc) => [doc.abs, doc]));
+    const index = byAbs.get(indexAbs);
+    // 링크 대상이 문서 목록에 없지만 디스크에 파일로 있으면, 실제 경로가 문서와 같은지 본다.
+    // 같으면 철자가 다른 것(대소문자 차이 등)이므로 링크를 실제 문서로 돌리고 철자 차이를 기록한다.
+    const byReal = new Map();
+    for (const doc of docs) {
+        const real = realpathOf(doc.abs);
+        if (real !== undefined)
+            byReal.set(real, doc);
+    }
+    for (const doc of docs) {
+        for (const link of doc.links) {
+            if (link.kind !== 'internal' || link.path === undefined || byAbs.has(link.path) || !isFile(link.path))
+                continue;
+            const real = realpathOf(link.path);
+            const actual = real === undefined ? undefined : byReal.get(real);
+            if (actual === undefined)
+                continue;
+            link.spellingMismatch = actual.file;
+            link.path = actual.abs;
+        }
+    }
+    // 개요 디렉터리 → 개요 문서. 상세 문서와 개요는 가까운 개요를 부모로 삼고, 없으면 인덱스가 부모다.
+    const overviewByDir = new Map();
+    for (const doc of docs) {
+        if (doc.role === 'overview')
+            overviewByDir.set(dirname(doc.abs), doc);
+    }
+    for (const doc of docs) {
+        if (doc.role === 'index' || doc.role === 'log')
+            continue;
+        const dir = dirname(doc.abs);
+        const start = doc.role === 'overview' ? dirname(dir) : dir;
+        let parent;
+        for (const candidate of dirsUpTo(start, specAbs)) {
+            const overview = overviewByDir.get(candidate);
+            if (overview) {
+                parent = overview;
+                break;
+            }
+        }
+        doc.parent = parent ?? index;
+    }
+    return { root, config, lang: config.lang, vocab, specAbs, indexAbs, logAbs, docs, byAbs, index, slugCache: new Map() };
+}
+// 문서 또는 임의의 .md 파일의 제목 슬러그 집합. 그래프 밖 파일은 한 번만 읽는다.
+export function slugsOf(graph, abs) {
+    const known = graph.byAbs.get(abs);
+    if (known)
+        return new Set(known.headings.map((heading) => heading.slug));
+    if (!graph.slugCache.has(abs)) {
+        let slugs;
+        try {
+            slugs = new Set(scanMarkdown(readFileSync(abs, 'utf8')).headings.map((heading) => heading.slug));
+        }
+        catch {
+            slugs = undefined;
+        }
+        graph.slugCache.set(abs, slugs);
+    }
+    return graph.slugCache.get(abs);
+}
+//# sourceMappingURL=graph.js.map