@knowledgine/core 0.0.1 → 0.2.0

package/dist/graph/entity-extractor.js

@@ -0,0 +1,237 @@
+/**
+ * useState, useEffect などのReact hooks・ノイズキーワードのストップリスト
+ */
+const STOP_LIST = new Set([
+    "usestate",
+    "useeffect",
+    "usecontext",
+    "usereducer",
+    "usecallback",
+    "usememo",
+    "useref",
+    "console",
+    "process",
+    "module",
+    "exports",
+    "require",
+    "import",
+    "export",
+    "default",
+    "const",
+    "let",
+    "var",
+    "function",
+    "class",
+    "return",
+    "null",
+    "undefined",
+    "true",
+    "false",
+    "this",
+    "new",
+    "typeof",
+    "instanceof",
+    "string",
+    "number",
+    "boolean",
+    "object",
+    "array",
+    "any",
+    "void",
+    "never",
+    "unknown",
+    "error",
+    "promise",
+    "async",
+    "await",
+    "then",
+    "catch",
+    "finally",
+    "try",
+]);
+/**
+ * Extracts entities from note text, with optional post-processing via ExtractionRules.
+ */
+export class EntityExtractor {
+    rules;
+    constructor(rules) {
+        this.rules = rules;
+    }
+    extract(content, frontmatter = {}) {
+        const results = [];
+        results.push(...this.extractFromFrontmatterTags(frontmatter));
+        results.push(...this.extractFromFrontmatterFields(frontmatter));
+        results.push(...this.extractImports(content));
+        results.push(...this.extractMarkdownLinks(content));
+        results.push(...this.extractInlineCode(content));
+        results.push(...this.extractMentions(content));
+        results.push(...this.extractOrgRepos(content));
+        let deduped = this.deduplicate(results);
+        if (this.rules) {
+            deduped = this.applyRules(deduped);
+        }
+        return deduped;
+    }
+    applyRules(entities) {
+        const rules = this.rules;
+        // 1. Filter out blacklisted entities
+        let filtered = entities.filter((e) => !rules.entityBlacklist.includes(e.name));
+        // 2. Apply type overrides
+        filtered = filtered.map((e) => {
+            const override = rules.typeOverrides.find((o) => o.name === e.name && o.fromType === e.entityType);
+            if (override) {
+                return { ...e, entityType: override.toType };
+            }
+            return e;
+        });
+        // 3. Add whitelisted entities (if not already present)
+        for (const wl of rules.entityWhitelist) {
+            const key = `${wl.type}:${wl.name}`;
+            const exists = filtered.some((e) => `${e.entityType}:${e.name}` === key);
+            if (!exists) {
+                filtered.push({
+                    name: wl.name,
+                    entityType: wl.type,
+                    sourceType: "whitelist",
+                });
+            }
+        }
+        return filtered;
+    }
+    extractFromFrontmatterTags(frontmatter) {
+        const results = [];
+        const tags = frontmatter["tags"];
+        if (!Array.isArray(tags))
+            return results;
+        for (const tag of tags) {
+            if (typeof tag !== "string" || tag.trim() === "")
+                continue;
+            const name = tag.trim().toLowerCase();
+            if (this.isStopWord(name))
+                continue;
+            results.push({ name, entityType: "technology", sourceType: "tag" });
+        }
+        return results;
+    }
+    extractFromFrontmatterFields(frontmatter) {
+        const results = [];
+        // author/reviewer → person
+        for (const field of ["author", "reviewer", "assignee"]) {
+            const val = frontmatter[field];
+            if (typeof val === "string" && val.trim()) {
+                results.push({
+                    name: val.trim().toLowerCase(),
+                    entityType: "person",
+                    sourceType: "frontmatter",
+                });
+            }
+            else if (Array.isArray(val)) {
+                for (const v of val) {
+                    if (typeof v === "string" && v.trim()) {
+                        results.push({
+                            name: v.trim().toLowerCase(),
+                            entityType: "person",
+                            sourceType: "frontmatter",
+                        });
+                    }
+                }
+            }
+        }
+        // project → project
+        const project = frontmatter["project"];
+        if (typeof project === "string" && project.trim()) {
+            results.push({
+                name: project.trim().toLowerCase(),
+                entityType: "project",
+                sourceType: "frontmatter",
+            });
+        }
+        return results;
+    }
+    extractImports(content) {
+        const results = [];
+        // import X from 'package' / import { X } from 'package' / require('package')
+        const importRe = /(?:import\s+(?:.*?\s+from\s+)?|require\s*\(\s*)['"]([^'"./][^'"]*)['"]/g;
+        let m;
+        while ((m = importRe.exec(content)) !== null) {
+            const pkg = m[1].split("/")[0]; // @scope/pkg → @scope/pkg, lodash/fp → lodash
+            if (!pkg || this.isStopWord(pkg))
+                continue;
+            // Exclude destructured (e.g., import { useState } from 'react' → react is fine, but not useState)
+            results.push({ name: pkg.toLowerCase(), entityType: "technology", sourceType: "import" });
+        }
+        return results;
+    }
+    extractMarkdownLinks(content) {
+        const results = [];
+        // [text](url) — internal links might be entities
+        const linkRe = /\[([^\]]+)\]\(([^)]+)\)/g;
+        let m;
+        while ((m = linkRe.exec(content)) !== null) {
+            const text = m[1].trim();
+            const url = m[2].trim();
+            // Only external URLs or paths with meaningful names
+            if (url.startsWith("http") && text && !this.isStopWord(text.toLowerCase())) {
+                // Skip very long link texts (likely sentences)
+                if (text.length <= 40 && !text.includes(" ")) {
+                    results.push({ name: text.toLowerCase(), entityType: "technology", sourceType: "link" });
+                }
+            }
+        }
+        return results;
+    }
+    extractInlineCode(content) {
+        const results = [];
+        // `package-name` or `ClassName` patterns
+        const codeRe = /`([^`\s]{2,30})`/g;
+        let m;
+        while ((m = codeRe.exec(content)) !== null) {
+            const code = m[1].trim();
+            // Only include package-like names (kebab-case or single words)
+            if (/^[@a-z][\w/-]*$/.test(code) && !this.isStopWord(code.toLowerCase())) {
+                results.push({ name: code.toLowerCase(), entityType: "tool", sourceType: "code" });
+            }
+        }
+        return results;
+    }
+    extractMentions(content) {
+        const results = [];
+        // @username patterns
+        const mentionRe = /@([\w-]{2,30})/g;
+        let m;
+        while ((m = mentionRe.exec(content)) !== null) {
+            const username = m[1].trim().toLowerCase();
+            if (!this.isStopWord(username)) {
+                results.push({ name: username, entityType: "person", sourceType: "mention" });
+            }
+        }
+        return results;
+    }
+    extractOrgRepos(content) {
+        const results = [];
+        // org/repo patterns (e.g., facebook/react, microsoft/typescript)
+        const orgRepoRe = /\b([a-z][\w-]{1,30})\/([a-z][\w-]{1,30})\b/g;
+        let m;
+        while ((m = orgRepoRe.exec(content)) !== null) {
+            const fullName = `${m[1]}/${m[2]}`.toLowerCase();
+            if (!this.isStopWord(m[1]) && !this.isStopWord(m[2])) {
+                results.push({ name: fullName, entityType: "project", sourceType: "frontmatter" });
+            }
+        }
+        return results;
+    }
+    isStopWord(word) {
+        return STOP_LIST.has(word.toLowerCase());
+    }
+    deduplicate(entities) {
+        const seen = new Map();
+        for (const e of entities) {
+            const key = `${e.entityType}:${e.name}`;
+            if (!seen.has(key)) {
+                seen.set(key, e);
+            }
+        }
+        return Array.from(seen.values());
+    }
+}
+//# sourceMappingURL=entity-extractor.js.map

package/dist/graph/entity-extractor.js.map

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

package/dist/graph/graph-repository.d.ts

@@ -0,0 +1,72 @@
+import type Database from "better-sqlite3";
+import type { Entity, Relation, Observation, EntityType, EntityWithGraph } from "../types.js";
+export declare class GraphRepository {
+    private db;
+    constructor(db: Database.Database);
+    createEntity(entity: Omit<Entity, "id">): number;
+    /**
+     * 名前を小文字正規化してupsert。同名・同タイプのエンティティは更新する。
+     */
+    upsertEntity(entity: Omit<Entity, "id">): number;
+    getEntityById(id: number): (Entity & {
+        id: number;
+    }) | undefined;
+    getEntityByName(name: string, entityType?: EntityType): (Entity & {
+        id: number;
+    }) | undefined;
+    /**
+     * FTS5 trigram検索。3文字未満はLIKEフォールバック。
+     */
+    searchEntities(query: string, limit?: number): Array<Entity & {
+        id: number;
+    }>;
+    deleteEntity(id: number): boolean;
+    createRelation(relation: Omit<Relation, "id">): number;
+    /**
+     * 同一 (from, to, type) のrelationが存在する場合はstrengthをMAXで更新。
+     */
+    upsertRelation(relation: Omit<Relation, "id">): number;
+    getRelationsByEntityId(entityId: number): Array<Relation & {
+        id: number;
+    }>;
+    deleteRelation(id: number): boolean;
+    createObservation(observation: Omit<Observation, "id">): number;
+    getObservationsByEntityId(entityId: number): Array<Observation & {
+        id: number;
+    }>;
+    deleteObservation(id: number): boolean;
+    linkEntityToNote(entityId: number, noteId: number): void;
+    getLinkedNotes(entityId: number): Array<{
+        entityId: number;
+        noteId: number;
+    }>;
+    getLinkedEntities(noteId: number): Array<Entity & {
+        id: number;
+    }>;
+    getEntityWithGraph(entityId: number): EntityWithGraph | undefined;
+    /**
+     * 幅優先探索でhops内の関連エンティティを取得。
+     * 循環グラフ対策: visitedセットで重複訪問を防ぐ。maxHops上限は3。
+     */
+    findRelatedEntities(entityId: number, maxHops?: number): Array<Entity & {
+        id: number;
+        hops: number;
+    }>;
+    getGraphStats(): {
+        totalEntities: number;
+        totalRelations: number;
+        totalObservations: number;
+        entitiesByType: Record<string, number>;
+        relationsByType: Record<string, number>;
+    };
+    invalidateRelation(id: number, validTo?: string): boolean;
+    invalidateObservation(id: number, validTo?: string): boolean;
+    getRelationHistory(fromEntityId: number, toEntityId: number): Array<Relation & {
+        id: number;
+        validFrom: string | null;
+        validTo: string | null;
+        recordedAt: string | null;
+        supersededAt: string | null;
+    }>;
+}
+//# sourceMappingURL=graph-repository.d.ts.map

package/dist/graph/graph-repository.d.ts.map

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