claude-cognitive 0.3.2 → 0.4.0

package/dist/feedback/scorer.js

@@ -0,0 +1,194 @@
+/**
+ * Feedback Scorer
+ *
+ * Aggregates detection results into final fact scores and prepares
+ * feedback for storage/API submission.
+ *
+ * @module feedback/scorer
+ */
+import { USED_THRESHOLD, IGNORED_THRESHOLD, NEGATIVE_SIGNAL_WEIGHT, } from "./constants.js";
+/**
+ * Aggregate all detections into final fact scores
+ */
+export function aggregateDetections(detections) {
+    const factScores = new Map();
+    // Process positive signals (additive)
+    const positiveDetections = [
+        ...(detections.explicit || []),
+        ...(detections.semantic || []),
+        ...(detections.behavioral || []),
+    ];
+    for (const detection of positiveDetections) {
+        const current = factScores.get(detection.factId) || {
+            factId: detection.factId,
+            used: 0,
+            ignored: 0,
+            detections: [],
+        };
+        // Add confidence (cap at 1.0)
+        current.used = Math.min(current.used + detection.confidence, 1.0);
+        current.detections.push(detection);
+        factScores.set(detection.factId, current);
+    }
+    // Process negative signals
+    for (const signal of detections.negative || []) {
+        const current = factScores.get(signal.factId) || {
+            factId: signal.factId,
+            used: 0,
+            ignored: 0,
+            detections: [],
+        };
+        // Add ignore confidence (cap at 1.0)
+        current.ignored = Math.min(current.ignored + signal.ignoreConfidence, 1.0);
+        current.detections.push({
+            detectionType: "negative_signals",
+            confidence: signal.ignoreConfidence,
+            evidence: { signals: signal.signals },
+        });
+        factScores.set(signal.factId, current);
+    }
+    // Calculate final verdicts
+    const results = [];
+    for (const scores of factScores.values()) {
+        const verdict = calculateVerdict(scores.used, scores.ignored);
+        results.push({
+            factId: scores.factId,
+            verdict: verdict.verdict,
+            confidence: verdict.confidence,
+            scores: {
+                used: scores.used,
+                ignored: scores.ignored,
+            },
+            detections: scores.detections,
+        });
+    }
+    // Sort by confidence (highest first)
+    results.sort((a, b) => b.confidence - a.confidence);
+    return results;
+}
+/**
+ * Calculate verdict for a fact based on used and ignored scores
+ */
+export function calculateVerdict(usedScore, ignoredScore) {
+    // Net score: positive - (negative * weight)
+    // Negative signals weighted less than positive
+    const netScore = usedScore - (ignoredScore * NEGATIVE_SIGNAL_WEIGHT);
+    let verdict;
+    if (netScore > USED_THRESHOLD) {
+        verdict = "used";
+    }
+    else if (netScore < IGNORED_THRESHOLD) {
+        verdict = "ignored";
+    }
+    else {
+        verdict = "uncertain";
+    }
+    return {
+        verdict,
+        confidence: Math.abs(netScore),
+    };
+}
+// =============================================================================
+// Feedback Preparation
+// =============================================================================
+/**
+ * Prepare feedback for Hindsight API submission
+ * Sanitizes data to ensure no sensitive information is included
+ */
+export function prepareFeedback(factScores, query) {
+    return factScores
+        .filter((score) => score.verdict !== "uncertain")
+        .map((score) => ({
+        factId: score.factId,
+        signalType: score.verdict,
+        confidence: score.confidence,
+        query,
+    }));
+}
+/**
+ * Create a summary of feedback results
+ */
+export function summarizeFeedback(factScores) {
+    const summary = {
+        total: factScores.length,
+        used: 0,
+        ignored: 0,
+        uncertain: 0,
+        usageRate: 0,
+        avgUsedConfidence: 0,
+        avgIgnoredConfidence: 0,
+        topUsed: [],
+        topIgnored: [],
+    };
+    let usedConfidenceSum = 0;
+    let ignoredConfidenceSum = 0;
+    for (const score of factScores) {
+        switch (score.verdict) {
+            case "used":
+                summary.used++;
+                usedConfidenceSum += score.confidence;
+                break;
+            case "ignored":
+                summary.ignored++;
+                ignoredConfidenceSum += score.confidence;
+                break;
+            default:
+                summary.uncertain++;
+        }
+    }
+    // Calculate rates and averages
+    if (summary.total > 0) {
+        summary.usageRate = summary.used / summary.total;
+    }
+    if (summary.used > 0) {
+        summary.avgUsedConfidence = usedConfidenceSum / summary.used;
+    }
+    if (summary.ignored > 0) {
+        summary.avgIgnoredConfidence = ignoredConfidenceSum / summary.ignored;
+    }
+    // Get top 5 used and ignored facts
+    const used = factScores
+        .filter((s) => s.verdict === "used")
+        .sort((a, b) => b.confidence - a.confidence);
+    const ignored = factScores
+        .filter((s) => s.verdict === "ignored")
+        .sort((a, b) => b.confidence - a.confidence);
+    summary.topUsed = used.slice(0, 5).map((s) => ({
+        factId: s.factId,
+        confidence: s.confidence,
+        detectionTypes: [...new Set(s.detections.map((d) => d.detectionType))],
+    }));
+    summary.topIgnored = ignored.slice(0, 5).map((s) => ({
+        factId: s.factId,
+        confidence: s.confidence,
+    }));
+    return summary;
+}
+/**
+ * Filter feedback to only high-confidence results
+ */
+export function filterHighConfidence(factScores, minConfidence = 0.5) {
+    return factScores.filter((score) => score.verdict !== "uncertain" && score.confidence >= minConfidence);
+}
+/**
+ * Get detection type breakdown
+ */
+export function getDetectionBreakdown(factScores) {
+    const breakdown = {
+        explicit_reference: 0,
+        semantic_match: 0,
+        file_access_correlation: 0,
+        task_topic_correlation: 0,
+        negative_signals: 0,
+    };
+    for (const score of factScores) {
+        for (const detection of score.detections || []) {
+            const detType = detection.detectionType;
+            if (detType && detType in breakdown && breakdown[detType] !== undefined) {
+                breakdown[detType] = breakdown[detType] + 1;
+            }
+        }
+    }
+    return breakdown;
+}
+//# sourceMappingURL=scorer.js.map

package/dist/feedback/scorer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scorer.js","sourceRoot":"","sources":["../../src/feedback/scorer.ts"],"names":[],"mappings":"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"}

package/dist/feedback/similarity.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Text Similarity Functions
+ *
+ * Provides Jaccard similarity calculation for semantic matching.
+ *
+ * @module feedback/similarity
+ */
+/**
+ * Calculate Jaccard similarity between two texts
+ * @param text1 - First text
+ * @param text2 - Second text
+ * @returns Similarity score (0-1)
+ */
+export declare function calculateSimilarity(text1: string, text2: string): number;
+/**
+ * Calculate Jaccard similarity between two sets
+ */
+export declare function jaccardSimilarity(set1: Set<string>, set2: Set<string>): number;
+//# sourceMappingURL=similarity.d.ts.map

package/dist/feedback/similarity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"similarity.d.ts","sourceRoot":"","sources":["../../src/feedback/similarity.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAgBxE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAQ9E"}

package/dist/feedback/similarity.js

@@ -0,0 +1,49 @@
+/**
+ * Text Similarity Functions
+ *
+ * Provides Jaccard similarity calculation for semantic matching.
+ *
+ * @module feedback/similarity
+ */
+/**
+ * Normalize text for comparison
+ */
+function normalizeText(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^\w\s]/g, "") // Remove punctuation
+        .replace(/\s+/g, " ") // Normalize whitespace
+        .trim();
+}
+/**
+ * Calculate Jaccard similarity between two texts
+ * @param text1 - First text
+ * @param text2 - Second text
+ * @returns Similarity score (0-1)
+ */
+export function calculateSimilarity(text1, text2) {
+    const words1 = new Set(normalizeText(text1).split(/\s+/).filter(Boolean));
+    const words2 = new Set(normalizeText(text2).split(/\s+/).filter(Boolean));
+    if (words1.size === 0 && words2.size === 0) {
+        return 1; // Both empty = identical
+    }
+    if (words1.size === 0 || words2.size === 0) {
+        return 0; // One empty = no similarity
+    }
+    const intersection = new Set([...words1].filter((w) => words2.has(w)));
+    const union = new Set([...words1, ...words2]);
+    return intersection.size / union.size;
+}
+/**
+ * Calculate Jaccard similarity between two sets
+ */
+export function jaccardSimilarity(set1, set2) {
+    if (set1.size === 0 && set2.size === 0)
+        return 1;
+    if (set1.size === 0 || set2.size === 0)
+        return 0;
+    const intersectionSize = [...set1].filter((x) => set2.has(x)).length;
+    const unionSize = new Set([...set1, ...set2]).size;
+    return intersectionSize / unionSize;
+}
+//# sourceMappingURL=similarity.js.map

package/dist/feedback/similarity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"similarity.js","sourceRoot":"","sources":["../../src/feedback/similarity.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,IAAI;SACR,WAAW,EAAE;SACb,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,qBAAqB;SAC7C,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,uBAAuB;SAC5C,IAAI,EAAE,CAAC;AACZ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa,EAAE,KAAa;IAC9D,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1E,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAE1E,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QAC3C,OAAO,CAAC,CAAC,CAAC,yBAAyB;IACrC,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QAC3C,OAAO,CAAC,CAAC,CAAC,4BAA4B;IACxC,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvE,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC;IAE9C,OAAO,YAAY,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAiB,EAAE,IAAiB;IACpE,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACjD,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAEjD,MAAM,gBAAgB,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACrE,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAEnD,OAAO,gBAAgB,GAAG,SAAS,CAAC;AACtC,CAAC"}

package/dist/feedback/tracker.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Recall Session Tracker
+ *
+ * Tracks recalled facts for a session to enable feedback loop analysis.
+ * Writes to .claude/feedback-sessions/.recall-session.json
+ *
+ * @module feedback/tracker
+ */
+import type { Memory } from "../types.js";
+export interface RecallParams {
+    query: string;
+    queryType: "fixed" | "adaptive";
+    parameters: {
+        limit: number;
+        budget: string;
+        factTypes: string[];
+        timeWindow: string | null;
+    };
+    context: SessionContext;
+}
+export interface SessionContext {
+    branch: string | null;
+    recentFiles: string[];
+    projectType: string | null;
+}
+export interface RecalledFact {
+    factId: string;
+    text: string;
+    factType: string;
+    score: number;
+    position: number;
+}
+export interface RecallSession {
+    sessionId: string;
+    startedAt: string;
+    project: string;
+    recall: RecallParams;
+    factsRecalled: RecalledFact[];
+    totalFacts: number;
+    totalTokens: number;
+}
+export interface SessionStats {
+    currentSession: RecallSession | null;
+    archivedSessions: number;
+    totalFactsTracked: number;
+    oldestSession: string | null;
+    newestSession: string | null;
+}
+/**
+ * Get the path to the feedback sessions directory
+ */
+export declare function getSessionActivityDir(projectDir: string): string;
+/**
+ * Get the path to the recall session file
+ */
+export declare function getRecallSessionPath(projectDir: string): string;
+/**
+ * Create a new recall session record
+ */
+export declare function createRecallSession(sessionId: string, projectDir: string, recallParams?: {
+    query?: string;
+    queryType?: "fixed" | "adaptive";
+    limit?: number;
+    budget?: string;
+    factTypes?: string[];
+    timeWindow?: string | null;
+}): RecallSession;
+/**
+ * Add recalled facts to session
+ */
+export declare function addRecalledFacts(session: RecallSession, facts: Memory[]): RecallSession;
+/**
+ * Save recall session to disk
+ */
+export declare function saveRecallSession(session: RecallSession, projectDir: string): Promise<void>;
+/**
+ * Load recall session from disk
+ */
+export declare function loadRecallSession(sessionId: string | null, projectDir: string): Promise<RecallSession | null>;
+/**
+ * Track a recall operation (convenience function combining create, add, save)
+ */
+export declare function trackRecall(options: {
+    sessionId: string;
+    projectDir: string;
+    query: string;
+    facts: Memory[];
+    params?: {
+        queryType?: "fixed" | "adaptive";
+        limit?: number;
+        budget?: string;
+        factTypes?: string[];
+        timeWindow?: string | null;
+    };
+}): Promise<RecallSession>;
+/**
+ * Clean up old session data
+ */
+export declare function cleanupOldSessions(projectDir: string, retentionDays?: number): Promise<number>;
+/**
+ * Get statistics about tracked sessions
+ */
+export declare function getSessionStats(projectDir: string): Promise<SessionStats>;
+//# sourceMappingURL=tracker.d.ts.map

package/dist/feedback/tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../../src/feedback/tracker.ts"],"names":[],"mappings":"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"}