mulch-cli 0.4.2 → 0.4.3

package/dist/utils/scoring.js

@@ -0,0 +1,80 @@
+/**
+ * Returns the number of successful outcomes for a record.
+ * Successful outcomes indicate confirmed, working applications of the record.
+ */
+export function getSuccessCount(record) {
+    if (!record.outcomes || record.outcomes.length === 0)
+        return 0;
+    return record.outcomes.filter((o) => o.status === "success").length;
+}
+/**
+ * Returns the number of failed outcomes for a record.
+ */
+export function getFailureCount(record) {
+    if (!record.outcomes || record.outcomes.length === 0)
+        return 0;
+    return record.outcomes.filter((o) => o.status === "failure").length;
+}
+/**
+ * Returns the total number of recorded outcomes (applications) for a record.
+ */
+export function getTotalApplications(record) {
+    return record.outcomes?.length ?? 0;
+}
+/**
+ * Returns the success rate (0-1) for a record.
+ * Partial outcomes are counted as 0.5 (half success).
+ * Returns 0 for records with no outcomes.
+ */
+export function getSuccessRate(record) {
+    const total = getTotalApplications(record);
+    if (total === 0)
+        return 0;
+    const partialCount = record.outcomes?.filter((o) => o.status === "partial").length ?? 0;
+    const successCount = getSuccessCount(record);
+    return (successCount + partialCount * 0.5) / total;
+}
+/**
+ * Computes the confirmation-frequency score for a record.
+ *
+ * The score is the count of successful confirmations (applications where
+ * the record's guidance was applied and the outcome was "success").
+ * Partial outcomes contribute 0.5 to the score.
+ *
+ * Records with no outcomes return 0.
+ * Records with only failures return 0.
+ */
+export function computeConfirmationScore(record) {
+    if (!record.outcomes || record.outcomes.length === 0)
+        return 0;
+    const successCount = getSuccessCount(record);
+    const partialCount = record.outcomes.filter((o) => o.status === "partial").length;
+    return successCount + partialCount * 0.5;
+}
+/**
+ * Applies a confirmation-frequency boost to a base score (e.g., a BM25 relevance score).
+ *
+ * Records with no outcomes (score = 0) are returned unchanged.
+ * Records with confirmed applications receive a multiplicative boost proportional
+ * to their confirmation score.
+ *
+ * @param baseScore - The base relevance score (e.g., from BM25)
+ * @param record - The record to score
+ * @param boostFactor - Multiplier controlling boost magnitude (default: 0.1)
+ * @returns The boosted score
+ */
+export function applyConfirmationBoost(baseScore, record, boostFactor = 0.1) {
+    const confirmationScore = computeConfirmationScore(record);
+    if (confirmationScore === 0)
+        return baseScore;
+    return baseScore * (1 + boostFactor * confirmationScore);
+}
+/**
+ * Sorts records by confirmation-frequency score, highest first.
+ * Records with equal scores maintain their original relative order (stable sort).
+ * Records with no outcomes (score = 0) sort to the end.
+ */
+export function sortByConfirmationScore(records) {
+    return [...records].sort((a, b) => computeConfirmationScore(b) - computeConfirmationScore(a));
+}
+//# sourceMappingURL=scoring.js.map

package/dist/utils/scoring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring.js","sourceRoot":"","sources":["../../src/utils/scoring.ts"],"names":[],"mappings":"AA0BA;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,MAAoB;IAClD,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAC/D,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;AACtE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAoB;IAClD,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAC/D,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;AACtE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAoB;IACvD,OAAO,MAAM,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,CAAC;AACtC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,MAAoB;IACjD,MAAM,KAAK,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC3C,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAC1B,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;IACxF,MAAM,YAAY,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAC7C,OAAO,CAAC,YAAY,GAAG,YAAY,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC;AACrD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAoB;IAC3D,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAC/D,MAAM,YAAY,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IAClF,OAAO,YAAY,GAAG,YAAY,GAAG,GAAG,CAAC;AAC3C,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,sBAAsB,CACpC,SAAiB,EACjB,MAAoB,EACpB,WAAW,GAAG,GAAG;IAEjB,MAAM,iBAAiB,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC;IAC3D,IAAI,iBAAiB,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9C,OAAO,SAAS,GAAG,CAAC,CAAC,GAAG,WAAW,GAAG,iBAAiB,CAAC,CAAC;AAC3D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAyB,OAAY;IAC1E,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CACtB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,wBAAwB,CAAC,CAAC,CAAC,GAAG,wBAAwB,CAAC,CAAC,CAAC,CACpE,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mulch-cli",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "description": "Let your agents grow 🌱 — structured expertise files that accumulate over time, live in git, work with any agent",
   "type": "module",
   "bin": {