isthmus-cli 0.5.0 → 0.7.0

package/dist/cli/preflight-command.js

@@ -0,0 +1,83 @@
+import { isSafeNonEmptyString } from "../exchange/parse.js";
+import { parsePreflightContext, PreflightValidationError } from "../exchange/preflight-context.js";
+import { parseBridgeRuntime, parseRuntimeExpectations, RuntimeValidationError } from "../exchange/runtime.js";
+import { MAX_DOCUMENTS_PER_JOIN } from "../join/join.js";
+import { createPreflightReport, hasPreflightBlockers, PreflightGraphError } from "../report/preflight.js";
+import { attachPreflightRuntime } from "../report/preflight-runtime.js";
+import { createPreflightExplanation, createPreflightSummary } from "../report/preflight-view.js";
+import { encodeSortedJson } from "../report/sorted-json.js";
+import { inputFailure, inputFailureResult, internalError, isJsonParseFailure, MAX_TOTAL_INPUT_TEXT_LENGTH } from "./command-support.js";
+import { parseCommandArguments } from "./parse-arguments.js";
+import { RuntimeInputError, RuntimeJsonReader } from "./runtime-json-reader.js";
+/** 같은 실행 문맥의 언어별 영향 결과를 연결해 사람이거나 AI인 소비자에게 전달한다. */
+export async function runPreflightCommand(arguments_, readTextFile) {
+    const parsed = parseCommandArguments(arguments_.slice(1), ['--revision', '--expectations', '--limit', '--explain'], ['--strict', '--compact', '--summary']);
+    const revision = parsed?.valueFlags.get('--revision');
+    const expectedPath = parsed?.valueFlags.get('--expectations');
+    const summaryRequested = parsed?.booleanFlags.has('--summary') ?? false;
+    const explainSelector = parsed?.valueFlags.get('--explain');
+    const limitText = parsed?.valueFlags.get('--limit');
+    const limit = limitText === undefined ? undefined : Number(limitText);
+    if (parsed === undefined || parsed.positionals.length < 1 || parsed.positionals.length > MAX_DOCUMENTS_PER_JOIN + 1 ||
+        (expectedPath === undefined && parsed.positionals.length !== 1) ||
+        (revision !== undefined && !isSafeNonEmptyString(revision)) ||
+        (summaryRequested && explainSelector !== undefined) || (!summaryRequested && limitText !== undefined) ||
+        (limitText !== undefined && (!Number.isSafeInteger(limit) || limit < 1 || limit > 100))) {
+        return { standardOutput: '', standardError: `${preflightUsage}\n`, exitCode: 64 };
+    }
+    let text;
+    try {
+        text = await readTextFile(parsed.positionals[0]);
+    }
+    catch {
+        return inputFailure('Unable to read preflight context; check that the file exists and is readable.\n');
+    }
+    if (text.length > MAX_TOTAL_INPUT_TEXT_LENGTH)
+        return inputFailure('Preflight context exceeds the input size limit.\n');
+    let value;
+    try {
+        value = JSON.parse(text);
+    }
+    catch (error) {
+        return isJsonParseFailure(error) ? inputFailure('Preflight context is not valid JSON.\n') : internalError();
+    }
+    try {
+        const context = parsePreflightContext(value);
+        let report = createPreflightReport(revision === undefined || revision === context.revision ? context : {
+            ...context, limitations: [...context.limitations, 'stale-preflight-context: capture revision differs from the requested revision'],
+        });
+        if (expectedPath !== undefined) {
+            const reader = new RuntimeJsonReader(readTextFile, text.length);
+            const expectations = parseRuntimeExpectations(await reader.read(expectedPath));
+            const documents = [];
+            for (const path of parsed.positionals.slice(1))
+                documents.push(parseBridgeRuntime(await reader.read(path)));
+            report = attachPreflightRuntime(context, report, expectations, documents);
+        }
+        const blocked = parsed.booleanFlags.has('--strict') && hasPreflightBlockers(report);
+        const view = summaryRequested
+            ? createPreflightSummary(report, limit ?? 20)
+            : explainSelector === undefined ? report : createPreflightExplanation(report, explainSelector);
+        const viewStatus = explainSelector === undefined ? 'found' : view.status;
+        const statusHint = explainSelector === undefined || viewStatus === 'found' ? ''
+            : viewStatus === 'ambiguous'
+                ? 'The requested preflight selector matches multiple subjects; repeat with an exact subject key or producer id.\n'
+                : 'No preflight subject matches the requested selector; query an exact subject key, producer id, or qualifiedName.\n';
+        const exitCode = viewStatus === 'found' ? blocked ? 1 : 0 : 64;
+        return { standardOutput: encodeSortedJson(view, parsed.booleanFlags.has('--compact')),
+            standardError: viewStatus === 'found' && blocked
+                ? 'Cross-language preflight requires review: errors, evidence gaps, or unobserved selections remain.\n'
+                : statusHint, exitCode };
+    }
+    catch (error) {
+        if (error instanceof PreflightValidationError || error instanceof PreflightGraphError ||
+            error instanceof RuntimeValidationError || error instanceof RuntimeInputError) {
+            return inputFailure(`Preflight context violates its contract: ${error.message}\n`);
+        }
+        return inputFailureResult(error) ?? internalError();
+    }
+}
+/** 입력 생성은 producer workflow가 맡으며 CLI는 JSON만 읽는다. */
+export const preflightUsage = 'Usage: isthmus preflight <context.json> [<runtime.json> ...] '
+    + '[--expectations <checks.json>] [--revision <revision>] [--summary [--limit <1..100>] | --explain <selector>] [--strict] [--compact]';
+//# sourceMappingURL=preflight-command.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preflight-command.js","sourceRoot":"","sources":["../../src/cli/preflight-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AACnG,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAC9G,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC1G,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACjG,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAExI,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAEhF,qDAAqD;AACrD,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,UAA6B,EAAE,YAA0B;IACjG,MAAM,MAAM,GAAG,qBAAqB,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,WAAW,CAAC,EAAE,CAAC,UAAU,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;IAC5J,MAAM,QAAQ,GAAG,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACtD,MAAM,YAAY,GAAG,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC9D,MAAM,gBAAgB,GAAG,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC;IACxE,MAAM,eAAe,GAAG,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC5D,MAAM,SAAS,GAAG,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACtE,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,sBAAsB,GAAG,CAAC;QACjH,CAAC,YAAY,KAAK,SAAS,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,CAAC;QAC/D,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;QAC3D,CAAC,gBAAgB,IAAI,eAAe,KAAK,SAAS,CAAC,IAAI,CAAC,CAAC,gBAAgB,IAAI,SAAS,KAAK,SAAS,CAAC;QACrG,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAM,GAAG,CAAC,IAAI,KAAM,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC;QAC5F,OAAO,EAAE,cAAc,EAAE,EAAE,EAAE,aAAa,EAAE,GAAG,cAAc,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IACpF,CAAC;IACD,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QAAC,IAAI,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC,CAAC;IAAC,CAAC;IAC1D,MAAM,CAAC;QAAC,OAAO,YAAY,CAAC,iFAAiF,CAAC,CAAC;IAAC,CAAC;IACjH,IAAI,IAAI,CAAC,MAAM,GAAG,2BAA2B;QAAE,OAAO,YAAY,CAAC,mDAAmD,CAAC,CAAC;IACxH,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAAC,CAAC;IACjC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,wCAAwC,CAAC,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IAC9G,CAAC;IACD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;QAC7C,IAAI,MAAM,GAAG,qBAAqB,CAAC,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;YACrG,GAAG,OAAO,EAAE,WAAW,EAAE,CAAC,GAAG,OAAO,CAAC,WAAW,EAAE,+EAA+E,CAAC;SACnI,CAAC,CAAC;QACH,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAAC,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YAChE,MAAM,YAAY,GAAG,wBAAwB,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;YAC/E,MAAM,SAAS,GAAG,EAAE,CAAC;YACrB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;gBAAE,SAAS,CAAC,IAAI,CAAC,kBAAkB,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC5G,MAAM,GAAG,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC;QAC5E,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,oBAAoB,CAAC,MAAM,CAAC,CAAC;QACpF,MAAM,IAAI,GAAG,gBAAgB;YAC3B,CAAC,CAAC,sBAAsB,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC;YAC7C,CAAC,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,0BAA0B,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;QACjG,MAAM,UAAU,GAAG,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;QACzE,MAAM,UAAU,GAAG,eAAe,KAAK,SAAS,IAAI,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE;YAC7E,CAAC,CAAC,UAAU,KAAK,WAAW;gBAC1B,CAAC,CAAC,gHAAgH;gBAClH,CAAC,CAAC,mHAAmH,CAAC;QAC1H,MAAM,QAAQ,GAAG,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,OAAO,EAAE,cAAc,EAAE,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YACnF,aAAa,EAAE,UAAU,KAAK,OAAO,IAAI,OAAO;gBAC9C,CAAC,CAAC,qGAAqG;gBACvG,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,wBAAwB,IAAI,KAAK,YAAY,mBAAmB;YACnF,KAAK,YAAY,sBAAsB,IAAI,KAAK,YAAY,iBAAiB,EAAE,CAAC;YAChF,OAAO,YAAY,CAAC,4CAA4C,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;QACrF,CAAC;QACD,OAAO,kBAAkB,CAAC,KAAK,CAAC,IAAI,aAAa,EAAE,CAAC;IACtD,CAAC;AACH,CAAC;AAED,oDAAoD;AACpD,MAAM,CAAC,MAAM,cAAc,GAAG,+DAA+D;MACzF,qIAAqI,CAAC","sourcesContent":["import { isSafeNonEmptyString } from '../exchange/parse.ts';\nimport { parsePreflightContext, PreflightValidationError } from '../exchange/preflight-context.ts';\nimport { parseBridgeRuntime, parseRuntimeExpectations, RuntimeValidationError } from '../exchange/runtime.ts';\nimport { MAX_DOCUMENTS_PER_JOIN } from '../join/join.ts';\nimport { createPreflightReport, hasPreflightBlockers, PreflightGraphError } from '../report/preflight.ts';\nimport { attachPreflightRuntime } from '../report/preflight-runtime.ts';\nimport { createPreflightExplanation, createPreflightSummary } from '../report/preflight-view.ts';\nimport { encodeSortedJson } from '../report/sorted-json.ts';\nimport { inputFailure, inputFailureResult, internalError, isJsonParseFailure, MAX_TOTAL_INPUT_TEXT_LENGTH } from './command-support.ts';\nimport type { CommandResult, ReadTextFile } from './command-support.ts';\nimport { parseCommandArguments } from './parse-arguments.ts';\nimport { RuntimeInputError, RuntimeJsonReader } from './runtime-json-reader.ts';\n\n/** 같은 실행 문맥의 언어별 영향 결과를 연결해 사람이거나 AI인 소비자에게 전달한다. */\nexport async function runPreflightCommand(arguments_: readonly string[], readTextFile: ReadTextFile): Promise<CommandResult> {\n  const parsed = parseCommandArguments(arguments_.slice(1), ['--revision', '--expectations', '--limit', '--explain'], ['--strict', '--compact', '--summary']);\n  const revision = parsed?.valueFlags.get('--revision');\n  const expectedPath = parsed?.valueFlags.get('--expectations');\n  const summaryRequested = parsed?.booleanFlags.has('--summary') ?? false;\n  const explainSelector = parsed?.valueFlags.get('--explain');\n  const limitText = parsed?.valueFlags.get('--limit');\n  const limit = limitText === undefined ? undefined : Number(limitText);\n  if (parsed === undefined || parsed.positionals.length < 1 || parsed.positionals.length > MAX_DOCUMENTS_PER_JOIN + 1 ||\n    (expectedPath === undefined && parsed.positionals.length !== 1) ||\n    (revision !== undefined && !isSafeNonEmptyString(revision)) ||\n    (summaryRequested && explainSelector !== undefined) || (!summaryRequested && limitText !== undefined) ||\n    (limitText !== undefined && (!Number.isSafeInteger(limit) || limit! < 1 || limit! > 100))) {\n    return { standardOutput: '', standardError: `${preflightUsage}\\n`, exitCode: 64 };\n  }\n  let text: string;\n  try { text = await readTextFile(parsed.positionals[0]!); }\n  catch { return inputFailure('Unable to read preflight context; check that the file exists and is readable.\\n'); }\n  if (text.length > MAX_TOTAL_INPUT_TEXT_LENGTH) return inputFailure('Preflight context exceeds the input size limit.\\n');\n  let value: unknown;\n  try { value = JSON.parse(text); }\n  catch (error) {\n    return isJsonParseFailure(error) ? inputFailure('Preflight context is not valid JSON.\\n') : internalError();\n  }\n  try {\n    const context = parsePreflightContext(value);\n    let report = createPreflightReport(revision === undefined || revision === context.revision ? context : {\n      ...context, limitations: [...context.limitations, 'stale-preflight-context: capture revision differs from the requested revision'],\n    });\n    if (expectedPath !== undefined) {\n      const reader = new RuntimeJsonReader(readTextFile, text.length);\n      const expectations = parseRuntimeExpectations(await reader.read(expectedPath));\n      const documents = [];\n      for (const path of parsed.positionals.slice(1)) documents.push(parseBridgeRuntime(await reader.read(path)));\n      report = attachPreflightRuntime(context, report, expectations, documents);\n    }\n    const blocked = parsed.booleanFlags.has('--strict') && hasPreflightBlockers(report);\n    const view = summaryRequested\n      ? createPreflightSummary(report, limit ?? 20)\n      : explainSelector === undefined ? report : createPreflightExplanation(report, explainSelector);\n    const viewStatus = explainSelector === undefined ? 'found' : view.status;\n    const statusHint = explainSelector === undefined || viewStatus === 'found' ? ''\n      : viewStatus === 'ambiguous'\n        ? 'The requested preflight selector matches multiple subjects; repeat with an exact subject key or producer id.\\n'\n        : 'No preflight subject matches the requested selector; query an exact subject key, producer id, or qualifiedName.\\n';\n    const exitCode = viewStatus === 'found' ? blocked ? 1 : 0 : 64;\n    return { standardOutput: encodeSortedJson(view, parsed.booleanFlags.has('--compact')),\n      standardError: viewStatus === 'found' && blocked\n        ? 'Cross-language preflight requires review: errors, evidence gaps, or unobserved selections remain.\\n'\n        : statusHint, exitCode };\n  } catch (error) {\n    if (error instanceof PreflightValidationError || error instanceof PreflightGraphError ||\n      error instanceof RuntimeValidationError || error instanceof RuntimeInputError) {\n      return inputFailure(`Preflight context violates its contract: ${error.message}\\n`);\n    }\n    return inputFailureResult(error) ?? internalError();\n  }\n}\n\n/** 입력 생성은 producer workflow가 맡으며 CLI는 JSON만 읽는다. */\nexport const preflightUsage = 'Usage: isthmus preflight <context.json> [<runtime.json> ...] '\n  + '[--expectations <checks.json>] [--revision <revision>] [--summary [--limit <1..100>] | --explain <selector>] [--strict] [--compact]';\n"]}

package/dist/cli/query-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 { createBridgeQuery, encodeBridgeQuery } from "../report/query.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";
 /** query 인자를 실행해 bridge 질의 JSON과 종료 코드를 반환한다. */
 export async function runQueryCommand(arguments_, readTextFile) {
@@ -16,12 +17,18 @@ export async function runQueryCommand(arguments_, readTextFile) {
         return queryUsageError();
     }
     try {
-        const documents = await readBridgeDocuments(inputPaths, readTextFile);
-        const joined = joinBridgeDocuments(documents);
+        const { bridges, messages } = await readBridgeInputs(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 query = createBridgeQuery(joined, requested);
+        const messageJoin = messages.length > 0
+            ? joinMessageBridges(messages, project)
+            : undefined;
+        const query = createBridgeQuery(joined, requested, messageJoin);
         return {
             standardOutput: encodeBridgeQuery(query),
             standardError: queryStatusHint(query),

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

@@ -1 +1 @@
-{"version":3,"file":"query-command.js","sourceRoot":"","sources":["../../src/cli/query-command.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE1E,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,aAAa,EACb,mBAAmB,GAGpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,iDAAiD;AACjD,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,UAA6B,EAC7B,YAA0B;IAE1B,MAAM,MAAM,GAAG,qBAAqB,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAClE,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,eAAe,EAAE,CAAC;IACnD,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC/C,IACE,SAAS,KAAK,SAAS;QACvB,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAC7B,UAAU,CAAC,MAAM,GAAG,CAAC;QACrB,UAAU,CAAC,MAAM,GAAG,sBAAsB,EAC1C,CAAC;QACD,OAAO,eAAe,EAAE,CAAC;IAC3B,CAAC;IACD,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QACtE,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC;YACjC,OAAO,uBAAuB,CAAC,MAAM,CAAC,aAAa,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;QACzE,CAAC;QACD,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACnD,OAAO;YACL,cAAc,EAAE,iBAAiB,CAAC,KAAK,CAAC;YACxC,aAAa,EAAE,eAAe,CAAC,KAAK,CAAC;YACrC,QAAQ,EAAE,KAAK,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;SAC5C,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,kBAAkB,CAAC,KAAK,CAAC,IAAI,aAAa,EAAE,CAAC;IACtD,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAS,eAAe,CAAC,KAA0B;IACjD,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO;QAAE,OAAO,EAAE,CAAC;IACxC,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QACjC,OAAO,8BAA8B,KAAK,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC,gBAAgB;cAC9E,0DAA0D,CAAC;IACjE,CAAC;IACD,OAAO,0DAA0D;UAC7D,4DAA4D,CAAC;AACnE,CAAC;AAED,qCAAqC;AACrC,SAAS,eAAe;IACtB,OAAO;QACL,cAAc,EAAE,EAAE;QAClB,aAAa,EAAE,GAAG,UAAU,IAAI;QAChC,QAAQ,EAAE,EAAE;KACb,CAAC;AACJ,CAAC;AAED,2BAA2B;AAC3B,MAAM,CAAC,MAAM,UAAU,GACrB,+DAA+D;MAC7D,+BAA+B,CAAC","sourcesContent":["import {\n  isBridgeJoinDeferred,\n  joinBridgeDocuments,\n  MAX_DOCUMENTS_PER_JOIN,\n} from '../join/join.ts';\nimport { createBridgeQuery, encodeBridgeQuery } from '../report/query.ts';\nimport type { BridgeQueryDocument } from '../report/query.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/** query 인자를 실행해 bridge 질의 JSON과 종료 코드를 반환한다. */\nexport async function runQueryCommand(\n  arguments_: readonly string[],\n  readTextFile: ReadTextFile,\n): Promise<CommandResult> {\n  const parsed = parseCommandArguments(arguments_.slice(1), [], []);\n  if (parsed === undefined) return queryUsageError();\n  const requested = parsed.positionals[0];\n  const inputPaths = parsed.positionals.slice(1);\n  if (\n    requested === undefined ||\n    requested.trim().length === 0 ||\n    inputPaths.length < 2 ||\n    inputPaths.length > MAX_DOCUMENTS_PER_JOIN\n  ) {\n    return queryUsageError();\n  }\n  try {\n    const documents = await readBridgeDocuments(inputPaths, readTextFile);\n    const joined = joinBridgeDocuments(documents);\n    if (isBridgeJoinDeferred(joined)) {\n      return bridgeJoinDeferredError(joined.observedFacts, documents.length);\n    }\n    const query = createBridgeQuery(joined, requested);\n    return {\n      standardOutput: encodeBridgeQuery(query),\n      standardError: queryStatusHint(query),\n      exitCode: query.status === 'found' ? 0 : 64,\n    };\n  } catch (error) {\n    return inputFailureResult(error) ?? internalError();\n  }\n}\n\n/**\n * 찾지 못한 질의에 원인을 한 줄로 알린다.\n *\n * 문서 자체는 stdout JSON이 이미 다 담고 있으므로, 사람이 종료 코드만 봐도\n * \"인수가 잘못됐는지\"와 \"이름이 없는지\"를 구분할 수 있게 하는 보조 문구다.\n * 정적 문자열과 숫자만 보간한다.\n */\nfunction queryStatusHint(query: BridgeQueryDocument): string {\n  if (query.status === 'found') return '';\n  if (query.status === 'ambiguous') {\n    return `The requested name matches ${query.candidates?.length ?? 0} bridge keys; `\n      + 'repeat the query with a qualifiedName from candidates.\\n';\n  }\n  return 'No bridge channel or method matches the requested name; '\n    + 'query a channel or method name that the inputs observed.\\n';\n}\n\n/** 잘못된 query 호출을 사용법과 코드 64로 바꾼다. */\nfunction queryUsageError(): CommandResult {\n  return {\n    standardOutput: '',\n    standardError: `${queryUsage}\\n`,\n    exitCode: 64,\n  };\n}\n\n/** query 명령의 한 줄 사용법이다. */\nexport const queryUsage =\n  'Usage: isthmus query <channel-or-method> <bridge-facts.json> '\n  + '<bridge-facts.json> [more...]';\n"]}
+{"version":3,"file":"query-command.js","sourceRoot":"","sources":["../../src/cli/query-command.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE1E,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,aAAa,EACb,gBAAgB,GAGjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,iDAAiD;AACjD,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,UAA6B,EAC7B,YAA0B;IAE1B,MAAM,MAAM,GAAG,qBAAqB,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAClE,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,eAAe,EAAE,CAAC;IACnD,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC/C,IACE,SAAS,KAAK,SAAS;QACvB,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAC7B,UAAU,CAAC,MAAM,GAAG,CAAC;QACrB,UAAU,CAAC,MAAM,GAAG,sBAAsB,EAC1C,CAAC;QACD,OAAO,eAAe,EAAE,CAAC;IAC3B,CAAC;IACD,IAAI,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,gBAAgB,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QAC/E,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,QAAQ,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC;QAC5D,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC;YAC/B,CAAC,CAAC,mBAAmB,CAAC,OAAO,CAAC;YAC9B,CAAC,CAAC,qBAAqB,EAAE,CAAC;QAC5B,IAAI,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC;YACjC,OAAO,uBAAuB,CAAC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACvE,CAAC;QACD,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC;YACrC,CAAC,CAAC,kBAAkB,CAAC,QAAQ,EAAE,OAAO,CAAC;YACvC,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;QAChE,OAAO;YACL,cAAc,EAAE,iBAAiB,CAAC,KAAK,CAAC;YACxC,aAAa,EAAE,eAAe,CAAC,KAAK,CAAC;YACrC,QAAQ,EAAE,KAAK,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;SAC5C,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,kBAAkB,CAAC,KAAK,CAAC,IAAI,aAAa,EAAE,CAAC;IACtD,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAS,eAAe,CAAC,KAA0B;IACjD,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO;QAAE,OAAO,EAAE,CAAC;IACxC,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QACjC,OAAO,8BAA8B,KAAK,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC,gBAAgB;cAC9E,0DAA0D,CAAC;IACjE,CAAC;IACD,OAAO,0DAA0D;UAC7D,4DAA4D,CAAC;AACnE,CAAC;AAED,qCAAqC;AACrC,SAAS,eAAe;IACtB,OAAO;QACL,cAAc,EAAE,EAAE;QAClB,aAAa,EAAE,GAAG,UAAU,IAAI;QAChC,QAAQ,EAAE,EAAE;KACb,CAAC;AACJ,CAAC;AAED,2BAA2B;AAC3B,MAAM,CAAC,MAAM,UAAU,GACrB,+DAA+D;MAC7D,+BAA+B,CAAC","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 { createBridgeQuery, encodeBridgeQuery } from '../report/query.ts';\nimport type { BridgeQueryDocument } from '../report/query.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/** query 인자를 실행해 bridge 질의 JSON과 종료 코드를 반환한다. */\nexport async function runQueryCommand(\n  arguments_: readonly string[],\n  readTextFile: ReadTextFile,\n): Promise<CommandResult> {\n  const parsed = parseCommandArguments(arguments_.slice(1), [], []);\n  if (parsed === undefined) return queryUsageError();\n  const requested = parsed.positionals[0];\n  const inputPaths = parsed.positionals.slice(1);\n  if (\n    requested === undefined ||\n    requested.trim().length === 0 ||\n    inputPaths.length < 2 ||\n    inputPaths.length > MAX_DOCUMENTS_PER_JOIN\n  ) {\n    return queryUsageError();\n  }\n  try {\n    const { bridges, messages } = await readBridgeInputs(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 query = createBridgeQuery(joined, requested, messageJoin);\n    return {\n      standardOutput: encodeBridgeQuery(query),\n      standardError: queryStatusHint(query),\n      exitCode: query.status === 'found' ? 0 : 64,\n    };\n  } catch (error) {\n    return inputFailureResult(error) ?? internalError();\n  }\n}\n\n/**\n * 찾지 못한 질의에 원인을 한 줄로 알린다.\n *\n * 문서 자체는 stdout JSON이 이미 다 담고 있으므로, 사람이 종료 코드만 봐도\n * \"인수가 잘못됐는지\"와 \"이름이 없는지\"를 구분할 수 있게 하는 보조 문구다.\n * 정적 문자열과 숫자만 보간한다.\n */\nfunction queryStatusHint(query: BridgeQueryDocument): string {\n  if (query.status === 'found') return '';\n  if (query.status === 'ambiguous') {\n    return `The requested name matches ${query.candidates?.length ?? 0} bridge keys; `\n      + 'repeat the query with a qualifiedName from candidates.\\n';\n  }\n  return 'No bridge channel or method matches the requested name; '\n    + 'query a channel or method name that the inputs observed.\\n';\n}\n\n/** 잘못된 query 호출을 사용법과 코드 64로 바꾼다. */\nfunction queryUsageError(): CommandResult {\n  return {\n    standardOutput: '',\n    standardError: `${queryUsage}\\n`,\n    exitCode: 64,\n  };\n}\n\n/** query 명령의 한 줄 사용법이다. */\nexport const queryUsage =\n  'Usage: isthmus query <channel-or-method> <bridge-facts.json> '\n  + '<bridge-facts.json> [more...]';\n"]}

package/dist/cli/retentions-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 { createCartographRetentionsDocument, encodeCartographRetentionsDocument, RetentionValidationError, validateCartographRetentionInputs, } from "../report/retentions.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";
 /** retentions 인자를 실행해 cartograph용 보존 문서를 반환한다. */
 export async function runRetentionsCommand(arguments_, readTextFile, now, producerVersion) {
@@ -8,13 +9,19 @@ export async function runRetentionsCommand(arguments_, readTextFile, now, produc
     if (inputPaths === undefined)
         return retentionUsageError();
     try {
-        const documents = await readBridgeDocuments(inputPaths, readTextFile);
-        const joined = joinBridgeDocuments(documents);
+        const { bridges, messages } = await readBridgeInputs(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);
         }
-        validateCartographRetentionInputs(documents);
-        const retentions = createCartographRetentionsDocument(joined, now().toISOString(), producerVersion);
+        validateCartographRetentionInputs(bridges, messages);
+        const messageJoin = messages.length > 0
+            ? joinMessageBridges(messages, project)
+            : undefined;
+        const retentions = createCartographRetentionsDocument(joined, now().toISOString(), producerVersion, messageJoin);
         return {
             standardOutput: encodeCartographRetentionsDocument(retentions),
             standardError: '',

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

@@ -1 +1 @@
-{"version":3,"file":"retentions-command.js","sourceRoot":"","sources":["../../src/cli/retentions-command.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,kCAAkC,EAClC,kCAAkC,EAClC,wBAAwB,EACxB,iCAAiC,GAClC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,aAAa,EACb,mBAAmB,GAIpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAI7D,kDAAkD;AAClD,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,UAA6B,EAC7B,YAA0B,EAC1B,GAAU,EACV,eAAuB;IAEvB,MAAM,UAAU,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IACnD,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,mBAAmB,EAAE,CAAC;IAC3D,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QACtE,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC;YACjC,OAAO,uBAAuB,CAAC,MAAM,CAAC,aAAa,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;QACzE,CAAC;QACD,iCAAiC,CAAC,SAAS,CAAC,CAAC;QAC7C,MAAM,UAAU,GAAG,kCAAkC,CACnD,MAAM,EACN,GAAG,EAAE,CAAC,WAAW,EAAE,EACnB,eAAe,CAChB,CAAC;QACF,OAAO;YACL,cAAc,EAAE,kCAAkC,CAAC,UAAU,CAAC;YAC9D,aAAa,EAAE,EAAE;YACjB,QAAQ,EAAE,CAAC;SACZ,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,wBAAwB,EAAE,CAAC;YAC9C,OAAO;gBACL,cAAc,EAAE,EAAE;gBAClB,aAAa,EAAE,GAAG,KAAK,CAAC,OAAO,IAAI;gBACnC,QAAQ,EAAE,CAAC;aACZ,CAAC;QACJ,CAAC;QACD,OAAO,kBAAkB,CAAC,KAAK,CAAC,IAAI,aAAa,EAAE,CAAC;IACtD,CAAC;AACH,CAAC;AAED,uCAAuC;AACvC,SAAS,mBAAmB,CAAC,UAA6B;IACxD,IAAI,UAAU,CAAC,CAAC,CAAC,KAAK,YAAY;QAAE,OAAO,SAAS,CAAC;IACrD,MAAM,MAAM,GAAG,qBAAqB,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;IACzE,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,YAAY;QAAE,OAAO,SAAS,CAAC;IACtE,MAAM,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IACtC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,sBAAsB;QAC9D,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,KAAK,CAAC;AACZ,CAAC;AAED,0CAA0C;AAC1C,SAAS,mBAAmB;IAC1B,OAAO;QACL,cAAc,EAAE,EAAE;QAClB,aAAa,EAAE,GAAG,cAAc,IAAI;QACpC,QAAQ,EAAE,EAAE;KACb,CAAC;AACJ,CAAC;AAED,gCAAgC;AAChC,MAAM,CAAC,MAAM,cAAc,GACzB,oEAAoE;MAClE,4BAA4B,CAAC","sourcesContent":["import {\n  isBridgeJoinDeferred,\n  joinBridgeDocuments,\n  MAX_DOCUMENTS_PER_JOIN,\n} from '../join/join.ts';\nimport {\n  createCartographRetentionsDocument,\n  encodeCartographRetentionsDocument,\n  RetentionValidationError,\n  validateCartographRetentionInputs,\n} from '../report/retentions.ts';\nimport {\n  bridgeJoinDeferredError,\n  inputFailureResult,\n  internalError,\n  readBridgeDocuments,\n  type Clock,\n  type CommandResult,\n  type ReadTextFile,\n} from './command-support.ts';\nimport { parseCommandArguments } from './parse-arguments.ts';\n\nexport type { Clock };\n\n/** retentions 인자를 실행해 cartograph용 보존 문서를 반환한다. */\nexport async function runRetentionsCommand(\n  arguments_: readonly string[],\n  readTextFile: ReadTextFile,\n  now: Clock,\n  producerVersion: string,\n): Promise<CommandResult> {\n  const inputPaths = retentionInputPaths(arguments_);\n  if (inputPaths === undefined) return retentionUsageError();\n  try {\n    const documents = await readBridgeDocuments(inputPaths, readTextFile);\n    const joined = joinBridgeDocuments(documents);\n    if (isBridgeJoinDeferred(joined)) {\n      return bridgeJoinDeferredError(joined.observedFacts, documents.length);\n    }\n    validateCartographRetentionInputs(documents);\n    const retentions = createCartographRetentionsDocument(\n      joined,\n      now().toISOString(),\n      producerVersion,\n    );\n    return {\n      standardOutput: encodeCartographRetentionsDocument(retentions),\n      standardError: '',\n      exitCode: 0,\n    };\n  } catch (error) {\n    if (error instanceof RetentionValidationError) {\n      return {\n        standardOutput: '',\n        standardError: `${error.message}\\n`,\n        exitCode: 2,\n      };\n    }\n    return inputFailureResult(error) ?? internalError();\n  }\n}\n\n/** 지원 대상과 최소 입력 수를 검증해 파일 경로만 돌려준다. */\nfunction retentionInputPaths(arguments_: readonly string[]): string[] | undefined {\n  if (arguments_[0] !== 'retentions') return undefined;\n  const parsed = parseCommandArguments(arguments_.slice(1), ['--for'], []);\n  if (parsed === undefined) return undefined;\n  if (parsed.valueFlags.get('--for') !== 'cartograph') return undefined;\n  const paths = [...parsed.positionals];\n  return paths.length < 2 || paths.length > MAX_DOCUMENTS_PER_JOIN\n    ? undefined\n    : paths;\n}\n\n/** 잘못된 retentions 호출을 사용법과 코드 64로 바꾼다. */\nfunction retentionUsageError(): CommandResult {\n  return {\n    standardOutput: '',\n    standardError: `${retentionUsage}\\n`,\n    exitCode: 64,\n  };\n}\n\n/** retentions 명령의 한 줄 사용법이다. */\nexport const retentionUsage =\n  'Usage: isthmus retentions <bridge-facts.json> <bridge-facts.json> '\n  + '[more...] --for cartograph';\n"]}
+{"version":3,"file":"retentions-command.js","sourceRoot":"","sources":["../../src/cli/retentions-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  createCartographRetentionsDocument,\n  encodeCartographRetentionsDocument,\n  RetentionValidationError,\n  validateCartographRetentionInputs,\n} from '../report/retentions.ts';\nimport {\n  bridgeJoinDeferredError,\n  inputFailureResult,\n  internalError,\n  readBridgeInputs,\n  type Clock,\n  type CommandResult,\n  type ReadTextFile,\n} from './command-support.ts';\nimport { parseCommandArguments } from './parse-arguments.ts';\n\nexport type { Clock };\n\n/** retentions 인자를 실행해 cartograph용 보존 문서를 반환한다. */\nexport async function runRetentionsCommand(\n  arguments_: readonly string[],\n  readTextFile: ReadTextFile,\n  now: Clock,\n  producerVersion: string,\n): Promise<CommandResult> {\n  const inputPaths = retentionInputPaths(arguments_);\n  if (inputPaths === undefined) return retentionUsageError();\n  try {\n    const { bridges, messages } = await readBridgeInputs(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    validateCartographRetentionInputs(bridges, messages);\n    const messageJoin = messages.length > 0\n      ? joinMessageBridges(messages, project)\n      : undefined;\n    const retentions = createCartographRetentionsDocument(\n      joined,\n      now().toISOString(),\n      producerVersion,\n      messageJoin,\n    );\n    return {\n      standardOutput: encodeCartographRetentionsDocument(retentions),\n      standardError: '',\n      exitCode: 0,\n    };\n  } catch (error) {\n    if (error instanceof RetentionValidationError) {\n      return {\n        standardOutput: '',\n        standardError: `${error.message}\\n`,\n        exitCode: 2,\n      };\n    }\n    return inputFailureResult(error) ?? internalError();\n  }\n}\n\n/** 지원 대상과 최소 입력 수를 검증해 파일 경로만 돌려준다. */\nfunction retentionInputPaths(arguments_: readonly string[]): string[] | undefined {\n  if (arguments_[0] !== 'retentions') return undefined;\n  const parsed = parseCommandArguments(arguments_.slice(1), ['--for'], []);\n  if (parsed === undefined) return undefined;\n  if (parsed.valueFlags.get('--for') !== 'cartograph') return undefined;\n  const paths = [...parsed.positionals];\n  return paths.length < 2 || paths.length > MAX_DOCUMENTS_PER_JOIN\n    ? undefined\n    : paths;\n}\n\n/** 잘못된 retentions 호출을 사용법과 코드 64로 바꾼다. */\nfunction retentionUsageError(): CommandResult {\n  return {\n    standardOutput: '',\n    standardError: `${retentionUsage}\\n`,\n    exitCode: 64,\n  };\n}\n\n/** retentions 명령의 한 줄 사용법이다. */\nexport const retentionUsage =\n  'Usage: isthmus retentions <bridge-facts.json> <bridge-facts.json> '\n  + '[more...] --for cartograph';\n"]}

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

@@ -0,0 +1,5 @@
+import type { CommandResult, ReadTextFile } from './command-support.ts';
+/** 시나리오별 실행 기대를 런타임 관찰 JSON과 대조하는 CLI다. */
+export declare function runRuntimeCommand(arguments_: readonly string[], readTextFile: ReadTextFile): Promise<CommandResult>;
+/** 런타임 기대 파일과 하나 이상의 실행 로그가 필요하다. */
+export declare const runtimeUsage: string;

package/dist/cli/runtime-command.js

@@ -0,0 +1,42 @@
+import { parseBridgeRuntime, parseRuntimeExpectations, RuntimeValidationError } from "../exchange/runtime.js";
+import { MAX_DOCUMENTS_PER_JOIN } from "../join/join.js";
+import { verifyRuntimeEvidence } from "../report/runtime.js";
+import { encodeSortedJson } from "../report/sorted-json.js";
+import { inputFailure, internalError } from "./command-support.js";
+import { parseCommandArguments } from "./parse-arguments.js";
+import { RuntimeInputError, RuntimeJsonReader } from "./runtime-json-reader.js";
+/** 시나리오별 실행 기대를 런타임 관찰 JSON과 대조하는 CLI다. */
+export async function runRuntimeCommand(arguments_, readTextFile) {
+    const parsed = parseCommandArguments(arguments_.slice(1), ['--expectations'], ['--strict', '--compact']);
+    const expectedPath = parsed?.valueFlags.get('--expectations');
+    if (parsed === undefined || expectedPath === undefined || parsed.positionals.length === 0 ||
+        parsed.positionals.length > MAX_DOCUMENTS_PER_JOIN) {
+        return { standardOutput: '', standardError: `${runtimeUsage}\n`, exitCode: 64 };
+    }
+    try {
+        const reader = new RuntimeJsonReader(readTextFile);
+        const expectations = parseRuntimeExpectations(await reader.read(expectedPath));
+        const documents = [];
+        for (const path of parsed.positionals)
+            documents.push(parseBridgeRuntime(await reader.read(path)));
+        const report = verifyRuntimeEvidence(expectations, documents);
+        const failed = parsed.booleanFlags.has('--strict') && report.status !== 'passed';
+        return {
+            standardOutput: encodeSortedJson(report, parsed.booleanFlags.has('--compact')),
+            standardError: failed
+                ? 'Runtime verification requires review: failed calls, missing scenarios, stale runs, or incomplete evidence remain.\n'
+                : '',
+            exitCode: failed ? 1 : 0,
+        };
+    }
+    catch (error) {
+        if (error instanceof RuntimeValidationError || error instanceof RuntimeInputError) {
+            return inputFailure(`${error.message}\n`);
+        }
+        return internalError();
+    }
+}
+/** 런타임 기대 파일과 하나 이상의 실행 로그가 필요하다. */
+export const runtimeUsage = 'Usage: isthmus verify-runtime --expectations <expectations.json> '
+    + '<runtime.json> [more...] [--strict] [--compact]';
+//# sourceMappingURL=runtime-command.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-command.js","sourceRoot":"","sources":["../../src/cli/runtime-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAC9G,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAEnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAEhF,2CAA2C;AAC3C,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,UAA6B,EAAE,YAA0B;IAEzD,MAAM,MAAM,GAAG,qBAAqB,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,gBAAgB,CAAC,EAAE,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;IACzG,MAAM,YAAY,GAAG,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC9D,IAAI,MAAM,KAAK,SAAS,IAAI,YAAY,KAAK,SAAS,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC;QACvF,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,sBAAsB,EAAE,CAAC;QACrD,OAAO,EAAE,cAAc,EAAE,EAAE,EAAE,aAAa,EAAE,GAAG,YAAY,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAClF,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAAC,YAAY,CAAC,CAAC;QACnD,MAAM,YAAY,GAAG,wBAAwB,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;QAC/E,MAAM,SAAS,GAAG,EAAE,CAAC;QACrB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,WAAW;YAAE,SAAS,CAAC,IAAI,CAAC,kBAAkB,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACnG,MAAM,MAAM,GAAG,qBAAqB,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC;QACjF,OAAO;YACL,cAAc,EAAE,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YAC9E,aAAa,EAAE,MAAM;gBACnB,CAAC,CAAC,qHAAqH;gBACvH,CAAC,CAAC,EAAE;YACN,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SACzB,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,sBAAsB,IAAI,KAAK,YAAY,iBAAiB,EAAE,CAAC;YAClF,OAAO,YAAY,CAAC,GAAG,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,aAAa,EAAE,CAAC;IACzB,CAAC;AACH,CAAC;AAED,qCAAqC;AACrC,MAAM,CAAC,MAAM,YAAY,GAAG,mEAAmE;MAC3F,iDAAiD,CAAC","sourcesContent":["import { parseBridgeRuntime, parseRuntimeExpectations, RuntimeValidationError } from '../exchange/runtime.ts';\nimport { MAX_DOCUMENTS_PER_JOIN } from '../join/join.ts';\nimport { verifyRuntimeEvidence } from '../report/runtime.ts';\nimport { encodeSortedJson } from '../report/sorted-json.ts';\nimport { inputFailure, internalError } from './command-support.ts';\nimport type { CommandResult, ReadTextFile } from './command-support.ts';\nimport { parseCommandArguments } from './parse-arguments.ts';\nimport { RuntimeInputError, RuntimeJsonReader } from './runtime-json-reader.ts';\n\n/** 시나리오별 실행 기대를 런타임 관찰 JSON과 대조하는 CLI다. */\nexport async function runRuntimeCommand(\n  arguments_: readonly string[], readTextFile: ReadTextFile,\n): Promise<CommandResult> {\n  const parsed = parseCommandArguments(arguments_.slice(1), ['--expectations'], ['--strict', '--compact']);\n  const expectedPath = parsed?.valueFlags.get('--expectations');\n  if (parsed === undefined || expectedPath === undefined || parsed.positionals.length === 0 ||\n    parsed.positionals.length > MAX_DOCUMENTS_PER_JOIN) {\n    return { standardOutput: '', standardError: `${runtimeUsage}\\n`, exitCode: 64 };\n  }\n  try {\n    const reader = new RuntimeJsonReader(readTextFile);\n    const expectations = parseRuntimeExpectations(await reader.read(expectedPath));\n    const documents = [];\n    for (const path of parsed.positionals) documents.push(parseBridgeRuntime(await reader.read(path)));\n    const report = verifyRuntimeEvidence(expectations, documents);\n    const failed = parsed.booleanFlags.has('--strict') && report.status !== 'passed';\n    return {\n      standardOutput: encodeSortedJson(report, parsed.booleanFlags.has('--compact')),\n      standardError: failed\n        ? 'Runtime verification requires review: failed calls, missing scenarios, stale runs, or incomplete evidence remain.\\n'\n        : '',\n      exitCode: failed ? 1 : 0,\n    };\n  } catch (error) {\n    if (error instanceof RuntimeValidationError || error instanceof RuntimeInputError) {\n      return inputFailure(`${error.message}\\n`);\n    }\n    return internalError();\n  }\n}\n\n/** 런타임 기대 파일과 하나 이상의 실행 로그가 필요하다. */\nexport const runtimeUsage = 'Usage: isthmus verify-runtime --expectations <expectations.json> '\n  + '<runtime.json> [more...] [--strict] [--compact]';\n"]}

package/dist/cli/runtime-json-reader.d.ts

@@ -0,0 +1,12 @@
+import type { ReadTextFile } from './command-support.ts';
+/** 기대·실행 JSON의 예산을 공유하며 이미 읽은 정적 context 크기도 포함한다. */
+export declare class RuntimeJsonReader {
+    private readonly readTextFile;
+    private totalLength;
+    private position;
+    constructor(readTextFile: ReadTextFile, initialLength?: number);
+    read(path: string): Promise<unknown>;
+}
+/** runtime 입력 I/O·JSON 오류를 내부 결함과 구분한다. */
+export declare class RuntimeInputError extends Error {
+}

package/dist/cli/runtime-json-reader.js

@@ -0,0 +1,37 @@
+import { isJsonParseFailure, MAX_INPUT_TEXT_LENGTH, MAX_TOTAL_INPUT_TEXT_LENGTH } from "./command-support.js";
+/** 기대·실행 JSON의 예산을 공유하며 이미 읽은 정적 context 크기도 포함한다. */
+export class RuntimeJsonReader {
+    readTextFile;
+    totalLength;
+    position = 0;
+    constructor(readTextFile, initialLength = 0) {
+        this.readTextFile = readTextFile;
+        this.totalLength = initialLength;
+    }
+    async read(path) {
+        this.position++;
+        let text;
+        try {
+            text = await this.readTextFile(path);
+        }
+        catch {
+            throw new RuntimeInputError(`Unable to read runtime input ${this.position}; check the file exists and is readable.`);
+        }
+        this.totalLength += text.length;
+        if (text.length > MAX_INPUT_TEXT_LENGTH || this.totalLength > MAX_TOTAL_INPUT_TEXT_LENGTH) {
+            throw new RuntimeInputError(`Runtime input ${this.position} exceeds the input size limits.`);
+        }
+        try {
+            return JSON.parse(text);
+        }
+        catch (error) {
+            if (isJsonParseFailure(error))
+                throw new RuntimeInputError(`Runtime input ${this.position} is not valid JSON.`);
+            throw error;
+        }
+    }
+}
+/** runtime 입력 I/O·JSON 오류를 내부 결함과 구분한다. */
+export class RuntimeInputError extends Error {
+}
+//# sourceMappingURL=runtime-json-reader.js.map

package/dist/cli/runtime-json-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-json-reader.js","sourceRoot":"","sources":["../../src/cli/runtime-json-reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAG9G,sDAAsD;AACtD,MAAM,OAAO,iBAAiB;IACX,YAAY,CAAe;IACpC,WAAW,CAAS;IACpB,QAAQ,GAAG,CAAC,CAAC;IAErB,YAAY,YAA0B,EAAE,aAAa,GAAG,CAAC;QACvD,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,WAAW,GAAG,aAAa,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAY;QACrB,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,IAAI,IAAY,CAAC;QACjB,IAAI,CAAC;YAAC,IAAI,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAAC,CAAC;QAC7C,MAAM,CAAC;YAAC,MAAM,IAAI,iBAAiB,CAAC,gCAAgC,IAAI,CAAC,QAAQ,0CAA0C,CAAC,CAAC;QAAC,CAAC;QAC/H,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,MAAM,CAAC;QAChC,IAAI,IAAI,CAAC,MAAM,GAAG,qBAAqB,IAAI,IAAI,CAAC,WAAW,GAAG,2BAA2B,EAAE,CAAC;YAC1F,MAAM,IAAI,iBAAiB,CAAC,iBAAiB,IAAI,CAAC,QAAQ,iCAAiC,CAAC,CAAC;QAC/F,CAAC;QACD,IAAI,CAAC;YAAC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAAC,CAAC;QAChC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,kBAAkB,CAAC,KAAK,CAAC;gBAAE,MAAM,IAAI,iBAAiB,CAAC,iBAAiB,IAAI,CAAC,QAAQ,qBAAqB,CAAC,CAAC;YAChH,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF;AAED,2CAA2C;AAC3C,MAAM,OAAO,iBAAkB,SAAQ,KAAK;CAAG","sourcesContent":["import { isJsonParseFailure, MAX_INPUT_TEXT_LENGTH, MAX_TOTAL_INPUT_TEXT_LENGTH } from './command-support.ts';\nimport type { ReadTextFile } from './command-support.ts';\n\n/** 기대·실행 JSON의 예산을 공유하며 이미 읽은 정적 context 크기도 포함한다. */\nexport class RuntimeJsonReader {\n  private readonly readTextFile: ReadTextFile;\n  private totalLength: number;\n  private position = 0;\n\n  constructor(readTextFile: ReadTextFile, initialLength = 0) {\n    this.readTextFile = readTextFile;\n    this.totalLength = initialLength;\n  }\n\n  async read(path: string): Promise<unknown> {\n    this.position++;\n    let text: string;\n    try { text = await this.readTextFile(path); }\n    catch { throw new RuntimeInputError(`Unable to read runtime input ${this.position}; check the file exists and is readable.`); }\n    this.totalLength += text.length;\n    if (text.length > MAX_INPUT_TEXT_LENGTH || this.totalLength > MAX_TOTAL_INPUT_TEXT_LENGTH) {\n      throw new RuntimeInputError(`Runtime input ${this.position} exceeds the input size limits.`);\n    }\n    try { return JSON.parse(text); }\n    catch (error) {\n      if (isJsonParseFailure(error)) throw new RuntimeInputError(`Runtime input ${this.position} is not valid JSON.`);\n      throw error;\n    }\n  }\n}\n\n/** runtime 입력 I/O·JSON 오류를 내부 결함과 구분한다. */\nexport class RuntimeInputError extends Error {}\n"]}

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

@@ -0,0 +1,13 @@
+import type { CommandResult, ReadTextFile, WriteTextFile } from './command-support.ts';
+export declare const serveUsage = "Usage: isthmus serve";
+/** 세션이 읽는 NDJSON 입력과 응답을 쓰는 싱크다. 테스트는 메모리로 주입한다. */
+export interface ServeIo {
+    readonly lines: AsyncIterable<string>;
+    readonly writeLine: (line: string) => void;
+}
+/**
+ * stdin의 한 줄씩 들어오는 JSON-RPC 메시지를 MCP 세션에 넘기고
+ * 응답을 stdout에 쓴다. stdin이 닫히면 0으로 끝난다 — 세션은
+ * 상태를 쌓지 않으므로 종료 시 잃는 것이 없다.
+ */
+export declare function runServeCommand(arguments_: readonly string[], readTextFile: ReadTextFile, writeTextFile?: WriteTextFile, producerVersion?: string, io?: ServeIo): Promise<CommandResult>;

package/dist/cli/serve-command.js

@@ -0,0 +1,43 @@
+import { createInterface } from 'node:readline';
+import { createMcpSession } from "./mcp-server.js";
+export const serveUsage = 'Usage: isthmus serve';
+/**
+ * stdin의 한 줄씩 들어오는 JSON-RPC 메시지를 MCP 세션에 넘기고
+ * 응답을 stdout에 쓴다. stdin이 닫히면 0으로 끝난다 — 세션은
+ * 상태를 쌓지 않으므로 종료 시 잃는 것이 없다.
+ */
+export async function runServeCommand(arguments_, readTextFile, writeTextFile, producerVersion, io) {
+    if (arguments_[0] !== 'serve' || arguments_.length !== 1) {
+        return {
+            standardOutput: '',
+            standardError: `${serveUsage}\n`,
+            exitCode: 64,
+        };
+    }
+    const session = createMcpSession({
+        readTextFile,
+        writeTextFile,
+        producerVersion,
+    });
+    const { lines, writeLine } = io ?? stdioLines();
+    for await (const line of lines) {
+        if (line.trim().length === 0)
+            continue;
+        const response = await session.handleLine(line);
+        if (response !== undefined) {
+            writeLine(response);
+        }
+    }
+    return { standardOutput: '', standardError: '', exitCode: 0 };
+}
+/** stdin을 줄 단위로 읽고 stdout에 한 줄씩 쓰는 기본 IO다. */
+function stdioLines() {
+    return {
+        lines: createInterface({
+            input: process.stdin,
+            crlfDelay: Infinity,
+        }),
+        writeLine: (line) => process.stdout.write(`${line}\n`),
+    };
+}
+//# sourceMappingURL=serve-command.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serve-command.js","sourceRoot":"","sources":["../../src/cli/serve-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAOnD,MAAM,CAAC,MAAM,UAAU,GAAG,sBAAsB,CAAC;AAQjD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,UAA6B,EAC7B,YAA0B,EAC1B,aAA6B,EAC7B,eAAwB,EACxB,EAAY;IAEZ,IAAI,UAAU,CAAC,CAAC,CAAC,KAAK,OAAO,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzD,OAAO;YACL,cAAc,EAAE,EAAE;YAClB,aAAa,EAAE,GAAG,UAAU,IAAI;YAChC,QAAQ,EAAE,EAAE;SACb,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,gBAAgB,CAAC;QAC/B,YAAY;QACZ,aAAa;QACb,eAAe;KAChB,CAAC,CAAC;IACH,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,UAAU,EAAE,CAAC;IAChD,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC/B,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACvC,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,SAAS,CAAC,QAAQ,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,cAAc,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;AAChE,CAAC;AAED,8CAA8C;AAC9C,SAAS,UAAU;IACjB,OAAO;QACL,KAAK,EAAE,eAAe,CAAC;YACrB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,SAAS,EAAE,QAAQ;SACpB,CAAC;QACF,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC;KACvD,CAAC;AACJ,CAAC","sourcesContent":["import { createInterface } from 'node:readline';\n\nimport { createMcpSession } from './mcp-server.ts';\nimport type {\n  CommandResult,\n  ReadTextFile,\n  WriteTextFile,\n} from './command-support.ts';\n\nexport const serveUsage = 'Usage: isthmus serve';\n\n/** 세션이 읽는 NDJSON 입력과 응답을 쓰는 싱크다. 테스트는 메모리로 주입한다. */\nexport interface ServeIo {\n  readonly lines: AsyncIterable<string>;\n  readonly writeLine: (line: string) => void;\n}\n\n/**\n * stdin의 한 줄씩 들어오는 JSON-RPC 메시지를 MCP 세션에 넘기고\n * 응답을 stdout에 쓴다. stdin이 닫히면 0으로 끝난다 — 세션은\n * 상태를 쌓지 않으므로 종료 시 잃는 것이 없다.\n */\nexport async function runServeCommand(\n  arguments_: readonly string[],\n  readTextFile: ReadTextFile,\n  writeTextFile?: WriteTextFile,\n  producerVersion?: string,\n  io?: ServeIo,\n): Promise<CommandResult> {\n  if (arguments_[0] !== 'serve' || arguments_.length !== 1) {\n    return {\n      standardOutput: '',\n      standardError: `${serveUsage}\\n`,\n      exitCode: 64,\n    };\n  }\n  const session = createMcpSession({\n    readTextFile,\n    writeTextFile,\n    producerVersion,\n  });\n  const { lines, writeLine } = io ?? stdioLines();\n  for await (const line of lines) {\n    if (line.trim().length === 0) continue;\n    const response = await session.handleLine(line);\n    if (response !== undefined) {\n      writeLine(response);\n    }\n  }\n  return { standardOutput: '', standardError: '', exitCode: 0 };\n}\n\n/** stdin을 줄 단위로 읽고 stdout에 한 줄씩 쓰는 기본 IO다. */\nfunction stdioLines(): ServeIo {\n  return {\n    lines: createInterface({\n      input: process.stdin,\n      crlfDelay: Infinity,\n    }),\n    writeLine: (line) => process.stdout.write(`${line}\\n`),\n  };\n}\n"]}

package/dist/exchange/capture-config.d.ts

@@ -0,0 +1,18 @@
+/**
+ * capture workflow 설정이 계약을 어겼음을 나타낸다.
+ *
+ * 이 설정은 제품이 실행하는 명령 목록이 아니라 `scripts/capture-preflight.mjs`가
+ * 실행할 명령 목록이다. 제품은 JSON으로 검증만 하고 자매 도구를 실행하지 않는다.
+ */
+export declare class CaptureConfigValidationError extends Error {
+    /** 입력 내용을 노출하지 않는 안전한 메시지를 보존한다. */
+    constructor(message: string);
+}
+/**
+ * capture workflow 설정을 검증한다.
+ *
+ * `scripts/capture-preflight.mjs`가 실행 전에 적용하는 규칙과 같은 정본이다.
+ * 규칙을 여기에 두어 `isthmus doctor`와 수집기가 같은 판정을 내리게 한다.
+ * `project`는 이미 realpath로 정규화된 조인 루트다.
+ */
+export declare function validateCaptureConfig(config: unknown, project: string): void;

package/dist/exchange/capture-config.js

@@ -0,0 +1,100 @@
+import { isAbsolute, relative, resolve } from 'node:path';
+import { isJsonObject, isProjectRelativePath, isSafeNonEmptyString } from "./parse.js";
+/**
+ * capture workflow 설정이 계약을 어겼음을 나타낸다.
+ *
+ * 이 설정은 제품이 실행하는 명령 목록이 아니라 `scripts/capture-preflight.mjs`가
+ * 실행할 명령 목록이다. 제품은 JSON으로 검증만 하고 자매 도구를 실행하지 않는다.
+ */
+export class CaptureConfigValidationError extends Error {
+    /** 입력 내용을 노출하지 않는 안전한 메시지를 보존한다. */
+    constructor(message) {
+        super(message);
+        this.name = 'CaptureConfigValidationError';
+    }
+}
+/** 명령 배열은 비어 있지 않은 안전한 문자열 토큰의 비어 있지 않은 배열이다. */
+function isCommand(value) {
+    return Array.isArray(value) && value.length > 0 && value.every(isSafeNonEmptyString);
+}
+/**
+ * capture workflow 설정을 검증한다.
+ *
+ * `scripts/capture-preflight.mjs`가 실행 전에 적용하는 규칙과 같은 정본이다.
+ * 규칙을 여기에 두어 `isthmus doctor`와 수집기가 같은 판정을 내리게 한다.
+ * `project`는 이미 realpath로 정규화된 조인 루트다.
+ */
+export function validateCaptureConfig(config, project) {
+    if (!isJsonObject(config))
+        fail('Capture config must be a JSON object.');
+    if (!isSafeNonEmptyString(config.project))
+        fail('Capture config requires a project path.');
+    const command = isCommand;
+    if (!command(config.dartograph) ||
+        (config.cartograph === undefined && config.kartograph === undefined) ||
+        (config.cartograph !== undefined && !command(config.cartograph)) ||
+        (config.kartograph !== undefined && !command(config.kartograph)) ||
+        !Array.isArray(config.prepare) || config.prepare.length === 0 ||
+        !config.prepare.every(command)) {
+        fail('Configure producer commands and a native index preparation command.');
+    }
+    if (config.messages !== undefined && config.messages !== true &&
+        (config.messages === null || typeof config.messages !== 'object' ||
+            Array.isArray(config.messages) || Object.entries(config.messages).some(([name, value]) => !['dartograph', 'cartograph', 'kartograph'].includes(name) ||
+            config[name] === undefined || !command(value)))) {
+        fail('Invalid message producer configuration.');
+    }
+    if (config.events !== undefined && config.events !== true &&
+        (config.events === null || typeof config.events !== 'object' ||
+            Array.isArray(config.events) || Object.entries(config.events).some(([name, value]) => !['dartograph', 'cartograph', 'kartograph'].includes(name) ||
+            config[name] === undefined || !command(value)))) {
+        fail('Invalid event producer configuration.');
+    }
+    // Kotlin 소스 읽기는 스냅이 없어도 동작한다. 스냅샷은 impact 분석에만
+    // 필요하므로 selection.kotlin이 있을 때만 요구한다.
+    const selection = config.selection;
+    const kotlinSelection = typeof selection === 'object' && selection !== null &&
+        !Array.isArray(selection) && selection.kotlin !== undefined;
+    if (kotlinSelection && config.kartograph === undefined) {
+        fail('A Kotlin selection requires its Kartograph producer.');
+    }
+    if (kotlinSelection && !isSafeNonEmptyString(config.kartographSnapshot)) {
+        fail('Configure a Kartograph snapshot produced by the preparation command.');
+    }
+    if (config.kartograph === undefined && config.kartographSnapshot !== undefined) {
+        fail('A Kartograph snapshot requires its producer.');
+    }
+    if (!Array.isArray(config.inputs) || config.inputs.length === 0 ||
+        !config.inputs.every(isProjectRelativePath) ||
+        !Array.isArray(config.toolInputs) || config.toolInputs.length === 0 ||
+        !config.toolInputs.every(isSafeNonEmptyString)) {
+        fail('Declare source/config inputs and producer implementation files for fingerprinting.');
+    }
+    const explicit = config.selection !== undefined;
+    const since = config.since !== undefined;
+    if (explicit === since ||
+        (explicit && (config.selection === null || typeof config.selection !== 'object' ||
+            Array.isArray(config.selection))) ||
+        (since && !isSafeNonEmptyString(config.since)) ||
+        !isSafeNonEmptyString(config.output) || !isSafeNonEmptyString(config.cache)) {
+        fail('Configure exactly one selection or since revision, plus output and cache paths.');
+    }
+    for (const output of [config.output, `${config.output}.sources.json`, config.cache]) {
+        const target = resolve(project, output);
+        for (const input of [...config.inputs, ...config.toolInputs,
+            ...(config.kartographSnapshot === undefined ? [] : [config.kartographSnapshot])]) {
+            const part = relative(resolve(project, input), target);
+            if (part === '' || (!part.startsWith('..') && !isAbsolute(part))) {
+                fail('Keep output and cache outside fingerprint input trees.');
+            }
+        }
+    }
+    if (resolve(project, config.output) === resolve(project, config.cache)) {
+        fail('Output and cache paths must differ.');
+    }
+}
+/** 입력 값을 포함하지 않는 검증 오류를 던진다. */
+function fail(message) {
+    throw new CaptureConfigValidationError(message);
+}
+//# sourceMappingURL=capture-config.js.map

package/dist/exchange/capture-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-config.js","sourceRoot":"","sources":["../../src/exchange/capture-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvF;;;;;GAKG;AACH,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IACrD,oCAAoC;IACpC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC7C,CAAC;CACF;AAED,iDAAiD;AACjD,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;AACvF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAe,EAAE,OAAe;IACpE,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC;QAAE,IAAI,CAAC,uCAAuC,CAAC,CAAC;IACzE,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,OAAO,CAAC;QAAE,IAAI,CAAC,yCAAyC,CAAC,CAAC;IAC3F,MAAM,OAAO,GAAG,SAAS,CAAC;IAC1B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC;QAC7B,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC;QACpE,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAChE,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAChE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAC7D,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACjC,IAAI,CAAC,qEAAqE,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,KAAK,IAAI;QAC3D,CAAC,MAAM,CAAC,QAAQ,KAAK,IAAI,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ;YAC9D,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CACvF,CAAC,CAAC,YAAY,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;YAC1D,MAAM,CAAC,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,IAAI,CAAC,yCAAyC,CAAC,CAAC;IAClD,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI;QACvD,CAAC,MAAM,CAAC,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ;YAC1D,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CACnF,CAAC,CAAC,YAAY,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;YAC1D,MAAM,CAAC,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,IAAI,CAAC,uCAAuC,CAAC,CAAC;IAChD,CAAC;IACD,+CAA+C;IAC/C,sCAAsC;IACtC,MAAM,SAAS,GAAG,MAAM,CAAC,SAAgD,CAAC;IAC1E,MAAM,eAAe,GAAG,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI;QACzE,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS,CAAC;IAC9D,IAAI,eAAe,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACvD,IAAI,CAAC,sDAAsD,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,eAAe,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACxE,IAAI,CAAC,sEAAsE,CAAC,CAAC;IAC/E,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,MAAM,CAAC,kBAAkB,KAAK,SAAS,EAAE,CAAC;QAC/E,IAAI,CAAC,8CAA8C,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;QAC7D,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC;QAC3C,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;QACnE,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,oBAAoB,CAAC,EAAE,CAAC;QACjD,IAAI,CAAC,oFAAoF,CAAC,CAAC;IAC7F,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,KAAK,SAAS,CAAC;IAChD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC;IACzC,IAAI,QAAQ,KAAK,KAAK;QACpB,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,KAAK,IAAI,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;YAC7E,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QACnC,CAAC,KAAK,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9C,CAAC,oBAAoB,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9E,IAAI,CAAC,iFAAiF,CAAC,CAAC;IAC1F,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,eAAe,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACpF,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,MAAgB,CAAC,CAAC;QAClD,KAAK,MAAM,KAAK,IAAI,CAAC,GAAI,MAAM,CAAC,MAAmB,EAAE,GAAI,MAAM,CAAC,UAAuB;YACrF,GAAG,CAAC,MAAM,CAAC,kBAAkB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,kBAA4B,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7F,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;YACvD,IAAI,IAAI,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;gBACjE,IAAI,CAAC,wDAAwD,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,MAAgB,CAAC,KAAK,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,KAAe,CAAC,EAAE,CAAC;QAC3F,IAAI,CAAC,qCAAqC,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC;AAED,gCAAgC;AAChC,SAAS,IAAI,CAAC,OAAe;IAC3B,MAAM,IAAI,4BAA4B,CAAC,OAAO,CAAC,CAAC;AAClD,CAAC","sourcesContent":["import { isAbsolute, relative, resolve } from 'node:path';\n\nimport { isJsonObject, isProjectRelativePath, isSafeNonEmptyString } from './parse.ts';\n\n/**\n * capture workflow 설정이 계약을 어겼음을 나타낸다.\n *\n * 이 설정은 제품이 실행하는 명령 목록이 아니라 `scripts/capture-preflight.mjs`가\n * 실행할 명령 목록이다. 제품은 JSON으로 검증만 하고 자매 도구를 실행하지 않는다.\n */\nexport class CaptureConfigValidationError extends Error {\n  /** 입력 내용을 노출하지 않는 안전한 메시지를 보존한다. */\n  constructor(message: string) {\n    super(message);\n    this.name = 'CaptureConfigValidationError';\n  }\n}\n\n/** 명령 배열은 비어 있지 않은 안전한 문자열 토큰의 비어 있지 않은 배열이다. */\nfunction isCommand(value: unknown): value is readonly string[] {\n  return Array.isArray(value) && value.length > 0 && value.every(isSafeNonEmptyString);\n}\n\n/**\n * capture workflow 설정을 검증한다.\n *\n * `scripts/capture-preflight.mjs`가 실행 전에 적용하는 규칙과 같은 정본이다.\n * 규칙을 여기에 두어 `isthmus doctor`와 수집기가 같은 판정을 내리게 한다.\n * `project`는 이미 realpath로 정규화된 조인 루트다.\n */\nexport function validateCaptureConfig(config: unknown, project: string): void {\n  if (!isJsonObject(config)) fail('Capture config must be a JSON object.');\n  if (!isSafeNonEmptyString(config.project)) fail('Capture config requires a project path.');\n  const command = isCommand;\n  if (!command(config.dartograph) ||\n    (config.cartograph === undefined && config.kartograph === undefined) ||\n    (config.cartograph !== undefined && !command(config.cartograph)) ||\n    (config.kartograph !== undefined && !command(config.kartograph)) ||\n    !Array.isArray(config.prepare) || config.prepare.length === 0 ||\n    !config.prepare.every(command)) {\n    fail('Configure producer commands and a native index preparation command.');\n  }\n  if (config.messages !== undefined && config.messages !== true &&\n    (config.messages === null || typeof config.messages !== 'object' ||\n      Array.isArray(config.messages) || Object.entries(config.messages).some(([name, value]) =>\n        !['dartograph', 'cartograph', 'kartograph'].includes(name) ||\n        config[name] === undefined || !command(value)))) {\n    fail('Invalid message producer configuration.');\n  }\n  if (config.events !== undefined && config.events !== true &&\n    (config.events === null || typeof config.events !== 'object' ||\n      Array.isArray(config.events) || Object.entries(config.events).some(([name, value]) =>\n        !['dartograph', 'cartograph', 'kartograph'].includes(name) ||\n        config[name] === undefined || !command(value)))) {\n    fail('Invalid event producer configuration.');\n  }\n  // Kotlin 소스 읽기는 스냅이 없어도 동작한다. 스냅샷은 impact 분석에만\n  // 필요하므로 selection.kotlin이 있을 때만 요구한다.\n  const selection = config.selection as Record<string, unknown> | undefined;\n  const kotlinSelection = typeof selection === 'object' && selection !== null &&\n    !Array.isArray(selection) && selection.kotlin !== undefined;\n  if (kotlinSelection && config.kartograph === undefined) {\n    fail('A Kotlin selection requires its Kartograph producer.');\n  }\n  if (kotlinSelection && !isSafeNonEmptyString(config.kartographSnapshot)) {\n    fail('Configure a Kartograph snapshot produced by the preparation command.');\n  }\n  if (config.kartograph === undefined && config.kartographSnapshot !== undefined) {\n    fail('A Kartograph snapshot requires its producer.');\n  }\n  if (!Array.isArray(config.inputs) || config.inputs.length === 0 ||\n    !config.inputs.every(isProjectRelativePath) ||\n    !Array.isArray(config.toolInputs) || config.toolInputs.length === 0 ||\n    !config.toolInputs.every(isSafeNonEmptyString)) {\n    fail('Declare source/config inputs and producer implementation files for fingerprinting.');\n  }\n  const explicit = config.selection !== undefined;\n  const since = config.since !== undefined;\n  if (explicit === since ||\n    (explicit && (config.selection === null || typeof config.selection !== 'object' ||\n      Array.isArray(config.selection))) ||\n    (since && !isSafeNonEmptyString(config.since)) ||\n    !isSafeNonEmptyString(config.output) || !isSafeNonEmptyString(config.cache)) {\n    fail('Configure exactly one selection or since revision, plus output and cache paths.');\n  }\n  for (const output of [config.output, `${config.output}.sources.json`, config.cache]) {\n    const target = resolve(project, output as string);\n    for (const input of [...(config.inputs as string[]), ...(config.toolInputs as string[]),\n      ...(config.kartographSnapshot === undefined ? [] : [config.kartographSnapshot as string])]) {\n      const part = relative(resolve(project, input), target);\n      if (part === '' || (!part.startsWith('..') && !isAbsolute(part))) {\n        fail('Keep output and cache outside fingerprint input trees.');\n      }\n    }\n  }\n  if (resolve(project, config.output as string) === resolve(project, config.cache as string)) {\n    fail('Output and cache paths must differ.');\n  }\n}\n\n/** 입력 값을 포함하지 않는 검증 오류를 던진다. */\nfunction fail(message: string): never {\n  throw new CaptureConfigValidationError(message);\n}"]}

package/dist/exchange/impact-selection.d.ts

@@ -0,0 +1,13 @@
+/** 변경 대상의 프로젝트 상대 파일과 정확한 심볼 이름/USR이다. 두 목록은 합집합이다. */
+export interface ImpactSelection {
+    readonly files: readonly string[];
+    readonly symbols: readonly string[];
+}
+/** 변경 목록이 큰 입력을 통한 선택 집합 증폭을 일으키지 않도록 제한한다. */
+export declare const MAX_IMPACT_SELECTORS = 10000;
+/** 변경 선택 계약 실패를 소스 값이 없는 메시지로 구분한다. */
+export declare class ImpactSelectionValidationError extends Error {
+    constructor(message: string);
+}
+/** 외부 변경 목록을 검증하고 위치·심볼 문자열을 손대지 않은 채 중복 제거한다. */
+export declare function parseImpactSelection(input: unknown): ImpactSelection;