open-multi-agent-kit 0.80.7 → 0.80.8

package/dist/core/headroom-middleware.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"headroom-middleware.js","sourceRoot":"","sources":["../../src/core/headroom-middleware.ts"],"names":[],"mappings":"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","sourcesContent":["import type { BeforeProviderSend, Context, TextContent, ToolResultMessage } from \"@earendil-works/omk-ai\";\nimport { estimateLeanContextTokens } from \"./lean-context-policy.ts\";\n\nconst DEFAULT_THRESHOLD_TOKENS = 2_048;\nconst LEAN_CONTEXT_STUB_PREFIX = \"[lean-context]\";\n\nconst DEFAULT_SECRET_PATTERNS: readonly RegExp[] = [\n\t/-----BEGIN [A-Z0-9 ]*PRIVATE KEY-----/i,\n\t/\\b(?:api[_-]?key|access[_-]?token|auth[_-]?token|refresh[_-]?token|client[_-]?secret|secret|password|passwd|pwd)\\b\\s*[:=]\\s*[\"']?[^\\s\"']{8,}/i,\n\t/\\bauthorization\\s*:\\s*bearer\\s+[A-Za-z0-9._~+/=-]{10,}/i,\n\t/\\b(?:gh[pousr]_|sk-|xox[baprs]-)[A-Za-z0-9_=-]{10,}/i,\n];\n\nexport interface HeadroomCompressTextInput {\n\treadonly text: string;\n\treadonly estimatedTokens: number;\n\treadonly thresholdTokens: number;\n\treadonly toolCallId: string;\n\treadonly toolName: string;\n\treadonly contentIndex: number;\n\treadonly isError: boolean;\n\treadonly details?: unknown;\n}\n\nexport type HeadroomCompressText = (input: HeadroomCompressTextInput) => string | undefined;\n\nexport interface HeadroomBeforeProviderSendOptions {\n\treadonly compressText: HeadroomCompressText;\n\treadonly thresholdTokens?: number;\n\treadonly logsThresholdTokens?: number;\n\treadonly enabled?: boolean;\n}\n\nexport interface HeadroomBeforeProviderSendStats {\n\treadonly seenToolResultTextBlocks: number;\n\treadonly compressedBlocks: number;\n\treadonly skippedBelowThresholdBlocks: number;\n\treadonly skippedSecretBlocks: number;\n\treadonly skippedLeanContextBlocks: number;\n\treadonly failedOpenBlocks: number;\n\treadonly inputTokens: number;\n\treadonly outputTokens: number;\n}\n\nexport interface HeadroomBeforeProviderSend {\n\treadonly beforeProviderSend: BeforeProviderSend;\n\tgetStats(): HeadroomBeforeProviderSendStats;\n\treset(): void;\n}\n\nexport function createHeadroomBeforeProviderSend(\n\toptions: HeadroomBeforeProviderSendOptions,\n): HeadroomBeforeProviderSend {\n\tlet stats = createEmptyStats();\n\n\treturn {\n\t\tbeforeProviderSend(input) {\n\t\t\tif (options.enabled === false) return undefined;\n\t\t\tconst result = transformContext(input.context, options, stats);\n\t\t\tstats = result.stats;\n\t\t\treturn result.changed ? result.context : undefined;\n\t\t},\n\t\tgetStats() {\n\t\t\treturn { ...stats };\n\t\t},\n\t\treset() {\n\t\t\tstats = createEmptyStats();\n\t\t},\n\t};\n}\n\ninterface ContextTransformResult {\n\treadonly context: Context;\n\treadonly stats: HeadroomBeforeProviderSendStats;\n\treadonly changed: boolean;\n}\n\nfunction transformContext(\n\tcontext: Context,\n\toptions: HeadroomBeforeProviderSendOptions,\n\tinitialStats: HeadroomBeforeProviderSendStats,\n): ContextTransformResult {\n\tlet nextStats = initialStats;\n\tlet changed = false;\n\tconst messages = context.messages.map((message) => {\n\t\tif (message.role !== \"toolResult\") return message;\n\t\tconst result = transformToolResult(message, options, nextStats);\n\t\tnextStats = result.stats;\n\t\tchanged = changed || result.changed;\n\t\treturn result.message;\n\t});\n\n\treturn {\n\t\tcontext: changed ? { ...context, messages } : context,\n\t\tstats: nextStats,\n\t\tchanged,\n\t};\n}\n\ninterface ToolResultTransformResult {\n\treadonly message: ToolResultMessage<unknown>;\n\treadonly stats: HeadroomBeforeProviderSendStats;\n\treadonly changed: boolean;\n}\n\nfunction transformToolResult(\n\tmessage: ToolResultMessage<unknown>,\n\toptions: HeadroomBeforeProviderSendOptions,\n\tinitialStats: HeadroomBeforeProviderSendStats,\n): ToolResultTransformResult {\n\tlet nextStats = initialStats;\n\tlet changed = false;\n\tconst content = message.content.map((block, index) => {\n\t\tif (block.type !== \"text\") return block;\n\t\tconst result = transformTextBlock(block, message, index, options, nextStats);\n\t\tnextStats = result.stats;\n\t\tchanged = changed || result.changed;\n\t\treturn result.block;\n\t});\n\n\treturn {\n\t\tmessage: changed ? { ...message, content } : message,\n\t\tstats: nextStats,\n\t\tchanged,\n\t};\n}\n\ninterface TextBlockTransformResult {\n\treadonly block: TextContent;\n\treadonly stats: HeadroomBeforeProviderSendStats;\n\treadonly changed: boolean;\n}\n\nfunction transformTextBlock(\n\tblock: TextContent,\n\tmessage: ToolResultMessage<unknown>,\n\tcontentIndex: number,\n\toptions: HeadroomBeforeProviderSendOptions,\n\tinitialStats: HeadroomBeforeProviderSendStats,\n): TextBlockTransformResult {\n\tconst estimatedTokens = estimateLeanContextTokens(block.text);\n\tlet stats = incrementStats(initialStats, {\n\t\tseenToolResultTextBlocks: 1,\n\t\tinputTokens: estimatedTokens,\n\t});\n\n\tif (isLeanContextStub(block.text)) {\n\t\treturn { block, stats: incrementStats(stats, { skippedLeanContextBlocks: 1 }), changed: false };\n\t}\n\n\tif (containsSecretPattern(block.text)) {\n\t\treturn { block, stats: incrementStats(stats, { skippedSecretBlocks: 1 }), changed: false };\n\t}\n\n\tconst thresholdTokens = getThresholdTokens(options, message);\n\tif (estimatedTokens <= thresholdTokens) {\n\t\treturn { block, stats: incrementStats(stats, { skippedBelowThresholdBlocks: 1 }), changed: false };\n\t}\n\n\tlet compressed: string | undefined;\n\ttry {\n\t\tcompressed = options.compressText({\n\t\t\ttext: block.text,\n\t\t\testimatedTokens,\n\t\t\tthresholdTokens,\n\t\t\ttoolCallId: message.toolCallId,\n\t\t\ttoolName: message.toolName,\n\t\t\tcontentIndex,\n\t\t\tisError: message.isError,\n\t\t\tdetails: message.details,\n\t\t});\n\t} catch {\n\t\treturn { block, stats: incrementStats(stats, { failedOpenBlocks: 1 }), changed: false };\n\t}\n\n\tif (compressed === undefined) {\n\t\treturn { block, stats: incrementStats(stats, { failedOpenBlocks: 1 }), changed: false };\n\t}\n\n\tif (compressed === block.text) {\n\t\treturn { block, stats, changed: false };\n\t}\n\n\tstats = incrementStats(stats, {\n\t\tcompressedBlocks: 1,\n\t\toutputTokens: estimateLeanContextTokens(compressed),\n\t});\n\treturn { block: { ...block, text: compressed }, stats, changed: true };\n}\n\nfunction createEmptyStats(): HeadroomBeforeProviderSendStats {\n\treturn {\n\t\tseenToolResultTextBlocks: 0,\n\t\tcompressedBlocks: 0,\n\t\tskippedBelowThresholdBlocks: 0,\n\t\tskippedSecretBlocks: 0,\n\t\tskippedLeanContextBlocks: 0,\n\t\tfailedOpenBlocks: 0,\n\t\tinputTokens: 0,\n\t\toutputTokens: 0,\n\t};\n}\n\nfunction incrementStats(\n\tstats: HeadroomBeforeProviderSendStats,\n\tdelta: Partial<Record<keyof HeadroomBeforeProviderSendStats, number>>,\n): HeadroomBeforeProviderSendStats {\n\treturn {\n\t\tseenToolResultTextBlocks: stats.seenToolResultTextBlocks + (delta.seenToolResultTextBlocks ?? 0),\n\t\tcompressedBlocks: stats.compressedBlocks + (delta.compressedBlocks ?? 0),\n\t\tskippedBelowThresholdBlocks: stats.skippedBelowThresholdBlocks + (delta.skippedBelowThresholdBlocks ?? 0),\n\t\tskippedSecretBlocks: stats.skippedSecretBlocks + (delta.skippedSecretBlocks ?? 0),\n\t\tskippedLeanContextBlocks: stats.skippedLeanContextBlocks + (delta.skippedLeanContextBlocks ?? 0),\n\t\tfailedOpenBlocks: stats.failedOpenBlocks + (delta.failedOpenBlocks ?? 0),\n\t\tinputTokens: stats.inputTokens + (delta.inputTokens ?? 0),\n\t\toutputTokens: stats.outputTokens + (delta.outputTokens ?? 0),\n\t};\n}\n\nfunction getThresholdTokens(options: HeadroomBeforeProviderSendOptions, message: ToolResultMessage<unknown>): number {\n\tconst threshold = isLogLikeToolResult(message)\n\t\t? (options.logsThresholdTokens ?? options.thresholdTokens)\n\t\t: options.thresholdTokens;\n\tif (threshold === undefined) return DEFAULT_THRESHOLD_TOKENS;\n\tif (!Number.isFinite(threshold) || threshold < 0) return 0;\n\treturn Math.ceil(threshold);\n}\n\nfunction isLogLikeToolResult(message: ToolResultMessage<unknown>): boolean {\n\tif (/\\b(?:bash|exec|shell|log|logs|stderr|stdout)\\b/i.test(message.toolName)) return true;\n\tconst details = asRecord(message.details);\n\tif (!details) return false;\n\treturn [\"path\", \"filePath\", \"command\", \"query\"].some((key) => {\n\t\tconst value = details[key];\n\t\treturn typeof value === \"string\" && /(?:\\.log\\b|\\blogs?\\b|stderr|stdout|trace)/i.test(value);\n\t});\n}\n\nfunction isLeanContextStub(text: string): boolean {\n\treturn text.trimStart().startsWith(LEAN_CONTEXT_STUB_PREFIX);\n}\n\nfunction containsSecretPattern(text: string): boolean {\n\treturn DEFAULT_SECRET_PATTERNS.some((pattern) => regexTestStateless(pattern, text));\n}\n\nfunction regexTestStateless(pattern: RegExp, text: string): boolean {\n\tconst flags = pattern.flags.replace(/[gy]/g, \"\");\n\treturn new RegExp(pattern.source, flags).test(text);\n}\n\nfunction asRecord(value: unknown): Record<string, unknown> | undefined {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value)\n\t\t? (value as Record<string, unknown>)\n\t\t: undefined;\n}\n"]}

package/dist/core/lean-context-middleware.d.ts

@@ -1,12 +0,0 @@
-import type { BeforeProviderSend } from "@earendil-works/omk-ai";
-import { type LeanContextPolicyOptions, type LeanContextPolicyState } from "./lean-context-policy.ts";
-export interface LeanContextBeforeProviderSendOptions extends LeanContextPolicyOptions {
-    readonly enabled?: boolean;
-}
-export interface LeanContextBeforeProviderSend {
-    readonly beforeProviderSend: BeforeProviderSend;
-    getState(): LeanContextPolicyState;
-    reset(): void;
-}
-export declare function createLeanContextBeforeProviderSend(options?: LeanContextBeforeProviderSendOptions): LeanContextBeforeProviderSend;
-//# sourceMappingURL=lean-context-middleware.d.ts.map

package/dist/core/lean-context-middleware.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"lean-context-middleware.d.ts","sourceRoot":"","sources":["../../src/core/lean-context-middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAA2C,MAAM,wBAAwB,CAAC;AAC1G,OAAO,EAGN,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,oCAAqC,SAAQ,wBAAwB;IACrF,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,6BAA6B;IAC7C,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;IAChD,QAAQ,IAAI,sBAAsB,CAAC;IACnC,KAAK,IAAI,IAAI,CAAC;CACd;AAED,wBAAgB,mCAAmC,CAClD,OAAO,GAAE,oCAAyC,GAChD,6BAA6B,CAiB/B","sourcesContent":["import type { BeforeProviderSend, Context, TextContent, ToolResultMessage } from \"@earendil-works/omk-ai\";\nimport {\n\tcreateLeanContextPolicyState,\n\tdecideLeanContextEmission,\n\ttype LeanContextPolicyOptions,\n\ttype LeanContextPolicyState,\n} from \"./lean-context-policy.ts\";\n\nexport interface LeanContextBeforeProviderSendOptions extends LeanContextPolicyOptions {\n\treadonly enabled?: boolean;\n}\n\nexport interface LeanContextBeforeProviderSend {\n\treadonly beforeProviderSend: BeforeProviderSend;\n\tgetState(): LeanContextPolicyState;\n\treset(): void;\n}\n\nexport function createLeanContextBeforeProviderSend(\n\toptions: LeanContextBeforeProviderSendOptions = {},\n): LeanContextBeforeProviderSend {\n\tlet state = createLeanContextPolicyState();\n\n\treturn {\n\t\tbeforeProviderSend(input) {\n\t\t\tif (options.enabled === false) return undefined;\n\t\t\tconst result = transformContext(input.context, state, options);\n\t\t\tstate = result.nextState;\n\t\t\treturn result.changed ? result.context : undefined;\n\t\t},\n\t\tgetState() {\n\t\t\treturn state;\n\t\t},\n\t\treset() {\n\t\t\tstate = createLeanContextPolicyState();\n\t\t},\n\t};\n}\n\ninterface ContextTransformResult {\n\treadonly context: Context;\n\treadonly nextState: LeanContextPolicyState;\n\treadonly changed: boolean;\n}\n\nfunction transformContext(\n\tcontext: Context,\n\tinitialState: LeanContextPolicyState,\n\toptions: LeanContextBeforeProviderSendOptions,\n): ContextTransformResult {\n\tlet nextState = initialState;\n\tlet changed = false;\n\tconst messages = context.messages.map((message) => {\n\t\tif (message.role !== \"toolResult\") return message;\n\t\tconst result = transformToolResult(message, nextState, options);\n\t\tnextState = result.nextState;\n\t\tchanged = changed || result.changed;\n\t\treturn result.message;\n\t});\n\n\treturn {\n\t\tcontext: changed ? { ...context, messages } : context,\n\t\tnextState,\n\t\tchanged,\n\t};\n}\n\ninterface ToolResultTransformResult {\n\treadonly message: ToolResultMessage;\n\treadonly nextState: LeanContextPolicyState;\n\treadonly changed: boolean;\n}\n\nfunction transformToolResult(\n\tmessage: ToolResultMessage,\n\tinitialState: LeanContextPolicyState,\n\toptions: LeanContextBeforeProviderSendOptions,\n): ToolResultTransformResult {\n\tlet nextState = initialState;\n\tlet changed = false;\n\tconst content = message.content.map((block, index) => {\n\t\tif (block.type !== \"text\") return block;\n\t\tconst key = extractLeanContextKey(message, index);\n\t\tconst decision = decideLeanContextEmission({\n\t\t\tstate: nextState,\n\t\t\ttool: message.toolName,\n\t\t\tkey,\n\t\t\tpath: key,\n\t\t\tcontent: block.text,\n\t\t\tminStubTokens: options.minStubTokens,\n\t\t\tneverStubFilenames: options.neverStubFilenames,\n\t\t\tsecretPatterns: options.secretPatterns,\n\t\t});\n\t\tnextState = decision.nextState;\n\t\tif (decision.emit !== \"stub\" || decision.stub === undefined) return block;\n\t\tchanged = true;\n\t\treturn { type: \"text\", text: decision.stub } satisfies TextContent;\n\t});\n\n\treturn {\n\t\tmessage: changed ? { ...message, content } : message,\n\t\tnextState,\n\t\tchanged,\n\t};\n}\n\nfunction extractLeanContextKey(message: ToolResultMessage, contentIndex: number): string {\n\tconst details = asRecord(message.details);\n\tconst detailKey = firstStringValue(details, [\"leanContextKey\", \"path\", \"filePath\", \"command\", \"query\"]);\n\treturn detailKey ?? `${message.toolName}:${message.toolCallId}:${contentIndex}`;\n}\n\nfunction firstStringValue(record: Record<string, unknown> | undefined, keys: readonly string[]): string | undefined {\n\tif (!record) return undefined;\n\tfor (const key of keys) {\n\t\tconst value = record[key];\n\t\tif (typeof value === \"string\" && value.trim().length > 0) {\n\t\t\treturn value;\n\t\t}\n\t}\n\treturn undefined;\n}\n\nfunction asRecord(value: unknown): Record<string, unknown> | undefined {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value)\n\t\t? (value as Record<string, unknown>)\n\t\t: undefined;\n}\n"]}

package/dist/core/lean-context-middleware.js

@@ -1,87 +0,0 @@
-import { createLeanContextPolicyState, decideLeanContextEmission, } from "./lean-context-policy.js";
-export function createLeanContextBeforeProviderSend(options = {}) {
-    let state = createLeanContextPolicyState();
-    return {
-        beforeProviderSend(input) {
-            if (options.enabled === false)
-                return undefined;
-            const result = transformContext(input.context, state, options);
-            state = result.nextState;
-            return result.changed ? result.context : undefined;
-        },
-        getState() {
-            return state;
-        },
-        reset() {
-            state = createLeanContextPolicyState();
-        },
-    };
-}
-function transformContext(context, initialState, options) {
-    let nextState = initialState;
-    let changed = false;
-    const messages = context.messages.map((message) => {
-        if (message.role !== "toolResult")
-            return message;
-        const result = transformToolResult(message, nextState, options);
-        nextState = result.nextState;
-        changed = changed || result.changed;
-        return result.message;
-    });
-    return {
-        context: changed ? { ...context, messages } : context,
-        nextState,
-        changed,
-    };
-}
-function transformToolResult(message, initialState, options) {
-    let nextState = initialState;
-    let changed = false;
-    const content = message.content.map((block, index) => {
-        if (block.type !== "text")
-            return block;
-        const key = extractLeanContextKey(message, index);
-        const decision = decideLeanContextEmission({
-            state: nextState,
-            tool: message.toolName,
-            key,
-            path: key,
-            content: block.text,
-            minStubTokens: options.minStubTokens,
-            neverStubFilenames: options.neverStubFilenames,
-            secretPatterns: options.secretPatterns,
-        });
-        nextState = decision.nextState;
-        if (decision.emit !== "stub" || decision.stub === undefined)
-            return block;
-        changed = true;
-        return { type: "text", text: decision.stub };
-    });
-    return {
-        message: changed ? { ...message, content } : message,
-        nextState,
-        changed,
-    };
-}
-function extractLeanContextKey(message, contentIndex) {
-    const details = asRecord(message.details);
-    const detailKey = firstStringValue(details, ["leanContextKey", "path", "filePath", "command", "query"]);
-    return detailKey ?? `${message.toolName}:${message.toolCallId}:${contentIndex}`;
-}
-function firstStringValue(record, keys) {
-    if (!record)
-        return undefined;
-    for (const key of keys) {
-        const value = record[key];
-        if (typeof value === "string" && value.trim().length > 0) {
-            return value;
-        }
-    }
-    return undefined;
-}
-function asRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value)
-        ? value
-        : undefined;
-}
-//# sourceMappingURL=lean-context-middleware.js.map

package/dist/core/lean-context-middleware.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"lean-context-middleware.js","sourceRoot":"","sources":["../../src/core/lean-context-middleware.ts"],"names":[],"mappings":"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","sourcesContent":["import type { BeforeProviderSend, Context, TextContent, ToolResultMessage } from \"@earendil-works/omk-ai\";\nimport {\n\tcreateLeanContextPolicyState,\n\tdecideLeanContextEmission,\n\ttype LeanContextPolicyOptions,\n\ttype LeanContextPolicyState,\n} from \"./lean-context-policy.ts\";\n\nexport interface LeanContextBeforeProviderSendOptions extends LeanContextPolicyOptions {\n\treadonly enabled?: boolean;\n}\n\nexport interface LeanContextBeforeProviderSend {\n\treadonly beforeProviderSend: BeforeProviderSend;\n\tgetState(): LeanContextPolicyState;\n\treset(): void;\n}\n\nexport function createLeanContextBeforeProviderSend(\n\toptions: LeanContextBeforeProviderSendOptions = {},\n): LeanContextBeforeProviderSend {\n\tlet state = createLeanContextPolicyState();\n\n\treturn {\n\t\tbeforeProviderSend(input) {\n\t\t\tif (options.enabled === false) return undefined;\n\t\t\tconst result = transformContext(input.context, state, options);\n\t\t\tstate = result.nextState;\n\t\t\treturn result.changed ? result.context : undefined;\n\t\t},\n\t\tgetState() {\n\t\t\treturn state;\n\t\t},\n\t\treset() {\n\t\t\tstate = createLeanContextPolicyState();\n\t\t},\n\t};\n}\n\ninterface ContextTransformResult {\n\treadonly context: Context;\n\treadonly nextState: LeanContextPolicyState;\n\treadonly changed: boolean;\n}\n\nfunction transformContext(\n\tcontext: Context,\n\tinitialState: LeanContextPolicyState,\n\toptions: LeanContextBeforeProviderSendOptions,\n): ContextTransformResult {\n\tlet nextState = initialState;\n\tlet changed = false;\n\tconst messages = context.messages.map((message) => {\n\t\tif (message.role !== \"toolResult\") return message;\n\t\tconst result = transformToolResult(message, nextState, options);\n\t\tnextState = result.nextState;\n\t\tchanged = changed || result.changed;\n\t\treturn result.message;\n\t});\n\n\treturn {\n\t\tcontext: changed ? { ...context, messages } : context,\n\t\tnextState,\n\t\tchanged,\n\t};\n}\n\ninterface ToolResultTransformResult {\n\treadonly message: ToolResultMessage;\n\treadonly nextState: LeanContextPolicyState;\n\treadonly changed: boolean;\n}\n\nfunction transformToolResult(\n\tmessage: ToolResultMessage,\n\tinitialState: LeanContextPolicyState,\n\toptions: LeanContextBeforeProviderSendOptions,\n): ToolResultTransformResult {\n\tlet nextState = initialState;\n\tlet changed = false;\n\tconst content = message.content.map((block, index) => {\n\t\tif (block.type !== \"text\") return block;\n\t\tconst key = extractLeanContextKey(message, index);\n\t\tconst decision = decideLeanContextEmission({\n\t\t\tstate: nextState,\n\t\t\ttool: message.toolName,\n\t\t\tkey,\n\t\t\tpath: key,\n\t\t\tcontent: block.text,\n\t\t\tminStubTokens: options.minStubTokens,\n\t\t\tneverStubFilenames: options.neverStubFilenames,\n\t\t\tsecretPatterns: options.secretPatterns,\n\t\t});\n\t\tnextState = decision.nextState;\n\t\tif (decision.emit !== \"stub\" || decision.stub === undefined) return block;\n\t\tchanged = true;\n\t\treturn { type: \"text\", text: decision.stub } satisfies TextContent;\n\t});\n\n\treturn {\n\t\tmessage: changed ? { ...message, content } : message,\n\t\tnextState,\n\t\tchanged,\n\t};\n}\n\nfunction extractLeanContextKey(message: ToolResultMessage, contentIndex: number): string {\n\tconst details = asRecord(message.details);\n\tconst detailKey = firstStringValue(details, [\"leanContextKey\", \"path\", \"filePath\", \"command\", \"query\"]);\n\treturn detailKey ?? `${message.toolName}:${message.toolCallId}:${contentIndex}`;\n}\n\nfunction firstStringValue(record: Record<string, unknown> | undefined, keys: readonly string[]): string | undefined {\n\tif (!record) return undefined;\n\tfor (const key of keys) {\n\t\tconst value = record[key];\n\t\tif (typeof value === \"string\" && value.trim().length > 0) {\n\t\t\treturn value;\n\t\t}\n\t}\n\treturn undefined;\n}\n\nfunction asRecord(value: unknown): Record<string, unknown> | undefined {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value)\n\t\t? (value as Record<string, unknown>)\n\t\t: undefined;\n}\n"]}

package/dist/core/lean-context-policy.d.ts

@@ -1,45 +0,0 @@
-export declare const LEAN_CONTEXT_DEFAULT_MIN_STUB_TOKENS = 256;
-export declare const LEAN_CONTEXT_NEVER_STUB_FILENAMES: readonly ["AGENTS.md", "CLAUDE.md", "SYSTEM.md"];
-export type LeanContextEmission = "full" | "stub";
-export type LeanContextDecisionReason = "first-pass" | "changed" | "unchanged" | "never-stub-parent-instruction" | "secret-pattern" | "below-min-token-threshold";
-export interface LeanContextPolicyState {
-    readonly hashesByToolKey: Readonly<Record<string, string>>;
-}
-export interface LeanContextPolicyOptions {
-    /** Repeated unchanged outputs below this token estimate stay full. */
-    readonly minStubTokens?: number;
-    /** Basenames that must never be replaced with an unchanged stub. */
-    readonly neverStubFilenames?: readonly string[];
-    /** Patterns that force full output when matched. */
-    readonly secretPatterns?: readonly RegExp[];
-}
-export interface LeanContextPolicyInput extends LeanContextPolicyOptions {
-    readonly state: LeanContextPolicyState;
-    readonly tool: string;
-    /** Stable caller-defined identity inside the tool, such as path or request key. */
-    readonly key: string;
-    readonly content: string;
-    /** Optional path used for parent-instruction filename checks. Defaults to key. */
-    readonly path?: string;
-}
-export interface LeanContextPolicyDecision {
-    readonly emit: LeanContextEmission;
-    readonly reason: LeanContextDecisionReason;
-    readonly contentSha256: string;
-    readonly previousSha256?: string;
-    readonly estimatedTokens: number;
-    readonly nextState: LeanContextPolicyState;
-    readonly stub?: string;
-}
-export declare function createLeanContextPolicyState(hashesByToolKey?: Readonly<Record<string, string>>): LeanContextPolicyState;
-export declare function decideLeanContextEmission(input: LeanContextPolicyInput): LeanContextPolicyDecision;
-export declare function getLeanContextTrackingHash(state: LeanContextPolicyState, tool: string, key: string): string | undefined;
-export declare function createLeanContextTrackingKey(tool: string, key: string): string;
-export declare function estimateLeanContextTokens(content: string): number;
-export declare function formatLeanContextUnchangedStub(input: {
-    readonly tool: string;
-    readonly key: string;
-    readonly contentSha256: string;
-    readonly estimatedTokens: number;
-}): string;
-//# sourceMappingURL=lean-context-policy.d.ts.map

package/dist/core/lean-context-policy.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"lean-context-policy.d.ts","sourceRoot":"","sources":["../../src/core/lean-context-policy.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,oCAAoC,MAAM,CAAC;AACxD,eAAO,MAAM,iCAAiC,kDAAmD,CAAC;AASlG,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,MAAM,CAAC;AAElD,MAAM,MAAM,yBAAyB,GAClC,YAAY,GACZ,SAAS,GACT,WAAW,GACX,+BAA+B,GAC/B,gBAAgB,GAChB,2BAA2B,CAAC;AAE/B,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC3D;AAED,MAAM,WAAW,wBAAwB;IACxC,sEAAsE;IACtE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,oEAAoE;IACpE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChD,oDAAoD;IACpD,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,sBAAuB,SAAQ,wBAAwB;IACvE,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mFAAmF;IACnF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,kFAAkF;IAClF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,yBAAyB;IACzC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,yBAAyB,CAAC;IAC3C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,sBAAsB,CAAC;IAC3C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,4BAA4B,CAC3C,eAAe,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM,GACpD,sBAAsB,CAExB;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,sBAAsB,GAAG,yBAAyB,CA6ClG;AAED,wBAAgB,0BAA0B,CACzC,KAAK,EAAE,sBAAsB,EAC7B,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,GACT,MAAM,GAAG,SAAS,CAEpB;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGjE;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CACjC,GAAG,MAAM,CAET","sourcesContent":["import { createHash } from \"node:crypto\";\n\nconst CHARS_PER_TOKEN_ESTIMATE = 4;\nconst TRACKING_KEY_SEPARATOR = \"\\u0000\";\n\nexport const LEAN_CONTEXT_DEFAULT_MIN_STUB_TOKENS = 256;\nexport const LEAN_CONTEXT_NEVER_STUB_FILENAMES = [\"AGENTS.md\", \"CLAUDE.md\", \"SYSTEM.md\"] as const;\n\nconst DEFAULT_SECRET_PATTERNS: readonly RegExp[] = [\n\t/-----BEGIN [A-Z0-9 ]*PRIVATE KEY-----/i,\n\t/\\b(?:api[_-]?key|access[_-]?token|auth[_-]?token|refresh[_-]?token|client[_-]?secret|password|passwd|pwd)\\b\\s*[:=]\\s*[\"']?[^\\s\"']{8,}/i,\n\t/\\bauthorization\\s*:\\s*bearer\\s+[A-Za-z0-9._~+/=-]{10,}/i,\n\t/\\b(?:gh[pousr]_|sk-|xox[baprs]-)[A-Za-z0-9_=-]{10,}/i,\n];\n\nexport type LeanContextEmission = \"full\" | \"stub\";\n\nexport type LeanContextDecisionReason =\n\t| \"first-pass\"\n\t| \"changed\"\n\t| \"unchanged\"\n\t| \"never-stub-parent-instruction\"\n\t| \"secret-pattern\"\n\t| \"below-min-token-threshold\";\n\nexport interface LeanContextPolicyState {\n\treadonly hashesByToolKey: Readonly<Record<string, string>>;\n}\n\nexport interface LeanContextPolicyOptions {\n\t/** Repeated unchanged outputs below this token estimate stay full. */\n\treadonly minStubTokens?: number;\n\t/** Basenames that must never be replaced with an unchanged stub. */\n\treadonly neverStubFilenames?: readonly string[];\n\t/** Patterns that force full output when matched. */\n\treadonly secretPatterns?: readonly RegExp[];\n}\n\nexport interface LeanContextPolicyInput extends LeanContextPolicyOptions {\n\treadonly state: LeanContextPolicyState;\n\treadonly tool: string;\n\t/** Stable caller-defined identity inside the tool, such as path or request key. */\n\treadonly key: string;\n\treadonly content: string;\n\t/** Optional path used for parent-instruction filename checks. Defaults to key. */\n\treadonly path?: string;\n}\n\nexport interface LeanContextPolicyDecision {\n\treadonly emit: LeanContextEmission;\n\treadonly reason: LeanContextDecisionReason;\n\treadonly contentSha256: string;\n\treadonly previousSha256?: string;\n\treadonly estimatedTokens: number;\n\treadonly nextState: LeanContextPolicyState;\n\treadonly stub?: string;\n}\n\nexport function createLeanContextPolicyState(\n\thashesByToolKey: Readonly<Record<string, string>> = {},\n): LeanContextPolicyState {\n\treturn { hashesByToolKey: { ...hashesByToolKey } };\n}\n\nexport function decideLeanContextEmission(input: LeanContextPolicyInput): LeanContextPolicyDecision {\n\tconst contentSha256 = sha256Text(input.content);\n\tconst trackingKey = createLeanContextTrackingKey(input.tool, input.key);\n\tconst previousSha256 = input.state.hashesByToolKey[trackingKey];\n\tconst estimatedTokens = estimateLeanContextTokens(input.content);\n\tconst nextState = updateTrackedHash(input.state, trackingKey, contentSha256);\n\tconst baseDecision = {\n\t\tcontentSha256,\n\t\tpreviousSha256,\n\t\testimatedTokens,\n\t\tnextState,\n\t};\n\n\tif (previousSha256 === undefined) {\n\t\treturn { ...baseDecision, emit: \"full\", reason: \"first-pass\" };\n\t}\n\n\tif (previousSha256 !== contentSha256) {\n\t\treturn { ...baseDecision, emit: \"full\", reason: \"changed\" };\n\t}\n\n\tif (isNeverStubParentInstruction(input.path ?? input.key, input.neverStubFilenames)) {\n\t\treturn { ...baseDecision, emit: \"full\", reason: \"never-stub-parent-instruction\" };\n\t}\n\n\tif (containsSecretPattern(input.content, input.secretPatterns)) {\n\t\treturn { ...baseDecision, emit: \"full\", reason: \"secret-pattern\" };\n\t}\n\n\tconst minStubTokens = normalizeMinStubTokens(input.minStubTokens);\n\tif (estimatedTokens < minStubTokens) {\n\t\treturn { ...baseDecision, emit: \"full\", reason: \"below-min-token-threshold\" };\n\t}\n\n\treturn {\n\t\t...baseDecision,\n\t\temit: \"stub\",\n\t\treason: \"unchanged\",\n\t\tstub: formatLeanContextUnchangedStub({\n\t\t\ttool: input.tool,\n\t\t\tkey: input.key,\n\t\t\tcontentSha256,\n\t\t\testimatedTokens,\n\t\t}),\n\t};\n}\n\nexport function getLeanContextTrackingHash(\n\tstate: LeanContextPolicyState,\n\ttool: string,\n\tkey: string,\n): string | undefined {\n\treturn state.hashesByToolKey[createLeanContextTrackingKey(tool, key)];\n}\n\nexport function createLeanContextTrackingKey(tool: string, key: string): string {\n\treturn `${tool}${TRACKING_KEY_SEPARATOR}${key}`;\n}\n\nexport function estimateLeanContextTokens(content: string): number {\n\tif (content.length === 0) return 0;\n\treturn Math.ceil(content.length / CHARS_PER_TOKEN_ESTIMATE);\n}\n\nexport function formatLeanContextUnchangedStub(input: {\n\treadonly tool: string;\n\treadonly key: string;\n\treadonly contentSha256: string;\n\treadonly estimatedTokens: number;\n}): string {\n\treturn `[lean-context] ${input.tool} result for ${input.key} unchanged; omitted ${input.estimatedTokens} estimated tokens (sha256:${input.contentSha256.slice(0, 12)}).`;\n}\n\nfunction updateTrackedHash(\n\tstate: LeanContextPolicyState,\n\ttrackingKey: string,\n\tcontentSha256: string,\n): LeanContextPolicyState {\n\tif (state.hashesByToolKey[trackingKey] === contentSha256) {\n\t\treturn state;\n\t}\n\treturn {\n\t\thashesByToolKey: {\n\t\t\t...state.hashesByToolKey,\n\t\t\t[trackingKey]: contentSha256,\n\t\t},\n\t};\n}\n\nfunction sha256Text(content: string): string {\n\treturn createHash(\"sha256\").update(content, \"utf8\").digest(\"hex\");\n}\n\nfunction isNeverStubParentInstruction(pathOrKey: string, filenames?: readonly string[]): boolean {\n\tconst allowedNames = filenames ?? LEAN_CONTEXT_NEVER_STUB_FILENAMES;\n\tconst basename = getBasename(pathOrKey).toUpperCase();\n\treturn allowedNames.some((name) => name.toUpperCase() === basename);\n}\n\nfunction getBasename(pathOrKey: string): string {\n\tconst normalized = pathOrKey.replaceAll(\"\\\\\", \"/\");\n\tconst parts = normalized.split(\"/\");\n\treturn parts.at(-1) ?? normalized;\n}\n\nfunction containsSecretPattern(content: string, patterns?: readonly RegExp[]): boolean {\n\tconst activePatterns = patterns ?? DEFAULT_SECRET_PATTERNS;\n\treturn activePatterns.some((pattern) => regexTestStateless(pattern, content));\n}\n\nfunction regexTestStateless(pattern: RegExp, content: string): boolean {\n\tconst flags = pattern.flags.replace(/[gy]/g, \"\");\n\treturn new RegExp(pattern.source, flags).test(content);\n}\n\nfunction normalizeMinStubTokens(value: number | undefined): number {\n\tif (value === undefined) return LEAN_CONTEXT_DEFAULT_MIN_STUB_TOKENS;\n\tif (!Number.isFinite(value) || value <= 0) return 0;\n\treturn Math.ceil(value);\n}\n"]}

package/dist/core/lean-context-policy.js

@@ -1,108 +0,0 @@
-import { createHash } from "node:crypto";
-const CHARS_PER_TOKEN_ESTIMATE = 4;
-const TRACKING_KEY_SEPARATOR = "\u0000";
-export const LEAN_CONTEXT_DEFAULT_MIN_STUB_TOKENS = 256;
-export const LEAN_CONTEXT_NEVER_STUB_FILENAMES = ["AGENTS.md", "CLAUDE.md", "SYSTEM.md"];
-const DEFAULT_SECRET_PATTERNS = [
-    /-----BEGIN [A-Z0-9 ]*PRIVATE KEY-----/i,
-    /\b(?:api[_-]?key|access[_-]?token|auth[_-]?token|refresh[_-]?token|client[_-]?secret|password|passwd|pwd)\b\s*[:=]\s*["']?[^\s"']{8,}/i,
-    /\bauthorization\s*:\s*bearer\s+[A-Za-z0-9._~+/=-]{10,}/i,
-    /\b(?:gh[pousr]_|sk-|xox[baprs]-)[A-Za-z0-9_=-]{10,}/i,
-];
-export function createLeanContextPolicyState(hashesByToolKey = {}) {
-    return { hashesByToolKey: { ...hashesByToolKey } };
-}
-export function decideLeanContextEmission(input) {
-    const contentSha256 = sha256Text(input.content);
-    const trackingKey = createLeanContextTrackingKey(input.tool, input.key);
-    const previousSha256 = input.state.hashesByToolKey[trackingKey];
-    const estimatedTokens = estimateLeanContextTokens(input.content);
-    const nextState = updateTrackedHash(input.state, trackingKey, contentSha256);
-    const baseDecision = {
-        contentSha256,
-        previousSha256,
-        estimatedTokens,
-        nextState,
-    };
-    if (previousSha256 === undefined) {
-        return { ...baseDecision, emit: "full", reason: "first-pass" };
-    }
-    if (previousSha256 !== contentSha256) {
-        return { ...baseDecision, emit: "full", reason: "changed" };
-    }
-    if (isNeverStubParentInstruction(input.path ?? input.key, input.neverStubFilenames)) {
-        return { ...baseDecision, emit: "full", reason: "never-stub-parent-instruction" };
-    }
-    if (containsSecretPattern(input.content, input.secretPatterns)) {
-        return { ...baseDecision, emit: "full", reason: "secret-pattern" };
-    }
-    const minStubTokens = normalizeMinStubTokens(input.minStubTokens);
-    if (estimatedTokens < minStubTokens) {
-        return { ...baseDecision, emit: "full", reason: "below-min-token-threshold" };
-    }
-    return {
-        ...baseDecision,
-        emit: "stub",
-        reason: "unchanged",
-        stub: formatLeanContextUnchangedStub({
-            tool: input.tool,
-            key: input.key,
-            contentSha256,
-            estimatedTokens,
-        }),
-    };
-}
-export function getLeanContextTrackingHash(state, tool, key) {
-    return state.hashesByToolKey[createLeanContextTrackingKey(tool, key)];
-}
-export function createLeanContextTrackingKey(tool, key) {
-    return `${tool}${TRACKING_KEY_SEPARATOR}${key}`;
-}
-export function estimateLeanContextTokens(content) {
-    if (content.length === 0)
-        return 0;
-    return Math.ceil(content.length / CHARS_PER_TOKEN_ESTIMATE);
-}
-export function formatLeanContextUnchangedStub(input) {
-    return `[lean-context] ${input.tool} result for ${input.key} unchanged; omitted ${input.estimatedTokens} estimated tokens (sha256:${input.contentSha256.slice(0, 12)}).`;
-}
-function updateTrackedHash(state, trackingKey, contentSha256) {
-    if (state.hashesByToolKey[trackingKey] === contentSha256) {
-        return state;
-    }
-    return {
-        hashesByToolKey: {
-            ...state.hashesByToolKey,
-            [trackingKey]: contentSha256,
-        },
-    };
-}
-function sha256Text(content) {
-    return createHash("sha256").update(content, "utf8").digest("hex");
-}
-function isNeverStubParentInstruction(pathOrKey, filenames) {
-    const allowedNames = filenames ?? LEAN_CONTEXT_NEVER_STUB_FILENAMES;
-    const basename = getBasename(pathOrKey).toUpperCase();
-    return allowedNames.some((name) => name.toUpperCase() === basename);
-}
-function getBasename(pathOrKey) {
-    const normalized = pathOrKey.replaceAll("\\", "/");
-    const parts = normalized.split("/");
-    return parts.at(-1) ?? normalized;
-}
-function containsSecretPattern(content, patterns) {
-    const activePatterns = patterns ?? DEFAULT_SECRET_PATTERNS;
-    return activePatterns.some((pattern) => regexTestStateless(pattern, content));
-}
-function regexTestStateless(pattern, content) {
-    const flags = pattern.flags.replace(/[gy]/g, "");
-    return new RegExp(pattern.source, flags).test(content);
-}
-function normalizeMinStubTokens(value) {
-    if (value === undefined)
-        return LEAN_CONTEXT_DEFAULT_MIN_STUB_TOKENS;
-    if (!Number.isFinite(value) || value <= 0)
-        return 0;
-    return Math.ceil(value);
-}
-//# sourceMappingURL=lean-context-policy.js.map

package/dist/core/lean-context-policy.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"lean-context-policy.js","sourceRoot":"","sources":["../../src/core/lean-context-policy.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\n\nconst CHARS_PER_TOKEN_ESTIMATE = 4;\nconst TRACKING_KEY_SEPARATOR = \"\\u0000\";\n\nexport const LEAN_CONTEXT_DEFAULT_MIN_STUB_TOKENS = 256;\nexport const LEAN_CONTEXT_NEVER_STUB_FILENAMES = [\"AGENTS.md\", \"CLAUDE.md\", \"SYSTEM.md\"] as const;\n\nconst DEFAULT_SECRET_PATTERNS: readonly RegExp[] = [\n\t/-----BEGIN [A-Z0-9 ]*PRIVATE KEY-----/i,\n\t/\\b(?:api[_-]?key|access[_-]?token|auth[_-]?token|refresh[_-]?token|client[_-]?secret|password|passwd|pwd)\\b\\s*[:=]\\s*[\"']?[^\\s\"']{8,}/i,\n\t/\\bauthorization\\s*:\\s*bearer\\s+[A-Za-z0-9._~+/=-]{10,}/i,\n\t/\\b(?:gh[pousr]_|sk-|xox[baprs]-)[A-Za-z0-9_=-]{10,}/i,\n];\n\nexport type LeanContextEmission = \"full\" | \"stub\";\n\nexport type LeanContextDecisionReason =\n\t| \"first-pass\"\n\t| \"changed\"\n\t| \"unchanged\"\n\t| \"never-stub-parent-instruction\"\n\t| \"secret-pattern\"\n\t| \"below-min-token-threshold\";\n\nexport interface LeanContextPolicyState {\n\treadonly hashesByToolKey: Readonly<Record<string, string>>;\n}\n\nexport interface LeanContextPolicyOptions {\n\t/** Repeated unchanged outputs below this token estimate stay full. */\n\treadonly minStubTokens?: number;\n\t/** Basenames that must never be replaced with an unchanged stub. */\n\treadonly neverStubFilenames?: readonly string[];\n\t/** Patterns that force full output when matched. */\n\treadonly secretPatterns?: readonly RegExp[];\n}\n\nexport interface LeanContextPolicyInput extends LeanContextPolicyOptions {\n\treadonly state: LeanContextPolicyState;\n\treadonly tool: string;\n\t/** Stable caller-defined identity inside the tool, such as path or request key. */\n\treadonly key: string;\n\treadonly content: string;\n\t/** Optional path used for parent-instruction filename checks. Defaults to key. */\n\treadonly path?: string;\n}\n\nexport interface LeanContextPolicyDecision {\n\treadonly emit: LeanContextEmission;\n\treadonly reason: LeanContextDecisionReason;\n\treadonly contentSha256: string;\n\treadonly previousSha256?: string;\n\treadonly estimatedTokens: number;\n\treadonly nextState: LeanContextPolicyState;\n\treadonly stub?: string;\n}\n\nexport function createLeanContextPolicyState(\n\thashesByToolKey: Readonly<Record<string, string>> = {},\n): LeanContextPolicyState {\n\treturn { hashesByToolKey: { ...hashesByToolKey } };\n}\n\nexport function decideLeanContextEmission(input: LeanContextPolicyInput): LeanContextPolicyDecision {\n\tconst contentSha256 = sha256Text(input.content);\n\tconst trackingKey = createLeanContextTrackingKey(input.tool, input.key);\n\tconst previousSha256 = input.state.hashesByToolKey[trackingKey];\n\tconst estimatedTokens = estimateLeanContextTokens(input.content);\n\tconst nextState = updateTrackedHash(input.state, trackingKey, contentSha256);\n\tconst baseDecision = {\n\t\tcontentSha256,\n\t\tpreviousSha256,\n\t\testimatedTokens,\n\t\tnextState,\n\t};\n\n\tif (previousSha256 === undefined) {\n\t\treturn { ...baseDecision, emit: \"full\", reason: \"first-pass\" };\n\t}\n\n\tif (previousSha256 !== contentSha256) {\n\t\treturn { ...baseDecision, emit: \"full\", reason: \"changed\" };\n\t}\n\n\tif (isNeverStubParentInstruction(input.path ?? input.key, input.neverStubFilenames)) {\n\t\treturn { ...baseDecision, emit: \"full\", reason: \"never-stub-parent-instruction\" };\n\t}\n\n\tif (containsSecretPattern(input.content, input.secretPatterns)) {\n\t\treturn { ...baseDecision, emit: \"full\", reason: \"secret-pattern\" };\n\t}\n\n\tconst minStubTokens = normalizeMinStubTokens(input.minStubTokens);\n\tif (estimatedTokens < minStubTokens) {\n\t\treturn { ...baseDecision, emit: \"full\", reason: \"below-min-token-threshold\" };\n\t}\n\n\treturn {\n\t\t...baseDecision,\n\t\temit: \"stub\",\n\t\treason: \"unchanged\",\n\t\tstub: formatLeanContextUnchangedStub({\n\t\t\ttool: input.tool,\n\t\t\tkey: input.key,\n\t\t\tcontentSha256,\n\t\t\testimatedTokens,\n\t\t}),\n\t};\n}\n\nexport function getLeanContextTrackingHash(\n\tstate: LeanContextPolicyState,\n\ttool: string,\n\tkey: string,\n): string | undefined {\n\treturn state.hashesByToolKey[createLeanContextTrackingKey(tool, key)];\n}\n\nexport function createLeanContextTrackingKey(tool: string, key: string): string {\n\treturn `${tool}${TRACKING_KEY_SEPARATOR}${key}`;\n}\n\nexport function estimateLeanContextTokens(content: string): number {\n\tif (content.length === 0) return 0;\n\treturn Math.ceil(content.length / CHARS_PER_TOKEN_ESTIMATE);\n}\n\nexport function formatLeanContextUnchangedStub(input: {\n\treadonly tool: string;\n\treadonly key: string;\n\treadonly contentSha256: string;\n\treadonly estimatedTokens: number;\n}): string {\n\treturn `[lean-context] ${input.tool} result for ${input.key} unchanged; omitted ${input.estimatedTokens} estimated tokens (sha256:${input.contentSha256.slice(0, 12)}).`;\n}\n\nfunction updateTrackedHash(\n\tstate: LeanContextPolicyState,\n\ttrackingKey: string,\n\tcontentSha256: string,\n): LeanContextPolicyState {\n\tif (state.hashesByToolKey[trackingKey] === contentSha256) {\n\t\treturn state;\n\t}\n\treturn {\n\t\thashesByToolKey: {\n\t\t\t...state.hashesByToolKey,\n\t\t\t[trackingKey]: contentSha256,\n\t\t},\n\t};\n}\n\nfunction sha256Text(content: string): string {\n\treturn createHash(\"sha256\").update(content, \"utf8\").digest(\"hex\");\n}\n\nfunction isNeverStubParentInstruction(pathOrKey: string, filenames?: readonly string[]): boolean {\n\tconst allowedNames = filenames ?? LEAN_CONTEXT_NEVER_STUB_FILENAMES;\n\tconst basename = getBasename(pathOrKey).toUpperCase();\n\treturn allowedNames.some((name) => name.toUpperCase() === basename);\n}\n\nfunction getBasename(pathOrKey: string): string {\n\tconst normalized = pathOrKey.replaceAll(\"\\\\\", \"/\");\n\tconst parts = normalized.split(\"/\");\n\treturn parts.at(-1) ?? normalized;\n}\n\nfunction containsSecretPattern(content: string, patterns?: readonly RegExp[]): boolean {\n\tconst activePatterns = patterns ?? DEFAULT_SECRET_PATTERNS;\n\treturn activePatterns.some((pattern) => regexTestStateless(pattern, content));\n}\n\nfunction regexTestStateless(pattern: RegExp, content: string): boolean {\n\tconst flags = pattern.flags.replace(/[gy]/g, \"\");\n\treturn new RegExp(pattern.source, flags).test(content);\n}\n\nfunction normalizeMinStubTokens(value: number | undefined): number {\n\tif (value === undefined) return LEAN_CONTEXT_DEFAULT_MIN_STUB_TOKENS;\n\tif (!Number.isFinite(value) || value <= 0) return 0;\n\treturn Math.ceil(value);\n}\n"]}

package/dist/core/native-adoption-benchmark.d.ts

@@ -1,166 +0,0 @@
-import { type RetrievalRanking, type ScoredContextCandidate } from "./context-graph-retrieval.ts";
-export declare const NATIVE_ADOPTION_BASELINE_SCHEMA_VERSION = "native-adoption-baseline.v1";
-export declare const DEFAULT_NATIVE_ADOPTION_SEED = 12648430;
-export type NativeAdoptionBenchmarkTarget = "selectMmrContext" | "fuseRrfRankings" | "scoreTopicalRelevance" | "scoreRetrievalCandidate" | "renderContextPack" | "cacheKeyControl";
-export type NativeAdoptionBottleneckClass = "cpu" | "io" | "provider" | "spawn" | "unknown";
-export type NativeAdoptionVerdict = "go" | "no-go" | "needs-telemetry";
-export interface NativeAdoptionFixtureOptions {
-    candidateCount: number;
-    embeddingDimensions: number;
-    seed?: number;
-}
-export interface NativeAdoptionFixtureManifest {
-    sha256: string;
-    payloadBytes: number;
-    candidateCount: number;
-    embeddingDimensions: number;
-    seed: number;
-}
-export interface NativeAdoptionFixture {
-    seed: number;
-    candidateCount: number;
-    embeddingDimensions: number;
-    query: string;
-    queryEmbedding?: readonly number[];
-    candidates: readonly ScoredContextCandidate[];
-    rankings: readonly RetrievalRanking[];
-    manifest: NativeAdoptionFixtureManifest;
-}
-export interface NativeAdoptionSampleStats {
-    samples: number;
-    minNs: number;
-    maxNs: number;
-    meanNs: number;
-    p50Ns: number;
-    p95Ns: number;
-    p99Ns: number;
-    coefficientOfVariation: number;
-}
-export interface NativeAdoptionTargetResult {
-    target: NativeAdoptionBenchmarkTarget;
-    operations: number;
-    outputDigest: string;
-}
-export interface NativeAdoptionTargetMeasurement extends NativeAdoptionTargetResult {
-    stats: NativeAdoptionSampleStats;
-    sideEffects: NativeAdoptionSideEffectCounts;
-}
-export interface NativeAdoptionMeasureOptions {
-    iterations?: number;
-    warmupIterations?: number;
-    clock?: () => number;
-}
-export interface NativeAdoptionGateInput {
-    runtimeCallsites: number;
-    bottleneckClass: NativeAdoptionBottleneckClass;
-    typescriptP95Ns: number;
-    projectedRustP95Ns: number;
-    ipcOverheadP95Ns: number;
-    movableFraction: number;
-    startupP95Ms: number;
-    rssDeltaMb: number;
-    archiveDeltaMb: number;
-    sideEffectViolations?: readonly string[];
-    budgets?: Partial<NativeAdoptionGateBudgets>;
-}
-export interface NativeAdoptionGateBudgets {
-    minTypeScriptP95Ns: number;
-    minMovableFraction: number;
-    maxIpcOverheadFraction: number;
-    minProjectedNetSpeedup: number;
-    maxStartupP95Ms: number;
-    maxRssDeltaMb: number;
-    maxArchiveDeltaMb: number;
-}
-export interface NativeAdoptionGateMetrics {
-    retainedTypeScriptP95Ns: number;
-    sidecarNetP95Ns: number;
-    projectedNetSpeedup: number;
-    cpuSpeedup: number;
-    ipcOverheadFraction: number;
-    movableFraction: number;
-}
-export interface NativeAdoptionGateDecision {
-    verdict: NativeAdoptionVerdict;
-    reasons: readonly string[];
-    metrics: NativeAdoptionGateMetrics;
-    budgets: NativeAdoptionGateBudgets;
-}
-export interface NativeAdoptionBaselineInput {
-    repoSha: string;
-    runtime: string;
-    generatedAt: string;
-    fixture: NativeAdoptionFixture;
-    measurements: readonly NativeAdoptionTargetMeasurement[];
-    decision: NativeAdoptionGateDecision;
-}
-export interface NativeAdoptionBaseline {
-    schemaVersion: typeof NATIVE_ADOPTION_BASELINE_SCHEMA_VERSION;
-    repoSha: string;
-    runtime: string;
-    generatedAt: string;
-    env: Record<string, never>;
-    fixture: NativeAdoptionFixtureManifest;
-    measurements: readonly NativeAdoptionTargetMeasurement[];
-    decision: NativeAdoptionGateDecision;
-}
-export interface NativeAdoptionSecretScanFinding {
-    path: string;
-    pattern: string;
-}
-export interface NativeAdoptionForbiddenImportFinding {
-    path: string;
-    specifier: string;
-    statement: string;
-}
-export interface NativeAdoptionSideEffectCounts {
-    network: number;
-    spawn: number;
-    fileRead: number;
-}
-export interface NativeAdoptionSideEffectRecorder {
-    recordNetwork: () => never;
-    recordSpawn: () => never;
-    recordFileRead: () => never;
-}
-export interface NativeAdoptionGuardedResult<T> {
-    value: T;
-    sideEffects: NativeAdoptionSideEffectCounts;
-}
-export interface NativeAdoptionSourceFile {
-    path: string;
-    content: string;
-}
-export interface NativeAdoptionCallsiteInput {
-    symbols: readonly string[];
-    files: readonly NativeAdoptionSourceFile[];
-}
-export interface NativeAdoptionCallsiteSummary {
-    runtimeCallsites: number;
-    testCallsites: number;
-    definitionCallsites: number;
-    exportCallsites: number;
-    harnessCallsites: number;
-    bySymbol: Record<string, {
-        runtime: number;
-        test: number;
-        definition: number;
-        export: number;
-        harness: number;
-    }>;
-}
-export declare function createNativeAdoptionFixture(options: NativeAdoptionFixtureOptions): NativeAdoptionFixture;
-export declare function assertNativeAdoptionFixtureSecretFree(fixture: NativeAdoptionFixture): void;
-export declare function scanNativeAdoptionSecrets(value: unknown): NativeAdoptionSecretScanFinding[];
-export declare function assertNativeAdoptionBaselineSecretFree(value: unknown): void;
-export declare const assertNativeAdoptionDocumentSecretFree: typeof assertNativeAdoptionBaselineSecretFree;
-export declare function runNativeAdoptionTarget(target: NativeAdoptionBenchmarkTarget, fixture: NativeAdoptionFixture): NativeAdoptionTargetResult;
-export declare function measureNativeAdoptionTarget(target: NativeAdoptionBenchmarkTarget, fixture: NativeAdoptionFixture, options?: NativeAdoptionMeasureOptions): NativeAdoptionTargetMeasurement;
-export declare function summarizeNativeAdoptionSamples(samples: readonly number[]): NativeAdoptionSampleStats;
-export declare function withNativeAdoptionSideEffectGuards<T>(fn: (recorder: NativeAdoptionSideEffectRecorder) => T): NativeAdoptionGuardedResult<T>;
-export declare function evaluateNativeAdoptionGate(input: NativeAdoptionGateInput): NativeAdoptionGateDecision;
-export declare function createNativeAdoptionBaseline(input: NativeAdoptionBaselineInput): NativeAdoptionBaseline;
-export declare function classifyNativeAdoptionCallsites(input: NativeAdoptionCallsiteInput): NativeAdoptionCallsiteSummary;
-export declare function scanNativeAdoptionForbiddenImports(files: readonly NativeAdoptionSourceFile[]): NativeAdoptionForbiddenImportFinding[];
-export declare function assertNativeAdoptionTimedTargetImportSafe(content: string, path?: string): void;
-//# sourceMappingURL=native-adoption-benchmark.d.ts.map

package/dist/core/native-adoption-benchmark.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"native-adoption-benchmark.d.ts","sourceRoot":"","sources":["../../src/core/native-adoption-benchmark.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { performance } from \"node:perf_hooks\";\nimport {\n\tcanonicalJsonStringify,\n\tfuseRrfRankings,\n\ttype RetrievalRanking,\n\trenderContextPack,\n\ttype ScoredContextCandidate,\n\tscoreRetrievalCandidate,\n\tscoreTopicalRelevance,\n\tselectMmrContext,\n} from \"./context-graph-retrieval.ts\";\n\nexport const NATIVE_ADOPTION_BASELINE_SCHEMA_VERSION = \"native-adoption-baseline.v1\";\nexport const DEFAULT_NATIVE_ADOPTION_SEED = 0xc0ffee;\n\nconst DEFAULT_MIN_TYPESCRIPT_P95_NS = 200_000;\nconst DEFAULT_MIN_MOVABLE_FRACTION = 0.6;\nconst DEFAULT_MAX_IPC_OVERHEAD_FRACTION = 0.3;\nconst DEFAULT_MIN_NET_SPEEDUP = 3;\nconst DEFAULT_MAX_STARTUP_P95_MS = 150;\nconst DEFAULT_MAX_RSS_DELTA_MB = 64;\nconst DEFAULT_MAX_ARCHIVE_DELTA_MB = 15;\nconst DEFAULT_TOKEN_BUDGET = 2_400;\n\nexport type NativeAdoptionBenchmarkTarget =\n\t| \"selectMmrContext\"\n\t| \"fuseRrfRankings\"\n\t| \"scoreTopicalRelevance\"\n\t| \"scoreRetrievalCandidate\"\n\t| \"renderContextPack\"\n\t| \"cacheKeyControl\";\n\nexport type NativeAdoptionBottleneckClass = \"cpu\" | \"io\" | \"provider\" | \"spawn\" | \"unknown\";\nexport type NativeAdoptionVerdict = \"go\" | \"no-go\" | \"needs-telemetry\";\n\nexport interface NativeAdoptionFixtureOptions {\n\tcandidateCount: number;\n\tembeddingDimensions: number;\n\tseed?: number;\n}\n\nexport interface NativeAdoptionFixtureManifest {\n\tsha256: string;\n\tpayloadBytes: number;\n\tcandidateCount: number;\n\tembeddingDimensions: number;\n\tseed: number;\n}\n\nexport interface NativeAdoptionFixture {\n\tseed: number;\n\tcandidateCount: number;\n\tembeddingDimensions: number;\n\tquery: string;\n\tqueryEmbedding?: readonly number[];\n\tcandidates: readonly ScoredContextCandidate[];\n\trankings: readonly RetrievalRanking[];\n\tmanifest: NativeAdoptionFixtureManifest;\n}\n\nexport interface NativeAdoptionSampleStats {\n\tsamples: number;\n\tminNs: number;\n\tmaxNs: number;\n\tmeanNs: number;\n\tp50Ns: number;\n\tp95Ns: number;\n\tp99Ns: number;\n\tcoefficientOfVariation: number;\n}\n\nexport interface NativeAdoptionTargetResult {\n\ttarget: NativeAdoptionBenchmarkTarget;\n\toperations: number;\n\toutputDigest: string;\n}\n\nexport interface NativeAdoptionTargetMeasurement extends NativeAdoptionTargetResult {\n\tstats: NativeAdoptionSampleStats;\n\tsideEffects: NativeAdoptionSideEffectCounts;\n}\n\nexport interface NativeAdoptionMeasureOptions {\n\titerations?: number;\n\twarmupIterations?: number;\n\tclock?: () => number;\n}\n\nexport interface NativeAdoptionGateInput {\n\truntimeCallsites: number;\n\tbottleneckClass: NativeAdoptionBottleneckClass;\n\ttypescriptP95Ns: number;\n\tprojectedRustP95Ns: number;\n\tipcOverheadP95Ns: number;\n\tmovableFraction: number;\n\tstartupP95Ms: number;\n\trssDeltaMb: number;\n\tarchiveDeltaMb: number;\n\tsideEffectViolations?: readonly string[];\n\tbudgets?: Partial<NativeAdoptionGateBudgets>;\n}\n\nexport interface NativeAdoptionGateBudgets {\n\tminTypeScriptP95Ns: number;\n\tminMovableFraction: number;\n\tmaxIpcOverheadFraction: number;\n\tminProjectedNetSpeedup: number;\n\tmaxStartupP95Ms: number;\n\tmaxRssDeltaMb: number;\n\tmaxArchiveDeltaMb: number;\n}\n\nexport interface NativeAdoptionGateMetrics {\n\tretainedTypeScriptP95Ns: number;\n\tsidecarNetP95Ns: number;\n\tprojectedNetSpeedup: number;\n\tcpuSpeedup: number;\n\tipcOverheadFraction: number;\n\tmovableFraction: number;\n}\n\nexport interface NativeAdoptionGateDecision {\n\tverdict: NativeAdoptionVerdict;\n\treasons: readonly string[];\n\tmetrics: NativeAdoptionGateMetrics;\n\tbudgets: NativeAdoptionGateBudgets;\n}\n\nexport interface NativeAdoptionBaselineInput {\n\trepoSha: string;\n\truntime: string;\n\tgeneratedAt: string;\n\tfixture: NativeAdoptionFixture;\n\tmeasurements: readonly NativeAdoptionTargetMeasurement[];\n\tdecision: NativeAdoptionGateDecision;\n}\n\nexport interface NativeAdoptionBaseline {\n\tschemaVersion: typeof NATIVE_ADOPTION_BASELINE_SCHEMA_VERSION;\n\trepoSha: string;\n\truntime: string;\n\tgeneratedAt: string;\n\tenv: Record<string, never>;\n\tfixture: NativeAdoptionFixtureManifest;\n\tmeasurements: readonly NativeAdoptionTargetMeasurement[];\n\tdecision: NativeAdoptionGateDecision;\n}\n\nexport interface NativeAdoptionSecretScanFinding {\n\tpath: string;\n\tpattern: string;\n}\n\nexport interface NativeAdoptionForbiddenImportFinding {\n\tpath: string;\n\tspecifier: string;\n\tstatement: string;\n}\n\nexport interface NativeAdoptionSideEffectCounts {\n\tnetwork: number;\n\tspawn: number;\n\tfileRead: number;\n}\n\nexport interface NativeAdoptionSideEffectRecorder {\n\trecordNetwork: () => never;\n\trecordSpawn: () => never;\n\trecordFileRead: () => never;\n}\n\nexport interface NativeAdoptionGuardedResult<T> {\n\tvalue: T;\n\tsideEffects: NativeAdoptionSideEffectCounts;\n}\n\nexport interface NativeAdoptionSourceFile {\n\tpath: string;\n\tcontent: string;\n}\n\nexport interface NativeAdoptionCallsiteInput {\n\tsymbols: readonly string[];\n\tfiles: readonly NativeAdoptionSourceFile[];\n}\n\nexport interface NativeAdoptionCallsiteSummary {\n\truntimeCallsites: number;\n\ttestCallsites: number;\n\tdefinitionCallsites: number;\n\texportCallsites: number;\n\tharnessCallsites: number;\n\tbySymbol: Record<\n\t\tstring,\n\t\t{\n\t\t\truntime: number;\n\t\t\ttest: number;\n\t\t\tdefinition: number;\n\t\t\texport: number;\n\t\t\tharness: number;\n\t\t}\n\t>;\n}\n\ntype NativeAdoptionSourceCategory = \"definition\" | \"export\" | \"test\" | \"harness\" | \"runtime\";\n\ninterface Prng {\n\tnext: () => number;\n}\n\nconst SECRET_PATTERNS: ReadonlyArray<{ name: string; pattern: RegExp }> = [\n\t{ name: \"pem-private-key\", pattern: /-----BEGIN [A-Z ]*PRIVATE KEY-----/i },\n\t{ name: \"bearer-token\", pattern: /\\bBearer\\s+[A-Za-z0-9._~+/=-]{16,}/i },\n\t{ name: \"jwt\", pattern: /\\beyJ[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+\\b/ },\n\t{\n\t\tname: \"env-secret-assignment\",\n\t\tpattern: /\\b[A-Z0-9_]*(?:API[_-]?KEY|SECRET|TOKEN|PASSWORD|PRIVATE[_-]?KEY)[A-Z0-9_]*\\s*=\\s*[\"']?[^\"'\\s]{8,}/,\n\t},\n\t{\n\t\tname: \"vendor-token-prefix\",\n\t\tpattern: /\\b(?:(?:ghp|gho|ghu|ghs|github_pat)_[A-Za-z0-9_]{16,}|sk-[A-Za-z0-9]{16,})\\b/,\n\t},\n];\n\nconst FORBIDDEN_NATIVE_ADOPTION_IMPORTS = new Set([\n\t\"fs\",\n\t\"node:fs\",\n\t\"child_process\",\n\t\"node:child_process\",\n\t\"net\",\n\t\"node:net\",\n\t\"tls\",\n\t\"node:tls\",\n\t\"http\",\n\t\"node:http\",\n\t\"https\",\n\t\"node:https\",\n\t\"undici\",\n]);\n\nexport function createNativeAdoptionFixture(options: NativeAdoptionFixtureOptions): NativeAdoptionFixture {\n\tconst seed = normalizeSeed(options.seed ?? DEFAULT_NATIVE_ADOPTION_SEED);\n\tconst candidateCount = Math.max(0, Math.floor(options.candidateCount));\n\tconst embeddingDimensions = Math.max(0, Math.floor(options.embeddingDimensions));\n\tconst prng = createMulberry32(seed);\n\tconst topics = [\"retrieval\", \"memory\", \"ontology\", \"cache\", \"session\", \"tools\"];\n\tconst query = \"context graph retrieval ranking memory cache\";\n\tconst queryEmbedding = embeddingDimensions > 0 ? createVector(prng, embeddingDimensions) : undefined;\n\tconst candidates: ScoredContextCandidate[] = [];\n\n\tfor (let index = 0; index < candidateCount; index++) {\n\t\tconst topic = topics[index % topics.length] ?? \"retrieval\";\n\t\tconst score = round6(1 - index / Math.max(candidateCount, 1) + prng.next() * 0.05);\n\t\tcandidates.push({\n\t\t\tid: `fixture-${index.toString().padStart(5, \"0\")}`,\n\t\t\tpath: `packages/coding-agent/src/fixture/${topic}-${index}.ts`,\n\t\t\ttitle: `${topic} fixture ${index}`,\n\t\t\tsymbol: `fixtureSymbol${index}`,\n\t\t\tkind: index % 3 === 0 ? \"function\" : \"document\",\n\t\t\tcontent: createFixtureContent(topic, index),\n\t\t\ttokenEstimate: 32 + (index % 11) * 7,\n\t\t\ttopic,\n\t\t\t...(embeddingDimensions > 0 ? { embedding: createVector(prng, embeddingDimensions) } : {}),\n\t\t\tscore: clamp01(score),\n\t\t\trrfScore: clamp01(score * 0.8),\n\t\t\ttopicalScore: clamp01(score * 0.9),\n\t\t});\n\t}\n\n\tconst rankings = createFixtureRankings(candidates);\n\tconst payload = { seed, candidateCount, embeddingDimensions, query, queryEmbedding, candidates, rankings };\n\tconst payloadText = canonicalJsonStringify(payload);\n\tconst manifest = {\n\t\tsha256: sha256Hex(payloadText),\n\t\tpayloadBytes: Buffer.byteLength(payloadText, \"utf8\"),\n\t\tcandidateCount,\n\t\tembeddingDimensions,\n\t\tseed,\n\t};\n\tconst fixture: NativeAdoptionFixture = {\n\t\tseed,\n\t\tcandidateCount,\n\t\tembeddingDimensions,\n\t\tquery,\n\t\t...(queryEmbedding ? { queryEmbedding } : {}),\n\t\tcandidates,\n\t\trankings,\n\t\tmanifest,\n\t};\n\tassertNativeAdoptionFixtureSecretFree(fixture);\n\treturn fixture;\n}\n\nexport function assertNativeAdoptionFixtureSecretFree(fixture: NativeAdoptionFixture): void {\n\tconst payload = canonicalJsonStringify({\n\t\tseed: fixture.seed,\n\t\tcandidateCount: fixture.candidateCount,\n\t\tembeddingDimensions: fixture.embeddingDimensions,\n\t\tquery: fixture.query,\n\t\tqueryEmbedding: fixture.queryEmbedding,\n\t\tcandidates: fixture.candidates,\n\t\trankings: fixture.rankings,\n\t\tmanifest: fixture.manifest,\n\t});\n\tconst hit = SECRET_PATTERNS.find(({ pattern }) => pattern.test(payload));\n\tif (hit) {\n\t\tthrow new Error(`secret-like fixture content rejected: ${hit.name}`);\n\t}\n}\n\nexport function scanNativeAdoptionSecrets(value: unknown): NativeAdoptionSecretScanFinding[] {\n\tconst findings: NativeAdoptionSecretScanFinding[] = [];\n\tvisitNativeAdoptionSecretValue(value, \"$\", findings, new Set<object>());\n\treturn findings;\n}\n\nexport function assertNativeAdoptionBaselineSecretFree(value: unknown): void {\n\tconst findings = scanNativeAdoptionSecrets(value);\n\tif (findings.length > 0) {\n\t\tconst first = findings[0];\n\t\tthrow new Error(`secret-like baseline content rejected: ${first?.pattern ?? \"unknown\"} at ${first?.path ?? \"$\"}`);\n\t}\n}\n\nexport const assertNativeAdoptionDocumentSecretFree = assertNativeAdoptionBaselineSecretFree;\n\nexport function runNativeAdoptionTarget(\n\ttarget: NativeAdoptionBenchmarkTarget,\n\tfixture: NativeAdoptionFixture,\n): NativeAdoptionTargetResult {\n\tassertNativeAdoptionFixtureSecretFree(fixture);\n\tif (target === \"selectMmrContext\") {\n\t\tconst result = selectMmrContext(fixture.candidates, { tokenBudget: DEFAULT_TOKEN_BUDGET, lambda: 0.6 });\n\t\treturn digestTargetResult(\n\t\t\ttarget,\n\t\t\tresult.selected.map((candidate) => candidate.id),\n\t\t\tfixture.candidates.length,\n\t\t);\n\t}\n\tif (target === \"fuseRrfRankings\") {\n\t\tconst result = fuseRrfRankings(fixture.rankings, { limit: Math.min(100, fixture.candidates.length) });\n\t\treturn digestTargetResult(\n\t\t\ttarget,\n\t\t\tresult.map((hit) => [hit.id, round6(hit.score)]),\n\t\t\tfixture.candidates.length,\n\t\t);\n\t}\n\tif (target === \"scoreTopicalRelevance\") {\n\t\tconst result = fixture.candidates.map((candidate) =>\n\t\t\tscoreTopicalRelevance({ query: fixture.query, queryEmbedding: fixture.queryEmbedding, document: candidate }),\n\t\t);\n\t\treturn digestTargetResult(\n\t\t\ttarget,\n\t\t\tresult.map((score) => round6(score.score)),\n\t\t\tfixture.candidates.length,\n\t\t);\n\t}\n\tif (target === \"scoreRetrievalCandidate\") {\n\t\tconst result = fixture.candidates.map(\n\t\t\t(candidate) =>\n\t\t\t\tscoreRetrievalCandidate({\n\t\t\t\t\trrfScore: candidate.rrfScore ?? candidate.score,\n\t\t\t\t\ttopicalScore: candidate.topicalScore ?? candidate.score,\n\t\t\t\t\tgraphScore: candidate.score,\n\t\t\t\t\trecencyScore: (candidate.score * 0.5) % 1,\n\t\t\t\t\tauthorityScore: (candidate.score * 0.75) % 1,\n\t\t\t\t\tconflictPenalty: candidate.conflicts?.length ? 1 : 0,\n\t\t\t\t}).finalScore,\n\t\t);\n\t\treturn digestTargetResult(target, result.map(round6), fixture.candidates.length);\n\t}\n\tif (target === \"renderContextPack\") {\n\t\tconst result = renderContextPack(fixture.candidates.slice(0, Math.min(16, fixture.candidates.length)), {\n\t\t\tqueryIntent: \"native-adoption-benchmark\",\n\t\t\tmaxEvidenceChars: 180,\n\t\t});\n\t\treturn digestTargetResult(target, result, fixture.candidates.length);\n\t}\n\tconst result = canonicalJsonStringify({\n\t\tquery: fixture.query,\n\t\tmanifest: fixture.manifest,\n\t\tfirst: fixture.candidates[0]?.id ?? \"none\",\n\t});\n\treturn digestTargetResult(target, result, fixture.candidates.length);\n}\n\nexport function measureNativeAdoptionTarget(\n\ttarget: NativeAdoptionBenchmarkTarget,\n\tfixture: NativeAdoptionFixture,\n\toptions: NativeAdoptionMeasureOptions = {},\n): NativeAdoptionTargetMeasurement {\n\tconst iterations = Math.max(1, Math.floor(options.iterations ?? 20));\n\tconst warmupIterations = Math.max(0, Math.floor(options.warmupIterations ?? 5));\n\tconst clock = options.clock ?? performance.now.bind(performance);\n\tlet lastResult = runNativeAdoptionTarget(target, fixture);\n\tfor (let index = 0; index < warmupIterations; index++) {\n\t\tlastResult = runNativeAdoptionTarget(target, fixture);\n\t}\n\n\tconst samples: number[] = [];\n\tlet sideEffects = createEmptySideEffectCounts();\n\tfor (let index = 0; index < iterations; index++) {\n\t\tconst guarded = withNativeAdoptionSideEffectGuards(() => {\n\t\t\tconst startMs = clock();\n\t\t\tlastResult = runNativeAdoptionTarget(target, fixture);\n\t\t\tconst endMs = clock();\n\t\t\treturn Math.max(0, Math.round((endMs - startMs) * 1_000_000));\n\t\t});\n\t\tsideEffects = addSideEffects(sideEffects, guarded.sideEffects);\n\t\tsamples.push(guarded.value);\n\t}\n\n\treturn {\n\t\t...lastResult,\n\t\tstats: summarizeNativeAdoptionSamples(samples),\n\t\tsideEffects,\n\t};\n}\n\nexport function summarizeNativeAdoptionSamples(samples: readonly number[]): NativeAdoptionSampleStats {\n\tif (samples.length === 0) {\n\t\treturn {\n\t\t\tsamples: 0,\n\t\t\tminNs: 0,\n\t\t\tmaxNs: 0,\n\t\t\tmeanNs: 0,\n\t\t\tp50Ns: 0,\n\t\t\tp95Ns: 0,\n\t\t\tp99Ns: 0,\n\t\t\tcoefficientOfVariation: 0,\n\t\t};\n\t}\n\tconst sorted = [...samples].map((sample) => Math.max(0, Math.round(sample))).sort((a, b) => a - b);\n\tconst meanNs = sorted.reduce((sum, sample) => sum + sample, 0) / sorted.length;\n\tconst variance = sorted.reduce((sum, sample) => sum + (sample - meanNs) ** 2, 0) / sorted.length;\n\treturn {\n\t\tsamples: sorted.length,\n\t\tminNs: sorted[0] ?? 0,\n\t\tmaxNs: sorted[sorted.length - 1] ?? 0,\n\t\tmeanNs,\n\t\tp50Ns: nearestRank(sorted, 0.5),\n\t\tp95Ns: nearestRank(sorted, 0.95),\n\t\tp99Ns: nearestRank(sorted, 0.99),\n\t\tcoefficientOfVariation: meanNs === 0 ? 0 : Math.sqrt(variance) / meanNs,\n\t};\n}\n\nexport function withNativeAdoptionSideEffectGuards<T>(\n\tfn: (recorder: NativeAdoptionSideEffectRecorder) => T,\n): NativeAdoptionGuardedResult<T> {\n\tconst sideEffects = createEmptySideEffectCounts();\n\tconst recorder = createSideEffectRecorder(sideEffects);\n\tconst originalFetch = globalThis.fetch;\n\tglobalThis.fetch = ((..._args: Parameters<typeof fetch>) => recorder.recordNetwork()) as typeof fetch;\n\n\tlet value: T | undefined;\n\tlet thrown: unknown;\n\ttry {\n\t\tvalue = fn(recorder);\n\t} catch (error) {\n\t\tthrown = error;\n\t} finally {\n\t\tglobalThis.fetch = originalFetch;\n\t}\n\n\tconst violations = formatSideEffectViolations(sideEffects);\n\tif (violations.length > 0) {\n\t\tthrow new Error(`forbidden side effect during native adoption benchmark: ${violations.join(\",\")}`);\n\t}\n\tif (thrown) throw thrown;\n\treturn { value: value as T, sideEffects };\n}\n\nexport function evaluateNativeAdoptionGate(input: NativeAdoptionGateInput): NativeAdoptionGateDecision {\n\tconst budgets = createGateBudgets(input.budgets);\n\tconst movableFraction = clamp01(input.movableFraction);\n\tconst retainedTypeScriptP95Ns = Math.max(0, input.typescriptP95Ns) * (1 - movableFraction);\n\tconst sidecarNetP95Ns =\n\t\tretainedTypeScriptP95Ns + Math.max(0, input.projectedRustP95Ns) + Math.max(0, input.ipcOverheadP95Ns);\n\tconst projectedNetSpeedup = sidecarNetP95Ns > 0 ? Math.max(0, input.typescriptP95Ns) / sidecarNetP95Ns : 0;\n\tconst movableTypeScriptP95Ns = Math.max(0, input.typescriptP95Ns) * movableFraction;\n\tconst cpuSpeedup = input.projectedRustP95Ns > 0 ? movableTypeScriptP95Ns / input.projectedRustP95Ns : 0;\n\tconst ipcOverheadFraction =\n\t\tinput.typescriptP95Ns > 0 ? Math.max(0, input.ipcOverheadP95Ns) / input.typescriptP95Ns : 1;\n\tconst reasons: string[] = [];\n\n\tif (input.runtimeCallsites <= 0) reasons.push(\"runtime-callsite-absent\");\n\tif (input.bottleneckClass !== \"cpu\") reasons.push(`bottleneck-not-cpu:${input.bottleneckClass}`);\n\tif (input.typescriptP95Ns < budgets.minTypeScriptP95Ns) reasons.push(\"typescript-p95-too-small\");\n\tif (movableFraction < budgets.minMovableFraction) reasons.push(\"movable-fraction-too-low\");\n\tif (ipcOverheadFraction >= budgets.maxIpcOverheadFraction) reasons.push(\"ipc-overhead-too-high\");\n\tif (projectedNetSpeedup < budgets.minProjectedNetSpeedup) reasons.push(\"projected-net-speedup-too-low\");\n\tif (input.startupP95Ms > budgets.maxStartupP95Ms) reasons.push(\"startup-p95-too-high\");\n\tif (input.rssDeltaMb > budgets.maxRssDeltaMb) reasons.push(\"rss-delta-too-high\");\n\tif (input.archiveDeltaMb > budgets.maxArchiveDeltaMb) reasons.push(\"archive-delta-too-high\");\n\tfor (const violation of input.sideEffectViolations ?? []) {\n\t\treasons.push(`side-effect:${violation}`);\n\t}\n\n\treturn {\n\t\tverdict: reasons.length === 0 ? \"go\" : \"no-go\",\n\t\treasons,\n\t\tmetrics: {\n\t\t\tretainedTypeScriptP95Ns,\n\t\t\tsidecarNetP95Ns,\n\t\t\tprojectedNetSpeedup,\n\t\t\tcpuSpeedup,\n\t\t\tipcOverheadFraction,\n\t\t\tmovableFraction,\n\t\t},\n\t\tbudgets,\n\t};\n}\n\nexport function createNativeAdoptionBaseline(input: NativeAdoptionBaselineInput): NativeAdoptionBaseline {\n\tassertNativeAdoptionFixtureSecretFree(input.fixture);\n\tconst baseline = {\n\t\tschemaVersion: NATIVE_ADOPTION_BASELINE_SCHEMA_VERSION,\n\t\trepoSha: input.repoSha,\n\t\truntime: input.runtime,\n\t\tgeneratedAt: input.generatedAt,\n\t\tenv: {},\n\t\tfixture: input.fixture.manifest,\n\t\tmeasurements: input.measurements,\n\t\tdecision: input.decision,\n\t} satisfies NativeAdoptionBaseline;\n\tassertNativeAdoptionBaselineSecretFree(baseline);\n\treturn baseline;\n}\n\nexport function classifyNativeAdoptionCallsites(input: NativeAdoptionCallsiteInput): NativeAdoptionCallsiteSummary {\n\tconst bySymbol: NativeAdoptionCallsiteSummary[\"bySymbol\"] = {};\n\tfor (const symbol of input.symbols) {\n\t\tbySymbol[symbol] = { runtime: 0, test: 0, definition: 0, export: 0, harness: 0 };\n\t}\n\n\tfor (const file of input.files) {\n\t\tconst category = classifySourceFile(file);\n\t\tfor (const symbol of input.symbols) {\n\t\t\tconst symbolSummary = bySymbol[symbol];\n\t\t\tif (!symbolSummary) continue;\n\t\t\tconst count = countNativeAdoptionReferences(file, symbol, category);\n\t\t\tif (count === 0) continue;\n\t\t\tif (category === \"test\") symbolSummary.test += count;\n\t\t\telse if (category === \"definition\") symbolSummary.definition += count;\n\t\t\telse if (category === \"export\") symbolSummary.export += count;\n\t\t\telse if (category === \"harness\") symbolSummary.harness += count;\n\t\t\telse symbolSummary.runtime += count;\n\t\t}\n\t}\n\n\treturn {\n\t\truntimeCallsites: sumBySymbol(bySymbol, \"runtime\"),\n\t\ttestCallsites: sumBySymbol(bySymbol, \"test\"),\n\t\tdefinitionCallsites: sumBySymbol(bySymbol, \"definition\"),\n\t\texportCallsites: sumBySymbol(bySymbol, \"export\"),\n\t\tharnessCallsites: sumBySymbol(bySymbol, \"harness\"),\n\t\tbySymbol,\n\t};\n}\n\nexport function scanNativeAdoptionForbiddenImports(\n\tfiles: readonly NativeAdoptionSourceFile[],\n): NativeAdoptionForbiddenImportFinding[] {\n\tconst findings: NativeAdoptionForbiddenImportFinding[] = [];\n\tfor (const file of files) {\n\t\tfor (const match of findNativeAdoptionImportSpecifiers(file.content)) {\n\t\t\tif (FORBIDDEN_NATIVE_ADOPTION_IMPORTS.has(match.specifier)) {\n\t\t\t\tfindings.push({ path: file.path, specifier: match.specifier, statement: match.statement });\n\t\t\t}\n\t\t}\n\t}\n\treturn findings;\n}\n\nexport function assertNativeAdoptionTimedTargetImportSafe(content: string, path = \"<inline>\"): void {\n\tconst findings = scanNativeAdoptionForbiddenImports([{ path, content }]);\n\tif (findings.length > 0) {\n\t\tconst first = findings[0];\n\t\tthrow new Error(`forbidden static import in timed native adoption target: ${first?.specifier ?? \"unknown\"}`);\n\t}\n}\n\nfunction createFixtureContent(topic: string, index: number): string {\n\treturn [\n\t\t`Fixture document ${index} covers ${topic} retrieval behavior.`,\n\t\t\"It describes graph context ranking, memory evidence, ontology validation, cache policy, and session packing.\",\n\t\t\"The text is synthetic and contains no credentials, network endpoints, or external provider payloads.\",\n\t].join(\" \");\n}\n\nfunction createFixtureRankings(candidates: readonly ScoredContextCandidate[]): RetrievalRanking[] {\n\tconst lexical = candidates.map((candidate) => ({ id: candidate.id, score: candidate.score }));\n\tconst vector = [...candidates]\n\t\t.sort((a, b) => (a.topic ?? \"\").localeCompare(b.topic ?? \"\") || b.score - a.score)\n\t\t.map((candidate) => ({ id: candidate.id, score: candidate.score }));\n\tconst graph = [...candidates]\n\t\t.sort((a, b) => (a.path ?? \"\").localeCompare(b.path ?? \"\"))\n\t\t.map((candidate) => ({ id: candidate.id, score: candidate.score }));\n\treturn [\n\t\t{ name: \"lexical\", weight: 1, hits: lexical },\n\t\t{ name: \"vector\", weight: 1.15, hits: vector },\n\t\t{ name: \"graph\", weight: 0.85, hits: graph },\n\t];\n}\n\nfunction createVector(prng: Prng, dimensions: number): number[] {\n\treturn Array.from({ length: dimensions }, () => round6(prng.next() * 2 - 1));\n}\n\nfunction createMulberry32(seed: number): Prng {\n\tlet state = seed >>> 0;\n\treturn {\n\t\tnext: () => {\n\t\t\tstate += 0x6d2b79f5;\n\t\t\tlet value = state;\n\t\t\tvalue = Math.imul(value ^ (value >>> 15), value | 1);\n\t\t\tvalue ^= value + Math.imul(value ^ (value >>> 7), value | 61);\n\t\t\treturn ((value ^ (value >>> 14)) >>> 0) / 4_294_967_296;\n\t\t},\n\t};\n}\n\nfunction normalizeSeed(seed: number): number {\n\treturn Number.isFinite(seed) ? Math.floor(seed) >>> 0 : DEFAULT_NATIVE_ADOPTION_SEED;\n}\n\nfunction digestTargetResult(\n\ttarget: NativeAdoptionBenchmarkTarget,\n\toutput: unknown,\n\toperations: number,\n): NativeAdoptionTargetResult {\n\treturn {\n\t\ttarget,\n\t\toperations,\n\t\toutputDigest: sha256Hex(canonicalJsonStringify({ target, output })),\n\t};\n}\n\nfunction sha256Hex(value: string): string {\n\treturn createHash(\"sha256\").update(value, \"utf8\").digest(\"hex\");\n}\n\nfunction nearestRank(sortedSamples: readonly number[], percentile: number): number {\n\tif (sortedSamples.length === 0) return 0;\n\tconst index = Math.min(sortedSamples.length - 1, Math.max(0, Math.ceil(percentile * sortedSamples.length) - 1));\n\treturn sortedSamples[index] ?? 0;\n}\n\nfunction createEmptySideEffectCounts(): NativeAdoptionSideEffectCounts {\n\treturn { network: 0, spawn: 0, fileRead: 0 };\n}\n\nfunction createSideEffectRecorder(sideEffects: NativeAdoptionSideEffectCounts): NativeAdoptionSideEffectRecorder {\n\treturn {\n\t\trecordNetwork: () => {\n\t\t\tsideEffects.network += 1;\n\t\t\tthrow new Error(\"forbidden side effect: network\");\n\t\t},\n\t\trecordSpawn: () => {\n\t\t\tsideEffects.spawn += 1;\n\t\t\tthrow new Error(\"forbidden side effect: spawn\");\n\t\t},\n\t\trecordFileRead: () => {\n\t\t\tsideEffects.fileRead += 1;\n\t\t\tthrow new Error(\"forbidden side effect: file-read\");\n\t\t},\n\t};\n}\n\nfunction addSideEffects(\n\tleft: NativeAdoptionSideEffectCounts,\n\tright: NativeAdoptionSideEffectCounts,\n): NativeAdoptionSideEffectCounts {\n\treturn {\n\t\tnetwork: left.network + right.network,\n\t\tspawn: left.spawn + right.spawn,\n\t\tfileRead: left.fileRead + right.fileRead,\n\t};\n}\n\nfunction formatSideEffectViolations(sideEffects: NativeAdoptionSideEffectCounts): string[] {\n\tconst violations: string[] = [];\n\tif (sideEffects.network > 0) violations.push(`network:${sideEffects.network}`);\n\tif (sideEffects.spawn > 0) violations.push(`spawn:${sideEffects.spawn}`);\n\tif (sideEffects.fileRead > 0) violations.push(`fileRead:${sideEffects.fileRead}`);\n\treturn violations;\n}\n\nfunction createGateBudgets(input: Partial<NativeAdoptionGateBudgets> | undefined): NativeAdoptionGateBudgets {\n\treturn {\n\t\tminTypeScriptP95Ns: input?.minTypeScriptP95Ns ?? DEFAULT_MIN_TYPESCRIPT_P95_NS,\n\t\tminMovableFraction: input?.minMovableFraction ?? DEFAULT_MIN_MOVABLE_FRACTION,\n\t\tmaxIpcOverheadFraction: input?.maxIpcOverheadFraction ?? DEFAULT_MAX_IPC_OVERHEAD_FRACTION,\n\t\tminProjectedNetSpeedup: input?.minProjectedNetSpeedup ?? DEFAULT_MIN_NET_SPEEDUP,\n\t\tmaxStartupP95Ms: input?.maxStartupP95Ms ?? DEFAULT_MAX_STARTUP_P95_MS,\n\t\tmaxRssDeltaMb: input?.maxRssDeltaMb ?? DEFAULT_MAX_RSS_DELTA_MB,\n\t\tmaxArchiveDeltaMb: input?.maxArchiveDeltaMb ?? DEFAULT_MAX_ARCHIVE_DELTA_MB,\n\t};\n}\n\nfunction classifySourceFile(file: NativeAdoptionSourceFile): NativeAdoptionSourceCategory {\n\tconst normalizedPath = file.path.replaceAll(\"\\\\\", \"/\");\n\tif (normalizedPath.endsWith(\"/src/core/native-adoption-benchmark.ts\")) return \"harness\";\n\tif (normalizedPath.includes(\"/test/bench/\") || normalizedPath.endsWith(\"/test/native-adoption-runner.test.ts\")) {\n\t\treturn \"harness\";\n\t}\n\tif (/\\/(test|tests)\\//.test(normalizedPath) || /\\.test\\.tsx?$/.test(normalizedPath)) return \"test\";\n\tif (normalizedPath.endsWith(\"/context-graph-retrieval.ts\")) return \"definition\";\n\tif (normalizedPath.endsWith(\"/src/index.ts\")) return \"export\";\n\treturn \"runtime\";\n}\n\nfunction countNativeAdoptionReferences(\n\tfile: NativeAdoptionSourceFile,\n\tsymbol: string,\n\tcategory: NativeAdoptionSourceCategory,\n): number {\n\tif (category === \"export\") return countBarrelExportReferences(file, symbol);\n\tif (category === \"definition\") return countDefinitionReferences(file.content, symbol);\n\treturn countCallExpressionReferences(file.content, symbol);\n}\n\nfunction countDefinitionReferences(content: string, symbol: string): number {\n\tconst escaped = escapeRegExp(symbol);\n\treturn (\n\t\tcontent.match(new RegExp(`(?:export\\\\s+)?(?:function|const|let|var|class)\\\\s+${escaped}\\\\b`, \"g\"))?.length ?? 0\n\t);\n}\n\nfunction countCallExpressionReferences(content: string, symbol: string): number {\n\tconst escaped = escapeRegExp(symbol);\n\tconst sanitized = stripCommentsAndStrings(content);\n\tconst matches = sanitized.match(new RegExp(`(^|[^\\\\w.$])${escaped}\\\\s*\\\\(`, \"g\"));\n\treturn matches?.length ?? 0;\n}\n\nfunction countSymbolReferences(content: string, symbol: string): number {\n\tconst escaped = escapeRegExp(symbol);\n\treturn content.match(new RegExp(`\\\\b${escaped}\\\\b`, \"g\"))?.length ?? 0;\n}\n\nfunction countBarrelExportReferences(file: NativeAdoptionSourceFile, symbol: string): number {\n\tconst normalizedPath = file.path.replaceAll(\"\\\\\", \"/\");\n\tif (!normalizedPath.endsWith(\"/src/index.ts\")) return 0;\n\tif (countSymbolReferences(file.content, symbol) > 0) return 0;\n\treturn file.content.includes(\"context-graph-retrieval.ts\") ? 1 : 0;\n}\n\nfunction sumBySymbol(\n\tbySymbol: NativeAdoptionCallsiteSummary[\"bySymbol\"],\n\tkey: \"runtime\" | \"test\" | \"definition\" | \"export\" | \"harness\",\n): number {\n\treturn Object.values(bySymbol).reduce((sum, value) => sum + value[key], 0);\n}\n\nfunction visitNativeAdoptionSecretValue(\n\tvalue: unknown,\n\tpath: string,\n\tfindings: NativeAdoptionSecretScanFinding[],\n\tseen: Set<object>,\n): void {\n\tif (typeof value === \"string\") {\n\t\tfor (const { name, pattern } of SECRET_PATTERNS) {\n\t\t\tif (pattern.test(value)) findings.push({ path, pattern: name });\n\t\t}\n\t\treturn;\n\t}\n\tif (typeof value !== \"object\" || value === null) return;\n\tif (seen.has(value)) return;\n\tseen.add(value);\n\tif (Array.isArray(value)) {\n\t\tvalue.forEach((entry, index) => {\n\t\t\tvisitNativeAdoptionSecretValue(entry, `${path}[${index}]`, findings, seen);\n\t\t});\n\t\treturn;\n\t}\n\tfor (const [key, entry] of Object.entries(value as Record<string, unknown>)) {\n\t\tvisitNativeAdoptionSecretValue(entry, `${path}.${key}`, findings, seen);\n\t}\n}\n\nfunction findNativeAdoptionImportSpecifiers(content: string): Array<{ specifier: string; statement: string }> {\n\tconst imports: Array<{ specifier: string; statement: string }> = [];\n\tconst sanitized = stripCommentsAndStrings(content, { keepImportSpecifiers: true });\n\tconst importPattern =\n\t\t/\\bimport\\s+(?:type\\s+)?(?:[^\"';]+?\\s+from\\s+)?[\"']([^\"']+)[\"']|\\brequire\\(\\s*[\"']([^\"']+)[\"']\\s*\\)/g;\n\tfor (const match of sanitized.matchAll(importPattern)) {\n\t\tconst specifier = match[1] ?? match[2];\n\t\tif (!specifier) continue;\n\t\timports.push({ specifier, statement: match[0] });\n\t}\n\treturn imports;\n}\n\nfunction stripCommentsAndStrings(content: string, options: { keepImportSpecifiers?: boolean } = {}): string {\n\tlet output = \"\";\n\tlet index = 0;\n\tlet state: \"code\" | \"single\" | \"double\" | \"template\" | \"line\" | \"block\" = \"code\";\n\twhile (index < content.length) {\n\t\tconst char = content[index] ?? \"\";\n\t\tconst next = content[index + 1] ?? \"\";\n\t\tif (state === \"code\") {\n\t\t\tif (char === \"/\" && next === \"/\") {\n\t\t\t\toutput += \"  \";\n\t\t\t\tindex += 2;\n\t\t\t\tstate = \"line\";\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (char === \"/\" && next === \"*\") {\n\t\t\t\toutput += \"  \";\n\t\t\t\tindex += 2;\n\t\t\t\tstate = \"block\";\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (char === \"'\") {\n\t\t\t\toutput += options.keepImportSpecifiers ? char : \" \";\n\t\t\t\tindex += 1;\n\t\t\t\tstate = \"single\";\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (char === '\"') {\n\t\t\t\toutput += options.keepImportSpecifiers ? char : \" \";\n\t\t\t\tindex += 1;\n\t\t\t\tstate = \"double\";\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (char === \"`\") {\n\t\t\t\toutput += \" \";\n\t\t\t\tindex += 1;\n\t\t\t\tstate = \"template\";\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\toutput += char;\n\t\t\tindex += 1;\n\t\t\tcontinue;\n\t\t}\n\t\tif (state === \"line\") {\n\t\t\toutput += char === \"\\n\" ? \"\\n\" : \" \";\n\t\t\tindex += 1;\n\t\t\tif (char === \"\\n\") state = \"code\";\n\t\t\tcontinue;\n\t\t}\n\t\tif (state === \"block\") {\n\t\t\toutput += char === \"\\n\" ? \"\\n\" : \" \";\n\t\t\tif (char === \"*\" && next === \"/\") {\n\t\t\t\toutput += \" \";\n\t\t\t\tindex += 2;\n\t\t\t\tstate = \"code\";\n\t\t\t} else {\n\t\t\t\tindex += 1;\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\t\tconst quote = state === \"single\" ? \"'\" : state === \"double\" ? '\"' : \"`\";\n\t\toutput += options.keepImportSpecifiers && state !== \"template\" ? char : char === \"\\n\" ? \"\\n\" : \" \";\n\t\tif (char === \"\\\\\") {\n\t\t\tconst escaped = content[index + 1] ?? \"\";\n\t\t\toutput += options.keepImportSpecifiers && state !== \"template\" ? escaped : escaped === \"\\n\" ? \"\\n\" : \" \";\n\t\t\tindex += 2;\n\t\t\tcontinue;\n\t\t}\n\t\tindex += 1;\n\t\tif (char === quote) state = \"code\";\n\t}\n\treturn output;\n}\n\nfunction escapeRegExp(value: string): string {\n\treturn value.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n}\n\nfunction round6(value: number): number {\n\treturn Math.round(value * 1_000_000) / 1_000_000;\n}\n\nfunction clamp01(value: number): number {\n\tif (!Number.isFinite(value)) return 0;\n\tif (value < 0) return 0;\n\tif (value > 1) return 1;\n\treturn value;\n}\n"]}