@sourcepress/knowledge 0.1.0

package/dist/ingestion/types.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Injectable fetch function for testability.
+ * Matches the standard fetch signature (subset).
+ */
+export type Fetcher = (url: string, init?: RequestInit) => Promise<Response>;
+/**
+ * Result of scraping a single URL.
+ */
+export interface ScrapeResult {
+    url: string;
+    title: string;
+    content: string;
+    markdown: string;
+    byline?: string;
+    excerpt?: string;
+    length: number;
+    scraped_at: string;
+}
+/**
+ * Sitemap section — a group of URLs sharing a path pattern.
+ */
+export interface SitemapSection {
+    name: string;
+    pattern: string;
+    urls: string[];
+    count: number;
+}
+/**
+ * Parsed sitemap result — sections grouped by URL pattern.
+ */
+export interface SitemapResult {
+    sitemap_url: string;
+    sections: SitemapSection[];
+    total_urls: number;
+}
+/**
+ * Options for running a sitemap import.
+ */
+export interface SitemapRunOptions {
+    sitemap_url: string;
+    include?: string[];
+    exclude?: string[];
+}
+/**
+ * Progress info for batch operations.
+ */
+export interface BatchProgress {
+    completed: number;
+    total: number;
+    failed: number;
+    results: Array<{
+        url: string;
+        path: string;
+        success: boolean;
+        error?: string;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ingestion/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAE7E;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChF"}

package/dist/ingestion/types.js

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

package/dist/ingestion/types.js.map

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

package/dist/json-file-store.d.ts

@@ -0,0 +1,19 @@
+import type { KnowledgeFile } from "@sourcepress/core";
+import type { KnowledgeFileFilter, KnowledgeGraph, KnowledgeStoreBackend } from "./types.js";
+export declare class JsonFileStore implements KnowledgeStoreBackend {
+    private readonly knowledgePath;
+    private readonly graphPath;
+    private files;
+    private graph;
+    constructor(dir: string);
+    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>;
+    private loadFiles;
+    private writeFiles;
+}
+//# sourceMappingURL=json-file-store.d.ts.map

package/dist/json-file-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-file-store.d.ts","sourceRoot":"","sources":["../src/json-file-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAEX,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACrB,MAAM,YAAY,CAAC;AAUpB,qBAAa,aAAc,YAAW,qBAAqB;IAC1D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC,OAAO,CAAC,KAAK,CAA2C;IACxD,OAAO,CAAC,KAAK,CAAgD;gBAEjD,GAAG,EAAE,MAAM;IASjB,KAAK,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAIrD,IAAI,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAkB5D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAStC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAIxB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAY/C,SAAS,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAoBjD,OAAO,CAAC,SAAS;IAcjB,OAAO,CAAC,UAAU;CAKlB"}

package/dist/json-file-store.js

@@ -0,0 +1,100 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+export class JsonFileStore {
+    knowledgePath;
+    graphPath;
+    files = null;
+    graph = undefined;
+    constructor(dir) {
+        this.knowledgePath = join(dir, "knowledge.json");
+        this.graphPath = join(dir, "graph.json");
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+    }
+    async store(file) {
+        const files = this.loadFiles();
+        files.set(file.path, { ...file });
+        this.writeFiles(files);
+    }
+    async retrieve(path) {
+        return this.loadFiles().get(path) ?? null;
+    }
+    async list(filter) {
+        let results = Array.from(this.loadFiles().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) {
+        const files = this.loadFiles();
+        const deleted = files.delete(path);
+        if (deleted) {
+            this.writeFiles(files);
+        }
+        return deleted;
+    }
+    async count() {
+        return this.loadFiles().size;
+    }
+    async saveGraph(graph) {
+        this.graph = graph;
+        const serialized = {
+            entities: Array.from(graph.entities.entries()),
+            relations: graph.relations,
+            clusters: graph.clusters,
+            built_at: graph.built_at,
+            file_count: graph.file_count,
+        };
+        writeFileSync(this.graphPath, JSON.stringify(serialized, null, "\t"), "utf-8");
+    }
+    async loadGraph() {
+        if (this.graph !== undefined) {
+            return this.graph;
+        }
+        if (!existsSync(this.graphPath)) {
+            this.graph = null;
+            return null;
+        }
+        const raw = readFileSync(this.graphPath, "utf-8");
+        const data = JSON.parse(raw);
+        this.graph = {
+            entities: new Map(data.entities),
+            relations: data.relations,
+            clusters: data.clusters,
+            built_at: data.built_at,
+            file_count: data.file_count,
+        };
+        return this.graph;
+    }
+    loadFiles() {
+        if (this.files !== null) {
+            return this.files;
+        }
+        if (!existsSync(this.knowledgePath)) {
+            this.files = new Map();
+            return this.files;
+        }
+        const raw = readFileSync(this.knowledgePath, "utf-8");
+        const entries = JSON.parse(raw);
+        this.files = new Map(entries);
+        return this.files;
+    }
+    writeFiles(files) {
+        this.files = files;
+        const entries = Array.from(files.entries());
+        writeFileSync(this.knowledgePath, JSON.stringify(entries, null, "\t"), "utf-8");
+    }
+}
+//# sourceMappingURL=json-file-store.js.map

package/dist/json-file-store.js.map

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

package/dist/knowledge-engine.d.ts

@@ -0,0 +1,45 @@
+import type { BudgetTracker, ResolvedProvider } from "@sourcepress/ai";
+import type { ContentFile, KnowledgeFile } from "@sourcepress/core";
+import type { BatchProgress, Fetcher, SitemapResult, SitemapRunOptions } from "./ingestion/types.js";
+import type { GraphQueryResult, KnowledgeGap, KnowledgeGraph, KnowledgeStoreBackend, StaleContent } from "./types.js";
+export declare class KnowledgeEngine {
+    private store;
+    private provider;
+    private budget;
+    private graphOps;
+    private currentGraph;
+    private scraper;
+    private sitemapParser;
+    constructor(store: KnowledgeStoreBackend, provider: ResolvedProvider, budget: BudgetTracker, fetcher?: Fetcher);
+    initialize(): Promise<void>;
+    ingest(path: string, body: string, source: KnowledgeFile["source"], sourceUrl?: string): Promise<KnowledgeFile>;
+    buildGraph(): Promise<KnowledgeGraph>;
+    query(nameOrAlias: string): GraphQueryResult | null;
+    findGaps(contentFiles: ContentFile[]): KnowledgeGap[];
+    findStale(contentFiles: ContentFile[], knowledgeTimestamps: Record<string, string>): StaleContent[];
+    getGraph(): KnowledgeGraph | null;
+    getStore(): KnowledgeStoreBackend;
+    /**
+     * Import a single URL: scrape → classify → extract entities → store.
+     */
+    importUrl(url: string): Promise<KnowledgeFile>;
+    /**
+     * Parse a sitemap and return grouped sections for interactive selection.
+     */
+    parseSitemap(sitemapUrl: string): Promise<SitemapResult>;
+    /**
+     * Filter a parsed sitemap result by include/exclude patterns.
+     */
+    filterSitemapUrls(result: SitemapResult, options: SitemapRunOptions): string[];
+    /**
+     * Import a batch of URLs. Calls progressCallback for each completed URL.
+     */
+    importBatch(urls: string[], progressCallback?: (completed: number, total: number, failed: number) => void): Promise<BatchProgress>;
+    /**
+     * Convert a URL to a knowledge file path.
+     * https://example.com/blog/post-1 → knowledge/example.com/blog/post-1.md
+     */
+    private urlToPath;
+    private getExistingEntities;
+}
+//# sourceMappingURL=knowledge-engine.d.ts.map

package/dist/knowledge-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-engine.d.ts","sourceRoot":"","sources":["../src/knowledge-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEvE,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAKpE,OAAO,KAAK,EACX,aAAa,EACb,OAAO,EACP,aAAa,EACb,iBAAiB,EACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAEX,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,qBAAqB,EACrB,YAAY,EACZ,MAAM,YAAY,CAAC;AAEpB,qBAAa,eAAe;IAC3B,OAAO,CAAC,KAAK,CAAwB;IACrC,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,aAAa,CAAgB;gBAGpC,KAAK,EAAE,qBAAqB,EAC5B,QAAQ,EAAE,gBAAgB,EAC1B,MAAM,EAAE,aAAa,EACrB,OAAO,CAAC,EAAE,OAAO;IASZ,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B,MAAM,CACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,EAC/B,SAAS,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,CAAC;IAwBnB,UAAU,IAAI,OAAO,CAAC,cAAc,CAAC;IAkC3C,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAKnD,QAAQ,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,YAAY,EAAE;IAKrD,SAAS,CACR,YAAY,EAAE,WAAW,EAAE,EAC3B,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACzC,YAAY,EAAE;IAKjB,QAAQ,IAAI,cAAc,GAAG,IAAI;IAGjC,QAAQ,IAAI,qBAAqB;IAIjC;;OAEG;IACG,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAMpD;;OAEG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAI9D;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,EAAE;IAI9E;;OAEG;IACG,WAAW,CAChB,IAAI,EAAE,MAAM,EAAE,EACd,gBAAgB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,GAC3E,OAAO,CAAC,aAAa,CAAC;IA6BzB;;;OAGG;IACH,OAAO,CAAC,SAAS;IAOjB,OAAO,CAAC,mBAAmB;CAO3B"}

package/dist/knowledge-engine.js

@@ -0,0 +1,160 @@
+import { classify, extract } from "@sourcepress/ai";
+import { GraphBuilder } from "./graph-builder.js";
+import { GraphOps } from "./graph-ops.js";
+import { Scraper } from "./ingestion/scraper.js";
+import { SitemapParser } from "./ingestion/sitemap-parser.js";
+export class KnowledgeEngine {
+    store;
+    provider;
+    budget;
+    graphOps = null;
+    currentGraph = null;
+    scraper;
+    sitemapParser;
+    constructor(store, provider, budget, fetcher) {
+        this.store = store;
+        this.provider = provider;
+        this.budget = budget;
+        this.scraper = new Scraper(fetcher);
+        this.sitemapParser = new SitemapParser(fetcher);
+    }
+    async initialize() {
+        const graph = await this.store.loadGraph();
+        if (graph) {
+            this.currentGraph = graph;
+            this.graphOps = new GraphOps(graph);
+        }
+    }
+    async ingest(path, body, source, sourceUrl) {
+        const classification = await classify({ text: body }, this.provider, this.budget);
+        const extraction = await extract({ text: body, file_path: path, existing_entities: this.getExistingEntities() }, this.provider, this.budget);
+        const knowledgeFile = {
+            path,
+            type: classification.type,
+            quality: classification.quality,
+            quality_score: classification.quality_score,
+            entities: extraction.entities.map((e) => ({ type: e.type, name: e.name })),
+            ingested_at: new Date().toISOString(),
+            source,
+            source_url: sourceUrl,
+            body,
+        };
+        await this.store.store(knowledgeFile);
+        return knowledgeFile;
+    }
+    async buildGraph() {
+        const files = await this.store.list();
+        const builder = new GraphBuilder();
+        for (const file of files) {
+            const extraction = await extract({
+                text: file.body,
+                file_path: file.path,
+                existing_entities: Array.from(builder.getEntities().values()),
+            }, this.provider, this.budget);
+            const entities = extraction.entities.map((e) => ({
+                type: e.type,
+                name: e.name,
+                aliases: e.aliases ?? [],
+                confidence: e.confidence ?? 0.5,
+                source_file: file.path,
+            }));
+            builder.addEntities(entities);
+            builder.addRelations(extraction.relations.map((r) => ({ ...r, source_file: file.path })));
+        }
+        const graph = builder.build();
+        this.currentGraph = graph;
+        this.graphOps = new GraphOps(graph);
+        await this.store.saveGraph(graph);
+        return graph;
+    }
+    query(nameOrAlias) {
+        if (!this.graphOps)
+            return null;
+        return this.graphOps.query(nameOrAlias);
+    }
+    findGaps(contentFiles) {
+        if (!this.graphOps)
+            return [];
+        return this.graphOps.findGaps(contentFiles);
+    }
+    findStale(contentFiles, knowledgeTimestamps) {
+        if (!this.graphOps)
+            return [];
+        return this.graphOps.findStale(contentFiles, knowledgeTimestamps);
+    }
+    getGraph() {
+        return this.currentGraph;
+    }
+    getStore() {
+        return this.store;
+    }
+    /**
+     * Import a single URL: scrape → classify → extract entities → store.
+     */
+    async importUrl(url) {
+        const scraped = await this.scraper.scrape(url);
+        const path = this.urlToPath(url);
+        return this.ingest(path, scraped.markdown, "url", url);
+    }
+    /**
+     * Parse a sitemap and return grouped sections for interactive selection.
+     */
+    async parseSitemap(sitemapUrl) {
+        return this.sitemapParser.parse(sitemapUrl);
+    }
+    /**
+     * Filter a parsed sitemap result by include/exclude patterns.
+     */
+    filterSitemapUrls(result, options) {
+        return this.sitemapParser.filterUrls(result, options);
+    }
+    /**
+     * Import a batch of URLs. Calls progressCallback for each completed URL.
+     */
+    async importBatch(urls, progressCallback) {
+        const progress = {
+            completed: 0,
+            total: urls.length,
+            failed: 0,
+            results: [],
+        };
+        for (const url of urls) {
+            try {
+                const file = await this.importUrl(url);
+                progress.completed++;
+                progress.results.push({ url, path: file.path, success: true });
+            }
+            catch (error) {
+                progress.failed++;
+                progress.completed++;
+                progress.results.push({
+                    url,
+                    path: "",
+                    success: false,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+            progressCallback?.(progress.completed, progress.total, progress.failed);
+        }
+        return progress;
+    }
+    /**
+     * Convert a URL to a knowledge file path.
+     * https://example.com/blog/post-1 → knowledge/example.com/blog/post-1.md
+     */
+    urlToPath(url) {
+        const parsed = new URL(url);
+        const pathname = parsed.pathname.replace(/\/$/, "") || "/index";
+        const clean = pathname.replace(/\.[^.]+$/, ""); // Remove file extensions
+        return `knowledge/${parsed.hostname}${clean}.md`;
+    }
+    getExistingEntities() {
+        if (!this.currentGraph)
+            return [];
+        return Array.from(this.currentGraph.entities.values()).map((e) => ({
+            type: e.type,
+            name: e.name,
+        }));
+    }
+}
+//# sourceMappingURL=knowledge-engine.js.map

package/dist/knowledge-engine.js.map

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

package/dist/knowledge-store.d.ts

@@ -0,0 +1,14 @@
+import type { KnowledgeFile } from "@sourcepress/core";
+import type { KnowledgeFileFilter, KnowledgeGraph, KnowledgeStoreBackend } from "./types.js";
+export declare class InMemoryKnowledgeStore implements KnowledgeStoreBackend {
+    private files;
+    private graph;
+    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>;
+}
+//# sourceMappingURL=knowledge-store.d.ts.map

package/dist/knowledge-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-store.d.ts","sourceRoot":"","sources":["../src/knowledge-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAE7F,qBAAa,sBAAuB,YAAW,qBAAqB;IACnE,OAAO,CAAC,KAAK,CAAyC;IACtD,OAAO,CAAC,KAAK,CAA+B;IAEtC,KAAK,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAIrD,IAAI,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAkB5D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAItC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAIxB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,SAAS,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;CAGjD"}

package/dist/knowledge-store.js

@@ -0,0 +1,40 @@
+export class InMemoryKnowledgeStore {
+    files = new Map();
+    graph = null;
+    async store(file) {
+        this.files.set(file.path, { ...file });
+    }
+    async retrieve(path) {
+        return this.files.get(path) ?? null;
+    }
+    async list(filter) {
+        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) {
+        return this.files.delete(path);
+    }
+    async count() {
+        return this.files.size;
+    }
+    async saveGraph(graph) {
+        this.graph = graph;
+    }
+    async loadGraph() {
+        return this.graph;
+    }
+}
+//# sourceMappingURL=knowledge-store.js.map

package/dist/knowledge-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-store.js","sourceRoot":"","sources":["../src/knowledge-store.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,sBAAsB;IAC1B,KAAK,GAA+B,IAAI,GAAG,EAAE,CAAC;IAC9C,KAAK,GAA0B,IAAI,CAAC;IAE5C,KAAK,CAAC,KAAK,CAAC,IAAmB;QAC9B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAY;QAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAA4B;QACtC,IAAI,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9C,IAAI,MAAM,EAAE,IAAI,EAAE,CAAC;YAClB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACrB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,MAAM,EAAE,MAAM,EAAE,CAAC;YACpB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC;QAC7D,CAAC;QACD,IAAI,MAAM,EAAE,KAAK,EAAE,CAAC;YACnB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;YAC3B,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,IAAI,KAAK,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,OAAO,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAY;QACxB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,KAAK;QACV,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAAqB;QACpC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,SAAS;QACd,OAAO,IAAI,CAAC,KAAK,CAAC;IACnB,CAAC;CACD"}

package/dist/types.d.ts

@@ -0,0 +1,67 @@
+import type { Entity, 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;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAa,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAE1E,MAAM,WAAW,gBAAgB;IAChC,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,SAAS,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,eAAgB,SAAQ,MAAM;IAC9C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC9B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACvC,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAChC,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC,KAAK,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACrC,KAAK,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IACtD,IAAI,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAC7D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACzB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,SAAS,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,mBAAmB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/types.js

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

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,26 @@
+{
+	"name": "@sourcepress/knowledge",
+	"version": "0.1.0",
+	"publishConfig": { "access": "public" },
+	"type": "module",
+	"exports": {
+		".": { "types": "./dist/index.d.ts", "import": "./dist/index.js" }
+	},
+	"scripts": {
+		"build": "tsc",
+		"test": "vitest run",
+		"typecheck": "tsc --noEmit",
+		"clean": "rm -rf dist"
+	},
+	"dependencies": {
+		"@sourcepress/core": "workspace:*",
+		"@sourcepress/ai": "workspace:*",
+		"linkedom": "^0.18.0",
+		"@mozilla/readability": "^0.5.0"
+	},
+	"devDependencies": {
+		"typescript": "^5.7.0",
+		"vitest": "^3.0.0",
+		"@types/mozilla__readability": "^0.4.0"
+	}
+}