isthmus-cli 0.5.0 → 0.7.0

package/dist/cli/doctor-command.js

@@ -0,0 +1,128 @@
+import { isAbsolute, join, resolve } from 'node:path';
+import { CaptureConfigValidationError, validateCaptureConfig } from "../exchange/capture-config.js";
+import { isJsonObject, isSafeNonEmptyString } from "../exchange/parse.js";
+import { encodeSortedJson } from "../report/sorted-json.js";
+import { inputFailure, isJsonParseFailure, MAX_INPUT_TEXT_LENGTH, } from "./command-support.js";
+/**
+ * capture 설정 JSON을 검증하고 참조한 실행 파일이 실제로 있는지 확인한다.
+ *
+ * producer를 실행하거나 버전을 묻지 않는다 — 제품은 JSON만 읽는다. 여기서
+ * 확인하는 것은 `scripts/capture-preflight.mjs`가 실행할 명령의 첫 토큰이
+ * 존재하는 파일(또는 PATH 위의 실행 파일)인지뿐이다.
+ */
+export async function runDoctorCommand(arguments_, readTextFile, fileSystem, cwd, pathValue = '') {
+    if (arguments_[0] !== 'doctor')
+        return usageError();
+    const rest = arguments_.slice(1);
+    if (rest.length !== 1 || rest[0].startsWith('--'))
+        return usageError();
+    const configPath = rest[0];
+    let text;
+    try {
+        text = await readTextFile(configPath);
+    }
+    catch {
+        return inputFailure('Unable to read the capture config; check that the file exists and is readable.\n');
+    }
+    if (text.length > MAX_INPUT_TEXT_LENGTH) {
+        return inputFailure('The capture config exceeds the input size limits.\n');
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch (error) {
+        if (isJsonParseFailure(error)) {
+            return inputFailure('The capture config is not valid JSON; regenerate it with isthmus init.\n');
+        }
+        throw error;
+    }
+    if (!isJsonObject(parsed) || !isSafeNonEmptyString(parsed.project)) {
+        return inputFailure('The capture config must be a JSON object with a project path.\n');
+    }
+    let project;
+    try {
+        project = await fileSystem.realPath(parsed.project);
+    }
+    catch {
+        return inputFailure('The capture config project path does not exist; point it at the app root.\n');
+    }
+    try {
+        validateCaptureConfig(parsed, project);
+    }
+    catch (error) {
+        if (error instanceof CaptureConfigValidationError) {
+            return inputFailure(`The capture config violates the workflow contract: ${error.message}\n`);
+        }
+        throw error;
+    }
+    const pathEntries = pathValue.split(':').filter((entry) => entry.length > 0);
+    const checks = [];
+    const names = [
+        ...producerNames(parsed),
+        ...objectCommands(parsed.messages, parsed),
+        ...objectCommands(parsed.events, parsed),
+        ...parsed.prepare.map((command, index) => ({
+            name: `prepare-${index + 1}`,
+            command,
+        })),
+    ];
+    for (const { name, command } of names) {
+        const resolved = await resolveExecutable(command[0], project, fileSystem, pathEntries);
+        checks.push({
+            name,
+            status: resolved === undefined ? 'missing' : 'ok',
+            command,
+            ...(resolved === undefined ? {} : { resolved }),
+        });
+    }
+    const report = {
+        format: 'isthmus-doctor',
+        version: 1,
+        status: checks.every(({ status }) => status === 'ok') ? 'ok' : 'incomplete',
+        project,
+        checks,
+    };
+    return {
+        standardOutput: encodeSortedJson(report),
+        standardError: '',
+        exitCode: report.status === 'ok' ? 0 : 1,
+    };
+}
+/** 설정에 선언된 기본 producer 명령과 이름을 순서대로 모은다. */
+function producerNames(config) {
+    return [
+        { name: 'dartograph', command: config.dartograph },
+        ...['cartograph', 'kartograph']
+            .filter((name) => config[name] !== undefined)
+            .map((name) => ({ name, command: config[name] })),
+    ];
+}
+/** messages·events의 사용자 지정 명령만 검사한다. `true`는 기본 명령 재사용이다. */
+function objectCommands(value, config) {
+    if (value === undefined || value === true || !isJsonObject(value))
+        return [];
+    return Object.entries(value)
+        .filter(([name, command]) => config[name] !== undefined && Array.isArray(command))
+        .map(([name, command]) => ({ name, command: command }));
+}
+/** 첫 토큰이 존재하는 파일이거나 PATH 위의 실행 파일인지 확인한다. */
+async function resolveExecutable(token, project, fileSystem, pathEntries) {
+    if (token.includes('/') || token.includes('\\')) {
+        const candidate = isAbsolute(token) ? token : resolve(project, token);
+        return (await fileSystem.statPath(candidate)) === 'file' ? candidate : undefined;
+    }
+    for (const entry of pathEntries) {
+        const candidate = join(entry, token);
+        if ((await fileSystem.statPath(candidate)) === 'file')
+            return candidate;
+    }
+    return undefined;
+}
+/** 잘못된 CLI 호출을 경로 없는 사용법과 코드 64로 바꾼다. */
+function usageError() {
+    return { standardOutput: '', standardError: `${doctorUsage}\n`, exitCode: 64 };
+}
+/** doctor 명령의 한 줄 사용법이다. */
+export const doctorUsage = 'Usage: isthmus doctor <capture.json>';
+//# sourceMappingURL=doctor-command.js.map

package/dist/cli/doctor-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-command.js","sourceRoot":"","sources":["../../src/cli/doctor-command.ts"],"names":[],"mappings":"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","sourcesContent":["import { isAbsolute, join, resolve } from 'node:path';\n\nimport { CaptureConfigValidationError, validateCaptureConfig } from '../exchange/capture-config.ts';\nimport { isJsonObject, isSafeNonEmptyString } from '../exchange/parse.ts';\nimport { encodeSortedJson } from '../report/sorted-json.ts';\nimport {\n  inputFailure,\n  isJsonParseFailure,\n  MAX_INPUT_TEXT_LENGTH,\n  type CaptureFileSystem,\n  type CommandResult,\n  type ReadTextFile,\n} from './command-support.ts';\n\n/** doctor가 확인한 명령 하나의 결과다. */\ninterface DoctorCheck {\n  readonly name: string;\n  readonly status: 'ok' | 'missing';\n  readonly command: readonly string[];\n  readonly resolved?: string;\n}\n\n/** doctor가 내는 기계 판독 보고서다. */\ninterface DoctorReport {\n  readonly format: 'isthmus-doctor';\n  readonly version: 1;\n  readonly status: 'ok' | 'incomplete';\n  readonly project: string;\n  readonly checks: readonly DoctorCheck[];\n}\n\n/**\n * capture 설정 JSON을 검증하고 참조한 실행 파일이 실제로 있는지 확인한다.\n *\n * producer를 실행하거나 버전을 묻지 않는다 — 제품은 JSON만 읽는다. 여기서\n * 확인하는 것은 `scripts/capture-preflight.mjs`가 실행할 명령의 첫 토큰이\n * 존재하는 파일(또는 PATH 위의 실행 파일)인지뿐이다.\n */\nexport async function runDoctorCommand(\n  arguments_: readonly string[],\n  readTextFile: ReadTextFile,\n  fileSystem: CaptureFileSystem,\n  cwd: string,\n  pathValue: string = '',\n): Promise<CommandResult> {\n  if (arguments_[0] !== 'doctor') return usageError();\n  const rest = arguments_.slice(1);\n  if (rest.length !== 1 || rest[0]!.startsWith('--')) return usageError();\n  const configPath = rest[0]!;\n\n  let text: string;\n  try {\n    text = await readTextFile(configPath);\n  } catch {\n    return inputFailure(\n      'Unable to read the capture config; check that the file exists and is readable.\\n',\n    );\n  }\n  if (text.length > MAX_INPUT_TEXT_LENGTH) {\n    return inputFailure('The capture config exceeds the input size limits.\\n');\n  }\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(text);\n  } catch (error) {\n    if (isJsonParseFailure(error)) {\n      return inputFailure(\n        'The capture config is not valid JSON; regenerate it with isthmus init.\\n',\n      );\n    }\n    throw error;\n  }\n  if (!isJsonObject(parsed) || !isSafeNonEmptyString(parsed.project)) {\n    return inputFailure('The capture config must be a JSON object with a project path.\\n');\n  }\n  let project: string;\n  try {\n    project = await fileSystem.realPath(parsed.project);\n  } catch {\n    return inputFailure(\n      'The capture config project path does not exist; point it at the app root.\\n',\n    );\n  }\n  try {\n    validateCaptureConfig(parsed, project);\n  } catch (error) {\n    if (error instanceof CaptureConfigValidationError) {\n      return inputFailure(`The capture config violates the workflow contract: ${error.message}\\n`);\n    }\n    throw error;\n  }\n\n  const pathEntries = pathValue.split(':').filter((entry) => entry.length > 0);\n  const checks: DoctorCheck[] = [];\n  const names = [\n    ...producerNames(parsed),\n    ...objectCommands(parsed.messages, parsed),\n    ...objectCommands(parsed.events, parsed),\n    ...(parsed.prepare as readonly (readonly string[])[]).map((command, index) => ({\n      name: `prepare-${index + 1}`,\n      command,\n    })),\n  ];\n  for (const { name, command } of names) {\n    const resolved = await resolveExecutable(command[0]!, project, fileSystem, pathEntries);\n    checks.push({\n      name,\n      status: resolved === undefined ? 'missing' : 'ok',\n      command,\n      ...(resolved === undefined ? {} : { resolved }),\n    });\n  }\n  const report: DoctorReport = {\n    format: 'isthmus-doctor',\n    version: 1,\n    status: checks.every(({ status }) => status === 'ok') ? 'ok' : 'incomplete',\n    project,\n    checks,\n  };\n  return {\n    standardOutput: encodeSortedJson(report),\n    standardError: '',\n    exitCode: report.status === 'ok' ? 0 : 1,\n  };\n}\n\n/** 설정에 선언된 기본 producer 명령과 이름을 순서대로 모은다. */\nfunction producerNames(\n  config: Record<string, unknown>,\n): ReadonlyArray<{ name: string; command: readonly string[] }> {\n  return [\n    { name: 'dartograph', command: config.dartograph as readonly string[] },\n    ...(['cartograph', 'kartograph'] as const)\n      .filter((name) => config[name] !== undefined)\n      .map((name) => ({ name, command: config[name] as readonly string[] })),\n  ];\n}\n\n/** messages·events의 사용자 지정 명령만 검사한다. `true`는 기본 명령 재사용이다. */\nfunction objectCommands(\n  value: unknown,\n  config: Record<string, unknown>,\n): ReadonlyArray<{ name: string; command: readonly string[] }> {\n  if (value === undefined || value === true || !isJsonObject(value)) return [];\n  return Object.entries(value)\n    .filter(([name, command]) => config[name] !== undefined && Array.isArray(command))\n    .map(([name, command]) => ({ name, command: command as readonly string[] }));\n}\n\n/** 첫 토큰이 존재하는 파일이거나 PATH 위의 실행 파일인지 확인한다. */\nasync function resolveExecutable(\n  token: string,\n  project: string,\n  fileSystem: CaptureFileSystem,\n  pathEntries: readonly string[],\n): Promise<string | undefined> {\n  if (token.includes('/') || token.includes('\\\\')) {\n    const candidate = isAbsolute(token) ? token : resolve(project, token);\n    return (await fileSystem.statPath(candidate)) === 'file' ? candidate : undefined;\n  }\n  for (const entry of pathEntries) {\n    const candidate = join(entry, token);\n    if ((await fileSystem.statPath(candidate)) === 'file') return candidate;\n  }\n  return undefined;\n}\n\n/** 잘못된 CLI 호출을 경로 없는 사용법과 코드 64로 바꾼다. */\nfunction usageError(): CommandResult {\n  return { standardOutput: '', standardError: `${doctorUsage}\\n`, exitCode: 64 };\n}\n\n/** doctor 명령의 한 줄 사용법이다. */\nexport const doctorUsage =\n  'Usage: isthmus doctor <capture.json>';"]}

package/dist/cli/extract-js-command.d.ts

@@ -0,0 +1,33 @@
+/**
+ * `isthmus extract-js` — React Native 호출 측 bridge-facts 생산자다.
+ *
+ * JS/TS 파일(또는 그 파일을 담은 디렉터리)을 토큰 스캔해 정적 모듈·컴포넌트
+ * 이름과 바인딩 해석이 끝난 메서드 호출을 bridge-facts v1 문서로 낸다.
+ * 해석이 멈춘 곳은 limitations로만 보고한다 — 문서를 거짓으로 완전하게
+ * 만들지 않는다.
+ */
+import { type Clock, type CommandResult, type ReadTextFile } from './command-support.ts';
+/** 디렉터리 항목 — 워커가 경로 종류를 다시 질의하지 않게 타입을 함께 준다. */
+export interface JsDirectoryEntry {
+    readonly name: string;
+    readonly isFile: boolean;
+    readonly isDirectory: boolean;
+}
+/** extract-js가 필요로 하는 최소 파일시스템 표면이다. */
+export interface ExtractJsFileSystem {
+    /** 경로 종류를 돌려준다 — 없으면 'missing'. */
+    readonly statPath: (path: string) => Promise<'file' | 'directory' | 'missing'>;
+    /** 디렉터리의 바로 아래 항목들을 나열한다. */
+    readonly listDirectory: (path: string) => Promise<readonly JsDirectoryEntry[]>;
+    /** 심볼릭 링크·`..`를 풀어 절대 경로로 만든다. */
+    readonly realPath: (path: string) => Promise<string>;
+}
+/**
+ * extract-js 인자를 실행해 프로세스에 독립적인 결과를 반환한다.
+ *
+ * 성공 시 정렬된 bridge-facts JSON을 stdout에 쓴다. 입력 실패는 원인 종류와
+ * 해결 방향을 담은 코드 2, 잘못된 호출은 사용법과 코드 64다.
+ */
+export declare function runExtractJsCommand(arguments_: readonly string[], fileSystem: ExtractJsFileSystem, readSource: ReadTextFile, now?: Clock, version?: string): Promise<CommandResult>;
+/** extract-js 명령의 한 줄 사용법이다. */
+export declare const extractJsUsage = "Usage: isthmus extract-js <file-or-dir> [more...] [--project <dir>]";

package/dist/cli/extract-js-command.js

@@ -0,0 +1,233 @@
+/**
+ * `isthmus extract-js` — React Native 호출 측 bridge-facts 생산자다.
+ *
+ * JS/TS 파일(또는 그 파일을 담은 디렉터리)을 토큰 스캔해 정적 모듈·컴포넌트
+ * 이름과 바인딩 해석이 끝난 메서드 호출을 bridge-facts v1 문서로 낸다.
+ * 해석이 멈춘 곳은 limitations로만 보고한다 — 문서를 거짓으로 완전하게
+ * 만들지 않는다.
+ */
+import { sep } from 'node:path';
+import { createJsFactsDocument, JS_SOURCE_EXTENSIONS, } from "../extract/js-document.js";
+import { encodeSortedJson } from "../report/sorted-json.js";
+import { inputFailure, MAX_INPUT_TEXT_LENGTH, MAX_TOTAL_INPUT_TEXT_LENGTH, } from "./command-support.js";
+import { parseCommandArguments } from "./parse-arguments.js";
+/** 스캔 대상 확장자 집합이다. */
+const jsExtensions = new Set(JS_SOURCE_EXTENSIONS);
+/** 워크에서 건너뛸 디렉터리다 — 종속성·빌드 산출물·VCS 내부다. */
+const SKIPPED_DIRECTORIES = new Set([
+    'node_modules', 'dist', 'build', 'coverage', 'out',
+    '.git', '.svn', '.hg', '.expo', '.next', '.turbo',
+]);
+/** 한 번의 호출이 받을 수 있는 입력 경로 수 상한이다. */
+const MAX_INPUT_PATHS = 256;
+/** 스캔 대상 파일 수 상한이다. */
+const MAX_SCANNED_FILES = 10_000;
+/**
+ * extract-js 인자를 실행해 프로세스에 독립적인 결과를 반환한다.
+ *
+ * 성공 시 정렬된 bridge-facts JSON을 stdout에 쓴다. 입력 실패는 원인 종류와
+ * 해결 방향을 담은 코드 2, 잘못된 호출은 사용법과 코드 64다.
+ */
+export async function runExtractJsCommand(arguments_, fileSystem, readSource, now = () => new Date(), version) {
+    if (arguments_[0] !== 'extract-js')
+        return usageError();
+    const options = parseCommandArguments(arguments_.slice(1), ['--project'], []);
+    if (options === undefined)
+        return usageError();
+    const { positionals, valueFlags } = options;
+    if (positionals.length === 0 || positionals.length > MAX_INPUT_PATHS) {
+        return usageError();
+    }
+    const roots = await Promise.all(positionals.map((input) => safeRealPath(fileSystem, input)));
+    const missingIndex = roots.findIndex((path) => path === undefined);
+    if (missingIndex !== -1) {
+        return inputFailure(`Unable to read extract-js input ${missingIndex + 1}; `
+            + 'check that the file or directory exists and is readable.\n');
+    }
+    const projectFlag = valueFlags.get('--project');
+    let projectRoot;
+    if (projectFlag !== undefined) {
+        const root = await safeRealPath(fileSystem, projectFlag);
+        if (root === undefined || await fileSystem.statPath(root) !== 'directory') {
+            return inputFailure('extract-js --project does not name a readable directory; '
+                + 'pass the project root that contains the inputs.\n');
+        }
+        projectRoot = normalizeSeparators(root);
+    }
+    else {
+        projectRoot = await commonAncestor(roots, fileSystem);
+    }
+    const discovered = [];
+    for (const [index, absolute] of roots.entries()) {
+        const kind = await fileSystem.statPath(absolute);
+        if (kind === 'missing') {
+            return inputFailure(`Unable to read extract-js input ${index + 1}; `
+                + 'check that the file or directory exists and is readable.\n');
+        }
+        let candidates;
+        try {
+            candidates = kind === 'directory'
+                ? await walkDirectory(fileSystem, absolute, MAX_SCANNED_FILES - discovered.length)
+                : [absolute];
+        }
+        catch {
+            return inputFailure(`Unable to list extract-js input ${index + 1}; `
+                + 'check that the directory is readable.\n');
+        }
+        for (const candidate of candidates) {
+            if (!isJsSource(candidate)) {
+                if (kind === 'file') {
+                    return inputFailure(`extract-js input ${index + 1} is not a JS/TS source file; `
+                        + 'pass .js/.ts/.jsx/.tsx sources or a directory containing them.\n');
+                }
+                continue;
+            }
+            const relative = relativize(candidate, projectRoot);
+            if (relative === undefined || relative === '') {
+                return inputFailure(`extract-js input ${index + 1} escapes the project root; `
+                    + 'pass --project that contains every input.\n');
+            }
+            discovered.push({ path: relative, text: '' });
+            if (discovered.length > MAX_SCANNED_FILES) {
+                return inputFailure(`extract-js input set exceeds ${MAX_SCANNED_FILES} files; `
+                    + 'narrow the scanned directories.\n');
+            }
+        }
+    }
+    // 같은 파일이 여러 입력에서 발견돼도 한 번만 스캔한다.
+    const ordered = [...new Map(discovered.map((f) => [f.path, f])).values()]
+        .sort((left, right) => left.path.localeCompare(right.path));
+    let totalLength = 0;
+    for (const file of ordered) {
+        let text;
+        try {
+            text = await readSource(`${projectRoot}/${file.path}`);
+        }
+        catch {
+            return inputFailure(`Unable to read extract-js source ${file.path}; `
+                + 'check that the file exists and is readable.\n');
+        }
+        totalLength += text.length;
+        if (text.length > MAX_INPUT_TEXT_LENGTH ||
+            totalLength > MAX_TOTAL_INPUT_TEXT_LENGTH) {
+            return inputFailure('extract-js input set exceeds the source size limits; '
+                + 'narrow the scanned directories.\n');
+        }
+        file.text = text;
+    }
+    if (version === undefined) {
+        return {
+            standardOutput: '',
+            standardError: 'Unable to read package metadata.\n',
+            exitCode: 2,
+        };
+    }
+    const document = createJsFactsDocument(ordered, version, now().toISOString(), projectRoot);
+    return { standardOutput: encodeSortedJson(document), standardError: '', exitCode: 0 };
+}
+/**
+ * 디렉터리 아래 JS/TS 파일을 재귀로 모은다. 실패는 빈 목록이 아니라 던진다.
+ *
+ * `budget`은 아직 받을 수 있는 파일 수다 — 거대한 트리 전체를 열거한 뒤에야
+ * 상한 오류를 내지 않도록 예산을 넘으면 즉시 멈추고 호출자가 상한을 보고한다.
+ */
+async function walkDirectory(fileSystem, directory, budget) {
+    const found = [];
+    const pending = [directory];
+    while (pending.length > 0 && found.length <= budget) {
+        const current = pending.pop();
+        let entries;
+        try {
+            entries = await fileSystem.listDirectory(current);
+        }
+        catch (error) {
+            throw new Error(`listDirectory failed: ${current}`, { cause: error });
+        }
+        for (const entry of [...entries]
+            .sort((left, right) => left.name.localeCompare(right.name))) {
+            const child = `${current}/${entry.name}`;
+            if (entry.isDirectory) {
+                if (SKIPPED_DIRECTORIES.has(entry.name) || entry.name.startsWith('.')) {
+                    continue;
+                }
+                pending.push(child);
+            }
+            else if (entry.isFile && isJsSource(entry.name)) {
+                found.push(child);
+            }
+        }
+    }
+    return found;
+}
+/**
+ * `--project` 없이 입력들의 공통 조상 디렉터리를 찾는다.
+ *
+ * 파일 입력은 디렉터리로 접고, 모든 입력을 포함하는 가장 깊은 공통
+ * 디렉터리를 고른다. 프로젝트 밖 경로가 facts의 상대 경로를 깨지 않게 한다.
+ */
+async function commonAncestor(absolutePaths, fileSystem) {
+    const roots = [];
+    for (const absolute of absolutePaths) {
+        const normalized = normalizeSeparators(absolute);
+        const isFile = await fileSystem.statPath(absolute) === 'file';
+        roots.push(isFile ? normalized.slice(0, normalized.lastIndexOf('/')) : normalized);
+    }
+    let common = roots[0] ?? '/';
+    for (const candidate of roots.slice(1)) {
+        while (candidate !== common && !candidate.startsWith(`${common}/`)) {
+            const parent = common.slice(0, common.lastIndexOf('/'));
+            if (parent === '' || parent === common) {
+                common = '/';
+                break;
+            }
+            common = parent;
+        }
+    }
+    return common;
+}
+/** 절대 경로를 프로젝트 상대 POSIX 경로로 바꾼다. 루트 밖이면 undefined다. */
+function relativize(absolute, projectRoot) {
+    const normalized = normalizeSeparators(absolute);
+    const root = normalizeSeparators(projectRoot);
+    if (root === '/')
+        return normalized.replace(/^\/+/, '');
+    if (normalized === root)
+        return '';
+    if (!normalized.startsWith(`${root}/`))
+        return undefined;
+    return normalized.slice(root.length + 1);
+}
+/** 스캔 대상 확장자 여부다. */
+function isJsSource(path) {
+    const dot = path.lastIndexOf('.');
+    return dot !== -1 && jsExtensions.has(path.slice(dot + 1));
+}
+/**
+ * OS 경로 구분자를 계약이 요구하는 `/`로 통일한다.
+ *
+ * `\`는 POSIX에서 유효한 파일명 문자이므로 구분자가 `\`인 플랫폼에서만
+ * 바꾼다 — 무조건 치환하면 `a\b.ts` 같은 합법 파일명이 깨진다.
+ */
+function normalizeSeparators(path) {
+    return sep === '\\' ? path.replace(/\\/g, '/') : path;
+}
+/** realpath가 던지는 입력을 경로 없는 undefined로 정규화한다. */
+async function safeRealPath(fileSystem, path) {
+    try {
+        return await fileSystem.realPath(path);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** 잘못된 CLI 호출을 경로 없는 사용법과 코드 64로 바꾼다. */
+function usageError() {
+    return {
+        standardOutput: '',
+        standardError: `${extractJsUsage}\n`,
+        exitCode: 64,
+    };
+}
+/** extract-js 명령의 한 줄 사용법이다. */
+export const extractJsUsage = 'Usage: isthmus extract-js <file-or-dir> [more...] [--project <dir>]';
+//# sourceMappingURL=extract-js-command.js.map

package/dist/cli/extract-js-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-js-command.js","sourceRoot":"","sources":["../../src/cli/extract-js-command.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `isthmus extract-js` — React Native 호출 측 bridge-facts 생산자다.\n *\n * JS/TS 파일(또는 그 파일을 담은 디렉터리)을 토큰 스캔해 정적 모듈·컴포넌트\n * 이름과 바인딩 해석이 끝난 메서드 호출을 bridge-facts v1 문서로 낸다.\n * 해석이 멈춘 곳은 limitations로만 보고한다 — 문서를 거짓으로 완전하게\n * 만들지 않는다.\n */\n\nimport { sep } from 'node:path';\nimport {\n  createJsFactsDocument,\n  JS_SOURCE_EXTENSIONS,\n} from '../extract/js-document.ts';\nimport { encodeSortedJson } from '../report/sorted-json.ts';\nimport {\n  inputFailure,\n  MAX_INPUT_TEXT_LENGTH,\n  MAX_TOTAL_INPUT_TEXT_LENGTH,\n  type Clock,\n  type CommandResult,\n  type ReadTextFile,\n} from './command-support.ts';\nimport { parseCommandArguments } from './parse-arguments.ts';\n\n/** 디렉터리 항목 — 워커가 경로 종류를 다시 질의하지 않게 타입을 함께 준다. */\nexport interface JsDirectoryEntry {\n  readonly name: string;\n  readonly isFile: boolean;\n  readonly isDirectory: boolean;\n}\n\n/** extract-js가 필요로 하는 최소 파일시스템 표면이다. */\nexport interface ExtractJsFileSystem {\n  /** 경로 종류를 돌려준다 — 없으면 'missing'. */\n  readonly statPath: (path: string) => Promise<'file' | 'directory' | 'missing'>;\n  /** 디렉터리의 바로 아래 항목들을 나열한다. */\n  readonly listDirectory: (path: string) => Promise<readonly JsDirectoryEntry[]>;\n  /** 심볼릭 링크·`..`를 풀어 절대 경로로 만든다. */\n  readonly realPath: (path: string) => Promise<string>;\n}\n\n/** 스캔 대상 확장자 집합이다. */\nconst jsExtensions = new Set<string>(JS_SOURCE_EXTENSIONS);\n\n/** 워크에서 건너뛸 디렉터리다 — 종속성·빌드 산출물·VCS 내부다. */\nconst SKIPPED_DIRECTORIES = new Set([\n  'node_modules', 'dist', 'build', 'coverage', 'out',\n  '.git', '.svn', '.hg', '.expo', '.next', '.turbo',\n]);\n\n/** 한 번의 호출이 받을 수 있는 입력 경로 수 상한이다. */\nconst MAX_INPUT_PATHS = 256;\n/** 스캔 대상 파일 수 상한이다. */\nconst MAX_SCANNED_FILES = 10_000;\n\n/**\n * extract-js 인자를 실행해 프로세스에 독립적인 결과를 반환한다.\n *\n * 성공 시 정렬된 bridge-facts JSON을 stdout에 쓴다. 입력 실패는 원인 종류와\n * 해결 방향을 담은 코드 2, 잘못된 호출은 사용법과 코드 64다.\n */\nexport async function runExtractJsCommand(\n  arguments_: readonly string[],\n  fileSystem: ExtractJsFileSystem,\n  readSource: ReadTextFile,\n  now: Clock = () => new Date(),\n  version?: string,\n): Promise<CommandResult> {\n  if (arguments_[0] !== 'extract-js') return usageError();\n  const options = parseCommandArguments(arguments_.slice(1), ['--project'], []);\n  if (options === undefined) return usageError();\n  const { positionals, valueFlags } = options;\n  if (positionals.length === 0 || positionals.length > MAX_INPUT_PATHS) {\n    return usageError();\n  }\n\n  const roots = await Promise.all(\n    positionals.map((input) => safeRealPath(fileSystem, input)),\n  );\n  const missingIndex = roots.findIndex((path) => path === undefined);\n  if (missingIndex !== -1) {\n    return inputFailure(\n      `Unable to read extract-js input ${missingIndex + 1}; `\n      + 'check that the file or directory exists and is readable.\\n',\n    );\n  }\n\n  const projectFlag = valueFlags.get('--project');\n  let projectRoot: string;\n  if (projectFlag !== undefined) {\n    const root = await safeRealPath(fileSystem, projectFlag);\n    if (root === undefined || await fileSystem.statPath(root) !== 'directory') {\n      return inputFailure(\n        'extract-js --project does not name a readable directory; '\n        + 'pass the project root that contains the inputs.\\n',\n      );\n    }\n    projectRoot = normalizeSeparators(root);\n  } else {\n    projectRoot = await commonAncestor(roots as string[], fileSystem);\n  }\n\n  const discovered: { path: string; text: string }[] = [];\n  for (const [index, absolute] of (roots as string[]).entries()) {\n    const kind = await fileSystem.statPath(absolute);\n    if (kind === 'missing') {\n      return inputFailure(\n        `Unable to read extract-js input ${index + 1}; `\n        + 'check that the file or directory exists and is readable.\\n',\n      );\n    }\n    let candidates: string[];\n    try {\n      candidates = kind === 'directory'\n        ? await walkDirectory(\n          fileSystem, absolute, MAX_SCANNED_FILES - discovered.length)\n        : [absolute];\n    } catch {\n      return inputFailure(\n        `Unable to list extract-js input ${index + 1}; `\n        + 'check that the directory is readable.\\n',\n      );\n    }\n    for (const candidate of candidates) {\n      if (!isJsSource(candidate)) {\n        if (kind === 'file') {\n          return inputFailure(\n            `extract-js input ${index + 1} is not a JS/TS source file; `\n            + 'pass .js/.ts/.jsx/.tsx sources or a directory containing them.\\n',\n          );\n        }\n        continue;\n      }\n      const relative = relativize(candidate, projectRoot);\n      if (relative === undefined || relative === '') {\n        return inputFailure(\n          `extract-js input ${index + 1} escapes the project root; `\n          + 'pass --project that contains every input.\\n',\n        );\n      }\n      discovered.push({ path: relative, text: '' });\n      if (discovered.length > MAX_SCANNED_FILES) {\n        return inputFailure(\n          `extract-js input set exceeds ${MAX_SCANNED_FILES} files; `\n          + 'narrow the scanned directories.\\n',\n        );\n      }\n    }\n  }\n\n  // 같은 파일이 여러 입력에서 발견돼도 한 번만 스캔한다.\n  const ordered = [...new Map(discovered.map((f) => [f.path, f])).values()]\n    .sort((left, right) => left.path.localeCompare(right.path));\n  let totalLength = 0;\n  for (const file of ordered) {\n    let text: string;\n    try {\n      text = await readSource(`${projectRoot}/${file.path}`);\n    } catch {\n      return inputFailure(\n        `Unable to read extract-js source ${file.path}; `\n        + 'check that the file exists and is readable.\\n',\n      );\n    }\n    totalLength += text.length;\n    if (\n      text.length > MAX_INPUT_TEXT_LENGTH ||\n      totalLength > MAX_TOTAL_INPUT_TEXT_LENGTH\n    ) {\n      return inputFailure(\n        'extract-js input set exceeds the source size limits; '\n        + 'narrow the scanned directories.\\n',\n      );\n    }\n    file.text = text;\n  }\n\n  if (version === undefined) {\n    return {\n      standardOutput: '',\n      standardError: 'Unable to read package metadata.\\n',\n      exitCode: 2,\n    };\n  }\n  const document = createJsFactsDocument(\n    ordered, version, now().toISOString(), projectRoot,\n  );\n  return { standardOutput: encodeSortedJson(document), standardError: '', exitCode: 0 };\n}\n\n/**\n * 디렉터리 아래 JS/TS 파일을 재귀로 모은다. 실패는 빈 목록이 아니라 던진다.\n *\n * `budget`은 아직 받을 수 있는 파일 수다 — 거대한 트리 전체를 열거한 뒤에야\n * 상한 오류를 내지 않도록 예산을 넘으면 즉시 멈추고 호출자가 상한을 보고한다.\n */\nasync function walkDirectory(\n  fileSystem: ExtractJsFileSystem,\n  directory: string,\n  budget: number,\n): Promise<string[]> {\n  const found: string[] = [];\n  const pending = [directory];\n  while (pending.length > 0 && found.length <= budget) {\n    const current = pending.pop()!;\n    let entries: readonly JsDirectoryEntry[];\n    try {\n      entries = await fileSystem.listDirectory(current);\n    } catch (error) {\n      throw new Error(`listDirectory failed: ${current}`, { cause: error });\n    }\n    for (const entry of [...entries]\n      .sort((left, right) => left.name.localeCompare(right.name))) {\n      const child = `${current}/${entry.name}`;\n      if (entry.isDirectory) {\n        if (SKIPPED_DIRECTORIES.has(entry.name) || entry.name.startsWith('.')) {\n          continue;\n        }\n        pending.push(child);\n      } else if (entry.isFile && isJsSource(entry.name)) {\n        found.push(child);\n      }\n    }\n  }\n  return found;\n}\n\n/**\n * `--project` 없이 입력들의 공통 조상 디렉터리를 찾는다.\n *\n * 파일 입력은 디렉터리로 접고, 모든 입력을 포함하는 가장 깊은 공통\n * 디렉터리를 고른다. 프로젝트 밖 경로가 facts의 상대 경로를 깨지 않게 한다.\n */\nasync function commonAncestor(\n  absolutePaths: readonly string[],\n  fileSystem: ExtractJsFileSystem,\n): Promise<string> {\n  const roots: string[] = [];\n  for (const absolute of absolutePaths) {\n    const normalized = normalizeSeparators(absolute);\n    const isFile = await fileSystem.statPath(absolute) === 'file';\n    roots.push(isFile ? normalized.slice(0, normalized.lastIndexOf('/')) : normalized);\n  }\n  let common = roots[0] ?? '/';\n  for (const candidate of roots.slice(1)) {\n    while (candidate !== common && !candidate.startsWith(`${common}/`)) {\n      const parent = common.slice(0, common.lastIndexOf('/'));\n      if (parent === '' || parent === common) {\n        common = '/';\n        break;\n      }\n      common = parent;\n    }\n  }\n  return common;\n}\n\n/** 절대 경로를 프로젝트 상대 POSIX 경로로 바꾼다. 루트 밖이면 undefined다. */\nfunction relativize(absolute: string, projectRoot: string): string | undefined {\n  const normalized = normalizeSeparators(absolute);\n  const root = normalizeSeparators(projectRoot);\n  if (root === '/') return normalized.replace(/^\\/+/, '');\n  if (normalized === root) return '';\n  if (!normalized.startsWith(`${root}/`)) return undefined;\n  return normalized.slice(root.length + 1);\n}\n\n/** 스캔 대상 확장자 여부다. */\nfunction isJsSource(path: string): boolean {\n  const dot = path.lastIndexOf('.');\n  return dot !== -1 && jsExtensions.has(path.slice(dot + 1));\n}\n\n/**\n * OS 경로 구분자를 계약이 요구하는 `/`로 통일한다.\n *\n * `\\`는 POSIX에서 유효한 파일명 문자이므로 구분자가 `\\`인 플랫폼에서만\n * 바꾼다 — 무조건 치환하면 `a\\b.ts` 같은 합법 파일명이 깨진다.\n */\nfunction normalizeSeparators(path: string): string {\n  return sep === '\\\\' ? path.replace(/\\\\/g, '/') : path;\n}\n\n/** realpath가 던지는 입력을 경로 없는 undefined로 정규화한다. */\nasync function safeRealPath(\n  fileSystem: ExtractJsFileSystem,\n  path: string,\n): Promise<string | undefined> {\n  try {\n    return await fileSystem.realPath(path);\n  } catch {\n    return undefined;\n  }\n}\n\n/** 잘못된 CLI 호출을 경로 없는 사용법과 코드 64로 바꾼다. */\nfunction usageError(): CommandResult {\n  return {\n    standardOutput: '',\n    standardError: `${extractJsUsage}\\n`,\n    exitCode: 64,\n  };\n}\n\n/** extract-js 명령의 한 줄 사용법이다. */\nexport const extractJsUsage =\n  'Usage: isthmus extract-js <file-or-dir> [more...] [--project <dir>]';\n"]}

package/dist/cli/graph-command.js

@@ -1,6 +1,7 @@
-import { isBridgeJoinDeferred, joinBridgeDocuments, MAX_DOCUMENTS_PER_JOIN, } from "../join/join.js";
+import { emptyBridgeJoinResult, isBridgeJoinDeferred, joinBridgeDocuments, MAX_DOCUMENTS_PER_JOIN, } from "../join/join.js";
+import { joinMessageBridges } from "../join/messages.js";
 import { BridgeGraphLimitError, BridgeGraphValidationError, createBridgeGraph, renderBridgeGraph, } from "../report/graph.js";
-import { bridgeJoinDeferredError, inputFailureResult, internalError, readBridgeDocuments, } from "./command-support.js";
+import { bridgeJoinDeferredError, inputFailureResult, internalError, readBridgeInputs, } from "./command-support.js";
 import { parseCommandArguments } from "./parse-arguments.js";
 /** graph 인자를 실행해 경계 그래프와 종료 코드를 반환한다. */
 export async function runGraphCommand(arguments_, readTextFile) {
@@ -8,12 +9,18 @@ export async function runGraphCommand(arguments_, readTextFile) {
     if (options === undefined)
         return graphUsageError();
     try {
-        const documents = await readBridgeDocuments(options.inputPaths, readTextFile);
-        const joined = joinBridgeDocuments(documents);
+        const { bridges, messages } = await readBridgeInputs(options.inputPaths, readTextFile);
+        const project = bridges[0]?.project ?? messages[0].project;
+        const joined = bridges.length > 0
+            ? joinBridgeDocuments(bridges)
+            : emptyBridgeJoinResult();
         if (isBridgeJoinDeferred(joined)) {
-            return bridgeJoinDeferredError(joined.observedFacts, documents.length);
+            return bridgeJoinDeferredError(joined.observedFacts, bridges.length);
         }
-        const graph = createBridgeGraph(joined);
+        const messageJoin = messages.length > 0
+            ? joinMessageBridges(messages, project)
+            : undefined;
+        const graph = createBridgeGraph(joined, messageJoin);
         return {
             standardOutput: renderBridgeGraph(graph, options.format),
             standardError: '',

package/dist/cli/graph-command.js.map

@@ -1 +1 @@
-{"version":3,"file":"graph-command.js","sourceRoot":"","sources":["../../src/cli/graph-command.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  isBridgeJoinDeferred,\n  joinBridgeDocuments,\n  MAX_DOCUMENTS_PER_JOIN,\n} from '../join/join.ts';\nimport {\n  BridgeGraphLimitError,\n  BridgeGraphValidationError,\n  createBridgeGraph,\n  renderBridgeGraph,\n} from '../report/graph.ts';\nimport {\n  bridgeJoinDeferredError,\n  inputFailureResult,\n  internalError,\n  readBridgeDocuments,\n  type CommandResult,\n  type ReadTextFile,\n} from './command-support.ts';\nimport { parseCommandArguments } from './parse-arguments.ts';\n\n/** graph 인자를 실행해 경계 그래프와 종료 코드를 반환한다. */\nexport async function runGraphCommand(\n  arguments_: readonly string[],\n  readTextFile: ReadTextFile,\n): Promise<CommandResult> {\n  const options = parseGraphArguments(arguments_);\n  if (options === undefined) return graphUsageError();\n  try {\n    const documents = await readBridgeDocuments(options.inputPaths, readTextFile);\n    const joined = joinBridgeDocuments(documents);\n    if (isBridgeJoinDeferred(joined)) {\n      return bridgeJoinDeferredError(joined.observedFacts, documents.length);\n    }\n    const graph = createBridgeGraph(joined);\n    return {\n      standardOutput: renderBridgeGraph(graph, options.format),\n      standardError: '',\n      exitCode: 0,\n    };\n  } catch (error) {\n    if (\n      error instanceof BridgeGraphLimitError ||\n      error instanceof BridgeGraphValidationError\n    ) {\n      return {\n        standardOutput: '',\n        standardError: `${error.message}\\n`,\n        exitCode: 2,\n      };\n    }\n    return inputFailureResult(error) ?? internalError();\n  }\n}\n\n/** graph의 입력 파일과 선택 출력 형식을 검증한다. 플래그는 어디에 와도 된다. */\nfunction parseGraphArguments(arguments_: readonly string[]): GraphOptions | undefined {\n  if (arguments_[0] !== 'graph') return undefined;\n  const parsed = parseCommandArguments(arguments_.slice(1), ['--format'], []);\n  if (parsed === undefined) return undefined;\n  const format = parsed.valueFlags.get('--format');\n  if (format !== undefined && !isGraphFormat(format)) return undefined;\n  const inputPaths = [...parsed.positionals];\n  if (\n    inputPaths.length < 2 ||\n    inputPaths.length > MAX_DOCUMENTS_PER_JOIN\n  ) {\n    return undefined;\n  }\n  return { inputPaths, format: format ?? 'json' };\n}\n\n/** 지원하는 그래프 형식인지 확인한다. */\nfunction isGraphFormat(value: string): value is GraphFormat {\n  return value === 'json' || value === 'dot' || value === 'mermaid';\n}\n\n/** graph 사용 오류를 경로 없는 코드 64로 바꾼다. */\nfunction graphUsageError(): CommandResult {\n  return {\n    standardOutput: '',\n    standardError: `${graphUsage}\\n`,\n    exitCode: 64,\n  };\n}\n\n/** 검증된 graph 명령 옵션이다. */\ninterface GraphOptions {\n  readonly inputPaths: readonly string[];\n  readonly format: GraphFormat;\n}\n\ntype GraphFormat = 'json' | 'dot' | 'mermaid';\n\n/** graph 명령의 한 줄 사용법이다. */\nexport const graphUsage =\n  'Usage: isthmus graph <bridge-facts.json> <bridge-facts.json> '\n  + '[more...] [--format json|dot|mermaid]';\n"]}
+{"version":3,"file":"graph-command.js","sourceRoot":"","sources":["../../src/cli/graph-command.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  emptyBridgeJoinResult,\n  isBridgeJoinDeferred,\n  joinBridgeDocuments,\n  MAX_DOCUMENTS_PER_JOIN,\n} from '../join/join.ts';\nimport { joinMessageBridges } from '../join/messages.ts';\nimport {\n  BridgeGraphLimitError,\n  BridgeGraphValidationError,\n  createBridgeGraph,\n  renderBridgeGraph,\n} from '../report/graph.ts';\nimport {\n  bridgeJoinDeferredError,\n  inputFailureResult,\n  internalError,\n  readBridgeInputs,\n  type CommandResult,\n  type ReadTextFile,\n} from './command-support.ts';\nimport { parseCommandArguments } from './parse-arguments.ts';\n\n/** graph 인자를 실행해 경계 그래프와 종료 코드를 반환한다. */\nexport async function runGraphCommand(\n  arguments_: readonly string[],\n  readTextFile: ReadTextFile,\n): Promise<CommandResult> {\n  const options = parseGraphArguments(arguments_);\n  if (options === undefined) return graphUsageError();\n  try {\n    const { bridges, messages } = await readBridgeInputs(options.inputPaths, readTextFile);\n    const project = bridges[0]?.project ?? messages[0]!.project;\n    const joined = bridges.length > 0\n      ? joinBridgeDocuments(bridges)\n      : emptyBridgeJoinResult();\n    if (isBridgeJoinDeferred(joined)) {\n      return bridgeJoinDeferredError(joined.observedFacts, bridges.length);\n    }\n    const messageJoin = messages.length > 0\n      ? joinMessageBridges(messages, project)\n      : undefined;\n    const graph = createBridgeGraph(joined, messageJoin);\n    return {\n      standardOutput: renderBridgeGraph(graph, options.format),\n      standardError: '',\n      exitCode: 0,\n    };\n  } catch (error) {\n    if (\n      error instanceof BridgeGraphLimitError ||\n      error instanceof BridgeGraphValidationError\n    ) {\n      return {\n        standardOutput: '',\n        standardError: `${error.message}\\n`,\n        exitCode: 2,\n      };\n    }\n    return inputFailureResult(error) ?? internalError();\n  }\n}\n\n/** graph의 입력 파일과 선택 출력 형식을 검증한다. 플래그는 어디에 와도 된다. */\nfunction parseGraphArguments(arguments_: readonly string[]): GraphOptions | undefined {\n  if (arguments_[0] !== 'graph') return undefined;\n  const parsed = parseCommandArguments(arguments_.slice(1), ['--format'], []);\n  if (parsed === undefined) return undefined;\n  const format = parsed.valueFlags.get('--format');\n  if (format !== undefined && !isGraphFormat(format)) return undefined;\n  const inputPaths = [...parsed.positionals];\n  if (\n    inputPaths.length < 2 ||\n    inputPaths.length > MAX_DOCUMENTS_PER_JOIN\n  ) {\n    return undefined;\n  }\n  return { inputPaths, format: format ?? 'json' };\n}\n\n/** 지원하는 그래프 형식인지 확인한다. */\nfunction isGraphFormat(value: string): value is GraphFormat {\n  return value === 'json' || value === 'dot' || value === 'mermaid';\n}\n\n/** graph 사용 오류를 경로 없는 코드 64로 바꾼다. */\nfunction graphUsageError(): CommandResult {\n  return {\n    standardOutput: '',\n    standardError: `${graphUsage}\\n`,\n    exitCode: 64,\n  };\n}\n\n/** 검증된 graph 명령 옵션이다. */\ninterface GraphOptions {\n  readonly inputPaths: readonly string[];\n  readonly format: GraphFormat;\n}\n\ntype GraphFormat = 'json' | 'dot' | 'mermaid';\n\n/** graph 명령의 한 줄 사용법이다. */\nexport const graphUsage =\n  'Usage: isthmus graph <bridge-facts.json> <bridge-facts.json> '\n  + '[more...] [--format json|dot|mermaid]';\n"]}

package/dist/cli/impact-command.d.ts

@@ -0,0 +1,5 @@
+import type { CommandResult, ReadTextFile } from './command-support.ts';
+/** 파일·심볼·CI 변경 목록을 브리지 영향 보고서로 바꾸는 CLI 경계다. */
+export declare function runImpactCommand(arguments_: readonly string[], readTextFile: ReadTextFile): Promise<CommandResult>;
+/** impact 명령의 독립적인 선택 방식과 CI 실패 옵션이다. */
+export declare const impactUsage: string;

package/dist/cli/impact-command.js

@@ -0,0 +1,111 @@
+import { ImpactSelectionValidationError, parseImpactSelection } from "../exchange/impact-selection.js";
+import { isSafeNonEmptyString } from "../exchange/parse.js";
+import { parseBridgeRuntime, RuntimeValidationError } from "../exchange/runtime.js";
+import { MAX_DOCUMENTS_PER_JOIN } from "../join/join.js";
+import { createBridgeImpact, encodeBridgeImpact, hasImpactBlockers } from "../report/impact.js";
+import { inputFailure, inputFailureResult, internalError, isJsonParseFailure, MAX_INPUT_TEXT_LENGTH, readBridgeDocuments, } from "./command-support.js";
+import { parseCommandArguments } from "./parse-arguments.js";
+/** 파일·심볼·CI 변경 목록을 브리지 영향 보고서로 바꾸는 CLI 경계다. */
+export async function runImpactCommand(arguments_, readTextFile) {
+    const parsed = parseCommandArguments(arguments_.slice(1), ['--file', '--symbol', '--changes', '--runtime', '--revision'], ['--strict', '--compact']);
+    if (parsed === undefined || ['--file', '--symbol', '--changes'].filter((flag) => parsed.valueFlags.has(flag)).length !== 1 ||
+        parsed.positionals.length < 2 || parsed.positionals.length > MAX_DOCUMENTS_PER_JOIN) {
+        return usageError();
+    }
+    const runtimePath = parsed.valueFlags.get('--runtime');
+    const revision = parsed.valueFlags.get('--revision');
+    if ((runtimePath === undefined) !== (revision === undefined) ||
+        (revision !== undefined && !isSafeNonEmptyString(revision)))
+        return usageError();
+    try {
+        let selection;
+        let supplementalTextLength = 0;
+        const changesPath = parsed.valueFlags.get('--changes');
+        if (changesPath !== undefined) {
+            const loaded = await readSupplemental(changesPath, readTextFile, 'changes', parseImpactSelection);
+            if ('exitCode' in loaded)
+                return loaded;
+            selection = loaded.document;
+            supplementalTextLength += loaded.textLength;
+        }
+        else {
+            const file = parsed.valueFlags.get('--file');
+            const symbol = parsed.valueFlags.get('--symbol');
+            try {
+                selection = parseImpactSelection({ format: 'isthmus-changes', version: 1,
+                    files: file === undefined ? [] : [file], symbols: symbol === undefined ? [] : [symbol] });
+            }
+            catch (error) {
+                if (error instanceof ImpactSelectionValidationError)
+                    return usageError();
+                throw error;
+            }
+        }
+        let runtime;
+        if (runtimePath !== undefined && revision !== undefined) {
+            const loaded = await readSupplemental(runtimePath, readTextFile, 'runtime', parseBridgeRuntime);
+            if ('exitCode' in loaded)
+                return loaded;
+            supplementalTextLength += loaded.textLength;
+            runtime = { document: loaded.document, revision };
+        }
+        const documents = await readBridgeDocuments(parsed.positionals, readTextFile, supplementalTextLength);
+        const report = createBridgeImpact(documents, selection, runtime);
+        const blocked = parsed.booleanFlags.has('--strict') && hasImpactBlockers(report);
+        return {
+            standardOutput: encodeBridgeImpact(report, parsed.booleanFlags.has('--compact')),
+            standardError: blocked
+                ? 'Change preflight requires review: related errors, analysis gaps, or unobserved selectors remain.\n'
+                : report.status === 'unobserved'
+                    ? 'No selected bridge facts were observed; inspect source coverage and use a pre-change snapshot for deleted code.\n'
+                    : '',
+            exitCode: blocked ? 1 : 0,
+        };
+    }
+    catch (error) {
+        if (error instanceof RuntimeValidationError)
+            return inputFailure(`${error.message}\n`);
+        return inputFailureResult(error) ?? internalError();
+    }
+}
+/** 변경 파일도 브리지 입력과 같은 읽기·구문·계약 실패 경계를 지킨다. */
+async function readSupplemental(path, readTextFile, kind, parse) {
+    const label = kind === 'changes' ? 'Changes' : 'Runtime';
+    const format = kind === 'changes' ? 'isthmus-changes' : 'bridge-runtime';
+    let text;
+    try {
+        text = await readTextFile(path);
+    }
+    catch {
+        return inputFailure(`Unable to read ${kind} input; check that the file exists and is readable.\n`);
+    }
+    if (text.length > MAX_INPUT_TEXT_LENGTH)
+        return inputFailure(`${label} input exceeds the input size limit.\n`);
+    let value;
+    try {
+        value = JSON.parse(text);
+    }
+    catch (error) {
+        if (isJsonParseFailure(error))
+            return inputFailure(`${label} input is not valid JSON.\n`);
+        throw error;
+    }
+    try {
+        return { document: parse(value), textLength: text.length };
+    }
+    catch (error) {
+        if (error instanceof ImpactSelectionValidationError || error instanceof RuntimeValidationError) {
+            return inputFailure(`${label} input violates the ${format} contract: ${error.message}\n`);
+        }
+        throw error;
+    }
+}
+/** 잘못된 인수는 입력을 읽기 전에 코드 64로 거부한다. */
+function usageError() {
+    return { standardOutput: '', standardError: `${impactUsage}\n`, exitCode: 64 };
+}
+/** impact 명령의 독립적인 선택 방식과 CI 실패 옵션이다. */
+export const impactUsage = 'Usage: isthmus impact (--file <relative-path> | --symbol <name-or-usr> '
+    + '| --changes <changes.json>) <bridge-facts.json> <bridge-facts.json> [more...] '
+    + '[--runtime <runtime.json> --revision <revision>] [--strict] [--compact]';
+//# sourceMappingURL=impact-command.js.map