greplica 0.1.0

package/dist/libs/knowledge-graph/graph-context/local-embedder.js

@@ -0,0 +1,74 @@
+import { join } from "node:path";
+import { greplicaHome } from "../../config/greplica-home.js";
+const localModelAliases = {
+    "all-mpnet-base-v2": "Xenova/all-mpnet-base-v2",
+    "all-MiniLM-L6-v2": "Xenova/all-MiniLM-L6-v2",
+};
+export class LocalEmbedder {
+    options;
+    extractor;
+    modelId;
+    cacheDir;
+    constructor(options) {
+        this.options = options;
+        this.modelId = resolveLocalModelId(options.model);
+        this.cacheDir = join(greplicaHome(), "models");
+    }
+    async embed(text) {
+        const [embedding] = await this.embedBatch([text]);
+        if (!embedding)
+            throw new Error("Local embedding model returned no embedding for query.");
+        return embedding;
+    }
+    async embedBatch(texts) {
+        const embeddings = [];
+        for (let index = 0; index < texts.length; index += this.options.batchSize) {
+            embeddings.push(...(await this.embedChunk(texts.slice(index, index + this.options.batchSize))));
+        }
+        return embeddings;
+    }
+    async embedChunk(texts) {
+        if (texts.length === 0)
+            return [];
+        const extractor = await this.loadExtractor();
+        const output = await extractor(texts, { pooling: "mean", normalize: true });
+        return splitTensorRows(output, texts.length, this.options.dimensions, this.modelId);
+    }
+    async loadExtractor() {
+        this.extractor ??= loadFeatureExtractionPipeline(this.modelId, this.cacheDir);
+        return this.extractor;
+    }
+}
+async function loadFeatureExtractionPipeline(modelId, cacheDir) {
+    const { pipeline } = await import("@huggingface/transformers");
+    const options = {
+        cache_dir: cacheDir,
+        dtype: "q8",
+    };
+    try {
+        return await pipeline("feature-extraction", modelId, {
+            ...options,
+            local_files_only: true,
+        });
+    }
+    catch {
+        return pipeline("feature-extraction", modelId, options);
+    }
+}
+function resolveLocalModelId(model) {
+    return localModelAliases[model] ?? model;
+}
+function splitTensorRows(output, expectedRows, expectedDimensions, modelId) {
+    const [rows, dimensions] = output.dims;
+    if (rows !== expectedRows || dimensions !== expectedDimensions) {
+        throw new Error(`Local embedding model ${modelId} returned shape [${output.dims.join(", ")}]; expected [${expectedRows}, ${expectedDimensions}].`);
+    }
+    const data = output.data;
+    const embeddings = [];
+    for (let row = 0; row < rows; row += 1) {
+        const start = row * dimensions;
+        embeddings.push(Array.from(data.slice(start, start + dimensions)));
+    }
+    return embeddings;
+}
+//# sourceMappingURL=local-embedder.js.map

package/dist/libs/knowledge-graph/graph-context/local-embedder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-embedder.js","sourceRoot":"","sources":["../../../../libs/knowledge-graph/graph-context/local-embedder.ts"],"names":[],"mappings":"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"}

package/dist/libs/knowledge-graph/graph-context/openai-embedder.d.ts

@@ -0,0 +1,14 @@
+export interface OpenAIEmbedderOptions {
+    apiKey?: string;
+    model: string;
+    dimensions: number;
+    batchSize: number;
+}
+export declare class OpenAIEmbedder {
+    private readonly options;
+    private readonly apiKey;
+    constructor(options: OpenAIEmbedderOptions);
+    embed(text: string): Promise<number[]>;
+    embedBatch(texts: string[]): Promise<number[][]>;
+    private embedChunk;
+}

package/dist/libs/knowledge-graph/graph-context/openai-embedder.js

@@ -0,0 +1,59 @@
+export class OpenAIEmbedder {
+    options;
+    apiKey;
+    constructor(options) {
+        this.options = options;
+        const apiKey = (options.apiKey ?? process.env.OPENAI_API_KEY)?.trim();
+        if (!apiKey) {
+            throw new Error("OPENAI_API_KEY is required for graph context embeddings. Set it in the environment, target-root .env.local, or target-root .env.");
+        }
+        this.apiKey = apiKey;
+    }
+    async embed(text) {
+        const [embedding] = await this.embedBatch([text]);
+        if (!embedding)
+            throw new Error("OpenAI returned no embedding for query.");
+        return embedding;
+    }
+    async embedBatch(texts) {
+        const embeddings = [];
+        for (let index = 0; index < texts.length; index += this.options.batchSize) {
+            embeddings.push(...(await this.embedChunk(texts.slice(index, index + this.options.batchSize))));
+        }
+        return embeddings;
+    }
+    async embedChunk(texts) {
+        if (texts.length === 0)
+            return [];
+        const response = await fetch("https://api.openai.com/v1/embeddings", {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                input: texts,
+                model: this.options.model,
+                dimensions: this.options.dimensions,
+                encoding_format: "float",
+            }),
+        });
+        const payload = (await response.json());
+        if (!response.ok) {
+            throw new Error(`OpenAI embeddings request failed: ${payload.error?.message ?? response.statusText}`);
+        }
+        if (!Array.isArray(payload.data)) {
+            throw new Error("OpenAI embeddings response did not include data.");
+        }
+        return payload.data
+            .slice()
+            .sort((a, b) => a.index - b.index)
+            .map((item) => {
+            if (item.embedding.length !== this.options.dimensions) {
+                throw new Error(`OpenAI returned ${item.embedding.length} dimensions; expected ${this.options.dimensions}.`);
+            }
+            return item.embedding;
+        });
+    }
+}
+//# sourceMappingURL=openai-embedder.js.map

package/dist/libs/knowledge-graph/graph-context/openai-embedder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-embedder.js","sourceRoot":"","sources":["../../../../libs/knowledge-graph/graph-context/openai-embedder.ts"],"names":[],"mappings":"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"}

package/dist/libs/knowledge-graph/graph-context/rank.d.ts

@@ -0,0 +1,16 @@
+import type { GraphContextConfig } from "./config.js";
+import type { ScoreEntry } from "./bm25.js";
+import type { ContextDocument } from "./documents.js";
+import type { ContextSignals } from "./types.js";
+export interface SemanticScoreEntry extends ScoreEntry {
+}
+export interface RankedContextDocument {
+    document: ContextDocument;
+    score: number;
+    signals: ContextSignals;
+}
+export declare function rankContextDocuments(documents: ContextDocument[], semantic: SemanticScoreEntry[], bm25: ScoreEntry[], exact: ScoreEntry[], config: GraphContextConfig): RankedContextDocument[];
+export declare function selectRankedDocuments(ranked: RankedContextDocument[], config: GraphContextConfig, options?: {
+    minimumSelected?: number;
+}): RankedContextDocument[];
+export declare function roundScore(value: number): number;

package/dist/libs/knowledge-graph/graph-context/rank.js

@@ -0,0 +1,52 @@
+export function rankContextDocuments(documents, semantic, bm25, exact, config) {
+    const semanticById = indexScores(semantic);
+    const bm25ById = indexScores(bm25);
+    const exactById = indexScores(exact);
+    const ranked = documents
+        .map((document) => {
+        const semanticScore = semanticById.get(document.key);
+        const bm25Score = bm25ById.get(document.key);
+        const exactScore = exactById.get(document.key);
+        const semanticValue = semanticScore?.score ?? 0;
+        if (semanticValue < config.ranking.semanticThreshold)
+            return undefined;
+        const weighted = semanticValue * config.ranking.weights.semantic +
+            (bm25Score?.score ?? 0) * config.ranking.weights.bm25 +
+            (exactScore?.score ?? 0) * config.ranking.weights.exact;
+        const divisor = config.ranking.weights.semantic +
+            config.ranking.weights.bm25 +
+            config.ranking.weights.exact;
+        return {
+            document,
+            score: weighted / divisor,
+            signals: {
+                semantic_score: semanticValue,
+                semantic_rank: semanticScore?.rank ?? null,
+                bm25_score: bm25Score?.score ?? 0,
+                bm25_rank: bm25Score?.rank ?? null,
+                exact_score: exactScore?.score ?? 0,
+                exact_rank: exactScore?.rank ?? null,
+                graph_score: 0,
+                graph_sources: [],
+            },
+        };
+    })
+        .filter((candidate) => candidate !== undefined)
+        .sort((a, b) => b.score - a.score || a.document.key.localeCompare(b.document.key));
+    const maxScore = ranked[0]?.score ?? 1;
+    return ranked.map((candidate) => ({
+        ...candidate,
+        score: maxScore === 0 ? 0 : candidate.score / maxScore,
+    }));
+}
+export function selectRankedDocuments(ranked, config, options = {}) {
+    return ranked.filter((document, index) => index < (options.minimumSelected ?? 0) ||
+        document.score >= config.ranking.selectionThreshold);
+}
+export function roundScore(value) {
+    return Math.round(value * 1000) / 1000;
+}
+function indexScores(scores) {
+    return new Map(scores.map((score) => [score.id, score]));
+}
+//# sourceMappingURL=rank.js.map

package/dist/libs/knowledge-graph/graph-context/rank.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rank.js","sourceRoot":"","sources":["../../../../libs/knowledge-graph/graph-context/rank.ts"],"names":[],"mappings":"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"}

package/dist/libs/knowledge-graph/graph-context/render.d.ts

@@ -0,0 +1,38 @@
+import type { Claim } from "../claim.js";
+import type { Source } from "../schema.js";
+import type { ClaimContextResult, GraphContextResult } from "./types.js";
+interface CompactGraphContextResult {
+    query: string;
+    components: CompactComponentResult[];
+    flows: CompactFlowResult[];
+    claims: CompactClaimResult[];
+    sources: Source[];
+}
+interface CompactComponentResult {
+    id: string;
+    name: string;
+    code_anchor?: string;
+    matched_claim_ids: string[];
+}
+interface CompactFlowResult {
+    id: string;
+    name: string;
+    matched_claim_ids: string[];
+}
+interface CompactClaimResult {
+    id: string;
+    kind: Claim["kind"];
+    text: string;
+    truth: Claim["truth"];
+    intent: Claim["intent"];
+    about: ClaimContextResult["about"];
+    evidence: Array<{
+        source_id: string;
+        title?: string;
+        ref: string;
+        reason?: string;
+    }>;
+}
+export declare function renderGraphContextMarkdown(result: GraphContextResult): string;
+export declare function compactGraphContextResult(result: GraphContextResult): CompactGraphContextResult;
+export {};

package/dist/libs/knowledge-graph/graph-context/render.js

@@ -0,0 +1,114 @@
+export function renderGraphContextMarkdown(result) {
+    const claimById = new Map(result.claims.map((claim) => [claim.object.id, claim]));
+    const shownClaimIds = new Set();
+    const content = [
+        "# Graph Context",
+        "",
+        `Query: ${result.query}`,
+        "",
+        "## Components",
+        "",
+        ...renderComponents(result.components),
+        "",
+        "## Flows",
+        "",
+        ...renderFlows(result.flows, claimById, shownClaimIds),
+    ];
+    const remainingClaims = result.claims.filter((claim) => !shownClaimIds.has(claim.object.id));
+    if (remainingClaims.length > 0) {
+        content.push("", "## Other Relevant Claims", "", ...renderClaimItems(remainingClaims));
+    }
+    if (result.sources.length > 0) {
+        content.push("", "## Sources", "", ...renderSources(result.sources));
+    }
+    return lines(...content);
+}
+export function compactGraphContextResult(result) {
+    return {
+        query: result.query,
+        components: result.components.map((component) => ({
+            id: component.object.id,
+            name: component.object.name,
+            code_anchor: component.object.code_anchor,
+            matched_claim_ids: component.matched_claim_ids,
+        })),
+        flows: result.flows.map((flow) => ({
+            id: flow.object.id,
+            name: flow.object.name,
+            matched_claim_ids: flow.matched_claim_ids,
+        })),
+        claims: result.claims.map((claim) => ({
+            id: claim.object.id,
+            kind: claim.object.kind,
+            text: claim.object.text,
+            truth: claim.object.truth,
+            intent: claim.object.intent,
+            about: claim.about,
+            evidence: claim.evidence.map((evidence) => ({
+                source_id: evidence.source.id,
+                title: evidence.source.title,
+                ref: evidence.source.ref,
+                reason: evidence.reason.length > 0 ? evidence.reason : undefined,
+            })),
+        })),
+        sources: result.sources,
+    };
+}
+function renderComponents(components) {
+    if (components.length === 0)
+        return ["- None."];
+    return components.map((component) => {
+        const anchor = component.object.code_anchor === undefined ? "" : `\n  Anchor: \`${component.object.code_anchor}\``;
+        return `- \`${component.object.id}\` ${component.object.name}${anchor}`;
+    });
+}
+function renderFlows(flows, claimById, shownClaimIds) {
+    if (flows.length === 0)
+        return ["- None."];
+    return flows.flatMap((flow) => {
+        const claims = claimsForFlow(flow, claimById);
+        for (const claim of claims)
+            shownClaimIds.add(claim.object.id);
+        return [
+            `### ${flow.object.name}`,
+            "",
+            `ID: \`${flow.object.id}\``,
+            "",
+            "Claims:",
+            ...renderClaimItems(claims),
+            "",
+        ];
+    });
+}
+function claimsForFlow(flow, claimById) {
+    const claims = new Map();
+    for (const claimId of flow.matched_claim_ids) {
+        const claim = claimById.get(claimId);
+        if (claim !== undefined)
+            claims.set(claim.object.id, claim);
+    }
+    for (const claim of claimById.values()) {
+        if (claim.about.some((subject) => subject.type === "flow" && subject.id === flow.object.id)) {
+            claims.set(claim.object.id, claim);
+        }
+    }
+    return [...claims.values()].sort((left, right) => left.object.kind.localeCompare(right.object.kind) || left.object.id.localeCompare(right.object.id));
+}
+function renderClaimItems(claims) {
+    if (claims.length === 0)
+        return ["- None."];
+    return claims.map((claim) => {
+        const evidence = claim.evidence.length === 0 ? "" : ` Source: ${claim.evidence.map(evidenceLabel).join("; ")}.`;
+        return `- \`${claim.object.id}\` (${claim.object.kind}, ${claim.object.truth}): ${claim.object.text}${evidence}`;
+    });
+}
+function evidenceLabel(evidence) {
+    return evidence.source.title ?? evidence.source.ref ?? evidence.source.id;
+}
+function renderSources(sources) {
+    return sources.map((source) => `- \`${source.id}\` ${source.title ?? source.ref}`);
+}
+function lines(...values) {
+    return `${values.join("\n").replace(/\n{3,}/g, "\n\n").trimEnd()}\n`;
+}
+//# sourceMappingURL=render.js.map

package/dist/libs/knowledge-graph/graph-context/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../../libs/knowledge-graph/graph-context/render.ts"],"names":[],"mappings":"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"}

package/dist/libs/knowledge-graph/graph-context/types.d.ts

@@ -0,0 +1,58 @@
+import type { Claim } from "../claim.js";
+import type { Component, Flow, Source } from "../schema.js";
+export interface EmbeddingStatus {
+    checked_objects: number;
+    created: number;
+    reused: number;
+}
+export interface GraphContextSource {
+    id: string;
+    edge_kind: string;
+    weight: number;
+    score: number;
+}
+export interface ContextSignals {
+    semantic_score: number;
+    semantic_rank: number | null;
+    bm25_score: number;
+    bm25_rank: number | null;
+    exact_score: number;
+    exact_rank: number | null;
+    graph_score: number;
+    graph_sources: GraphContextSource[];
+}
+export interface ClaimEvidenceResult {
+    source: Source;
+    reason: string;
+}
+export interface ClaimContextResult {
+    rank: number;
+    score: number;
+    signals: ContextSignals;
+    object: Claim;
+    about: Array<{
+        type: "component" | "flow";
+        id: string;
+    }>;
+    evidence: ClaimEvidenceResult[];
+}
+export interface GraphObjectContextResult<TObject> {
+    rank: number;
+    score: number;
+    direct_score: number;
+    claim_support_score: number;
+    signals: ContextSignals;
+    object: TObject;
+    matched_claim_ids: string[];
+}
+export type ComponentContextResult = GraphObjectContextResult<Component>;
+export type FlowContextResult = GraphObjectContextResult<Flow>;
+export interface GraphContextResult {
+    query: string;
+    search_config_version: string;
+    embedding_status: EmbeddingStatus;
+    claims: ClaimContextResult[];
+    components: ComponentContextResult[];
+    flows: FlowContextResult[];
+    sources: Source[];
+}

package/dist/libs/knowledge-graph/graph-context/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/libs/knowledge-graph/graph-context/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../libs/knowledge-graph/graph-context/types.ts"],"names":[],"mappings":""}

package/dist/libs/knowledge-graph/graph-context/vector.d.ts

@@ -0,0 +1,3 @@
+export declare function float32ArrayToBuffer(vector: number[]): Buffer;
+export declare function bufferToFloat32Array(buffer: Buffer): Float32Array;
+export declare function cosineSimilarity(a: ArrayLike<number>, b: ArrayLike<number>): number;

package/dist/libs/knowledge-graph/graph-context/vector.js

@@ -0,0 +1,25 @@
+export function float32ArrayToBuffer(vector) {
+    return Buffer.from(new Float32Array(vector).buffer);
+}
+export function bufferToFloat32Array(buffer) {
+    return new Float32Array(buffer.buffer, buffer.byteOffset, buffer.byteLength / Float32Array.BYTES_PER_ELEMENT);
+}
+export function cosineSimilarity(a, b) {
+    if (a.length !== b.length) {
+        throw new Error(`Embedding dimension mismatch. Expected ${a.length}, got ${b.length}.`);
+    }
+    let dot = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let index = 0; index < a.length; index += 1) {
+        const av = a[index] ?? 0;
+        const bv = b[index] ?? 0;
+        dot += av * bv;
+        normA += av * av;
+        normB += bv * bv;
+    }
+    if (normA === 0 || normB === 0)
+        return 0;
+    return dot / (Math.sqrt(normA) * Math.sqrt(normB));
+}
+//# sourceMappingURL=vector.js.map

package/dist/libs/knowledge-graph/graph-context/vector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector.js","sourceRoot":"","sources":["../../../../libs/knowledge-graph/graph-context/vector.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,oBAAoB,CAAC,MAAgB;IACnD,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU,GAAG,YAAY,CAAC,iBAAiB,CAAC,CAAC;AAChH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,CAAoB,EAAE,CAAoB;IACzE,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC,MAAM,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1F,CAAC;IAED,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACjD,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzB,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzB,GAAG,IAAI,EAAE,GAAG,EAAE,CAAC;QACf,KAAK,IAAI,EAAE,GAAG,EAAE,CAAC;QACjB,KAAK,IAAI,EAAE,GAAG,EAAE,CAAC;IACnB,CAAC;IAED,IAAI,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACzC,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AACrD,CAAC"}

package/dist/libs/knowledge-graph/proposal.d.ts

@@ -0,0 +1,65 @@
+import type { Claim } from "./claim.js";
+import type { Edge, EdgeKind, EdgeMetadata } from "./edge.js";
+import type { Component, Flow, GraphObjectType, Source } from "./schema.js";
+export interface MemoryCommitProposal {
+    title: string;
+    summary?: string;
+    creates: {
+        components?: Component[];
+        flows?: Flow[];
+        claims?: Claim[];
+        sources?: Source[];
+        edges?: Edge[];
+    };
+}
+export type CompactComponent = Component & {
+    contains?: string | string[];
+    supersedes?: string | string[];
+};
+export type CompactFlow = Flow & {
+    contains?: string | string[];
+    touches?: string | string[];
+    supersedes?: string | string[];
+};
+export type CompactClaim = Claim & {
+    about?: string | string[];
+    evidenced_by?: string | string[];
+    supersedes?: string | string[];
+};
+export interface CompactEdge {
+    kind: EdgeKind;
+    from: string;
+    to: string;
+    metadata?: EdgeMetadata;
+}
+export interface CompactMemoryProposal {
+    title: string;
+    summary?: string;
+    creates: {
+        components?: CompactComponent[];
+        flows?: CompactFlow[];
+        claims?: CompactClaim[];
+        sources?: Source[];
+        edges?: CompactEdge[];
+    };
+}
+export type ProposalSubject = {
+    type: "component";
+    id: string;
+} | {
+    type: "flow";
+    id: string;
+} | {
+    type: "claim";
+    id: string;
+} | {
+    type: "edge";
+    id: string;
+} | {
+    type: "source";
+    id: string;
+};
+export interface ProposalSubjectLookup {
+    subjectType(id: string): GraphObjectType | undefined;
+}
+export declare function normalizeProposal(input: unknown, lookup?: ProposalSubjectLookup): MemoryCommitProposal;