@roarpeng/graphflow 0.6.5

package/dist/core/types.d.ts

@@ -0,0 +1,61 @@
+export type TaskStatus = "PENDING" | "RUNNING" | "VALIDATING" | "COMPLETED" | "FAILED" | "HUMAN_REVIEW_REQUIRED";
+export type AgentRole = "planner" | "worker" | "validator" | "enricher" | "evolver";
+export interface ValidationResult {
+    passed: boolean;
+    feedback: string;
+    matchedCriteria: string[];
+    missingCriteria: string[];
+    riskTags: string[];
+}
+export interface RouteDecision {
+    role: AgentRole;
+    provider: string;
+    model: string;
+    tier: "smart" | "economy";
+    fallbackApplied: boolean;
+}
+export interface TaskRunResult {
+    status: TaskStatus;
+    attempts: number;
+    feedback: string;
+    routeDecisions?: RouteDecision[];
+    executionRounds?: string[][];
+    validationSummary?: {
+        matched: number;
+        missing: number;
+        riskTags: string[];
+    };
+    replanRounds?: number;
+    brainstormIdeas?: string[];
+    promptContextLines?: number;
+    episodeId?: string;
+    similarEpisodes?: Array<{
+        id: string;
+        task: string;
+        score: number;
+    }>;
+}
+export interface TaskNode {
+    id: string;
+    description: string;
+    dependencies: string[];
+    status: TaskStatus;
+    contextQuery: string;
+    retryCount: number;
+}
+export interface OrchestrationInput {
+    task: string;
+    maxRetries?: number;
+}
+export interface GraphNode {
+    id: string;
+    type: "File" | "Symbol" | "Module" | "TaskRun" | "Decision" | "Skill";
+    content: string;
+    metadata?: Record<string, unknown>;
+}
+export interface GraphEdge {
+    from: string;
+    to: string;
+    relation: "defines" | "references" | "imports" | "depends_on" | "changes" | "validates" | "co_occurs" | "prerequisite" | "improves" | "conflicts_with";
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,SAAS,GACT,YAAY,GACZ,WAAW,GACX,QAAQ,GACR,uBAAuB,CAAC;AAE5B,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;AAEpF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1B,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;IACjC,eAAe,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;IAC7B,iBAAiB,CAAC,EAAE;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IACF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtE;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,UAAU,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EACJ,SAAS,GACT,YAAY,GACZ,SAAS,GACT,YAAY,GACZ,SAAS,GACT,WAAW,GACX,WAAW,GACX,cAAc,GACd,UAAU,GACV,gBAAgB,CAAC;CACtB"}

package/dist/core/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

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

package/dist/graph/client-factory.d.ts

@@ -0,0 +1,22 @@
+import type { GraphFlowConfig } from "../config/schema";
+import type { GraphEdge, GraphNode } from "../core/types";
+export interface GraphStoreSnapshot {
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+}
+export interface GraphClient {
+    upsertNodes(nodes: GraphNode[]): Promise<void>;
+    upsertEdges(edges: GraphEdge[]): Promise<void>;
+    queryByKeyword(query: string): Promise<GraphNode[]>;
+    readSnapshot?(): GraphStoreSnapshot;
+    getNodesByIds?(ids: string[]): Promise<GraphNode[]>;
+    getNeighbors?(nodeIds: string[], relations?: GraphEdge["relation"][], direction?: "out" | "in" | "both"): Promise<{
+        node: GraphNode;
+        via: GraphEdge["relation"];
+    }[]>;
+    deleteNode?(id: string): Promise<void>;
+    deleteEdge?(from: string, to: string, relation: GraphEdge["relation"]): Promise<void>;
+    vacuum?(): Promise<void> | void;
+}
+export declare function createGraphClient(config: GraphFlowConfig): GraphClient;
+//# sourceMappingURL=client-factory.d.ts.map

package/dist/graph/client-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-factory.d.ts","sourceRoot":"","sources":["../../src/graph/client-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAQ1D,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACpD,YAAY,CAAC,IAAI,kBAAkB,CAAC;IACpC,aAAa,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACpD,YAAY,CAAC,CACX,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,CAAC,EAAE,SAAS,CAAC,UAAU,CAAC,EAAE,EACnC,SAAS,CAAC,EAAE,KAAK,GAAG,IAAI,GAAG,MAAM,GAChC,OAAO,CAAC;QAAE,IAAI,EAAE,SAAS,CAAC;QAAC,GAAG,EAAE,SAAS,CAAC,UAAU,CAAC,CAAA;KAAE,EAAE,CAAC,CAAC;IAC9D,UAAU,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,UAAU,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtF,MAAM,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACjC;AA0CD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,WAAW,CAwBtE"}

package/dist/graph/client-factory.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createGraphClient = createGraphClient;
+const paths_1 = require("../config/paths");
+const logger_1 = require("../utils/logger");
+const graphify_client_1 = require("./graphify-client");
+const graphify_file_client_1 = require("./graphify-file-client");
+const graphify_mcp_client_1 = require("./graphify-mcp-client");
+const sqlite_client_1 = require("./sqlite-client");
+class InMemoryGraphClientAdapter {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async upsertNodes(nodes) {
+        this.client.upsertNodes(nodes);
+    }
+    async upsertEdges(edges) {
+        this.client.upsertEdges(edges);
+    }
+    async queryByKeyword(query) {
+        return this.client.queryByKeyword(query);
+    }
+    async getNodesByIds(ids) {
+        return this.client.getNodesByIds(ids);
+    }
+    async getNeighbors(nodeIds, relations, direction) {
+        return this.client.getNeighbors(nodeIds, relations, direction);
+    }
+    readSnapshot() {
+        return this.client.readSnapshot();
+    }
+    async deleteNode(id) {
+        return this.client.deleteNode(id);
+    }
+    async deleteEdge(from, to, relation) {
+        return this.client.deleteEdge(from, to, relation);
+    }
+}
+function createGraphClient(config) {
+    if (config.graphPolicy.transport === "mcp-http") {
+        return new graphify_mcp_client_1.GraphifyMcpClient(config.graphPolicy.mcpEndpoint, config.graphPolicy.mcpApiKey);
+    }
+    if (config.graphPolicy.transport === "file") {
+        return new graphify_file_client_1.GraphifyFileClient((0, paths_1.resolveGraphStorePath)(config));
+    }
+    if (config.graphPolicy.transport === "sqlite") {
+        try {
+            return new sqlite_client_1.GraphifySqliteClient((0, paths_1.resolveGraphStorePath)(config));
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            const fallbackPath = (0, paths_1.resolveGraphStorePath)(config).replace(/\.sqlite$/i, ".json");
+            logger_1.logger.warn({ err, fallbackPath }, `[graphflow] sqlite transport unavailable, falling back to file. Reason: ${msg}`);
+            return new graphify_file_client_1.GraphifyFileClient(fallbackPath);
+        }
+    }
+    return new InMemoryGraphClientAdapter(new graphify_client_1.GraphifyClient());
+}
+//# sourceMappingURL=client-factory.js.map

package/dist/graph/client-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-factory.js","sourceRoot":"","sources":["../../src/graph/client-factory.ts"],"names":[],"mappings":";;AAsEA,8CAwBC;AA5FD,2CAAwD;AACxD,4CAAyC;AACzC,uDAAmD;AACnD,iEAA4D;AAC5D,+DAA0D;AAC1D,mDAAuD;AAuBvD,MAAM,0BAA0B;IACD;IAA7B,YAA6B,MAAsB;QAAtB,WAAM,GAAN,MAAM,CAAgB;IAAG,CAAC;IAEvD,KAAK,CAAC,WAAW,CAAC,KAAkB;QAClC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,KAAkB;QAClC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,KAAa;QAChC,OAAO,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,GAAa;QAC/B,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,OAAiB,EACjB,SAAmC,EACnC,SAAiC;QAEjC,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IACjE,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,EAAU;QACzB,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,IAAY,EAAE,EAAU,EAAE,QAA+B;QACxE,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC;IACpD,CAAC;CACF;AAED,SAAgB,iBAAiB,CAAC,MAAuB;IACvD,IAAI,MAAM,CAAC,WAAW,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;QAChD,OAAO,IAAI,uCAAiB,CAAC,MAAM,CAAC,WAAW,CAAC,WAAY,EAAE,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IAC9F,CAAC;IAED,IAAI,MAAM,CAAC,WAAW,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;QAC5C,OAAO,IAAI,yCAAkB,CAAC,IAAA,6BAAqB,EAAC,MAAM,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,IAAI,MAAM,CAAC,WAAW,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;QAC9C,IAAI,CAAC;YACH,OAAO,IAAI,oCAAoB,CAAC,IAAA,6BAAqB,EAAC,MAAM,CAAC,CAAC,CAAC;QACjE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,MAAM,YAAY,GAAG,IAAA,6BAAqB,EAAC,MAAM,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YAClF,eAAM,CAAC,IAAI,CACT,EAAE,GAAG,EAAE,YAAY,EAAE,EACrB,2EAA2E,GAAG,EAAE,CACjF,CAAC;YACF,OAAO,IAAI,yCAAkB,CAAC,YAAY,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,OAAO,IAAI,0BAA0B,CAAC,IAAI,gCAAc,EAAE,CAAC,CAAC;AAC9D,CAAC"}

package/dist/graph/context-slicer.d.ts

@@ -0,0 +1,47 @@
+import type { GraphEdge, GraphNode } from "../core/types";
+import { type EmbeddingProvider } from "../learning/embeddings";
+import type { GraphClient } from "./client-factory";
+export interface ContextSlice {
+    items: string[];
+    tokenEstimate: number;
+}
+export type ContextLayer = "L1" | "L2" | "L3";
+export interface ContextAnchorItem {
+    id: string;
+    type: GraphNode["type"];
+    layer: ContextLayer;
+}
+export interface LayeredContextPackage {
+    summaryChannel: string[];
+    anchorChannel: ContextAnchorItem[];
+    tokenEstimate: number;
+    truncated: boolean;
+}
+export interface LayeredPackageOptions {
+    layerQuota?: {
+        l1: number;
+        l2: number;
+        l3: number;
+    };
+    enableEdgeExpansion?: boolean;
+    enableVectorRecall?: boolean;
+    embeddingProvider?: EmbeddingProvider;
+    vectorTopK?: number;
+    vectorMinSimilarity?: number;
+}
+export interface SubgraphExpansionOptions {
+    hops?: number;
+    maxNodes?: number;
+    relations?: GraphEdge["relation"][];
+}
+export declare function expandSubgraph(client: GraphClient, seedIds: string[], options?: SubgraphExpansionOptions): Promise<GraphNode[]>;
+export declare function buildContextSlice(client: GraphClient, query: string, maxTokens: number): Promise<ContextSlice>;
+export declare function vectorRecall(nodes: GraphNode[], queryEmbedding: number[], topK: number, minSimilarity: number): GraphNode[];
+export declare function buildLayeredContextPackage(client: GraphClient, query: string, maxTokens: number, options?: LayeredPackageOptions): Promise<LayeredContextPackage>;
+export interface ContextRefillManager {
+    initialPackage(query: string): Promise<LayeredContextPackage>;
+    refill(evidenceHints: string[]): Promise<string[]>;
+}
+export declare function createContextRefillManager(client: GraphClient, maxTokens: number, options?: LayeredPackageOptions): ContextRefillManager;
+export declare function summarizeNodes(nodes: GraphNode[]): string[];
+//# sourceMappingURL=context-slicer.d.ts.map

package/dist/graph/context-slicer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-slicer.d.ts","sourceRoot":"","sources":["../../src/graph/context-slicer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAgCpD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE9C,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACxB,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,EAAE,iBAAiB,EAAE,CAAC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,CAAC,EAAE;QACX,EAAE,EAAE,MAAM,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;KACZ,CAAC;IACF,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;CACrC;AASD,wBAAsB,cAAc,CAClC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,SAAS,EAAE,CAAC,CAyBtB;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,YAAY,CAAC,CAGvB;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,EAAE,EAClB,cAAc,EAAE,MAAM,EAAE,EACxB,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,GACpB,SAAS,EAAE,CAWb;AAED,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CA6EhC;AAED,MAAM,WAAW,oBAAoB;IACnC,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC9D,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CACpD;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,oBAAoB,CAsCtB;AAgBD,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,EAAE,CAE3D"}

package/dist/graph/context-slicer.js

@@ -0,0 +1,246 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.expandSubgraph = expandSubgraph;
+exports.buildContextSlice = buildContextSlice;
+exports.vectorRecall = vectorRecall;
+exports.buildLayeredContextPackage = buildLayeredContextPackage;
+exports.createContextRefillManager = createContextRefillManager;
+exports.summarizeNodes = summarizeNodes;
+const logger_1 = require("../utils/logger");
+const embeddings_1 = require("../learning/embeddings");
+let encoderFn = null;
+let encoderLoaded = false;
+function getEncoder() {
+    if (encoderLoaded)
+        return encoderFn;
+    encoderLoaded = true;
+    try {
+        const mod = require("gpt-tokenizer/encoding/o200k_base");
+        if (typeof mod.encode === "function") {
+            encoderFn = mod.encode.bind(mod);
+            return encoderFn;
+        }
+    }
+    catch (error) {
+        logger_1.logger.error({ error }, "Caught error");
+        // fall through
+    }
+    try {
+        const mod = require("gpt-tokenizer");
+        if (typeof mod.encode === "function") {
+            encoderFn = mod.encode.bind(mod);
+            return encoderFn;
+        }
+    }
+    catch (error) {
+        logger_1.logger.error({ error }, "Caught error");
+        // fall through
+    }
+    encoderFn = null;
+    return null;
+}
+const DEFAULT_EXPANSION_RELATIONS = [
+    "references",
+    "imports",
+    "depends_on",
+    "prerequisite",
+];
+async function expandSubgraph(client, seedIds, options) {
+    if (typeof client.getNeighbors !== "function")
+        return [];
+    const hops = options?.hops ?? 1;
+    const maxNodes = options?.maxNodes ?? 20;
+    const relations = options?.relations ?? DEFAULT_EXPANSION_RELATIONS;
+    const excluded = new Set(seedIds);
+    const collected = new Map();
+    let frontier = [...seedIds];
+    for (let depth = 0; depth < hops; depth += 1) {
+        if (frontier.length === 0)
+            break;
+        const neighbors = await client.getNeighbors(frontier, relations, "both");
+        const nextFrontier = [];
+        for (const { node } of neighbors) {
+            if (excluded.has(node.id) || collected.has(node.id))
+                continue;
+            collected.set(node.id, node);
+            nextFrontier.push(node.id);
+            if (collected.size >= maxNodes)
+                break;
+        }
+        if (collected.size >= maxNodes)
+            break;
+        frontier = nextFrontier;
+    }
+    return Array.from(collected.values());
+}
+async function buildContextSlice(client, query, maxTokens) {
+    const pkg = await buildLayeredContextPackage(client, query, maxTokens);
+    return { items: pkg.summaryChannel, tokenEstimate: pkg.tokenEstimate };
+}
+function vectorRecall(nodes, queryEmbedding, topK, minSimilarity) {
+    if (!queryEmbedding || queryEmbedding.length === 0)
+        return [];
+    const scored = [];
+    for (const node of nodes) {
+        const emb = (0, embeddings_1.extractEmbedding)(node);
+        if (!emb)
+            continue;
+        const sim = (0, embeddings_1.cosineSimilarity)(queryEmbedding, emb);
+        if (sim >= minSimilarity)
+            scored.push({ node, sim });
+    }
+    scored.sort((a, b) => b.sim - a.sim);
+    return scored.slice(0, topK).map((s) => s.node);
+}
+async function buildLayeredContextPackage(client, query, maxTokens, options) {
+    const keywordHits = await client.queryByKeyword(query);
+    let hits = keywordHits;
+    if (options?.enableVectorRecall === true && options.embeddingProvider) {
+        try {
+            const queryEmbedding = await options.embeddingProvider.embed(query);
+            const topK = options.vectorTopK ?? 8;
+            const minSim = options.vectorMinSimilarity ?? 0.05;
+            const vectorHits = vectorRecall(keywordHits, queryEmbedding, topK, minSim);
+            hits = (0, embeddings_1.reciprocalRankFusion)([keywordHits, vectorHits]);
+        }
+        catch (error) {
+            logger_1.logger.error({ error }, "Caught error");
+            hits = keywordHits;
+        }
+    }
+    const summaryChannel = [];
+    const anchorChannel = [];
+    let tokens = 0;
+    let truncated = false;
+    const quota = {
+        l1: options?.layerQuota?.l1 ?? Number.POSITIVE_INFINITY,
+        l2: options?.layerQuota?.l2 ?? Number.POSITIVE_INFINITY,
+        l3: options?.layerQuota?.l3 ?? Number.POSITIVE_INFINITY,
+    };
+    const used = { l1: 0, l2: 0, l3: 0 };
+    const added = new Set();
+    for (const hit of hits) {
+        const layer = classifyLayer(hit);
+        if (!canUseLayer(layer, quota, used)) {
+            continue;
+        }
+        const summary = `${hit.type}: ${hit.content}`;
+        const estimate = estimateTokens(summary);
+        if (tokens + estimate > maxTokens) {
+            truncated = true;
+            break;
+        }
+        summaryChannel.push(summary);
+        anchorChannel.push({ id: hit.id, type: hit.type, layer });
+        added.add(hit.id);
+        tokens += estimate;
+        markLayerUsed(layer, used);
+    }
+    const enableExpansion = options?.enableEdgeExpansion !== false;
+    if (enableExpansion && !truncated && typeof client.getNeighbors === "function") {
+        const seedIds = anchorChannel.slice(0, 5).map((a) => a.id);
+        if (seedIds.length > 0) {
+            const expanded = await expandSubgraph(client, seedIds, { hops: 1 });
+            for (const node of expanded) {
+                if (added.has(node.id))
+                    continue;
+                const layer = classifyLayer(node);
+                if (!canUseLayer(layer, quota, used))
+                    continue;
+                const summary = `${node.type}: ${node.content}`;
+                const estimate = estimateTokens(summary);
+                if (tokens + estimate > maxTokens) {
+                    truncated = true;
+                    break;
+                }
+                summaryChannel.push(summary);
+                anchorChannel.push({ id: node.id, type: node.type, layer });
+                added.add(node.id);
+                tokens += estimate;
+                markLayerUsed(layer, used);
+            }
+        }
+    }
+    return { summaryChannel, anchorChannel, tokenEstimate: tokens, truncated };
+}
+function createContextRefillManager(client, maxTokens, options) {
+    const seenAnchors = new Set();
+    return {
+        async initialPackage(query) {
+            const pkg = await buildLayeredContextPackage(client, query, maxTokens, options);
+            for (const anchor of pkg.anchorChannel) {
+                seenAnchors.add(anchor.id);
+            }
+            return pkg;
+        },
+        async refill(evidenceHints) {
+            const items = [];
+            let tokens = 0;
+            for (const hint of evidenceHints) {
+                const hits = await client.queryByKeyword(hint);
+                for (const hit of hits) {
+                    if (seenAnchors.has(hit.id)) {
+                        continue;
+                    }
+                    const line = `${hit.id} | ${hit.type}: ${hit.content}`;
+                    const estimate = estimateTokens(line);
+                    if (tokens + estimate > maxTokens) {
+                        return items;
+                    }
+                    seenAnchors.add(hit.id);
+                    tokens += estimate;
+                    items.push(line);
+                    break;
+                }
+            }
+            return items;
+        },
+    };
+}
+function estimateTokens(text) {
+    const enc = getEncoder();
+    if (enc) {
+        try {
+            const n = enc(text).length;
+            return Math.max(1, n);
+        }
+        catch (error) {
+            logger_1.logger.error({ error }, "Caught error");
+            // fall back below
+        }
+    }
+    return Math.max(1, Math.ceil(text.length / 4));
+}
+function summarizeNodes(nodes) {
+    return nodes.map((node) => `${node.type}(${node.id})`);
+}
+function classifyLayer(node) {
+    if (node.type === "File" || node.type === "Symbol") {
+        return "L1";
+    }
+    if (node.type === "Module") {
+        return "L2";
+    }
+    return "L3";
+}
+function canUseLayer(layer, quota, used) {
+    if (layer === "L1") {
+        return used.l1 < quota.l1;
+    }
+    if (layer === "L2") {
+        return used.l2 < quota.l2;
+    }
+    return used.l3 < quota.l3;
+}
+function markLayerUsed(layer, used) {
+    if (layer === "L1") {
+        used.l1 += 1;
+        return;
+    }
+    if (layer === "L2") {
+        used.l2 += 1;
+        return;
+    }
+    used.l3 += 1;
+}
+//# sourceMappingURL=context-slicer.js.map

package/dist/graph/context-slicer.js.map

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

package/dist/graph/file-indexer.d.ts

@@ -0,0 +1,15 @@
+import type { GraphClient } from "./client-factory";
+export interface FileIndexerOptions {
+    includeExtensions?: string[];
+    maxFileSizeBytes?: number;
+    /** When true, ignore index cache and re-process every file. */
+    forceReindex?: boolean;
+}
+/** Remove graph store, index cache, and vector DB for a full rebuild. */
+export declare function clearGraphIndexArtifacts(rootDir: string, graphStorePath: string): void;
+export declare function indexWorkspaceFiles(client: GraphClient, rootDir: string, options?: FileIndexerOptions): Promise<{
+    indexedFiles: number;
+    indexedSymbols: number;
+    indexedReferences: number;
+}>;
+//# sourceMappingURL=file-indexer.d.ts.map

package/dist/graph/file-indexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-indexer.d.ts","sourceRoot":"","sources":["../../src/graph/file-indexer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAOpD,MAAM,WAAW,kBAAkB;IACjC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,+DAA+D;IAC/D,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAoDD,yEAAyE;AACzE,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI,CAMtF;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,CAAC,CAmPtF"}