keywordgraph-mcp-server 1.7.4 → 1.8.5

package/dist/utils/knowledgeBase.js

@@ -0,0 +1,110 @@
+/**
+ * Pure helpers for `optimize_knowledge_base`: turn the graph engine's
+ * diversity diagnosis into a reading that makes sense for a code base, a
+ * document vault, or a body of procedural knowledge (rules, frameworks,
+ * principles). The engine's numbers are the same for any text; what differs
+ * is what a "gap" or a "dominant cluster" means for the thing being studied.
+ */
+export const FOCUSES = ["general", "codebase", "vault", "procedural"];
+export const STATES = ["biased", "focused", "diversified", "dispersed"];
+const READINGS = {
+    general: {
+        biased: {
+            meaning: "One cluster of ideas dominates; the rest orbit it.",
+            action: "Develop the under-represented clusters before adding more to the dominant one.",
+        },
+        focused: {
+            meaning: "Coherent and centred, but narrow.",
+            action: "Develop the content gaps: the topics listed as under-developed are the cheapest way to widen it.",
+        },
+        diversified: {
+            meaning: "Several strong clusters that barely connect.",
+            action: "Bridge the gaps between clusters — the missing links are where the most original ideas sit.",
+        },
+        dispersed: {
+            meaning: "Many small clusters with no shared backbone.",
+            action: "Consolidate: pick the most common gap topics and connect the fragments through them.",
+        },
+    },
+    codebase: {
+        biased: {
+            meaning: "One module or feature area dominates the project: everything depends on it or describes it (a god module, or a product that is really one feature with satellites).",
+            action: "Decide whether the dominance is intended. If not, develop the thin areas and cut dependencies on the dominant one; the under-developed list shows which parts of the code base nobody has built out.",
+        },
+        focused: {
+            meaning: "The code base is coherent and centred on a clear purpose, but narrow: little exists beyond the main path.",
+            action: "The gaps are the features and integrations that are implied but not built; the under-developed topics are the ones to build next.",
+        },
+        diversified: {
+            meaning: "Several substantial subsystems that hardly talk to each other.",
+            action: "The gaps between clusters are missing integrations or glue code — the most actionable state for a product: each gap is a feature that connects two things users already have.",
+        },
+        dispersed: {
+            meaning: "Fragmented: many small parts sharing no entities — features that do not compose, or several projects in one repo.",
+            action: "Consolidate around the most common gap topics; consider extracting or removing fragments that connect to nothing.",
+        },
+    },
+    vault: {
+        biased: {
+            meaning: "The vault keeps returning to one theme; other notes are satellites of it.",
+            action: "Grow the satellite themes into their own clusters, or accept the vault as single-topic and prune what does not serve it.",
+        },
+        focused: {
+            meaning: "A coherent vault around one line of thought, not yet exploring its edges.",
+            action: "Write into the gaps: the under-developed topics are notes the vault is already pointing at but has not written.",
+        },
+        diversified: {
+            meaning: "Several well-developed themes with few notes linking them.",
+            action: "The gaps are the bridge notes waiting to be written — the places where two of your themes would produce a new idea if connected.",
+        },
+        dispersed: {
+            meaning: "Many unconnected notes; no theme is developed enough to organise the others.",
+            action: "Pick the most common gap topics as hub notes and link the fragments through them (maps of content).",
+        },
+    },
+    procedural: {
+        biased: {
+            meaning: "One framework or rule set dominates the procedural knowledge; the others are footnotes to it.",
+            action: "Check whether the dominant framework really covers the other situations; develop the thin rule sets or make the dominance explicit.",
+        },
+        focused: {
+            meaning: "A coherent set of rules and frameworks around one way of working, with little guidance beyond it.",
+            action: "The gaps are situations the rules do not address; the under-developed topics are frameworks mentioned but not spelled out.",
+        },
+        diversified: {
+            meaning: "Several independent frameworks or rule sets that never reference each other.",
+            action: "The gaps are where two frameworks should hand off to each other — write the rules for those transitions, or you have contradictions waiting to happen.",
+        },
+        dispersed: {
+            meaning: "Fragmented procedural knowledge: many rules, no organising principles.",
+            action: "Consolidate the rules under the most common gap topics as principles; rules that connect to no principle are candidates for removal.",
+        },
+    },
+};
+export function normalizeState(raw) {
+    if (typeof raw !== "string")
+        return undefined;
+    const value = raw.toLowerCase();
+    return STATES.find((state) => value.includes(state));
+}
+export function readState(focus, state) {
+    return READINGS[focus][state];
+}
+/** Bounded, de-duplicated list helper for report fields. */
+export function dedupeList(items, limit) {
+    const seen = new Set();
+    const out = [];
+    for (const item of items) {
+        if (!item)
+            continue;
+        const key = item.trim();
+        if (!key || seen.has(key.toLowerCase()))
+            continue;
+        seen.add(key.toLowerCase());
+        out.push(key);
+        if (out.length >= limit)
+            break;
+    }
+    return out;
+}
+//# sourceMappingURL=knowledgeBase.js.map

package/dist/utils/knowledgeBase.js.map

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

package/dist/utils/learnings.d.ts

@@ -0,0 +1,121 @@
+import type { GraphResponse, Statement } from "../types/index.js";
+import { READ_ATTEMPTS, errorText } from "./graphLookup.js";
+export declare const GRAPH_PREFIX = "learn-";
+export declare const MAX_GRAPH_NAME_LENGTH = 28;
+export declare const MARKER_CATEGORY = "learnings-enabled";
+export declare const LEARNING_TYPES: readonly ["location", "trap", "convention", "decision", "workflow", "question", "approach"];
+export type LearningType = (typeof LEARNING_TYPES)[number];
+export declare const TYPE_CATEGORY_PREFIX = "type-";
+export declare const SOURCE_CATEGORY_PREFIX = "source-";
+/** Near-duplicate threshold on word-set Jaccard similarity. */
+export declare const DEDUPE_THRESHOLD = 0.6;
+export declare const MAX_STATEMENT_LENGTH = 400;
+export declare function slugify(input: string): string;
+export declare function learningsGraphName(project: string): string;
+/**
+ * Not attached to statements any more: a per-client label links every
+ * statement of that client and became the most central node of the graph in
+ * testing. Kept so `toStoredLearning` can still read graphs written before
+ * that change.
+ */
+export declare function sourceCategory(clientName?: string): string;
+export declare function typeCategory(type: LearningType): string;
+export interface RedactionIssue {
+    index: number;
+    reason: "secret-like" | "too-long" | "empty";
+}
+/** Returns the indices (never the content) of statements that must not be stored. */
+export declare function redactionIssues(statements: string[]): RedactionIssue[];
+export declare function tokenize(statement: string): Set<string>;
+export declare function jaccard(a: Set<string>, b: Set<string>): number;
+export interface DedupeResult {
+    statement: string;
+    status: "new" | "reinforced";
+    /** The existing statement this one reinforces (when status is "reinforced"). */
+    matches?: string;
+    similarity?: number;
+}
+/**
+ * Compare candidates against what the graph already holds. A near-duplicate
+ * is not dropped — it is rewritten as a short "Confirmed again" statement so
+ * the repeat still raises the weight of the same entity links (that is how
+ * frequently re-learned things become central) without duplicating the text.
+ */
+export declare function dedupeAgainstExisting(candidates: string[], existing: string[], threshold?: number): DedupeResult[];
+export interface LearningsGraphInfo {
+    exists: boolean;
+    /**
+     * True for graphs created before 2026-08-28 with `categoriesAsMentions`
+     * on (labels are nodes there). Informational only; consent is the marker
+     * statement.
+     */
+    categoriesOn: boolean;
+    id?: number;
+    url?: string;
+    createdAt?: string;
+}
+export { READ_ATTEMPTS, errorText };
+/** Exact-name lookup through /listGraphs (read-only; never creates anything). */
+export declare function findLearningsGraph(graphName: string): Promise<LearningsGraphInfo>;
+export interface StoredLearning {
+    content: string;
+    types: string[];
+    source?: string;
+    categories: string[];
+    createdAt?: string;
+}
+export declare function toStoredLearning(statement: Statement): StoredLearning | null;
+export declare function isMarkerStatement(statement: Statement): boolean;
+/**
+ * Read every statement of the graph (doNotSave; the graph must already exist —
+ * a missing name errors and is never created). "Select an existing graph
+ * context" on a graph that does exist means the request hit an instance
+ * with a stale contexts list (see firstPositive), not a parameter problem.
+ */
+export declare function fetchLearningsGraph(graphName: string): Promise<{
+    statements: Statement[];
+    response: GraphResponse;
+}>;
+/**
+ * Resolve whether learnings are enabled for a graph name: the graph exists
+ * and holds the marker statement written by `createLearningsGraph`. The
+ * listing supplies url/createdAt; reading by name is authoritative for
+ * existence (a missing graph errors and is never created) and is also what
+ * catches a graph the listing does not show yet (see firstPositive).
+ */
+export declare function checkEnabled(graphName: string): Promise<{
+    enabled: boolean;
+    info: LearningsGraphInfo;
+    reason?: "missing" | "not-a-learnings-graph";
+}>;
+export interface AppendResult {
+    graphName?: string;
+    graphUrl?: string;
+    response: GraphResponse;
+}
+/**
+ * Append statements (with parallel categories/timestamps) to an existing
+ * graph. Sent as a plain statements payload, without contextSettings: the
+ * `type` labels stay metadata and never become nodes (the same as
+ * prepareStatementsPayload with categoriesAsNodes off), and an append must
+ * not carry settings anyway — the graph already has its own.
+ */
+export declare function appendLearnings(params: {
+    graphName: string;
+    statements: string[];
+    categories: string[][];
+    timestamps: string[];
+}): Promise<AppendResult>;
+/**
+ * Create the learnings graph. The marker statement (and its
+ * `learnings-enabled` category) is what `checkEnabled` looks for.
+ */
+export declare function createLearningsGraph(params: {
+    graphName: string;
+    slug: string;
+    clientName?: string;
+}): Promise<AppendResult>;
+export declare function newestFirst<T extends {
+    createdAt?: string;
+}>(items: T[]): T[];
+//# sourceMappingURL=learnings.d.ts.map

package/dist/utils/learnings.d.ts.map

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

package/dist/utils/learnings.js

@@ -0,0 +1,339 @@
+/**
+ * Project learnings: an append-only, per-project graph (`learn-<slug>`) where
+ * the calling LLM saves what it learned about operating in a project, so the
+ * next session — on any client — can retrieve it.
+ *
+ * Consent model (see docs/drafts/project-learnings-graph.md): the graph only
+ * exists if the user explicitly asked for it via `enable_project_learnings`.
+ * `add_project_learnings` refuses when the graph is missing and never creates
+ * one. Statements carry their `type-*` label as plain per-statement metadata
+ * (`categories`), deliberately WITHOUT `categoriesAsMentions`: with that
+ * flag each label becomes a [[label]] mention node linked to every statement
+ * of that type, which in testing made the labels the most central nodes of
+ * the graph. As metadata the labels are returned with each statement and
+ * filterable, while the graph's nodes stay the real entities.
+ */
+import { makeInfraNodusRequest } from "../api/client.js";
+import { READ_ATTEMPTS, errorText, findGraphByName, firstPositive, } from "./graphLookup.js";
+export const GRAPH_PREFIX = "learn-";
+export const MAX_GRAPH_NAME_LENGTH = 28;
+export const MARKER_CATEGORY = "learnings-enabled";
+export const LEARNING_TYPES = [
+    "location",
+    "trap",
+    "convention",
+    "decision",
+    "workflow",
+    "question",
+    "approach",
+];
+export const TYPE_CATEGORY_PREFIX = "type-";
+export const SOURCE_CATEGORY_PREFIX = "source-";
+/** Near-duplicate threshold on word-set Jaccard similarity. */
+export const DEDUPE_THRESHOLD = 0.6;
+export const MAX_STATEMENT_LENGTH = 400;
+export function slugify(input) {
+    return input
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .replace(/-{2,}/g, "-");
+}
+export function learningsGraphName(project) {
+    const slug = slugify(project) || "project";
+    const room = MAX_GRAPH_NAME_LENGTH - GRAPH_PREFIX.length;
+    return GRAPH_PREFIX + slug.slice(0, room).replace(/-+$/g, "");
+}
+/**
+ * Not attached to statements any more: a per-client label links every
+ * statement of that client and became the most central node of the graph in
+ * testing. Kept so `toStoredLearning` can still read graphs written before
+ * that change.
+ */
+export function sourceCategory(clientName) {
+    return SOURCE_CATEGORY_PREFIX + (slugify(clientName ?? "") || "unknown");
+}
+export function typeCategory(type) {
+    return TYPE_CATEGORY_PREFIX + type;
+}
+// ---------------------------------------------------------------------------
+// Redaction lint
+// ---------------------------------------------------------------------------
+const SECRET_PATTERNS = [
+    /\bsk-[A-Za-z0-9_-]{8,}/, // OpenAI/Anthropic-style keys
+    /\bAKIA[0-9A-Z]{16}\b/, // AWS access key id
+    /\bbearer\s+[A-Za-z0-9._~+/=-]{12,}/i,
+    /\bapi[_-]?key\s*[:=]\s*['"]?[A-Za-z0-9._-]{8,}/i,
+    /\b(?:password|passwd|secret|token)\s*[:=]\s*['"]?\S{6,}/i,
+    /-----BEGIN [A-Z ]*PRIVATE KEY-----/,
+    /:\/\/[^\s/@]+:[^\s/@]+@/, // user:pass@host in a URL
+    /\beyJ[A-Za-z0-9_-]{10,}\.[A-Za-z0-9_-]{10,}/, // JWT
+];
+/** Returns the indices (never the content) of statements that must not be stored. */
+export function redactionIssues(statements) {
+    const issues = [];
+    statements.forEach((statement, index) => {
+        if (!statement || !statement.trim()) {
+            issues.push({ index, reason: "empty" });
+            return;
+        }
+        if (statement.length > MAX_STATEMENT_LENGTH) {
+            issues.push({ index, reason: "too-long" });
+            return;
+        }
+        if (SECRET_PATTERNS.some((pattern) => pattern.test(statement))) {
+            issues.push({ index, reason: "secret-like" });
+        }
+    });
+    return issues;
+}
+// ---------------------------------------------------------------------------
+// Dedupe
+// ---------------------------------------------------------------------------
+const STOPWORDS = new Set([
+    "the", "and", "for", "that", "this", "with", "from", "are", "was", "were",
+    "has", "have", "not", "but", "its", "into", "when", "which", "also", "than",
+    "then", "there", "their", "they", "them", "been", "being", "use", "used",
+    "confirmed", "again",
+]);
+export function tokenize(statement) {
+    const words = statement
+        .toLowerCase()
+        .replace(/\[\[|\]\]/g, " ")
+        .split(/[^a-z0-9._/-]+/)
+        .map((word) => word.replace(/^[._/-]+|[._/-]+$/g, ""))
+        .filter((word) => word.length >= 3 && !STOPWORDS.has(word));
+    return new Set(words);
+}
+export function jaccard(a, b) {
+    if (a.size === 0 || b.size === 0)
+        return 0;
+    let intersection = 0;
+    for (const word of a)
+        if (b.has(word))
+            intersection += 1;
+    const union = a.size + b.size - intersection;
+    return union === 0 ? 0 : intersection / union;
+}
+/**
+ * Compare candidates against what the graph already holds. A near-duplicate
+ * is not dropped — it is rewritten as a short "Confirmed again" statement so
+ * the repeat still raises the weight of the same entity links (that is how
+ * frequently re-learned things become central) without duplicating the text.
+ */
+export function dedupeAgainstExisting(candidates, existing, threshold = DEDUPE_THRESHOLD) {
+    const existingTokens = existing.map((statement) => ({
+        statement,
+        tokens: tokenize(statement),
+    }));
+    const accepted = [];
+    return candidates.map((candidate) => {
+        const tokens = tokenize(candidate);
+        let best = null;
+        for (const entry of existingTokens) {
+            const similarity = jaccard(tokens, entry.tokens);
+            if (similarity >= threshold && (!best || similarity > best.similarity)) {
+                best = { statement: entry.statement, similarity };
+            }
+        }
+        // Also collapse duplicates within the same batch.
+        if (!best) {
+            for (const prior of accepted) {
+                if (jaccard(tokens, prior) >= threshold) {
+                    best = { statement: "(earlier statement in this batch)", similarity: 1 };
+                    break;
+                }
+            }
+        }
+        accepted.push(tokens);
+        if (best) {
+            return {
+                statement: best.statement.startsWith("(")
+                    ? candidate
+                    : `Confirmed again: ${stripConfirmedPrefix(best.statement)}`,
+                status: "reinforced",
+                matches: best.statement,
+                similarity: Number(best.similarity.toFixed(2)),
+            };
+        }
+        return { statement: candidate, status: "new" };
+    });
+}
+function stripConfirmedPrefix(statement) {
+    return statement.replace(/^(?:confirmed again:\s*)+/i, "");
+}
+// The retrying lookup and the error-envelope normaliser live in
+// graphLookup.ts (shared with delete_statements); re-exported here so the
+// existing imports and tests keep working.
+export { READ_ATTEMPTS, errorText };
+/** Exact-name lookup through /listGraphs (read-only; never creates anything). */
+export async function findLearningsGraph(graphName) {
+    const found = await findGraphByName(graphName);
+    if (!found)
+        return { exists: false, categoriesOn: false };
+    return {
+        exists: true,
+        categoriesOn: found.textProcessingSettings?.categoriesAsMentions === true,
+        id: found.id,
+        url: found.defaultRevisionUrl ?? undefined,
+        createdAt: found.createdAt,
+    };
+}
+export function toStoredLearning(statement) {
+    if (!statement.content)
+        return null;
+    const categories = statement.categories ?? [];
+    return {
+        content: statement.content,
+        types: categories
+            .filter((category) => category.startsWith(TYPE_CATEGORY_PREFIX))
+            .map((category) => category.slice(TYPE_CATEGORY_PREFIX.length)),
+        source: categories
+            .find((category) => category.startsWith(SOURCE_CATEGORY_PREFIX))
+            ?.slice(SOURCE_CATEGORY_PREFIX.length),
+        categories,
+        createdAt: statement.createdAt,
+    };
+}
+export function isMarkerStatement(statement) {
+    return ((statement.categories ?? []).includes(MARKER_CATEGORY) ||
+        (statement.content ?? "").includes(`[[${MARKER_CATEGORY}]]`));
+}
+/**
+ * Read every statement of the graph (doNotSave; the graph must already exist —
+ * a missing name errors and is never created). "Select an existing graph
+ * context" on a graph that does exist means the request hit an instance
+ * with a stale contexts list (see firstPositive), not a parameter problem.
+ */
+export async function fetchLearningsGraph(graphName) {
+    const queryParams = new URLSearchParams({
+        doNotSave: "true",
+        addStats: "true",
+        includeStatements: "true",
+        includeGraphSummary: "false",
+        extendedGraphSummary: "true",
+        includeGraph: "false",
+        compactGraph: "true",
+        compactStatements: "false",
+        aiTopics: "false",
+    });
+    let lastError = "Graph not found";
+    const response = await firstPositive(async (n) => {
+        try {
+            const result = await makeInfraNodusRequest(`/graphAndStatements?${queryParams.toString()}`, { name: graphName, aiTopics: "false", attempt: n });
+            if (result.error) {
+                lastError = errorText(result.error);
+                return null;
+            }
+            return result;
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error.message : String(error);
+            return null;
+        }
+    });
+    if (!response)
+        throw new Error(lastError);
+    return { statements: response.statements ?? [], response };
+}
+/**
+ * Resolve whether learnings are enabled for a graph name: the graph exists
+ * and holds the marker statement written by `createLearningsGraph`. The
+ * listing supplies url/createdAt; reading by name is authoritative for
+ * existence (a missing graph errors and is never created) and is also what
+ * catches a graph the listing does not show yet (see firstPositive).
+ */
+export async function checkEnabled(graphName) {
+    const info = await findLearningsGraph(graphName);
+    let statements;
+    try {
+        ({ statements } = await fetchLearningsGraph(graphName));
+    }
+    catch {
+        return { enabled: false, info, reason: "missing" };
+    }
+    if (statements.some(isMarkerStatement)) {
+        return { enabled: true, info: { ...info, exists: true } };
+    }
+    return {
+        enabled: false,
+        info: { ...info, exists: true },
+        reason: "not-a-learnings-graph",
+    };
+}
+/**
+ * Append statements (with parallel categories/timestamps) to an existing
+ * graph. Sent as a plain statements payload, without contextSettings: the
+ * `type` labels stay metadata and never become nodes (the same as
+ * prepareStatementsPayload with categoriesAsNodes off), and an append must
+ * not carry settings anyway — the graph already has its own.
+ */
+export async function appendLearnings(params) {
+    const payload = {
+        text: "",
+        statements: params.statements,
+        categories: params.categories,
+        timestamps: params.timestamps,
+    };
+    const queryParams = new URLSearchParams({
+        doNotSave: "false",
+        addStats: "false",
+        includeStatements: "false",
+        includeGraphSummary: "false",
+        extendedGraphSummary: "false",
+        includeGraph: "false",
+        compactGraph: "true",
+        compactStatements: "true",
+        aiTopics: "false",
+    });
+    // An instance with a stale contexts list (see firstPositive) treats an
+    // append to an existing graph as a create and the engine rejects it with
+    // "Context with this name already exists". That error is the only one
+    // worth retrying: it means the graph exists and another instance will
+    // append correctly.
+    let lastError = "Append failed";
+    for (let n = 0; n < READ_ATTEMPTS; n++) {
+        const response = await makeInfraNodusRequest(`/graphAndStatements?${queryParams.toString()}`, {
+            name: params.graphName,
+            aiTopics: "false",
+            contextType: "memory",
+            ...payload,
+            ...(n > 0 ? { attempt: n } : {}),
+        });
+        if (!response.error) {
+            return {
+                graphName: response.graphName ?? params.graphName,
+                graphUrl: response.graphUrl,
+                response,
+            };
+        }
+        lastError = errorText(response.error);
+        if (!/already exists/i.test(lastError))
+            break;
+    }
+    throw new Error(lastError);
+}
+/**
+ * Create the learnings graph. The marker statement (and its
+ * `learnings-enabled` category) is what `checkEnabled` looks for.
+ */
+export async function createLearningsGraph(params) {
+    const now = new Date().toISOString();
+    const client = params.clientName?.trim() || "unknown client";
+    return appendLearnings({
+        graphName: params.graphName,
+        statements: [
+            `[[${MARKER_CATEGORY}]] Project [[${params.slug}]] learnings enabled on ${now.slice(0, 10)} from ${client}. Append-only graph of what agents learned about operating in this project.`,
+        ],
+        categories: [[MARKER_CATEGORY]],
+        timestamps: [now],
+    });
+}
+export function newestFirst(items) {
+    return [...items].sort((a, b) => {
+        const ta = a.createdAt ? Date.parse(a.createdAt) : 0;
+        const tb = b.createdAt ? Date.parse(b.createdAt) : 0;
+        return tb - ta;
+    });
+}
+//# sourceMappingURL=learnings.js.map

package/dist/utils/learnings.js.map

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