@microsoft/sarif-multitool-darwin 4.6.3 → 4.6.4

package/Sarif.Multitool.Library.xml

@@ -519,11 +519,6 @@
               Looks up a localized string similar to {0}: The 'message' object on this 'result' object does not provide a 'text' property. This property is required by the {1} service..
             </summary>
         </member>
-        <member name="P:Microsoft.CodeAnalysis.Sarif.Multitool.Rules.RuleResources.Base1015_ProvideRequiredResultProperties_Error_MissingPartialFingerprints_Text">
-            <summary>
-              Looks up a localized string similar to {0}: This &apos;result&apos; object does not provide a &apos;partialFingerprints&apos; dictionary. This property is required by the {1} service..
-            </summary>
-        </member>
         <member name="P:Microsoft.CodeAnalysis.Sarif.Multitool.Rules.RuleResources.Base1016_ProvideRequiredLocationProperties_Error_MissingPhysicalLocation_Text">
             <summary>
               Looks up a localized string similar to {0}: This &apos;location&apos; object does not provide a &apos;physicalLocation&apos; object. This property is required by the {1} service..

package/Sarif.xml

@@ -9327,6 +9327,13 @@
             I.e., the total number of log files created is the sum of distinct property bag property across all logs.
             </summary>
         </member>
+        <member name="F:Microsoft.CodeAnalysis.Sarif.SplittingStrategy.PerIndexList">
+            <summary>
+            Split SARIF log files according to an explicit list of result addresses
+            grouped into buckets. Used for AI-driven splitting where the caller
+            dictates exactly which results land in which output file.
+            </summary>
+        </member>
         <member name="M:Microsoft.CodeAnalysis.Sarif.UriHelper.MakeValidUri(System.String)">
              <summary>
              Create a syntactically valid URI from a path that might be
@@ -12013,6 +12020,92 @@
         <member name="F:Microsoft.CodeAnalysis.Sarif.Writers.MimeType.JavaProperties">
             <summary>The MIME type for Java properties files (which are xml).</summary>
         </member>
+        <member name="T:Microsoft.CodeAnalysis.Sarif.Writers.PartitionFunctions">
+            <summary>
+            Provides ready-made <see cref="T:Microsoft.CodeAnalysis.Sarif.Visitors.PartitionFunction`1"/> implementations for the
+            well-known <see cref="T:Microsoft.CodeAnalysis.Sarif.SplittingStrategy"/> values, plus an explicit address-list
+            strategy ("PerIndexList") that lets a caller dictate exactly which results land
+            in each output bucket.
+            </summary>
+            <remarks>
+            All factory methods perform a single O(N) pre-walk of the log to compute a
+            per-result partition key, then return an O(1) closure that the
+            <see cref="T:Microsoft.CodeAnalysis.Sarif.Visitors.PartitioningVisitor`1"/> can call during its own traversal.
+            Results are looked up by reference equality, which is safe because the visitor
+            hands the same <see cref="T:Microsoft.CodeAnalysis.Sarif.Result"/> instances it walked to the partition function.
+            </remarks>
+        </member>
+        <member name="F:Microsoft.CodeAnalysis.Sarif.Writers.PartitionFunctions.IndexListBucketPrefix">
+            <summary>
+            Auto-generated bucket name used when an explicit address-list spec does not
+            itself name buckets. Buckets are numbered in spec order, starting at zero.
+            </summary>
+        </member>
+        <member name="M:Microsoft.CodeAnalysis.Sarif.Writers.PartitionFunctions.ForStrategy(Microsoft.CodeAnalysis.Sarif.SarifLog,Microsoft.CodeAnalysis.Sarif.SplittingStrategy)">
+            <summary>
+            Returns a <see cref="T:Microsoft.CodeAnalysis.Sarif.Visitors.PartitionFunction`1"/> implementing the specified
+            <see cref="T:Microsoft.CodeAnalysis.Sarif.SplittingStrategy"/> against the given log.
+            </summary>
+            <param name="log">The SARIF log to be partitioned.</param>
+            <param name="strategy">The splitting strategy to apply.</param>
+            <exception cref="T:System.ArgumentNullException">Thrown when <paramref name="log"/> is null.</exception>
+            <exception cref="T:System.ArgumentOutOfRangeException">
+            Thrown when <paramref name="strategy"/> is not supported by this helper.
+            Use <see cref="M:Microsoft.CodeAnalysis.Sarif.Writers.PartitionFunctions.ForIndexList(Microsoft.CodeAnalysis.Sarif.SarifLog,System.String,System.String,System.Boolean)"/> for <see cref="F:Microsoft.CodeAnalysis.Sarif.SplittingStrategy.PerIndexList"/>.
+            </exception>
+        </member>
+        <member name="M:Microsoft.CodeAnalysis.Sarif.Writers.PartitionFunctions.ForIndexList(Microsoft.CodeAnalysis.Sarif.SarifLog,System.String,System.String,System.Boolean)">
+            <summary>
+            Returns a <see cref="T:Microsoft.CodeAnalysis.Sarif.Visitors.PartitionFunction`1"/> that places each result into a
+            caller-specified bucket according to its address in the input log.
+            </summary>
+            <param name="log">The SARIF log to be partitioned.</param>
+            <param name="indexSpec">
+            A spec in the compact mini-language understood by <see cref="M:Microsoft.CodeAnalysis.Sarif.Writers.PartitionFunctions.ParseIndexSpec(System.String)"/>.
+            </param>
+            <param name="spilloverBucket">
+            Optional bucket name to receive any result not addressed by
+            <paramref name="indexSpec"/>. When null, unmatched results are discarded.
+            </param>
+            <param name="strictCoverage">
+            When true, throws if any result in the log is not addressed by
+            <paramref name="indexSpec"/> (and no <paramref name="spilloverBucket"/> is set).
+            </param>
+            <exception cref="T:System.ArgumentNullException">Thrown when <paramref name="log"/> is null.</exception>
+            <exception cref="T:System.ArgumentException">Thrown when <paramref name="indexSpec"/> is null or empty.</exception>
+            <exception cref="T:System.FormatException">Thrown when the spec cannot be parsed.</exception>
+        </member>
+        <member name="M:Microsoft.CodeAnalysis.Sarif.Writers.PartitionFunctions.ParseIndexSpec(System.String)">
+            <summary>
+            Parses a partition spec written in the compact mini-language.
+            </summary>
+            <remarks>
+            Grammar:
+            <code>
+            spec    ::= bucket ( "|" bucket )*
+            bucket  ::= segment ( ";" segment )*
+            segment ::= compactSeg | sarifUri
+            compactSeg ::= [ runId ":" ] resultIdx ( "," resultIdx )*
+            sarifUri   ::= "sarif:/runs/" runId "/results/" resultIdx
+            </code>
+            Buckets are auto-named "bucket0", "bucket1", ... in spec order. The
+            <c>runId</c> prefix on a compact segment is optional; if omitted, run 0 is
+            assumed (handy for the very common single-run AI workflow). Whitespace
+            around any token is ignored.
+            </remarks>
+            <param name="spec">The spec string to parse.</param>
+            <returns>
+            A dictionary mapping each addressed <see cref="T:Microsoft.CodeAnalysis.Sarif.Writers.PartitionFunctions.ResultAddress"/> to the
+            auto-generated bucket name it belongs to.
+            </returns>
+            <exception cref="T:System.ArgumentException">Thrown when <paramref name="spec"/> is null or empty.</exception>
+            <exception cref="T:System.FormatException">Thrown when the spec is malformed or contains a duplicate address.</exception>
+        </member>
+        <member name="T:Microsoft.CodeAnalysis.Sarif.Writers.PartitionFunctions.ResultAddress">
+            <summary>
+            An address into a SARIF log: a (run index, result index) pair.
+            </summary>
+        </member>
         <member name="T:Microsoft.CodeAnalysis.Sarif.Writers.RegionComponents">
             <summary>
              RegionComponents has flags for the different ways a Region

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@microsoft/sarif-multitool-darwin",
 	"description": "SARIF Multitool for MacOS (Darwin)",
-	"version": "4.6.3",
+	"version": "4.6.4",
 	"scripts": {
 		"postinstall": "chmod u+x Sarif.Multitool"
 	},