isthmus-cli 0.1.0

package/dist/exchange/parse.d.ts

@@ -0,0 +1,48 @@
+/** bridge-facts 생산 플랫폼이다. */
+export type BridgePlatform = 'dart' | 'swift' | 'kotlin' | 'js';
+/** 언어 경계를 잇는 메커니즘이다. */
+export type BridgeTarget = 'flutter' | 'react-native' | 'capacitor';
+/** 교환 형식의 사실 종류다. */
+export type BridgeFactKind = 'channel-create' | 'channel-register' | 'method-invoke' | 'method-handle' | 'module-export' | 'module-import' | 'component-export' | 'component-require';
+/** 사실의 프로젝트 상대 소스 위치다. */
+export interface BridgeLocation {
+    readonly path: string;
+    readonly line: number;
+    readonly column: number;
+}
+/** 사실을 감싸는 언어별 선언 식별자다. */
+export interface BridgeSymbol {
+    readonly qualifiedName: string;
+    readonly usr?: string;
+}
+/** 생산 도구 하나가 관찰한 언어 경계 사실이다. */
+export interface BridgeFact {
+    readonly kind: BridgeFactKind;
+    readonly channel: string | null;
+    readonly method?: string;
+    readonly dynamic: boolean;
+    readonly location: BridgeLocation;
+    readonly symbol?: BridgeSymbol;
+}
+/** bridge-facts 버전 1 문서다. */
+export interface BridgeFactsDocument {
+    readonly format: 'bridge-facts';
+    readonly version: 1;
+    readonly tool: Readonly<{
+        name: string;
+        version: string;
+    }>;
+    readonly generatedAt: string;
+    readonly platform: BridgePlatform;
+    readonly target: BridgeTarget | null;
+    readonly project: string;
+    readonly facts: readonly BridgeFact[];
+    readonly limitations: readonly string[];
+}
+/** 외부 교환 문서가 v1 계약을 어겼음을 나타낸다. */
+export declare class BridgeFactsValidationError extends Error {
+    /** 입력 내용을 노출하지 않는 안전한 메시지를 보존한다. */
+    constructor(message: string);
+}
+/** 신뢰하지 않는 JSON 값을 검증된 bridge-facts v1 문서로 바꾼다. */
+export declare function parseBridgeFactsDocument(input: unknown): BridgeFactsDocument;

package/dist/exchange/parse.js

@@ -0,0 +1,148 @@
+/** 외부 교환 문서가 v1 계약을 어겼음을 나타낸다. */
+export class BridgeFactsValidationError extends Error {
+    /** 입력 내용을 노출하지 않는 안전한 메시지를 보존한다. */
+    constructor(message) {
+        super(message);
+        this.name = 'BridgeFactsValidationError';
+    }
+}
+/** 신뢰하지 않는 JSON 값을 검증된 bridge-facts v1 문서로 바꾼다. */
+export function parseBridgeFactsDocument(input) {
+    if (!isJsonObject(input)) {
+        throw new BridgeFactsValidationError('Bridge facts must be a JSON object.');
+    }
+    if (input.format !== 'bridge-facts') {
+        throw new BridgeFactsValidationError('Expected format "bridge-facts".');
+    }
+    if (input.version !== 1) {
+        throw new BridgeFactsValidationError('Unsupported bridge-facts version; expected version 1.');
+    }
+    validateDocumentMetadata(input);
+    return input;
+}
+/** 문서 수준 필드가 v1 타입과 허용값을 따르는지 검증한다. */
+function validateDocumentMetadata(document) {
+    validateTool(document.tool);
+    if (!isTimestamp(document.generatedAt))
+        fail('Invalid generatedAt timestamp.');
+    if (!bridgePlatforms.has(document.platform))
+        fail('Unsupported bridge platform.');
+    if (document.target !== null && !bridgeTargets.has(document.target)) {
+        fail('Unsupported bridge target.');
+    }
+    if (!isNonEmptyString(document.project))
+        fail('Invalid project path.');
+    if (!Array.isArray(document.facts))
+        fail('Facts must be an array.');
+    document.facts.forEach(validateFact);
+    if (!isStringArray(document.limitations))
+        fail('Limitations must be strings.');
+}
+/** 사실 하나의 조인 키와 증거 필드를 검증한다. */
+function validateFact(value, index) {
+    if (!isJsonObject(value))
+        fail(`Fact at index ${index} must be a JSON object.`);
+    if (!bridgeFactKinds.has(value.kind))
+        fail(`Invalid fact kind at index ${index}.`);
+    if (value.channel !== null && !isSafeNonEmptyString(value.channel)) {
+        fail(`Invalid fact channel at index ${index}.`);
+    }
+    if (methodFactKinds.has(value.kind) && !isSafeNonEmptyString(value.method)) {
+        fail(`Method fact at index ${index} requires a method name.`);
+    }
+    if (typeof value.dynamic !== 'boolean')
+        fail(`Invalid dynamic flag at index ${index}.`);
+    validateLocation(value.location, index);
+    validateSymbol(value.symbol, index);
+}
+/** 사실 위치가 상대 경로와 1부터 시작하는 줄·열을 갖는지 검증한다. */
+function validateLocation(value, index) {
+    if (!isJsonObject(value) ||
+        !isProjectRelativePath(value.path) ||
+        !isPositiveInteger(value.line) ||
+        !isPositiveInteger(value.column)) {
+        fail(`Invalid fact location at index ${index}.`);
+    }
+}
+/** 절대·상위 경로와 제어 문자를 제외한 프로젝트 상대 경로인지 확인한다. */
+function isProjectRelativePath(value) {
+    if (!isNonEmptyString(value))
+        return false;
+    if (/^(?:[/\\]|[A-Za-z]:)/u.test(value))
+        return false;
+    if (/[\u0000-\u001f\u007f]/u.test(value))
+        return false;
+    return !value.split(/[/\\]/u).includes('..');
+}
+/** 선택 symbol의 이름과 USR이 비어 있지 않은지 검증한다. */
+function validateSymbol(value, index) {
+    if (value === undefined)
+        return;
+    if (!isJsonObject(value) ||
+        !isSafeNonEmptyString(value.qualifiedName) ||
+        (value.usr !== undefined && !isSafeNonEmptyString(value.usr))) {
+        fail(`Invalid fact symbol at index ${index}.`);
+    }
+}
+/** 생산 도구 이름과 버전이 비어 있지 않은지 검증한다. */
+function validateTool(value) {
+    if (!isJsonObject(value) ||
+        !isNonEmptyString(value.name) ||
+        !isNonEmptyString(value.version)) {
+        fail('Invalid tool metadata.');
+    }
+}
+/** ISO 계열 생성 시각으로 해석할 수 있는지 확인한다. */
+function isTimestamp(value) {
+    return (typeof value === 'string' &&
+        timestampPattern.test(value) &&
+        !Number.isNaN(Date.parse(value)));
+}
+/** 공백만 있지 않은 문자열인지 확인한다. */
+function isNonEmptyString(value) {
+    return typeof value === 'string' && value.trim().length > 0;
+}
+/** 조인 키를 깨뜨리는 제어 문자가 없는 비어 있지 않은 문자열인지 확인한다. */
+function isSafeNonEmptyString(value) {
+    return isNonEmptyString(value) && !controlCharacterPattern.test(value);
+}
+/** 모든 원소가 문자열인 배열인지 확인한다. */
+function isStringArray(value) {
+    return Array.isArray(value) && value.every((item) => typeof item === 'string');
+}
+/** 1부터 시작하는 정수인지 확인한다. */
+function isPositiveInteger(value) {
+    return Number.isInteger(value) && Number(value) >= 1;
+}
+/** 입력 값을 포함하지 않는 검증 오류를 던진다. */
+function fail(message) {
+    throw new BridgeFactsValidationError(message);
+}
+/** 지원하는 생산 플랫폼 집합이다. */
+const bridgePlatforms = new Set(['dart', 'swift', 'kotlin', 'js']);
+/** 지원하는 브리지 메커니즘 집합이다. */
+const bridgeTargets = new Set([
+    'flutter',
+    'react-native',
+    'capacitor',
+]);
+/** 버전 1이 정의한 사실 종류 집합이다. */
+const bridgeFactKinds = new Set([
+    'channel-create',
+    'channel-register',
+    'method-invoke',
+    'method-handle',
+    'module-export',
+    'module-import',
+    'component-export',
+    'component-require',
+]);
+/** method 필드가 필수인 사실 종류다. */
+const methodFactKinds = new Set(['method-invoke', 'method-handle']);
+const timestampPattern = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})$/u;
+const controlCharacterPattern = /[\u0000-\u001f\u007f]/u;
+/** 배열과 null을 제외한 JSON 객체인지 확인한다. */
+function isJsonObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=parse.js.map

package/dist/exchange/parse.js.map

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

package/dist/join/join.d.ts

@@ -0,0 +1,59 @@
+import type { BridgeFactsDocument, BridgeLocation, BridgePlatform, BridgeSymbol, BridgeTarget } from '../exchange/parse.ts';
+/** 한 언어 문서가 제공한 브리지 증거 위치다. */
+export interface BridgeEndpoint {
+    readonly platform: BridgePlatform;
+    readonly location: BridgeLocation;
+    readonly symbol?: BridgeSymbol;
+}
+/** 논리 채널 하나에 모인 양쪽 생성·등록 증거다. */
+export interface MatchedChannel {
+    readonly target: BridgeTarget;
+    readonly channel: string;
+    readonly creations: readonly BridgeEndpoint[];
+    readonly registrations: readonly BridgeEndpoint[];
+}
+/** 등록을 찾지 못한 논리 채널과 모든 생성 증거다. */
+export interface UnregisteredChannelCreation {
+    readonly target: BridgeTarget;
+    readonly channel: string;
+    readonly creations: readonly BridgeEndpoint[];
+}
+/** 논리 메서드 하나에 모인 양쪽 호출·핸들러 증거다. */
+export interface MatchedMethod {
+    readonly target: BridgeTarget;
+    readonly channel: string;
+    readonly method: string;
+    readonly invocations: readonly BridgeEndpoint[];
+    readonly handlers: readonly BridgeEndpoint[];
+}
+/** 핸들러를 찾지 못한 논리 호출과 모든 호출 증거다. */
+export interface UnhandledInvocation {
+    readonly target: BridgeTarget;
+    readonly channel: string;
+    readonly method: string;
+    readonly invocations: readonly BridgeEndpoint[];
+}
+/** 호출자를 찾지 못한 논리 핸들러와 모든 네이티브 증거다. */
+export interface HandlerWithoutInvocation {
+    readonly target: BridgeTarget;
+    readonly channel: string;
+    readonly method: string;
+    readonly handlers: readonly BridgeEndpoint[];
+}
+/** 생산 문서가 밝힌 분석 한계와 출처다. */
+export interface JoinLimitation {
+    readonly platform: BridgePlatform | 'cross-platform';
+    readonly tool: string;
+    readonly message: string;
+}
+/** 검증된 교환 문서들의 논리 조인 결과다. */
+export interface BridgeJoinResult {
+    readonly matchedChannels: readonly MatchedChannel[];
+    readonly unregisteredChannelCreations: readonly UnregisteredChannelCreation[];
+    readonly matchedMethods: readonly MatchedMethod[];
+    readonly unhandledInvocations: readonly UnhandledInvocation[];
+    readonly handlersWithoutInvocations: readonly HandlerWithoutInvocation[];
+    readonly limitations: readonly JoinLimitation[];
+}
+/** 위치가 아니라 문자열 키로 검증된 교환 문서를 조인한다. */
+export declare function joinBridgeDocuments(documents: readonly BridgeFactsDocument[]): BridgeJoinResult;

package/dist/join/join.js

@@ -0,0 +1,218 @@
+import { compareStrings } from "../compare.js";
+/** 위치가 아니라 문자열 키로 검증된 교환 문서를 조인한다. */
+export function joinBridgeDocuments(documents) {
+    const limitations = collectLimitations(documents);
+    if (documents.some(hasMixedTargets))
+        return emptyJoinResult(limitations);
+    const groups = collectChannelGroups(documents);
+    const matchedChannels = [...groups.values()]
+        .filter((group) => group.creations.length > 0 && group.registrations.length > 0)
+        .sort(compareChannels);
+    const unregisteredChannelCreations = [...groups.values()]
+        .filter((group) => group.creations.length > 0 && group.registrations.length === 0)
+        .map(({ target, channel, creations }) => ({ target, channel, creations }))
+        .sort(compareChannels);
+    const methodGroups = collectMethodGroups(documents);
+    const matchedMethods = [...methodGroups.values()]
+        .filter((group) => group.invocations.length > 0 && group.handlers.length > 0)
+        .sort(compareMethodKeys);
+    const unhandledInvocations = [...methodGroups.values()]
+        .filter((group) => group.invocations.length > 0 && group.handlers.length === 0)
+        .map(({ target, channel, method, invocations }) => ({
+        target,
+        channel,
+        method,
+        invocations,
+    }))
+        .sort(compareMethodKeys);
+    const handlersWithoutInvocations = [...methodGroups.values()]
+        .filter((group) => group.handlers.length > 0 && group.invocations.length === 0)
+        .map(({ target, channel, method, handlers }) => ({
+        target,
+        channel,
+        method,
+        handlers,
+    }))
+        .sort(compareMethodKeys);
+    return {
+        matchedChannels,
+        unregisteredChannelCreations,
+        matchedMethods,
+        unhandledInvocations,
+        handlersWithoutInvocations,
+        limitations,
+    };
+}
+/** 사실별 target이 없는 혼합 문서인지 확인한다. */
+function hasMixedTargets(document) {
+    return document.limitations.some((message) => message.startsWith('mixed-targets:'));
+}
+/** 안전하게 조인을 보류하면서 입력 한계만 전달한다. */
+function emptyJoinResult(limitations) {
+    return {
+        matchedChannels: [],
+        unregisteredChannelCreations: [],
+        matchedMethods: [],
+        unhandledInvocations: [],
+        handlersWithoutInvocations: [],
+        limitations,
+    };
+}
+/** 입력 limitation에 생산 플랫폼과 도구 이름을 붙여 정렬한다. */
+function collectLimitations(documents) {
+    const limitations = documents.flatMap((document) => document.limitations.map((message) => ({
+        platform: document.platform,
+        tool: document.tool.name,
+        message,
+    })));
+    const freshness = freshnessLimitation(documents);
+    if (freshness !== undefined)
+        limitations.push(freshness);
+    return limitations.sort(compareLimitations);
+}
+/** 생성 시각 차이가 하루를 넘을 때 교차 입력 한계를 만든다. */
+function freshnessLimitation(documents) {
+    if (documents.length < 2)
+        return undefined;
+    const timestamps = documents.map((document) => Date.parse(document.generatedAt));
+    const difference = Math.max(...timestamps) - Math.min(...timestamps);
+    if (difference <= millisecondsPerDay)
+        return undefined;
+    const hours = Math.round(difference / millisecondsPerHour);
+    return {
+        platform: 'cross-platform',
+        tool: 'isthmus',
+        message: `input-freshness: bridge documents differ by ${hours} hours`,
+    };
+}
+/** limitation을 플랫폼·도구·문장 순으로 고정한다. */
+function compareLimitations(left, right) {
+    return (compareStrings(left.platform, right.platform) ||
+        compareStrings(left.tool, right.tool) ||
+        compareStrings(left.message, right.message));
+}
+/** 메서드 키별로 호출과 핸들러 증거를 모은다. */
+function collectMethodGroups(documents) {
+    const groups = new Map();
+    for (const document of documents)
+        collectDocumentMethods(document, groups);
+    for (const group of groups.values()) {
+        sortUniqueEndpoints(group.invocations);
+        sortUniqueEndpoints(group.handlers);
+    }
+    return groups;
+}
+/** 증거 위치와 심볼을 정렬하고 같은 증거를 한 번만 남긴다. */
+function sortUniqueEndpoints(endpoints) {
+    endpoints.sort(compareEndpoints);
+    let previous;
+    const unique = endpoints.filter((endpoint) => {
+        const isDuplicate = previous !== undefined && compareEndpoints(previous, endpoint) === 0;
+        previous = endpoint;
+        return !isDuplicate;
+    });
+    endpoints.splice(0, endpoints.length, ...unique);
+}
+/** 증거 위치와 선택 심볼을 완전한 결정 순서로 비교한다. */
+function compareEndpoints(left, right) {
+    const locationOrder = compareStrings(left.platform, right.platform) ||
+        compareStrings(left.location.path, right.location.path) ||
+        left.location.line - right.location.line ||
+        left.location.column - right.location.column;
+    if (locationOrder !== 0)
+        return locationOrder;
+    if (left.symbol === undefined)
+        return right.symbol === undefined ? 0 : 1;
+    if (right.symbol === undefined)
+        return -1;
+    return (compareStrings(left.symbol.qualifiedName, right.symbol.qualifiedName) ||
+        compareOptionalStrings(left.symbol.usr, right.symbol.usr));
+}
+/** 존재하는 선택 문자열을 없는 값보다 먼저 두고 비교한다. */
+function compareOptionalStrings(left, right) {
+    if (left === undefined)
+        return right === undefined ? 0 : 1;
+    if (right === undefined)
+        return -1;
+    return compareStrings(left, right);
+}
+/** 문서 하나의 정적 메서드 사실을 그룹에 추가한다. */
+function collectDocumentMethods(document, groups) {
+    if (document.target === null)
+        return;
+    for (const fact of document.facts) {
+        if (!isStaticMethodFact(fact))
+            continue;
+        const key = `${document.target}\u0000${fact.channel}\u0000${fact.method}`;
+        const group = groups.get(key) ?? createMethodGroup(document.target, fact.channel, fact.method);
+        const endpoints = fact.kind === 'method-invoke' ? group.invocations : group.handlers;
+        endpoints.push(toEndpoint(document.platform, fact));
+        groups.set(key, group);
+    }
+}
+/** 조인 가능한 정적 메서드 호출·핸들러 사실인지 확인한다. */
+function isStaticMethodFact(fact) {
+    return ((fact.kind === 'method-invoke' || fact.kind === 'method-handle') &&
+        !fact.dynamic &&
+        fact.channel !== null &&
+        fact.method !== undefined);
+}
+/** 빈 메서드 그룹을 만든다. */
+function createMethodGroup(target, channel, method) {
+    return { target, channel, method, invocations: [], handlers: [] };
+}
+/** 채널 키별로 생성과 등록 증거를 모은다. */
+function collectChannelGroups(documents) {
+    const groups = new Map();
+    for (const document of documents)
+        collectDocumentChannels(document, groups);
+    for (const group of groups.values()) {
+        sortUniqueEndpoints(group.creations);
+        sortUniqueEndpoints(group.registrations);
+    }
+    return groups;
+}
+/** 문서 하나의 정적 채널 사실을 그룹에 추가한다. */
+function collectDocumentChannels(document, groups) {
+    if (document.target === null)
+        return;
+    for (const fact of document.facts) {
+        if (!isStaticChannelFact(fact))
+            continue;
+        const key = `${document.target}\u0000${fact.channel}`;
+        const group = groups.get(key) ?? createChannelGroup(document.target, fact.channel);
+        const endpoints = fact.kind === 'channel-create' ? group.creations : group.registrations;
+        endpoints.push(toEndpoint(document.platform, fact));
+        groups.set(key, group);
+    }
+}
+/** 조인 가능한 정적 채널 생성·등록 사실인지 확인한다. */
+function isStaticChannelFact(fact) {
+    return ((fact.kind === 'channel-create' || fact.kind === 'channel-register') &&
+        !fact.dynamic &&
+        fact.channel !== null);
+}
+/** 빈 채널 그룹을 만든다. */
+function createChannelGroup(target, channel) {
+    return { target, channel, creations: [], registrations: [] };
+}
+/** 사실을 플랫폼이 포함된 증거 위치로 바꾼다. */
+function toEndpoint(platform, fact) {
+    return fact.symbol === undefined
+        ? { platform, location: fact.location }
+        : { platform, location: fact.location, symbol: fact.symbol };
+}
+/** 채널 결과를 target과 이름 순으로 고정한다. */
+function compareChannels(left, right) {
+    return (compareStrings(left.target, right.target) ||
+        compareStrings(left.channel, right.channel));
+}
+/** 메서드 결과를 target·채널·메서드 순으로 고정한다. */
+function compareMethodKeys(left, right) {
+    return (compareStrings(left.target, right.target) ||
+        compareStrings(left.channel, right.channel) ||
+        compareStrings(left.method, right.method));
+}
+const millisecondsPerHour = 60 * 60 * 1_000;
+const millisecondsPerDay = 24 * millisecondsPerHour;
+//# sourceMappingURL=join.js.map

package/dist/join/join.js.map

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

package/dist/report/check-report.d.ts

@@ -0,0 +1,32 @@
+import type { BridgeTarget } from '../exchange/parse.ts';
+import type { BridgeEndpoint, BridgeJoinResult, JoinLimitation } from '../join/join.ts';
+/** check 결과 개수를 빠르게 판단할 요약이다. */
+export interface CheckSummary {
+    readonly errors: number;
+    readonly warnings: number;
+    readonly matchedChannels: number;
+    readonly matchedMethods: number;
+}
+/** check가 보고하는 안정적인 진단 종류다. */
+export type CheckIssueCode = 'unhandled-invocation' | 'unregistered-channel-creation' | 'handler-without-invocation';
+/** 삭제 판정 없이 경계 불일치 사실과 증거만 전달한다. */
+export interface CheckIssue {
+    readonly severity: 'error' | 'warning';
+    readonly code: CheckIssueCode;
+    readonly target: BridgeTarget;
+    readonly channel: string;
+    readonly method?: string;
+    readonly evidence: readonly BridgeEndpoint[];
+}
+/** 에이전트와 CI가 소비할 check 문서다. */
+export interface CheckReport {
+    readonly format: 'isthmus-check';
+    readonly version: 1;
+    readonly summary: CheckSummary;
+    readonly issues: readonly CheckIssue[];
+    readonly limitations: readonly JoinLimitation[];
+}
+/** check 문서를 결정적인 JSON 문자열로 인코딩한다. */
+export declare function encodeCheckReport(report: CheckReport): string;
+/** 조인 결과를 정책 심각도가 포함된 check 문서로 바꾼다. */
+export declare function createCheckReport(joined: BridgeJoinResult): CheckReport;

package/dist/report/check-report.js

@@ -0,0 +1,46 @@
+import { encodeSortedJson } from "./sorted-json.js";
+/** check 문서를 결정적인 JSON 문자열로 인코딩한다. */
+export function encodeCheckReport(report) {
+    return encodeSortedJson(report);
+}
+/** 조인 결과를 정책 심각도가 포함된 check 문서로 바꾼다. */
+export function createCheckReport(joined) {
+    return {
+        format: 'isthmus-check',
+        version: 1,
+        summary: {
+            errors: joined.unhandledInvocations.length +
+                joined.unregisteredChannelCreations.length,
+            warnings: joined.handlersWithoutInvocations.length,
+            matchedChannels: joined.matchedChannels.length,
+            matchedMethods: joined.matchedMethods.length,
+        },
+        issues: [
+            ...joined.unhandledInvocations.map((item) => ({
+                severity: 'error',
+                code: 'unhandled-invocation',
+                target: item.target,
+                channel: item.channel,
+                method: item.method,
+                evidence: item.invocations,
+            })),
+            ...joined.unregisteredChannelCreations.map((item) => ({
+                severity: 'error',
+                code: 'unregistered-channel-creation',
+                target: item.target,
+                channel: item.channel,
+                evidence: item.creations,
+            })),
+            ...joined.handlersWithoutInvocations.map((item) => ({
+                severity: 'warning',
+                code: 'handler-without-invocation',
+                target: item.target,
+                channel: item.channel,
+                method: item.method,
+                evidence: item.handlers,
+            })),
+        ],
+        limitations: joined.limitations,
+    };
+}
+//# sourceMappingURL=check-report.js.map

package/dist/report/check-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-report.js","sourceRoot":"","sources":["../../src/report/check-report.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAmCpD,sCAAsC;AACtC,MAAM,UAAU,iBAAiB,CAAC,MAAmB;IACnD,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,iBAAiB,CAAC,MAAwB;IACxD,OAAO;QACL,MAAM,EAAE,eAAe;QACvB,OAAO,EAAE,CAAC;QACV,OAAO,EAAE;YACP,MAAM,EACJ,MAAM,CAAC,oBAAoB,CAAC,MAAM;gBAClC,MAAM,CAAC,4BAA4B,CAAC,MAAM;YAC5C,QAAQ,EAAE,MAAM,CAAC,0BAA0B,CAAC,MAAM;YAClD,eAAe,EAAE,MAAM,CAAC,eAAe,CAAC,MAAM;YAC9C,cAAc,EAAE,MAAM,CAAC,cAAc,CAAC,MAAM;SAC7C;QACD,MAAM,EAAE;YACN,GAAG,MAAM,CAAC,oBAAoB,CAAC,GAAG,CAAa,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBACxD,QAAQ,EAAE,OAAO;gBACjB,IAAI,EAAE,sBAAsB;gBAC5B,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,QAAQ,EAAE,IAAI,CAAC,WAAW;aAC3B,CAAC,CAAC;YACH,GAAG,MAAM,CAAC,4BAA4B,CAAC,GAAG,CAAa,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAChE,QAAQ,EAAE,OAAO;gBACjB,IAAI,EAAE,+BAA+B;gBACrC,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,QAAQ,EAAE,IAAI,CAAC,SAAS;aACzB,CAAC,CAAC;YACH,GAAG,MAAM,CAAC,0BAA0B,CAAC,GAAG,CAAa,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC9D,QAAQ,EAAE,SAAS;gBACnB,IAAI,EAAE,4BAA4B;gBAClC,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;aACxB,CAAC,CAAC;SACJ;QACD,WAAW,EAAE,MAAM,CAAC,WAAW;KAChC,CAAC;AACJ,CAAC"}

package/dist/report/graph.d.ts

@@ -0,0 +1,30 @@
+import type { BridgeLocation, BridgePlatform, BridgeSymbol, BridgeTarget } from '../exchange/parse.ts';
+import type { BridgeJoinResult, JoinLimitation } from '../join/join.ts';
+/** 소스 위치 하나를 나타내는 경계 그래프 노드다. */
+export interface BridgeGraphNode {
+    readonly id: string;
+    readonly platform: BridgePlatform;
+    readonly location: BridgeLocation;
+    readonly symbol?: BridgeSymbol;
+}
+/** 호출 측 위치에서 수신 측 위치로 향하는 경계 간선이다. */
+export interface BridgeGraphEdge {
+    readonly from: string;
+    readonly to: string;
+    readonly kind: 'channel' | 'method';
+    readonly target: BridgeTarget;
+    readonly channel: string;
+    readonly method?: string;
+}
+/** 매치된 경계 간선만 담는 그래프 문서다. */
+export interface BridgeGraphDocument {
+    readonly format: 'isthmus-graph';
+    readonly version: 1;
+    readonly nodes: readonly BridgeGraphNode[];
+    readonly edges: readonly BridgeGraphEdge[];
+    readonly limitations: readonly JoinLimitation[];
+}
+/** 경계 그래프를 요청한 출력 형식으로 렌더링한다. */
+export declare function renderBridgeGraph(graph: BridgeGraphDocument, format: 'json' | 'dot' | 'mermaid'): string;
+/** 조인 결과의 매치만 경계 그래프로 바꾼다. */
+export declare function createBridgeGraph(joined: BridgeJoinResult): BridgeGraphDocument;