centient 2.20.0

package/dist/tools/session/validateCitation.js

@@ -0,0 +1,450 @@
+import { estimateTokensFromJSON } from "../../utils/tokenEstimator.js";
+import { runPythonScriptJSON } from "../../utils/pythonRunner.js";
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+export const validateCitationTool = {
+    name: "validate_citation",
+    description: "Verify that a cited reference exists and supports the claim. Checks sessions, articles, patterns, or flags external sources for manual verification. Cross-references with Memory Bank for additional context. Part of hallucination detection.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            citationType: {
+                type: "string",
+                enum: ["session", "article", "pattern", "external"],
+                description: "Type of citation to validate",
+            },
+            reference: {
+                type: "string",
+                description: 'Reference identifier (e.g., "session-2025-12-28", "article-534", "architecture-001")',
+            },
+            claim: {
+                type: "string",
+                description: "The claim being made about the reference",
+            },
+            projectPath: {
+                type: "string",
+                description: "Project path for session citations (optional for article/pattern)",
+            },
+        },
+        required: ["citationType", "reference", "claim"],
+    },
+};
+export async function validateCitationHandler(args) {
+    const startTime = Date.now();
+    try {
+        const input = args;
+        if (!input.citationType) {
+            throw new Error("citationType is required");
+        }
+        if (!input.reference) {
+            throw new Error("reference is required");
+        }
+        if (!input.claim) {
+            throw new Error("claim is required");
+        }
+        const result = await validateCitation(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 input = args;
+        const errorResult = {
+            success: false,
+            error: {
+                code: "VALIDATE_CITATION_ERROR",
+                message: errorMessage,
+            },
+            metadata: {
+                tokensUsed: 0,
+                duration,
+                citationType: input?.citationType || "unknown",
+            },
+        };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(errorResult, null, 2),
+                },
+            ],
+        };
+    }
+}
+async function validateCitation(input) {
+    const startTime = Date.now();
+    try {
+        let result;
+        switch (input.citationType) {
+            case "session":
+                result = await validateSessionCitation(input.reference, input.claim, input.projectPath);
+                break;
+            case "article":
+                result = await validateArticleCitation(input.reference, input.claim, input.projectPath);
+                break;
+            case "pattern":
+                result = await validatePatternCitation(input.reference, input.claim);
+                break;
+            case "external":
+                result = createExternalCitationResult(input.reference, input.claim);
+                break;
+            default:
+                throw new Error(`Unknown citation type: ${input.citationType}`);
+        }
+        if (input.citationType !== "external") {
+            const memoryContext = await getMemoryBankContext(input.claim, input.reference, input.projectPath);
+            result.memoryBankContext = memoryContext;
+            if (memoryContext.found) {
+                if (memoryContext.conflictingFacts > 0) {
+                    result.confidence = Math.max(0.1, result.confidence - 0.2);
+                    if (!result.discrepancy) {
+                        result.discrepancy = `Memory Bank contains ${memoryContext.conflictingFacts} potentially conflicting fact(s)`;
+                    }
+                }
+                else if (memoryContext.supportingFacts > 0) {
+                    result.confidence = Math.min(1.0, result.confidence + 0.1 * memoryContext.supportingFacts);
+                }
+            }
+        }
+        const tokensUsed = estimateTokensFromJSON({ input, result });
+        const duration = Date.now() - startTime;
+        return {
+            success: true,
+            data: result,
+            metadata: {
+                tokensUsed,
+                duration,
+                citationType: input.citationType,
+            },
+        };
+    }
+    catch (error) {
+        const duration = Date.now() - startTime;
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            error: {
+                code: "VALIDATE_CITATION_ERROR",
+                message: errorMessage,
+            },
+            metadata: {
+                tokensUsed: 0,
+                duration,
+                citationType: input.citationType,
+            },
+        };
+    }
+}
+async function validateSessionCitation(reference, claim, projectPath) {
+    const sessionId = reference.replace(/^session-/, "");
+    let artifactDir;
+    if (projectPath) {
+        artifactDir = path.join(projectPath, ".agent-artifacts");
+    }
+    else {
+        const homeDir = os.homedir();
+        const possiblePaths = [
+            path.join(homeDir, "Dev/DevLex/.agent-artifacts"),
+            path.join(homeDir, "Dev/PrivateLanguage/.agent-artifacts"),
+        ];
+        const foundPath = possiblePaths.find((p) => fs.existsSync(p));
+        artifactDir =
+            foundPath ??
+                possiblePaths[0] ??
+                path.join(homeDir, "Dev/DevLex/.agent-artifacts");
+    }
+    const sessionDirs = findSessionDirectories(artifactDir, sessionId);
+    if (sessionDirs.length === 0) {
+        return {
+            exists: false,
+            supportsClaim: false,
+            confidence: 0.1,
+            verificationMethod: "finalization_pack_search",
+            badge: "🚫 NOT FOUND",
+            discrepancy: `No session found matching "${sessionId}"`,
+        };
+    }
+    const sessionDir = sessionDirs[0];
+    const summaryPath = path.join(sessionDir, "session-summary.md");
+    const packPath = path.join(sessionDir, "finalization-pack.json");
+    let actualContent = "";
+    if (fs.existsSync(summaryPath)) {
+        actualContent = fs.readFileSync(summaryPath, "utf-8");
+    }
+    else if (fs.existsSync(packPath)) {
+        const pack = JSON.parse(fs.readFileSync(packPath, "utf-8"));
+        actualContent = JSON.stringify(pack.summary || pack, null, 2);
+    }
+    const { supports, confidence, discrepancy } = checkClaimSupport(claim, actualContent);
+    return {
+        exists: true,
+        supportsClaim: supports,
+        actualContent: actualContent.slice(0, 500) + (actualContent.length > 500 ? "..." : ""),
+        confidence,
+        verificationMethod: "finalization_pack_content_match",
+        badge: supports ? "✅ VERIFIED" : "⚠️ PARTIAL MATCH",
+        discrepancy: supports ? undefined : discrepancy,
+    };
+}
+async function validateArticleCitation(reference, claim, projectPath) {
+    const articleId = reference.startsWith("article-")
+        ? reference
+        : `article-${reference}`;
+    let indexPath;
+    if (projectPath) {
+        indexPath = path.join(projectPath, "articles/articles-index.json");
+    }
+    else {
+        const homeDir = os.homedir();
+        const possiblePaths = [
+            path.join(homeDir, "Dev/DevLex/articles/articles-index.json"),
+            path.join(homeDir, "Dev/PrivateLanguage/articles/articles-index.json"),
+        ];
+        const foundPath = possiblePaths.find((p) => fs.existsSync(p));
+        indexPath =
+            foundPath ??
+                possiblePaths[0] ??
+                path.join(homeDir, "Dev/DevLex/articles/articles-index.json");
+    }
+    if (!fs.existsSync(indexPath)) {
+        return {
+            exists: false,
+            supportsClaim: false,
+            confidence: 0.1,
+            verificationMethod: "articles_index_lookup",
+            badge: "🔍 INDEX NOT FOUND",
+            discrepancy: "Articles index not found",
+        };
+    }
+    const index = JSON.parse(fs.readFileSync(indexPath, "utf-8"));
+    const article = index.articles.find((a) => a.id === articleId);
+    if (!article) {
+        return {
+            exists: false,
+            supportsClaim: false,
+            confidence: 0.1,
+            verificationMethod: "articles_index_lookup",
+            badge: "🚫 NOT FOUND",
+            discrepancy: `Article "${articleId}" not found in index`,
+        };
+    }
+    const articleContent = `${article.title}. ${article.coreIdea || ""}. Tags: ${(article.tags || []).join(", ")}`;
+    const { supports, confidence, discrepancy } = checkClaimSupport(claim, articleContent);
+    return {
+        exists: true,
+        supportsClaim: supports,
+        actualContent: `Title: ${article.title}\nCore Idea: ${article.coreIdea || "N/A"}\nStatus: ${article.status || "N/A"}`,
+        confidence,
+        verificationMethod: "articles_index_content_match",
+        badge: supports ? "✅ VERIFIED" : "⚠️ PARTIAL MATCH",
+        discrepancy: supports ? undefined : discrepancy,
+    };
+}
+async function validatePatternCitation(reference, claim) {
+    const indexPath = path.join(os.homedir(), ".shared-patterns/index.json");
+    if (!fs.existsSync(indexPath)) {
+        return {
+            exists: false,
+            supportsClaim: false,
+            confidence: 0.1,
+            verificationMethod: "pattern_index_lookup",
+            badge: "🔍 INDEX NOT FOUND",
+            discrepancy: "Pattern library index not found",
+        };
+    }
+    const index = JSON.parse(fs.readFileSync(indexPath, "utf-8"));
+    let pattern = index.patterns.find((p) => p.id === reference);
+    if (!pattern) {
+        pattern = index.patterns.find((p) => p.id.includes(reference));
+    }
+    if (!pattern) {
+        return {
+            exists: false,
+            supportsClaim: false,
+            confidence: 0.1,
+            verificationMethod: "pattern_index_lookup",
+            badge: "🚫 NOT FOUND",
+            discrepancy: `Pattern "${reference}" not found in library`,
+        };
+    }
+    const patternContent = `${pattern.title}. ${pattern.description}. Category: ${pattern.category}`;
+    const { supports, confidence, discrepancy } = checkClaimSupport(claim, patternContent);
+    return {
+        exists: true,
+        supportsClaim: supports,
+        actualContent: `Title: ${pattern.title}\nCategory: ${pattern.category}\nDescription: ${pattern.description.slice(0, 200)}`,
+        confidence,
+        verificationMethod: "pattern_index_content_match",
+        badge: supports ? "✅ VERIFIED" : "⚠️ PARTIAL MATCH",
+        discrepancy: supports ? undefined : discrepancy,
+    };
+}
+function createExternalCitationResult(reference, claim) {
+    return {
+        exists: false,
+        supportsClaim: false,
+        confidence: 0.3,
+        verificationMethod: "external_manual_required",
+        badge: "🔗 EXTERNAL",
+        discrepancy: `External citation "${reference}" requires manual verification. Claim: "${claim.slice(0, 100)}"`,
+        actualContent: `External reference: ${reference}\nManual verification required.`,
+    };
+}
+function findSessionDirectories(artifactDir, sessionId) {
+    if (!fs.existsSync(artifactDir)) {
+        return [];
+    }
+    const entries = fs.readdirSync(artifactDir, { withFileTypes: true });
+    const matches = entries
+        .filter((e) => e.isDirectory() && e.name.includes(sessionId))
+        .map((e) => path.join(artifactDir, e.name));
+    return matches;
+}
+function checkClaimSupport(claim, content) {
+    const claimLower = claim.toLowerCase();
+    const contentLower = content.toLowerCase();
+    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",
+        "used",
+        "using",
+        "says",
+        "said",
+        "according",
+        "based",
+    ]);
+    const claimTerms = (claimLower.match(/\b\w{3,}\b/g) || []).filter((t) => !stopWords.has(t));
+    if (claimTerms.length === 0) {
+        return {
+            supports: false,
+            confidence: 0.3,
+            discrepancy: "No key terms in claim",
+        };
+    }
+    const matchedTerms = claimTerms.filter((term) => contentLower.includes(term));
+    const matchRatio = matchedTerms.length / claimTerms.length;
+    if (matchRatio >= 0.7) {
+        return { supports: true, confidence: 0.85 };
+    }
+    else if (matchRatio >= 0.4) {
+        return {
+            supports: true,
+            confidence: 0.6,
+            discrepancy: `Only ${Math.round(matchRatio * 100)}% of claim terms found in source`,
+        };
+    }
+    else {
+        return {
+            supports: false,
+            confidence: 0.3,
+            discrepancy: `Low term overlap (${Math.round(matchRatio * 100)}%). Missing: ${claimTerms
+                .filter((t) => !contentLower.includes(t))
+                .slice(0, 5)
+                .join(", ")}`,
+        };
+    }
+}
+async function searchMemoryBank(query, projectName, topK = 3) {
+    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 [];
+    }
+}
+async function getMemoryBankContext(claim, reference, projectPath) {
+    const projectName = projectPath
+        ? path.basename(projectPath).toLowerCase()
+        : "devlex";
+    const combinedQuery = `${reference} ${claim}`;
+    const facts = await searchMemoryBank(combinedQuery, projectName, 5);
+    if (facts.length === 0) {
+        return {
+            found: false,
+            relatedFacts: [],
+            supportingFacts: 0,
+            conflictingFacts: 0,
+        };
+    }
+    let supportingCount = 0;
+    let conflictingCount = 0;
+    const relatedFacts = [];
+    for (const fact of facts) {
+        const similarity = fact.distance !== null ? 1 - fact.distance : 0.5;
+        if (similarity < 0.5)
+            continue;
+        relatedFacts.push(fact.fact.slice(0, 100) + (fact.fact.length > 100 ? "..." : ""));
+        const { supports, confidence } = checkClaimSupport(claim, fact.fact);
+        if (supports && confidence > 0.5) {
+            supportingCount++;
+        }
+        else if (!supports && confidence < 0.4) {
+            const factLower = fact.fact.toLowerCase();
+            const negationPatterns = [
+                /\bnot\b/,
+                /\brejected\b/,
+                /\bavoided\b/,
+                /\binstead\b/,
+            ];
+            if (negationPatterns.some((p) => p.test(factLower))) {
+                conflictingCount++;
+            }
+        }
+    }
+    return {
+        found: true,
+        relatedFacts,
+        supportingFacts: supportingCount,
+        conflictingFacts: conflictingCount,
+    };
+}
+//# sourceMappingURL=validateCitation.js.map

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

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

package/dist/tools/stuck/checkStuckPattern.d.ts

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

package/dist/tools/stuck/checkStuckPattern.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkStuckPattern.d.ts","sourceRoot":"","sources":["../../../src/tools/stuck/checkStuckPattern.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAQ1D,eAAO,MAAM,qBAAqB,EAAE,IAenC,CAAC;AAsBF,wBAAsB,wBAAwB,CAC5C,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,CA+C7D"}

package/dist/tools/stuck/checkStuckPattern.js

@@ -0,0 +1,93 @@
+import { getActiveCoordinator } from "../session/startSessionCoordination.js";
+import { StuckDetector } from "../../utils/StuckDetector.js";
+import { estimateTokensFromJSON } from "../../utils/tokenEstimator.js";
+export const checkStuckPatternTool = {
+    name: "check_stuck_pattern",
+    description: "Analyze current session state to detect if the developer is stuck. Checks for repeated blockers, lack of progress, and error loops. Includes 10-minute cooldown to prevent alert spam.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            projectPath: {
+                type: "string",
+                description: 'Absolute path to project directory (e.g., "/Users/username/Dev/PrivateLanguage")',
+            },
+        },
+        required: ["projectPath"],
+    },
+};
+export async function checkStuckPatternHandler(args) {
+    const startTime = Date.now();
+    try {
+        const input = args;
+        if (!input.projectPath) {
+            throw new Error("projectPath is required");
+        }
+        const result = await checkStuckPattern(input);
+        const responseText = JSON.stringify(result, null, 2);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: responseText,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const duration = Date.now() - startTime;
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        const errorResult = {
+            success: false,
+            error: {
+                code: "CHECK_STUCK_ERROR",
+                message: errorMessage,
+            },
+            metadata: {
+                tokensUsed: 0,
+                duration,
+            },
+        };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(errorResult, null, 2),
+                },
+            ],
+        };
+    }
+}
+async function checkStuckPattern(input) {
+    const startTime = Date.now();
+    try {
+        const coordinator = getActiveCoordinator();
+        const detector = new StuckDetector(coordinator, input.projectPath);
+        const analysis = await detector.analyze();
+        const tokensUsed = estimateTokensFromJSON({ input, analysis });
+        const duration = Date.now() - startTime;
+        return {
+            success: true,
+            data: analysis,
+            metadata: {
+                tokensUsed,
+                duration,
+            },
+        };
+    }
+    catch (error) {
+        const duration = Date.now() - startTime;
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            error: {
+                code: "CHECK_STUCK_ERROR",
+                message: errorMessage,
+            },
+            metadata: {
+                tokensUsed: 0,
+                duration,
+            },
+        };
+    }
+}
+//# sourceMappingURL=checkStuckPattern.js.map

package/dist/tools/stuck/checkStuckPattern.js.map

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

package/dist/tools/stuck/getRecoverySuggestions.d.ts

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

package/dist/tools/stuck/getRecoverySuggestions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getRecoverySuggestions.d.ts","sourceRoot":"","sources":["../../../src/tools/stuck/getRecoverySuggestions.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAY1D,eAAO,MAAM,0BAA0B,EAAE,IA+CxC,CAAC;AAyBF,wBAAsB,6BAA6B,CACjD,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,CAoD7D"}