centient 2.20.0

package/dist/tools/session/askSession.js

@@ -0,0 +1,311 @@
+import { getActiveCoordinator } from "./startSessionCoordination.js";
+import { getLLMStreamClient, } from "../../utils/llmStreamClient.js";
+import { estimateTokensFromJSON } from "../../utils/tokenEstimator.js";
+export const askSessionTool = {
+    name: "ask_session",
+    description: `Ask natural language questions about the current session.
+
+Examples:
+- "What authentication decisions did we make?"
+- "Why did we choose PostgreSQL over MongoDB?"
+- "What blockers have we encountered?"
+- "Summarize our progress today"
+
+Returns a synthesized answer with source citations from session memory.
+Uses semantic search + LLM synthesis for intelligent responses.`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            question: {
+                type: "string",
+                description: "Natural language question about the session",
+            },
+            includeHistory: {
+                type: "boolean",
+                description: "Include Memory Bank historical context (default: false)",
+            },
+            maxSources: {
+                type: "number",
+                description: "Maximum source notes to include (default: 10)",
+            },
+            model: {
+                type: "string",
+                enum: ["gpt-4o", "gemini-2.0-flash"],
+                description: "LLM model for synthesis (default: gpt-4o)",
+            },
+        },
+        required: ["question"],
+    },
+};
+export async function askSessionHandler(args) {
+    const startTime = Date.now();
+    try {
+        const input = args;
+        if (!input.question || input.question.trim().length === 0) {
+            throw new Error("question is required");
+        }
+        const result = await askSession(input);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const duration = Date.now() - startTime;
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        const errorResult = {
+            success: false,
+            error: {
+                code: "ASK_SESSION_ERROR",
+                message: errorMessage,
+            },
+            metadata: {
+                tokensUsed: 0,
+                duration,
+                searchDuration: 0,
+                synthesisDuration: 0,
+            },
+        };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(errorResult, null, 2),
+                },
+            ],
+        };
+    }
+}
+function extractQueryTerms(question) {
+    const queries = [question];
+    const patterns = [
+        { pattern: /decision|decide|chose|choice/i, terms: ["decision"] },
+        {
+            pattern: /auth|authentication|login|session/i,
+            terms: ["authentication", "auth"],
+        },
+        { pattern: /database|db|postgres|mongo|sql/i, terms: ["database"] },
+        { pattern: /blocker|block|stuck|issue|problem/i, terms: ["blocker"] },
+        { pattern: /hypothesis|theory|assumption|test/i, terms: ["hypothesis"] },
+        { pattern: /learn|learning|discover|found/i, terms: ["learning"] },
+        { pattern: /pattern|approach|solution/i, terms: ["pattern"] },
+        { pattern: /why|reason|rationale/i, terms: ["decision", "rationale"] },
+        {
+            pattern: /progress|status|done|complete/i,
+            terms: ["progress", "completed"],
+        },
+        { pattern: /security|secure|vulnerability/i, terms: ["security"] },
+        { pattern: /performance|fast|slow|optimize/i, terms: ["performance"] },
+        { pattern: /api|endpoint|route/i, terms: ["api"] },
+    ];
+    for (const { pattern, terms } of patterns) {
+        if (pattern.test(question)) {
+            queries.push(...terms);
+        }
+    }
+    return [...new Set(queries)];
+}
+function determineConfidence(sources, question) {
+    if (sources.length === 0)
+        return "low";
+    const highRelevanceSources = sources.filter((s) => s.relevance >= 0.7);
+    if (highRelevanceSources.length >= 3)
+        return "high";
+    if (highRelevanceSources.length >= 1 && sources.length >= 2)
+        return "medium";
+    const questionLower = question.toLowerCase();
+    const hasDirectMatch = sources.some((s) => {
+        const typeLower = s.type.toLowerCase();
+        if (questionLower.includes("decision") && typeLower === "decision")
+            return true;
+        if (questionLower.includes("blocker") && typeLower === "blocker")
+            return true;
+        if (questionLower.includes("hypothesis") && typeLower === "hypothesis")
+            return true;
+        if (questionLower.includes("learn") && typeLower === "learning")
+            return true;
+        return false;
+    });
+    if (hasDirectMatch && sources.length >= 2)
+        return "medium";
+    return "low";
+}
+function buildSynthesisPrompt(question, sources) {
+    const sourceText = sources
+        .map((s, i) => {
+        const timestamp = new Date(s.timestamp).toLocaleString();
+        return `[${i + 1}] (${s.type}, ${timestamp}, relevance: ${(s.relevance * 100).toFixed(0)}%)
+${s.content}`;
+    })
+        .join("\n\n");
+    return `You are a helpful assistant answering questions about a development session.
+Based on the following session notes, answer the user's question.
+
+IMPORTANT GUIDELINES:
+1. Only use information from the provided sources
+2. Cite sources using [n] notation
+3. If sources don't contain enough information, say so clearly
+4. Keep answers concise but complete
+5. Highlight key decisions and their rationale
+6. If there are conflicting notes, mention both perspectives
+
+USER QUESTION: ${question}
+
+SESSION NOTES:
+${sourceText}
+
+Provide a clear, well-structured answer with citations:`;
+}
+async function askSession(input) {
+    const startTime = Date.now();
+    const { question, includeHistory = false, maxSources = 10, model = "gpt-4o", } = input;
+    void includeHistory;
+    const queryTerms = extractQueryTerms(question);
+    const searchStartTime = Date.now();
+    const sources = [];
+    try {
+        const coordinator = getActiveCoordinator();
+        const searchPromises = queryTerms
+            .slice(0, 3)
+            .map((term) => coordinator.searchWithRelationships(term, Math.ceil(maxSources / 2), true));
+        const searchResults = await Promise.all(searchPromises);
+        const seenContent = new Set();
+        for (const results of searchResults) {
+            for (const result of results) {
+                if (!seenContent.has(result.content)) {
+                    seenContent.add(result.content);
+                    sources.push({
+                        type: result.type,
+                        content: result.content,
+                        timestamp: result.timestamp,
+                        relevance: result.score,
+                        source: "session",
+                    });
+                }
+            }
+        }
+        sources.sort((a, b) => b.relevance - a.relevance);
+        sources.splice(maxSources);
+    }
+    catch (error) {
+        const duration = Date.now() - startTime;
+        return {
+            success: false,
+            error: {
+                code: "NO_ACTIVE_SESSION",
+                message: "No active session found. Start a session with start_session_coordination first.",
+            },
+            metadata: {
+                tokensUsed: 0,
+                duration,
+                searchDuration: Date.now() - searchStartTime,
+                synthesisDuration: 0,
+            },
+        };
+    }
+    const searchDuration = Date.now() - searchStartTime;
+    if (sources.length === 0) {
+        const duration = Date.now() - startTime;
+        return {
+            success: true,
+            data: {
+                question,
+                answer: "I couldn't find any relevant notes in the current session to answer your question. This might mean:\n" +
+                    "1. No notes have been saved yet (use save_session_note to add notes)\n" +
+                    "2. The topic hasn't been discussed in this session\n" +
+                    "3. Try rephrasing your question with different keywords",
+                confidence: "low",
+                sources: [],
+                sourceCount: 0,
+                model: "none",
+            },
+            metadata: {
+                tokensUsed: estimateTokensFromJSON({ question }),
+                duration,
+                searchDuration,
+                synthesisDuration: 0,
+            },
+        };
+    }
+    const synthesisStartTime = Date.now();
+    const prompt = buildSynthesisPrompt(question, sources);
+    try {
+        const client = getLLMStreamClient();
+        const llmResult = await client.complete({
+            model,
+            prompt,
+            systemPrompt: "You are a precise assistant that synthesizes information from session notes. Always cite sources and be accurate.",
+            maxTokens: 1024,
+            temperature: 0.3,
+        });
+        const synthesisDuration = Date.now() - synthesisStartTime;
+        const duration = Date.now() - startTime;
+        if (!llmResult.success) {
+            return {
+                success: false,
+                error: {
+                    code: "LLM_SYNTHESIS_ERROR",
+                    message: llmResult.error || "Failed to synthesize answer",
+                },
+                metadata: {
+                    tokensUsed: estimateTokensFromJSON({ question, sources }),
+                    duration,
+                    searchDuration,
+                    synthesisDuration,
+                },
+            };
+        }
+        const confidence = determineConfidence(sources, question);
+        return {
+            success: true,
+            data: {
+                question,
+                answer: llmResult.content,
+                confidence,
+                sources,
+                sourceCount: sources.length,
+                model: llmResult.model,
+            },
+            metadata: {
+                tokensUsed: estimateTokensFromJSON({
+                    question,
+                    sources,
+                    answer: llmResult.content,
+                }),
+                duration,
+                searchDuration,
+                synthesisDuration,
+            },
+        };
+    }
+    catch (error) {
+        const synthesisDuration = Date.now() - synthesisStartTime;
+        const duration = Date.now() - startTime;
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            success: true,
+            data: {
+                question,
+                answer: `Unable to synthesize answer (${errorMessage}). Here are the relevant sources:\n\n` +
+                    sources
+                        .map((s, i) => `[${i + 1}] **${s.type}** (${new Date(s.timestamp).toLocaleString()}):\n${s.content}`)
+                        .join("\n\n"),
+                confidence: "low",
+                sources,
+                sourceCount: sources.length,
+                model: "fallback",
+            },
+            metadata: {
+                tokensUsed: estimateTokensFromJSON({ question, sources }),
+                duration,
+                searchDuration,
+                synthesisDuration,
+            },
+        };
+    }
+}
+//# sourceMappingURL=askSession.js.map

package/dist/tools/session/askSession.js.map

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

package/dist/tools/session/checkClaimConsistency.d.ts

@@ -0,0 +1,9 @@
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const checkClaimConsistencyTool: Tool;
+export declare function checkClaimConsistencyHandler(args: unknown): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=checkClaimConsistency.d.ts.map

package/dist/tools/session/checkClaimConsistency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkClaimConsistency.d.ts","sourceRoot":"","sources":["../../../src/tools/session/checkClaimConsistency.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAa1D,eAAO,MAAM,yBAAyB,EAAE,IAgCvC,CAAC;AA8DF,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAkD7D"}

package/dist/tools/session/checkClaimConsistency.js

@@ -0,0 +1,343 @@
+import { getActiveCoordinator, hasActiveSession, } from "./startSessionCoordination.js";
+import { estimateTokensFromJSON } from "../../utils/tokenEstimator.js";
+import * as os from "os";
+import * as path from "path";
+import { runPythonScriptJSON } from "../../utils/pythonRunner.js";
+export const checkClaimConsistencyTool = {
+    name: "check_claim_consistency",
+    description: "Cross-reference a claim against known knowledge stores (session memory, Memory Bank, patterns). Returns consistency score, conflicts, supporting evidence, and recommendation. Part of hallucination detection.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            claim: {
+                type: "string",
+                description: 'The claim to verify (e.g., "We are using JWT with 15-min expiry")',
+            },
+            projectPath: {
+                type: "string",
+                description: "Absolute path to the project directory",
+            },
+            checkAgainst: {
+                type: "array",
+                items: {
+                    type: "string",
+                    enum: ["session", "memory_bank", "patterns"],
+                },
+                description: "Knowledge stores to check against (default: all three)",
+            },
+            threshold: {
+                type: "number",
+                description: "Similarity threshold for conflict/support detection (default: 0.7)",
+            },
+        },
+        required: ["claim", "projectPath"],
+    },
+};
+export async function checkClaimConsistencyHandler(args) {
+    const startTime = Date.now();
+    try {
+        const input = args;
+        if (!input.claim) {
+            throw new Error("claim is required");
+        }
+        if (!input.projectPath) {
+            throw new Error("projectPath is required");
+        }
+        const result = await checkClaimConsistency(input);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const duration = Date.now() - startTime;
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        const errorResult = {
+            success: false,
+            error: {
+                code: "CHECK_CONSISTENCY_ERROR",
+                message: errorMessage,
+            },
+            metadata: {
+                tokensUsed: 0,
+                duration,
+                sourcesChecked: 0,
+            },
+        };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(errorResult, null, 2),
+                },
+            ],
+        };
+    }
+}
+async function checkClaimConsistency(input) {
+    const startTime = Date.now();
+    const threshold = input.threshold ?? 0.7;
+    const checkAgainst = input.checkAgainst ?? [
+        "session",
+        "memory_bank",
+        "patterns",
+    ];
+    const conflicts = [];
+    const supportingEvidence = [];
+    const checkedSources = [];
+    try {
+        const projectName = path.basename(input.projectPath).toLowerCase();
+        if (checkAgainst.includes("session") && hasActiveSession()) {
+            checkedSources.push("session");
+            const sessionResults = await searchSessionMemory(input.claim, 5);
+            for (const result of sessionResults) {
+                const analysis = analyzeClaimRelationship(input.claim, result.content);
+                if (analysis.isConflict && result.score >= threshold) {
+                    conflicts.push({
+                        source: `session:${result.type}`,
+                        conflictingClaim: result.content,
+                        similarity: result.score,
+                    });
+                }
+                else if (analysis.isSupporting && result.score >= threshold) {
+                    supportingEvidence.push({
+                        source: `session:${result.type}`,
+                        supportingClaim: result.content,
+                        similarity: result.score,
+                    });
+                }
+            }
+        }
+        if (checkAgainst.includes("memory_bank")) {
+            checkedSources.push("memory_bank");
+            const memoryResults = await searchMemoryBank(input.claim, projectName, 5);
+            for (const result of memoryResults) {
+                const similarity = result.distance !== null ? 1 - result.distance : 0.5;
+                const analysis = analyzeClaimRelationship(input.claim, result.fact);
+                if (analysis.isConflict && similarity >= threshold) {
+                    conflicts.push({
+                        source: `memory_bank:${result.name}`,
+                        conflictingClaim: result.fact,
+                        similarity,
+                    });
+                }
+                else if (analysis.isSupporting && similarity >= threshold) {
+                    supportingEvidence.push({
+                        source: `memory_bank:${result.name}`,
+                        supportingClaim: result.fact,
+                        similarity,
+                    });
+                }
+            }
+        }
+        if (checkAgainst.includes("patterns")) {
+            checkedSources.push("patterns");
+        }
+        const confidenceScore = calculateConfidenceScore(conflicts, supportingEvidence, checkedSources.length);
+        const recommendation = determineRecommendation(confidenceScore, conflicts.length);
+        const badge = determineBadge(confidenceScore, conflicts.length);
+        const result = {
+            consistent: conflicts.length === 0,
+            confidenceScore,
+            conflicts,
+            supportingEvidence,
+            recommendation,
+            badge,
+            checkedSources,
+        };
+        const tokensUsed = estimateTokensFromJSON({ input, result });
+        const duration = Date.now() - startTime;
+        return {
+            success: true,
+            data: result,
+            metadata: {
+                tokensUsed,
+                duration,
+                sourcesChecked: checkedSources.length,
+            },
+        };
+    }
+    catch (error) {
+        const duration = Date.now() - startTime;
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            error: {
+                code: "CHECK_CONSISTENCY_ERROR",
+                message: errorMessage,
+            },
+            metadata: {
+                tokensUsed: 0,
+                duration,
+                sourcesChecked: checkedSources.length,
+            },
+        };
+    }
+}
+async function searchSessionMemory(query, limit) {
+    try {
+        const coordinator = getActiveCoordinator();
+        const results = await coordinator.searchWithRelationships(query, limit, false);
+        return results.map((r) => ({
+            score: r.score,
+            type: r.type,
+            content: r.content,
+        }));
+    }
+    catch {
+        return [];
+    }
+}
+async function searchMemoryBank(query, projectName, topK) {
+    try {
+        const scriptPath = path.join(os.homedir(), "Dev/ClaudeDev/scripts/memory-bank/query-memories.py");
+        const result = await runPythonScriptJSON(scriptPath, [
+            "--query",
+            query,
+            "--project-name",
+            projectName,
+            "--top-k",
+            String(topK),
+            "--format",
+            "json",
+        ]);
+        if (!result.success || !result.memories) {
+            return [];
+        }
+        return result.memories;
+    }
+    catch {
+        return [];
+    }
+}
+function analyzeClaimRelationship(claim, existingClaim) {
+    const claimLower = claim.toLowerCase();
+    const existingLower = existingClaim.toLowerCase();
+    const strongNegationPatterns = [
+        /\bnot\s+(?:to\s+)?use\b/,
+        /\bdecided\s+(?:not\s+)?(?:to\s+)?(?:not|against)\b/,
+        /\bdon't\s+use\b/,
+        /\bdoesn't\s+use\b/,
+        /\bwon't\s+use\b/,
+        /\bcan't\s+use\b/,
+        /\bnever\s+use\b/,
+        /\bnot\s+using\b/,
+        /\bwithout\b/,
+        /\binstead\s+of\b/,
+        /\brather\s+than\b/,
+        /\bavoiding\b/,
+        /\brejected\b/,
+        /\bdiscarded\b/,
+    ];
+    const positivePatterns = [
+        /\b(?:are|is)\s+using\b/,
+        /\buse\b/,
+        /\busing\b/,
+        /\bchose\b/,
+        /\bselected\b/,
+        /\bimplemented\b/,
+        /\badopted\b/,
+    ];
+    const stopWords = new Set([
+        "the",
+        "and",
+        "for",
+        "are",
+        "was",
+        "were",
+        "been",
+        "being",
+        "have",
+        "has",
+        "had",
+        "with",
+        "that",
+        "this",
+        "will",
+        "from",
+        "they",
+        "would",
+        "could",
+        "should",
+        "about",
+        "into",
+        "when",
+        "which",
+        "their",
+        "there",
+        "what",
+        "some",
+        "than",
+    ]);
+    const claimTerms = new Set((claimLower.match(/\b\w{3,}\b/g) || []).filter((t) => !stopWords.has(t)));
+    const existingTerms = new Set((existingLower.match(/\b\w{3,}\b/g) || []).filter((t) => !stopWords.has(t)));
+    const intersection = [...claimTerms].filter((t) => existingTerms.has(t));
+    const overlap = claimTerms.size > 0 ? intersection.length / claimTerms.size : 0;
+    const claimHasStrongNegation = strongNegationPatterns.some((p) => p.test(claimLower));
+    const existingHasStrongNegation = strongNegationPatterns.some((p) => p.test(existingLower));
+    const claimHasPositive = positivePatterns.some((p) => p.test(claimLower));
+    const existingHasPositive = positivePatterns.some((p) => p.test(existingLower));
+    if (overlap > 0.25) {
+        if ((claimHasPositive && existingHasStrongNegation) ||
+            (claimHasStrongNegation && existingHasPositive)) {
+            return { isConflict: true, isSupporting: false };
+        }
+        if (claimHasStrongNegation !== existingHasStrongNegation) {
+            return { isConflict: true, isSupporting: false };
+        }
+    }
+    if (overlap > 0.3) {
+        if (claimHasStrongNegation === existingHasStrongNegation) {
+            return { isConflict: false, isSupporting: true };
+        }
+    }
+    return { isConflict: false, isSupporting: false };
+}
+function calculateConfidenceScore(conflicts, supporting, sourcesChecked) {
+    if (sourcesChecked === 0) {
+        return 0.5;
+    }
+    let score = 0.5;
+    for (const conflict of conflicts) {
+        score -= conflict.similarity * 0.3;
+    }
+    for (const support of supporting) {
+        score += support.similarity * 0.2;
+    }
+    if (conflicts.length === 0 && sourcesChecked > 0) {
+        score += 0.1 * sourcesChecked;
+    }
+    return Math.max(0, Math.min(1, score));
+}
+function determineRecommendation(confidenceScore, conflictCount) {
+    if (conflictCount > 0) {
+        return "flag";
+    }
+    if (confidenceScore >= 0.7) {
+        return "proceed";
+    }
+    if (confidenceScore >= 0.4) {
+        return "verify";
+    }
+    return "flag";
+}
+function determineBadge(confidenceScore, conflictCount) {
+    if (conflictCount > 0) {
+        return "🚫 CONFLICTS";
+    }
+    if (confidenceScore >= 0.9) {
+        return "✅ VERIFIED";
+    }
+    if (confidenceScore >= 0.7) {
+        return "✓ SUPPORTED";
+    }
+    if (confidenceScore >= 0.4) {
+        return "⚠️ UNVERIFIED";
+    }
+    return "🔍 CHECK THIS";
+}
+//# sourceMappingURL=checkClaimConsistency.js.map