isthmus-cli 0.1.0

package/dist/report/graph.js

@@ -0,0 +1,143 @@
+import { compareStrings } from "../compare.js";
+import { encodeSortedJson } from "./sorted-json.js";
+/** 경계 그래프를 요청한 출력 형식으로 렌더링한다. */
+export function renderBridgeGraph(graph, format) {
+    if (format === 'json')
+        return encodeSortedJson(graph);
+    if (format === 'dot')
+        return renderDot(graph);
+    return renderMermaid(graph);
+}
+/** Mermaid flowchart 문법으로 경계 그래프를 렌더링한다. */
+function renderMermaid(graph) {
+    const identifiers = new Map(graph.nodes.map((node, index) => [node.id, `n${index}`]));
+    const lines = ['flowchart LR'];
+    for (const node of graph.nodes) {
+        const label = `${mermaidText(node.platform)}<br/>${mermaidText(locationLabel(node.location))}`;
+        lines.push(`  ${identifiers.get(node.id)}["${label}"]`);
+    }
+    for (const edge of graph.edges) {
+        const from = identifiers.get(edge.from);
+        const to = identifiers.get(edge.to);
+        lines.push(`  ${from} -->|"${mermaidText(edgeLabel(edge))}"| ${to}`);
+    }
+    return `${lines.join('\n')}\n`;
+}
+/** Mermaid 인용 라벨에서 제어 문자를 HTML 엔터티로 바꾼다. */
+function mermaidText(value) {
+    return value
+        .replaceAll('&', '&amp;')
+        .replaceAll('"', '&quot;')
+        .replaceAll('<', '&lt;')
+        .replaceAll('>', '&gt;')
+        .replaceAll('|', '&#124;')
+        .replaceAll('\r', '&#13;')
+        .replaceAll('\n', '&#10;');
+}
+/** Graphviz DOT 문법으로 경계 그래프를 렌더링한다. */
+function renderDot(graph) {
+    const lines = ['digraph isthmus {', '  rankdir=LR;'];
+    for (const node of graph.nodes) {
+        const label = `${node.platform}\n${locationLabel(node.location)}`;
+        lines.push(`  ${dotString(node.id)} [label=${dotString(label)}];`);
+    }
+    for (const edge of graph.edges) {
+        lines.push(`  ${dotString(edge.from)} -> ${dotString(edge.to)} `
+            + `[label=${dotString(edgeLabel(edge))}];`);
+    }
+    lines.push('}');
+    return `${lines.join('\n')}\n`;
+}
+/** DOT 문자열 리터럴로 안전하게 이스케이프한다. */
+function dotString(value) {
+    return JSON.stringify(value);
+}
+/** 위치를 사람이 읽을 수 있는 경로:줄:열로 만든다. */
+function locationLabel(location) {
+    return `${location.path}:${location.line}:${location.column}`;
+}
+/** 간선 종류와 문자열 키를 한 줄 라벨로 만든다. */
+function edgeLabel(edge) {
+    const key = edge.method === undefined
+        ? edge.channel
+        : `${edge.channel}#${edge.method}`;
+    return `${edge.kind} ${key}`;
+}
+/** 조인 결과의 매치만 경계 그래프로 바꾼다. */
+export function createBridgeGraph(joined) {
+    const nodes = new Map();
+    const edges = [];
+    addChannelEdges(joined, nodes, edges);
+    addMethodEdges(joined, nodes, edges);
+    return {
+        format: 'isthmus-graph',
+        version: 1,
+        nodes: [...nodes.values()].sort((left, right) => compareStrings(left.id, right.id)),
+        edges: edges.sort(compareEdges),
+        limitations: joined.limitations,
+    };
+}
+/** 매치된 채널의 생성→등록 간선을 추가한다. */
+function addChannelEdges(joined, nodes, edges) {
+    for (const match of joined.matchedChannels) {
+        for (const creation of match.creations) {
+            for (const registration of match.registrations) {
+                const from = addNode(nodes, creation);
+                const to = addNode(nodes, registration);
+                edges.push({
+                    from,
+                    to,
+                    kind: 'channel',
+                    target: match.target,
+                    channel: match.channel,
+                });
+            }
+        }
+    }
+}
+/** 매치된 메서드의 호출→핸들러 간선을 추가한다. */
+function addMethodEdges(joined, nodes, edges) {
+    for (const match of joined.matchedMethods) {
+        for (const invocation of match.invocations) {
+            for (const handler of match.handlers) {
+                const from = addNode(nodes, invocation);
+                const to = addNode(nodes, handler);
+                edges.push({
+                    from,
+                    to,
+                    kind: 'method',
+                    target: match.target,
+                    channel: match.channel,
+                    method: match.method,
+                });
+            }
+        }
+    }
+}
+/** 증거 위치를 그래프 노드로 추가하고 안정 ID를 돌려준다. */
+function addNode(nodes, endpoint) {
+    const id = endpointId(endpoint);
+    if (!nodes.has(id)) {
+        nodes.set(id, endpoint.symbol === undefined
+            ? { id, platform: endpoint.platform, location: endpoint.location }
+            : {
+                id,
+                platform: endpoint.platform,
+                location: endpoint.location,
+                symbol: endpoint.symbol,
+            });
+    }
+    return id;
+}
+/** 플랫폼과 소스 위치로 실행 간 안정적인 노드 ID를 만든다. */
+function endpointId(endpoint) {
+    const { path, line, column } = endpoint.location;
+    return `${endpoint.platform}:${path}:${line}:${column}`;
+}
+/** 간선을 종류·from·to 순으로 고정한다. */
+function compareEdges(left, right) {
+    return (compareStrings(left.kind, right.kind) ||
+        compareStrings(left.from, right.from) ||
+        compareStrings(left.to, right.to));
+}
+//# sourceMappingURL=graph.js.map

package/dist/report/graph.js.map

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

package/dist/report/query.d.ts

@@ -0,0 +1,28 @@
+import type { BridgeEndpoint, BridgeJoinResult, JoinLimitation } from '../join/join.ts';
+/** query가 식별한 채널 또는 메서드 키다. */
+export interface BridgeQuerySubject {
+    readonly name: string;
+    readonly qualifiedName: string;
+    readonly kind: 'channel' | 'method';
+}
+/** 한 브리지 키에서 본 호출 측과 수신 측 증거다. */
+export interface BridgeQueryResult {
+    readonly subject: BridgeQuerySubject;
+    readonly usedBy: readonly BridgeEndpoint[];
+    readonly dependsOn: readonly BridgeEndpoint[];
+}
+/** cartograph query와 같은 상태 외피를 쓰는 브리지 질의 문서다. */
+export interface BridgeQueryDocument {
+    readonly status: 'found' | 'ambiguous' | 'notFound';
+    readonly requested: string;
+    readonly level: 'bridge';
+    readonly limitations: readonly JoinLimitation[];
+    readonly result?: BridgeQueryResult;
+    readonly candidates?: ReadonlyArray<{
+        readonly qualifiedName: string;
+    }>;
+}
+/** query 문서를 결정적인 JSON 문자열로 인코딩한다. */
+export declare function encodeBridgeQuery(document: BridgeQueryDocument): string;
+/** 조인된 브리지에서 채널 또는 메서드 문자열을 질의한다. */
+export declare function createBridgeQuery(joined: BridgeJoinResult, requested: string): BridgeQueryDocument;

package/dist/report/query.js

@@ -0,0 +1,112 @@
+import { compareStrings } from "../compare.js";
+import { encodeSortedJson } from "./sorted-json.js";
+/** query 문서를 결정적인 JSON 문자열로 인코딩한다. */
+export function encodeBridgeQuery(document) {
+    return encodeSortedJson(document);
+}
+/** 조인된 브리지에서 채널 또는 메서드 문자열을 질의한다. */
+export function createBridgeQuery(joined, requested) {
+    const channels = channelResults(joined, requested);
+    if (channels.length > 1) {
+        return ambiguousQuery(joined, requested, channels);
+    }
+    const channel = channels[0];
+    if (channel !== undefined) {
+        return {
+            status: 'found',
+            requested,
+            level: 'bridge',
+            limitations: joined.limitations,
+            result: channel,
+        };
+    }
+    const methods = methodResults(joined, requested);
+    if (methods.length > 1) {
+        return ambiguousQuery(joined, requested, methods);
+    }
+    const method = methods[0];
+    if (method !== undefined) {
+        return {
+            status: 'found',
+            requested,
+            level: 'bridge',
+            limitations: joined.limitations,
+            result: method,
+        };
+    }
+    return {
+        status: 'notFound',
+        requested,
+        level: 'bridge',
+        limitations: joined.limitations,
+    };
+}
+/** 여러 논리 키가 같은 요청과 맞을 때 선택 가능한 정규화 이름을 돌려준다. */
+function ambiguousQuery(joined, requested, results) {
+    return {
+        status: 'ambiguous',
+        requested,
+        level: 'bridge',
+        limitations: joined.limitations,
+        candidates: results
+            .map(({ subject }) => ({ qualifiedName: subject.qualifiedName }))
+            .sort((left, right) => compareStrings(left.qualifiedName, right.qualifiedName)),
+    };
+}
+/** 요청 문자열과 정확히 같은 논리 메서드 결과를 만든다. */
+function methodResults(joined, requested) {
+    const matched = joined.matchedMethods
+        .map(({ target, channel, method, invocations, handlers }) => makeMethodResult(target, channel, method, invocations, handlers))
+        .filter((result) => matchesRequested(result, requested));
+    const unhandled = joined.unhandledInvocations
+        .map(({ target, channel, method, invocations }) => makeMethodResult(target, channel, method, invocations, []))
+        .filter((result) => matchesRequested(result, requested));
+    const handlers = joined.handlersWithoutInvocations
+        .map(({ target, channel, method, handlers }) => makeMethodResult(target, channel, method, [], handlers))
+        .filter((result) => matchesRequested(result, requested));
+    return [...matched, ...unhandled, ...handlers];
+}
+/** 메서드 키와 양쪽 증거를 query result로 바꾼다. */
+function makeMethodResult(target, channel, method, usedBy, dependsOn) {
+    return {
+        subject: {
+            name: method,
+            qualifiedName: `${target}:${encodeSubjectComponent(channel)}#${encodeSubjectComponent(method)}`,
+            kind: 'method',
+        },
+        usedBy,
+        dependsOn,
+    };
+}
+/** 요청 문자열과 정확히 같은 논리 채널 결과를 만든다. */
+function channelResults(joined, requested) {
+    const matched = joined.matchedChannels
+        .map(({ target, channel, creations, registrations }) => makeQueryResult(target, channel, 'channel', creations, registrations))
+        .filter((result) => matchesRequested(result, requested));
+    const unregistered = joined.unregisteredChannelCreations
+        .map(({ target, channel, creations }) => makeQueryResult(target, channel, 'channel', creations, []))
+        .filter((result) => matchesRequested(result, requested));
+    return [...matched, ...unregistered];
+}
+/** 짧은 이름 또는 모호성 해소용 qualifiedName과 정확히 일치하는지 확인한다. */
+function matchesRequested(result, requested) {
+    return (result.subject.name === requested ||
+        result.subject.qualifiedName === requested);
+}
+/** 조인 키와 양쪽 증거를 query result 골격으로 바꾼다. */
+function makeQueryResult(target, name, kind, usedBy, dependsOn) {
+    return {
+        subject: {
+            name,
+            qualifiedName: `${target}:${encodeSubjectComponent(name)}`,
+            kind,
+        },
+        usedBy,
+        dependsOn,
+    };
+}
+/** qualifiedName 구분자와 이스케이프 문자를 가역적인 퍼센트 표기로 바꾼다. */
+function encodeSubjectComponent(value) {
+    return value.replaceAll('%', '%25').replaceAll('#', '%23');
+}
+//# sourceMappingURL=query.js.map

package/dist/report/query.js.map

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

package/dist/report/retentions.d.ts

@@ -0,0 +1,39 @@
+import type { BridgePlatform, BridgeSymbol } from '../exchange/parse.ts';
+import type { BridgeJoinResult } from '../join/join.ts';
+/** cartograph가 보존할 Swift 선언 식별자다. */
+export interface RetentionSymbol extends BridgeSymbol {
+    readonly usr?: string;
+}
+/** 언어 경계 너머 호출자의 증거 위치다. */
+export interface RetentionCaller {
+    readonly platform: BridgePlatform;
+    readonly path: string;
+    readonly line: number;
+}
+/** 보존 판단을 설명할 채널·메서드·호출자 근거다. */
+export interface RetentionEvidence {
+    readonly channel: string;
+    readonly method: string;
+    readonly caller: RetentionCaller;
+}
+/** cartograph 외부 보존 근거 하나다. */
+export interface ExternalRetention {
+    readonly symbol: RetentionSymbol;
+    readonly reason: 'bridge';
+    readonly evidence: RetentionEvidence;
+}
+/** cartograph가 읽는 external-retentions 버전 0 문서다. */
+export interface CartographRetentionsDocument {
+    readonly format: 'external-retentions';
+    readonly version: 0;
+    readonly producedBy: Readonly<{
+        name: 'isthmus';
+        version: string;
+    }>;
+    readonly generatedAt: string;
+    readonly retentions: readonly ExternalRetention[];
+}
+/** cartograph 보존 문서를 결정적인 JSON으로 인코딩한다. */
+export declare function encodeCartographRetentionsDocument(document: CartographRetentionsDocument): string;
+/** 매치된 브리지 메서드를 cartograph 보존 근거로 바꾼다. */
+export declare function createCartographRetentionsDocument(joined: BridgeJoinResult, generatedAt: string, producerVersion: string): CartographRetentionsDocument;

package/dist/report/retentions.js

@@ -0,0 +1,49 @@
+import { encodeSortedJson } from "./sorted-json.js";
+/** cartograph 보존 문서를 결정적인 JSON으로 인코딩한다. */
+export function encodeCartographRetentionsDocument(document) {
+    return encodeSortedJson(document);
+}
+/** 매치된 브리지 메서드를 cartograph 보존 근거로 바꾼다. */
+export function createCartographRetentionsDocument(joined, generatedAt, producerVersion) {
+    return {
+        format: 'external-retentions',
+        version: 0,
+        producedBy: { name: 'isthmus', version: producerVersion },
+        generatedAt,
+        retentions: collectCartographRetentions(joined),
+    };
+}
+/** 매치별 Dart 호출자와 Swift 심볼을 cartograph 근거로 결합한다. */
+function collectCartographRetentions(joined) {
+    const retentions = [];
+    const seen = new Set();
+    for (const method of joined.matchedMethods) {
+        const caller = method.invocations[0];
+        if (caller === undefined)
+            continue;
+        for (const handler of method.handlers) {
+            if (handler.platform !== 'swift' || handler.symbol === undefined)
+                continue;
+            const symbolKey = handler.symbol.usr ?? `name:${handler.symbol.qualifiedName}`;
+            const retentionKey = `${symbolKey}\u0000${method.channel}\u0000${method.method}`;
+            if (seen.has(retentionKey))
+                continue;
+            seen.add(retentionKey);
+            retentions.push({
+                symbol: handler.symbol,
+                reason: 'bridge',
+                evidence: {
+                    channel: method.channel,
+                    method: method.method,
+                    caller: {
+                        platform: caller.platform,
+                        path: caller.location.path,
+                        line: caller.location.line,
+                    },
+                },
+            });
+        }
+    }
+    return retentions;
+}
+//# sourceMappingURL=retentions.js.map

package/dist/report/retentions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retentions.js","sourceRoot":"","sources":["../../src/report/retentions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAqCpD,2CAA2C;AAC3C,MAAM,UAAU,kCAAkC,CAChD,QAAsC;IAEtC,OAAO,gBAAgB,CAAC,QAAQ,CAAC,CAAC;AACpC,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,kCAAkC,CAChD,MAAwB,EACxB,WAAmB,EACnB,eAAuB;IAEvB,OAAO;QACL,MAAM,EAAE,qBAAqB;QAC7B,OAAO,EAAE,CAAC;QACV,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,EAAE;QACzD,WAAW;QACX,UAAU,EAAE,2BAA2B,CAAC,MAAM,CAAC;KAChD,CAAC;AACJ,CAAC;AAED,mDAAmD;AACnD,SAAS,2BAA2B,CAClC,MAAwB;IAExB,MAAM,UAAU,GAAwB,EAAE,CAAC;IAC3C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,SAAS;YAAE,SAAS;QACnC,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACtC,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;gBAAE,SAAS;YAC3E,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,QAAQ,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;YAC/E,MAAM,YAAY,GAAG,GAAG,SAAS,SAAS,MAAM,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC;YACjF,IAAI,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC;gBAAE,SAAS;YACrC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YACvB,UAAU,CAAC,IAAI,CAAC;gBACd,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,MAAM,EAAE,QAAQ;gBAChB,QAAQ,EAAE;oBACR,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,MAAM,EAAE;wBACN,QAAQ,EAAE,MAAM,CAAC,QAAQ;wBACzB,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI;wBAC1B,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI;qBAC3B;iBACF;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/report/sorted-json.d.ts

@@ -0,0 +1,2 @@
+/** JSON 객체 키를 모든 깊이에서 정렬하고 마지막 개행을 붙인다. */
+export declare function encodeSortedJson(value: unknown): string;

package/dist/report/sorted-json.js

@@ -0,0 +1,16 @@
+import { compareStrings } from "../compare.js";
+/** JSON 객체 키를 모든 깊이에서 정렬하고 마지막 개행을 붙인다. */
+export function encodeSortedJson(value) {
+    return `${JSON.stringify(sortJson(value), null, 2)}\n`;
+}
+/** JSON 배열 순서는 보존하고 객체 키만 재귀 정렬한다. */
+function sortJson(value) {
+    if (Array.isArray(value))
+        return value.map(sortJson);
+    if (typeof value !== 'object' || value === null)
+        return value;
+    return Object.fromEntries(Object.entries(value)
+        .sort(([left], [right]) => compareStrings(left, right))
+        .map(([key, item]) => [key, sortJson(item)]));
+}
+//# sourceMappingURL=sorted-json.js.map

package/dist/report/sorted-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sorted-json.js","sourceRoot":"","sources":["../../src/report/sorted-json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,2CAA2C;AAC3C,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AACzD,CAAC;AAED,sCAAsC;AACtC,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACrD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;SAClB,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;SACtD,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAC/C,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "isthmus-cli",
+  "version": "0.1.0",
+  "description": "Join bridge facts across cross-platform application boundaries.",
+  "keywords": [
+    "flutter",
+    "react-native",
+    "platform-channel",
+    "bridge",
+    "static-analysis",
+    "dead-code"
+  ],
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ictechgy/isthmus.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ictechgy/isthmus/issues"
+  },
+  "homepage": "https://github.com/ictechgy/isthmus#readme",
+  "engines": {
+    "node": ">=22.18.0"
+  },
+  "bin": {
+    "isthmus": "dist/cli/main.js"
+  },
+  "files": [
+    "dist",
+    "Skills",
+    "LICENSE",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "node scripts/run-tests.mjs",
+    "verify:cli": "npm run build && node scripts/verify-cli-contract.mjs",
+    "verify:package": "node scripts/verify-package-contract.mjs",
+    "verify": "npm run typecheck && npm test && npm run verify:cli && npm run verify:package",
+    "prepublishOnly": "npm run verify"
+  },
+  "devDependencies": {
+    "@types/node": "22.19.7",
+    "typescript": "5.9.3"
+  }
+}