rea-agents 3.0.0 → 3.2.0

package/dist/domain/managedMemberComparisonCoverage.js

@@ -1,32 +1,18 @@
-export const buildComparisonCoverage = ({ left, right, leftMethodPage, rightMethodPage, leftFieldPage, rightFieldPage, omittedMethodItems, omittedFieldItems, omittedCandidates, }) => {
-    const omittedMethods = omittedMethodItems +
-        leftMethodPage.sourceOmittedCount +
-        rightMethodPage.sourceOmittedCount;
-    const omittedFields = omittedFieldItems +
-        leftFieldPage.sourceOmittedCount +
-        rightFieldPage.sourceOmittedCount;
-    const leftStatus = sideCoverageStatus(left, leftMethodPage.sourceComplete && leftFieldPage.sourceComplete);
-    const rightStatus = sideCoverageStatus(right, rightMethodPage.sourceComplete && rightFieldPage.sourceComplete);
+export const buildComparisonCoverage = ({ left, right, }) => {
+    const leftStatus = sideCoverageStatus(left);
+    const rightStatus = sideCoverageStatus(right);
     const unknownInput = left.coverage.state !== "complete" || right.coverage.state !== "complete";
-    const truncated = omittedMethods + omittedFields + omittedCandidates > 0;
     return {
-        status: unknownInput
-            ? "partial"
-            : truncated
-                ? "truncated"
-                : leftStatus === "complete" && rightStatus === "complete"
-                    ? "complete-within-inputs"
-                    : "partial",
+        status: !unknownInput && leftStatus === "complete" && rightStatus === "complete"
+            ? "complete-within-inputs"
+            : "partial",
         left_status: leftStatus,
         right_status: rightStatus,
-        omitted_methods: omittedMethods,
-        omitted_fields: omittedFields,
-        omitted_candidates: omittedCandidates,
     };
 };
-const sideCoverageStatus = (result, pagesComplete) => result.coverage.state === "unavailable"
+const sideCoverageStatus = (result) => result.coverage.state === "unavailable"
     ? "unavailable"
-    : result.coverage.state === "complete" && pagesComplete
+    : result.coverage.state === "complete"
         ? "complete"
         : "partial";
 export const sideManifest = (side) => ({
@@ -35,8 +21,8 @@ export const sideManifest = (side) => ({
     mvid: side.result.module?.mvid ?? null,
     module_name: side.result.module?.name ?? null,
     metadata_status: side.result.metadata.status,
-    methods_total: side.result.methods.total,
-    fields_total: side.result.fields.total,
+    methods_total: side.result.methods.length,
+    fields_total: side.result.fields.length,
 });
 export const buildComparisonSummary = (items) => ({
     unchanged: items.filter(({ status }) => status === "unchanged").length,
@@ -53,20 +39,12 @@ export const buildComparisonMatching = (methodItems, fieldItems) => ({
         fieldItems.filter(({ match }) => match.status === "ambiguous").length,
     unmatched: [...methodItems, ...fieldItems].filter(({ match }) => match.status === "unmatched").length,
 });
-export const comparisonLimitations = (left, right, omittedItems, omittedCandidates) => {
+export const comparisonLimitations = (left, right) => {
     const limitations = [
         "Metadata tokens are build-local coordinates; matched pairs are remaps, not persistent identities.",
         "Names are reported as observations but are not used as a matching basis.",
     ];
-    if (!left.methods.complete || !right.methods.complete)
-        limitations.push("At least one method page is incomplete.");
-    if (!left.fields.complete || !right.fields.complete)
-        limitations.push("At least one field page is incomplete.");
     if (left.coverage.state !== "complete" || right.coverage.state !== "complete")
         limitations.push("At least one managed member observation is partial.");
-    if (omittedItems > 0)
-        limitations.push(`${String(omittedItems)} comparison items were omitted by output limits.`);
-    if (omittedCandidates > 0)
-        limitations.push(`${String(omittedCandidates)} ambiguous candidates were omitted by candidate limits.`);
     return limitations;
 };

package/dist/domain/managedMemberComparisonItems.js

@@ -0,0 +1,221 @@
+import canonicalize from "canonicalize";
+import { sha256, } from "./managedMemberComparisonMatch.js";
+const changedMethodDimensions = (left, right) => {
+    const dimensions = [];
+    if (left.signature.raw_sha256 !== right.signature.raw_sha256)
+        dimensions.push("signature");
+    if (left.body.normalized_il_sha256 !== right.body.normalized_il_sha256)
+        dimensions.push("cil");
+    if (canonicalize(left.body.opcode_counts) !==
+        canonicalize(right.body.opcode_counts))
+        dimensions.push("opcode-shape");
+    if (callShape(left.body.anchors) !== callShape(right.body.anchors))
+        dimensions.push("call-shape");
+    if (fieldShape(left.body.anchors) !== fieldShape(right.body.anchors))
+        dimensions.push("field-shape");
+    if (canonicalize(left.body.exception_regions) !==
+        canonicalize(right.body.exception_regions))
+        dimensions.push("exception-shape");
+    if (left.body.status !== right.body.status)
+        dimensions.push("availability");
+    return dimensions;
+};
+const callShape = (anchors) => JSON.stringify(anchors
+    .filter(({ operand_kind }) => operand_kind === "method")
+    .map(({ opcode, operand_kind }) => [opcode, operand_kind]));
+const fieldShape = (anchors) => JSON.stringify(anchors
+    .filter(({ operand_kind }) => operand_kind === "field")
+    .map(({ opcode, operand_kind }) => [opcode, operand_kind]));
+const methodIdentity = (item) => ({
+    token: item.token,
+    declaring_type: item.declaring_type,
+    name: item.name,
+    signature_sha256: item.signature.raw_sha256,
+    normalized_il_sha256: item.body.normalized_il_sha256,
+});
+const fieldIdentity = (item) => ({
+    token: item.token,
+    declaring_type: item.declaring_type,
+    name: item.name,
+    signature_sha256: item.signature.raw_sha256,
+});
+const unmatchedComparison = () => ({
+    status: "unmatched",
+    basis: "none",
+    confidence: "unknown",
+    candidate_left_tokens: [],
+    candidate_right_tokens: [],
+});
+const methodOnlyItem = (member, context) => {
+    if (member.left !== undefined) {
+        const absenceObserved = context.rightComplete;
+        return {
+            item_id: `mmc_method_${sha256({ token: member.left.token, side: "left" })}`,
+            status: absenceObserved ? "removed" : "unknown",
+            left: methodIdentity(member.left),
+            right: null,
+            match: unmatchedComparison(),
+            dimensions: ["availability"],
+            evidence_links: [context.leftEvidenceId, context.rightEvidenceId],
+            limitations: absenceObserved
+                ? []
+                : [
+                    "unknown-within-incomplete-metadata: The right method inventory is incomplete, so absence was not observed.",
+                ],
+        };
+    }
+    const absenceObserved = context.leftComplete;
+    return {
+        item_id: `mmc_method_${sha256({ token: member.right.token, side: "right" })}`,
+        status: absenceObserved ? "added" : "unknown",
+        left: null,
+        right: methodIdentity(member.right),
+        match: unmatchedComparison(),
+        dimensions: ["availability"],
+        evidence_links: [context.leftEvidenceId, context.rightEvidenceId],
+        limitations: absenceObserved
+            ? []
+            : [
+                "unknown-within-incomplete-metadata: The left method inventory is incomplete, so absence was not observed.",
+            ],
+    };
+};
+const fieldOnlyItem = (member, context) => {
+    if (member.left !== undefined) {
+        const absenceObserved = context.rightComplete;
+        return {
+            item_id: `mmc_field_${sha256({ token: member.left.token, side: "left" })}`,
+            status: absenceObserved ? "removed" : "unknown",
+            left: fieldIdentity(member.left),
+            right: null,
+            match: unmatchedComparison(),
+            evidence_links: [context.leftEvidenceId, context.rightEvidenceId],
+            limitations: absenceObserved
+                ? []
+                : [
+                    "unknown-within-incomplete-metadata: The right field inventory is incomplete, so absence was not observed.",
+                ],
+        };
+    }
+    const absenceObserved = context.leftComplete;
+    return {
+        item_id: `mmc_field_${sha256({ token: member.right.token, side: "right" })}`,
+        status: absenceObserved ? "added" : "unknown",
+        left: null,
+        right: fieldIdentity(member.right),
+        match: unmatchedComparison(),
+        evidence_links: [context.leftEvidenceId, context.rightEvidenceId],
+        limitations: absenceObserved
+            ? []
+            : [
+                "unknown-within-incomplete-metadata: The left field inventory is incomplete, so absence was not observed.",
+            ],
+    };
+};
+export const buildMethodItems = (matches, context) => {
+    const items = [];
+    for (const pair of matches.pairs) {
+        const dimensions = changedMethodDimensions(pair.left.item, pair.right.item);
+        items.push({
+            item_id: `mmc_method_${sha256({
+                left: pair.left.item.token,
+                right: pair.right.item.token,
+                basis: pair.basis,
+            })}`,
+            status: dimensions.length === 0 ? "unchanged" : "changed",
+            left: methodIdentity(pair.left.item),
+            right: methodIdentity(pair.right.item),
+            match: {
+                status: "matched",
+                basis: pair.basis,
+                confidence: pair.confidence,
+                candidate_left_tokens: [],
+                candidate_right_tokens: [],
+            },
+            dimensions,
+            evidence_links: [context.leftEvidenceId, context.rightEvidenceId],
+            limitations: [],
+        });
+    }
+    for (const ambiguous of matches.ambiguous) {
+        items.push({
+            item_id: `mmc_method_${sha256({
+                left: ambiguous.left.map(({ item }) => item.token),
+                right: ambiguous.right.map(({ item }) => item.token),
+                basis: ambiguous.basis,
+            })}`,
+            status: "unknown",
+            left: null,
+            right: null,
+            match: {
+                status: "ambiguous",
+                basis: ambiguous.basis,
+                confidence: "unknown",
+                candidate_left_tokens: ambiguous.left.map(({ item }) => item.token),
+                candidate_right_tokens: ambiguous.right.map(({ item }) => item.token),
+            },
+            dimensions: ["availability"],
+            evidence_links: [context.leftEvidenceId, context.rightEvidenceId],
+            limitations: [
+                "Multiple managed methods share the same non-name identity key; REA did not guess a token remap.",
+            ],
+        });
+    }
+    for (const item of matches.leftOnly)
+        items.push(methodOnlyItem({ left: item.item }, context));
+    for (const item of matches.rightOnly)
+        items.push(methodOnlyItem({ right: item.item }, context));
+    return items;
+};
+export const buildFieldItems = (matches, context) => {
+    const items = [];
+    for (const pair of matches.pairs) {
+        const changed = pair.left.item.signature.raw_sha256 !==
+            pair.right.item.signature.raw_sha256 ||
+            pair.left.item.flags !== pair.right.item.flags;
+        items.push({
+            item_id: `mmc_field_${sha256({
+                left: pair.left.item.token,
+                right: pair.right.item.token,
+            })}`,
+            status: changed ? "changed" : "unchanged",
+            left: fieldIdentity(pair.left.item),
+            right: fieldIdentity(pair.right.item),
+            match: {
+                status: "matched",
+                basis: pair.basis,
+                confidence: pair.confidence,
+                candidate_left_tokens: [],
+                candidate_right_tokens: [],
+            },
+            evidence_links: [context.leftEvidenceId, context.rightEvidenceId],
+            limitations: [],
+        });
+    }
+    for (const ambiguous of matches.ambiguous)
+        items.push({
+            item_id: `mmc_field_${sha256({
+                left: ambiguous.left.map(({ item }) => item.token),
+                right: ambiguous.right.map(({ item }) => item.token),
+            })}`,
+            status: "unknown",
+            left: null,
+            right: null,
+            match: {
+                status: "ambiguous",
+                basis: ambiguous.basis,
+                confidence: "unknown",
+                candidate_left_tokens: ambiguous.left.map(({ item }) => item.token),
+                candidate_right_tokens: ambiguous.right.map(({ item }) => item.token),
+            },
+            evidence_links: [context.leftEvidenceId, context.rightEvidenceId],
+            limitations: [
+                "Multiple managed fields share the same signature; REA did not guess a token remap from names.",
+            ],
+        });
+    for (const item of matches.leftOnly)
+        items.push(fieldOnlyItem({ left: item.item }, context));
+    for (const item of matches.rightOnly)
+        items.push(fieldOnlyItem({ right: item.item }, context));
+    return items;
+};

package/dist/domain/managedMemberComparisonMatch.js

@@ -61,26 +61,23 @@ const keyField = (item) => ({
     ]),
 });
 const stableKey = (value) => sha256(value);
-const matchMethods = (left, right, maxCandidates) => matchByKeys({
+const matchMethods = (left, right) => matchByKeys({
     left,
     right,
-    maxCandidates,
     exactBasis: "exact-il-signature",
     fallbackBases: ["structural-method-shape"],
 });
-const matchFields = (left, right, maxCandidates) => matchByKeys({
+const matchFields = (left, right) => matchByKeys({
     left,
     right,
-    maxCandidates,
     exactBasis: "field-signature",
     fallbackBases: [],
 });
-const matchByKeys = ({ left, right, maxCandidates, exactBasis, fallbackBases, }) => {
+const matchByKeys = ({ left, right, exactBasis, fallbackBases, }) => {
     const usedLeft = new Set();
     const usedRight = new Set();
     const pairs = [];
     const ambiguous = [];
-    let omittedCandidates = 0;
     const rounds = [
         { basis: exactBasis, key: ({ exactKey }) => exactKey },
         ...fallbackBases.map((basis) => ({
@@ -117,10 +114,9 @@ const matchByKeys = ({ left, right, maxCandidates, exactBasis, fallbackBases, })
                     usedLeft.add(item);
                 for (const item of rightItems)
                     usedRight.add(item);
-                omittedCandidates += Math.max(0, leftItems.length + rightItems.length - maxCandidates * 2);
                 ambiguous.push({
-                    left: leftItems.slice(0, maxCandidates),
-                    right: rightItems.slice(0, maxCandidates),
+                    left: leftItems,
+                    right: rightItems,
                     basis: round.basis,
                 });
             }
@@ -131,7 +127,6 @@ const matchByKeys = ({ left, right, maxCandidates, exactBasis, fallbackBases, })
         ambiguous,
         leftOnly: left.filter((item) => !usedLeft.has(item)),
         rightOnly: right.filter((item) => !usedRight.has(item)),
-        omittedCandidates,
     };
 };
 const groupBy = (items, keyOf) => {
@@ -146,204 +141,9 @@ const groupBy = (items, keyOf) => {
     }
     return grouped;
 };
-const changedMethodDimensions = (left, right) => {
-    const dimensions = [];
-    if (left.signature.raw_sha256 !== right.signature.raw_sha256)
-        dimensions.push("signature");
-    if (left.body.normalized_il_sha256 !== right.body.normalized_il_sha256)
-        dimensions.push("cil");
-    if (canonicalize(left.body.opcode_counts) !==
-        canonicalize(right.body.opcode_counts))
-        dimensions.push("opcode-shape");
-    if (callShape(left.body.anchors) !== callShape(right.body.anchors))
-        dimensions.push("call-shape");
-    if (fieldShape(left.body.anchors) !== fieldShape(right.body.anchors))
-        dimensions.push("field-shape");
-    if (canonicalize(left.body.exception_regions) !==
-        canonicalize(right.body.exception_regions))
-        dimensions.push("exception-shape");
-    if (left.body.status !== right.body.status)
-        dimensions.push("availability");
-    return dimensions;
-};
-const callShape = (anchors) => JSON.stringify(anchors
-    .filter(({ operand_kind }) => operand_kind === "method")
-    .map(({ opcode, operand_kind }) => [opcode, operand_kind]));
-const fieldShape = (anchors) => JSON.stringify(anchors
-    .filter(({ operand_kind }) => operand_kind === "field")
-    .map(({ opcode, operand_kind }) => [opcode, operand_kind]));
-const methodIdentity = (item) => ({
-    token: item.token,
-    declaring_type: item.declaring_type,
-    name: item.name,
-    signature_sha256: item.signature.raw_sha256,
-    normalized_il_sha256: item.body.normalized_il_sha256,
-});
-const fieldIdentity = (item) => ({
-    token: item.token,
-    declaring_type: item.declaring_type,
-    name: item.name,
-    signature_sha256: item.signature.raw_sha256,
-});
-const methodOnlyItem = (item, context, left) => {
-    const absenceObserved = left ? context.rightComplete : context.leftComplete;
-    return {
-        item_id: `mmc_method_${sha256({ token: item.token, side: left ? "left" : "right" })}`,
-        status: absenceObserved ? (left ? "removed" : "added") : "unknown",
-        left: left ? methodIdentity(item) : null,
-        right: left ? null : methodIdentity(item),
-        match: {
-            status: "unmatched",
-            basis: "none",
-            confidence: "unknown",
-            candidate_left_tokens: [],
-            candidate_right_tokens: [],
-        },
-        dimensions: ["availability"],
-        evidence_links: [context.leftEvidenceId, context.rightEvidenceId],
-        limitations: absenceObserved
-            ? []
-            : [
-                `unknown-within-unobserved-page: The ${left ? "right" : "left"} method page is incomplete, so absence was not observed.`,
-            ],
-    };
-};
-const fieldOnlyItem = (item, context, left) => {
-    const absenceObserved = left ? context.rightComplete : context.leftComplete;
-    return {
-        item_id: `mmc_field_${sha256({ token: item.token, side: left ? "left" : "right" })}`,
-        status: absenceObserved ? (left ? "removed" : "added") : "unknown",
-        left: left ? fieldIdentity(item) : null,
-        right: left ? null : fieldIdentity(item),
-        match: {
-            status: "unmatched",
-            basis: "none",
-            confidence: "unknown",
-            candidate_left_tokens: [],
-            candidate_right_tokens: [],
-        },
-        evidence_links: [context.leftEvidenceId, context.rightEvidenceId],
-        limitations: absenceObserved
-            ? []
-            : [
-                `unknown-within-unobserved-page: The ${left ? "right" : "left"} field page is incomplete, so absence was not observed.`,
-            ],
-    };
-};
-export const buildMethodItems = (matches, context) => {
-    const items = [];
-    for (const pair of matches.pairs) {
-        const dimensions = changedMethodDimensions(pair.left.item, pair.right.item);
-        items.push({
-            item_id: `mmc_method_${sha256({
-                left: pair.left.item.token,
-                right: pair.right.item.token,
-                basis: pair.basis,
-            })}`,
-            status: dimensions.length === 0 ? "unchanged" : "changed",
-            left: methodIdentity(pair.left.item),
-            right: methodIdentity(pair.right.item),
-            match: {
-                status: "matched",
-                basis: pair.basis,
-                confidence: pair.confidence,
-                candidate_left_tokens: [],
-                candidate_right_tokens: [],
-            },
-            dimensions,
-            evidence_links: [context.leftEvidenceId, context.rightEvidenceId],
-            limitations: [],
-        });
-    }
-    for (const ambiguous of matches.ambiguous) {
-        items.push({
-            item_id: `mmc_method_${sha256({
-                left: ambiguous.left.map(({ item }) => item.token),
-                right: ambiguous.right.map(({ item }) => item.token),
-                basis: ambiguous.basis,
-            })}`,
-            status: "unknown",
-            left: null,
-            right: null,
-            match: {
-                status: "ambiguous",
-                basis: ambiguous.basis,
-                confidence: "unknown",
-                candidate_left_tokens: ambiguous.left.map(({ item }) => item.token),
-                candidate_right_tokens: ambiguous.right.map(({ item }) => item.token),
-            },
-            dimensions: ["availability"],
-            evidence_links: [context.leftEvidenceId, context.rightEvidenceId],
-            limitations: [
-                "Multiple managed methods share the same non-name identity key; REA did not guess a token remap.",
-            ],
-        });
-    }
-    for (const item of matches.leftOnly)
-        items.push(methodOnlyItem(item.item, context, true));
-    for (const item of matches.rightOnly)
-        items.push(methodOnlyItem(item.item, context, false));
-    return limitItems(items, context.limits.max_method_matches);
-};
-export const buildFieldItems = (matches, context) => {
-    const items = [];
-    for (const pair of matches.pairs) {
-        const changed = pair.left.item.signature.raw_sha256 !==
-            pair.right.item.signature.raw_sha256 ||
-            pair.left.item.flags !== pair.right.item.flags;
-        items.push({
-            item_id: `mmc_field_${sha256({
-                left: pair.left.item.token,
-                right: pair.right.item.token,
-            })}`,
-            status: changed ? "changed" : "unchanged",
-            left: fieldIdentity(pair.left.item),
-            right: fieldIdentity(pair.right.item),
-            match: {
-                status: "matched",
-                basis: pair.basis,
-                confidence: pair.confidence,
-                candidate_left_tokens: [],
-                candidate_right_tokens: [],
-            },
-            evidence_links: [context.leftEvidenceId, context.rightEvidenceId],
-            limitations: [],
-        });
-    }
-    for (const ambiguous of matches.ambiguous)
-        items.push({
-            item_id: `mmc_field_${sha256({
-                left: ambiguous.left.map(({ item }) => item.token),
-                right: ambiguous.right.map(({ item }) => item.token),
-            })}`,
-            status: "unknown",
-            left: null,
-            right: null,
-            match: {
-                status: "ambiguous",
-                basis: ambiguous.basis,
-                confidence: "unknown",
-                candidate_left_tokens: ambiguous.left.map(({ item }) => item.token),
-                candidate_right_tokens: ambiguous.right.map(({ item }) => item.token),
-            },
-            evidence_links: [context.leftEvidenceId, context.rightEvidenceId],
-            limitations: [
-                "Multiple managed fields share the same signature; REA did not guess a token remap from names.",
-            ],
-        });
-    for (const item of matches.leftOnly)
-        items.push(fieldOnlyItem(item.item, context, true));
-    for (const item of matches.rightOnly)
-        items.push(fieldOnlyItem(item.item, context, false));
-    return limitItems(items, context.limits.max_field_matches);
-};
-const limitItems = (items, limit) => ({
-    items: items.slice(0, limit),
-    omitted: Math.max(0, items.length - limit),
-});
-export const keyMembers = (left, right, maxCandidates) => ({
-    methodMatches: matchMethods(left.result.methods.items.map(keyMethod), right.result.methods.items.map(keyMethod), maxCandidates),
-    fieldMatches: matchFields(left.result.fields.items.map(keyField), right.result.fields.items.map(keyField), maxCandidates),
+export const keyMembers = (left, right) => ({
+    methodMatches: matchMethods(left.result.methods.map(keyMethod), right.result.methods.map(keyMethod)),
+    fieldMatches: matchFields(left.result.fields.map(keyField), right.result.fields.map(keyField)),
 });
 export const parseManagedMemberEvidence = (evidence) => {
     const parsed = parseEvidence(evidence);

package/dist/domain/managedNativeVerification.js

@@ -22,13 +22,11 @@ const managedBoundaryFromInput = (input) => {
 export const verifyManagedNativeBoundaries = (input) => {
     const managed = managedBoundaryFromInput(input);
     const managedEvidence = parseEvidence(input.managed_boundaries);
-    const native = collectNativeSymbols(input.native_observations.slice(0, input.limits.max_native_observations));
-    const verifiedPinvokes = managed.pinvoke_imports.items.map((item) => verifyPinvoke({
+    const native = collectNativeSymbols(input.native_observations);
+    const verifiedPinvokes = managed.pinvoke_imports.map((item) => verifyPinvoke({
         item,
         managedEvidenceId: managedEvidence.evidence_id,
-        symbols: native.symbols,
-        hasSupportedNativeEvidence: native.accepted > 0,
-        input,
+        native,
     }));
     const pinvokeImports = verifiedPinvokes.map(({ verification }) => verification);
     const withoutId = buildVerificationResult({
@@ -36,7 +34,6 @@ export const verifyManagedNativeBoundaries = (input) => {
         managed,
         native,
         pinvokeImports,
-        verifiedPinvokes,
         input,
     });
     return managedNativeVerificationResultSchema.parse({