@sourcepress/knowledge 0.1.0

package/src/knowledge-store.ts

@@ -0,0 +1,49 @@
+import type { KnowledgeFile } from "@sourcepress/core";
+import type { KnowledgeFileFilter, KnowledgeGraph, KnowledgeStoreBackend } from "./types.js";
+
+export class InMemoryKnowledgeStore implements KnowledgeStoreBackend {
+	private files: Map<string, KnowledgeFile> = new Map();
+	private graph: KnowledgeGraph | null = null;
+
+	async store(file: KnowledgeFile): Promise<void> {
+		this.files.set(file.path, { ...file });
+	}
+
+	async retrieve(path: string): Promise<KnowledgeFile | null> {
+		return this.files.get(path) ?? null;
+	}
+
+	async list(filter?: KnowledgeFileFilter): Promise<KnowledgeFile[]> {
+		let results = Array.from(this.files.values());
+		if (filter?.type) {
+			results = results.filter((f) => f.type === filter.type);
+		}
+		if (filter?.quality) {
+			results = results.filter((f) => f.quality === filter.quality);
+		}
+		if (filter?.source) {
+			results = results.filter((f) => f.source === filter.source);
+		}
+		if (filter?.since) {
+			const since = filter.since;
+			results = results.filter((f) => f.ingested_at >= since);
+		}
+		return results;
+	}
+
+	async delete(path: string): Promise<boolean> {
+		return this.files.delete(path);
+	}
+
+	async count(): Promise<number> {
+		return this.files.size;
+	}
+
+	async saveGraph(graph: KnowledgeGraph): Promise<void> {
+		this.graph = graph;
+	}
+
+	async loadGraph(): Promise<KnowledgeGraph | null> {
+		return this.graph;
+	}
+}

package/src/types.ts

@@ -0,0 +1,76 @@
+import type { Entity, GraphEdge, KnowledgeFile } from "@sourcepress/core";
+
+export interface ExtractionResult {
+	entities: ExtractedEntity[];
+	relations: ExtractedRelation[];
+}
+
+export interface ExtractedEntity extends Entity {
+	aliases: string[];
+	confidence: number;
+	source_file: string;
+}
+
+export interface ExtractedRelation {
+	from_entity: string;
+	to_entity: string;
+	relation_type: string;
+	confidence: number;
+	evidence: string;
+	source_file: string;
+}
+
+export interface EntityCluster {
+	id: string;
+	name: string;
+	entities: string[];
+	coherence_score: number;
+}
+
+export interface KnowledgeGraph {
+	entities: Map<string, ExtractedEntity>;
+	relations: ExtractedRelation[];
+	clusters: EntityCluster[];
+	built_at: string;
+	file_count: number;
+}
+
+export interface GraphQueryResult {
+	entity: ExtractedEntity;
+	relations: ExtractedRelation[];
+	related_entities: ExtractedEntity[];
+	files: string[];
+}
+
+export interface KnowledgeGap {
+	entity_name: string;
+	entity_type: string;
+	knowledge_file_count: number;
+	content_file_count: number;
+	reason: string;
+}
+
+export interface StaleContent {
+	content_path: string;
+	generated_at: string;
+	newest_source_change: string;
+	stale_sources: string[];
+	reason: string;
+}
+
+export interface KnowledgeStoreBackend {
+	store(file: KnowledgeFile): Promise<void>;
+	retrieve(path: string): Promise<KnowledgeFile | null>;
+	list(filter?: KnowledgeFileFilter): Promise<KnowledgeFile[]>;
+	delete(path: string): Promise<boolean>;
+	count(): Promise<number>;
+	saveGraph(graph: KnowledgeGraph): Promise<void>;
+	loadGraph(): Promise<KnowledgeGraph | null>;
+}
+
+export interface KnowledgeFileFilter {
+	type?: string;
+	quality?: KnowledgeFile["quality"];
+	source?: KnowledgeFile["source"];
+	since?: string;
+}

package/tsconfig.json

@@ -0,0 +1,5 @@
+{
+	"extends": "../../tsconfig.json",
+	"compilerOptions": { "outDir": "dist", "rootDir": "src" },
+	"include": ["src"]
+}

package/vitest.config.ts

@@ -0,0 +1,2 @@
+import { defineConfig } from "vitest/config";
+export default defineConfig({ test: { include: ["src/__tests__/**/*.test.ts"] } });