@knowledgine/core 0.0.1 → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (79) hide show
  1. package/dist/config.d.ts +16 -0
  2. package/dist/config.d.ts.map +1 -1
  3. package/dist/config.js +17 -0
  4. package/dist/config.js.map +1 -1
  5. package/dist/embedding/embedding-provider.d.ts +9 -0
  6. package/dist/embedding/embedding-provider.d.ts.map +1 -0
  7. package/dist/embedding/embedding-provider.js +2 -0
  8. package/dist/embedding/embedding-provider.js.map +1 -0
  9. package/dist/embedding/model-manager.d.ts +10 -0
  10. package/dist/embedding/model-manager.d.ts.map +1 -0
  11. package/dist/embedding/model-manager.js +32 -0
  12. package/dist/embedding/model-manager.js.map +1 -0
  13. package/dist/embedding/onnx-embedding-provider.d.ts +18 -0
  14. package/dist/embedding/onnx-embedding-provider.d.ts.map +1 -0
  15. package/dist/embedding/onnx-embedding-provider.js +121 -0
  16. package/dist/embedding/onnx-embedding-provider.js.map +1 -0
  17. package/dist/embedding/tokenizer.d.ts +19 -0
  18. package/dist/embedding/tokenizer.d.ts.map +1 -0
  19. package/dist/embedding/tokenizer.js +80 -0
  20. package/dist/embedding/tokenizer.js.map +1 -0
  21. package/dist/errors.d.ts +12 -0
  22. package/dist/errors.d.ts.map +1 -1
  23. package/dist/errors.js +21 -0
  24. package/dist/errors.js.map +1 -1
  25. package/dist/graph/entity-extractor.d.ts +22 -0
  26. package/dist/graph/entity-extractor.d.ts.map +1 -0
  27. package/dist/graph/entity-extractor.js +203 -0
  28. package/dist/graph/entity-extractor.js.map +1 -0
  29. package/dist/graph/graph-repository.d.ts +63 -0
  30. package/dist/graph/graph-repository.d.ts.map +1 -0
  31. package/dist/graph/graph-repository.js +407 -0
  32. package/dist/graph/graph-repository.js.map +1 -0
  33. package/dist/graph/index.d.ts +4 -0
  34. package/dist/graph/index.d.ts.map +1 -0
  35. package/dist/graph/index.js +4 -0
  36. package/dist/graph/index.js.map +1 -0
  37. package/dist/graph/relation-inferrer.d.ts +23 -0
  38. package/dist/graph/relation-inferrer.d.ts.map +1 -0
  39. package/dist/graph/relation-inferrer.js +89 -0
  40. package/dist/graph/relation-inferrer.js.map +1 -0
  41. package/dist/index.d.ts +14 -2
  42. package/dist/index.d.ts.map +1 -1
  43. package/dist/index.js +15 -2
  44. package/dist/index.js.map +1 -1
  45. package/dist/search/hybrid-searcher.d.ts +14 -0
  46. package/dist/search/hybrid-searcher.d.ts.map +1 -0
  47. package/dist/search/hybrid-searcher.js +67 -0
  48. package/dist/search/hybrid-searcher.js.map +1 -0
  49. package/dist/search/knowledge-searcher.d.ts +8 -4
  50. package/dist/search/knowledge-searcher.d.ts.map +1 -1
  51. package/dist/search/knowledge-searcher.js +39 -15
  52. package/dist/search/knowledge-searcher.js.map +1 -1
  53. package/dist/search/link-generator.d.ts +7 -1
  54. package/dist/search/link-generator.d.ts.map +1 -1
  55. package/dist/search/link-generator.js +37 -1
  56. package/dist/search/link-generator.js.map +1 -1
  57. package/dist/search/semantic-searcher.d.ts +14 -0
  58. package/dist/search/semantic-searcher.d.ts.map +1 -0
  59. package/dist/search/semantic-searcher.js +30 -0
  60. package/dist/search/semantic-searcher.js.map +1 -0
  61. package/dist/storage/database.d.ts +4 -1
  62. package/dist/storage/database.d.ts.map +1 -1
  63. package/dist/storage/database.js +13 -1
  64. package/dist/storage/database.js.map +1 -1
  65. package/dist/storage/knowledge-repository.d.ts +27 -0
  66. package/dist/storage/knowledge-repository.d.ts.map +1 -1
  67. package/dist/storage/knowledge-repository.js +99 -0
  68. package/dist/storage/knowledge-repository.js.map +1 -1
  69. package/dist/storage/migrations/003_vector_embeddings.d.ts +3 -0
  70. package/dist/storage/migrations/003_vector_embeddings.d.ts.map +1 -0
  71. package/dist/storage/migrations/003_vector_embeddings.js +50 -0
  72. package/dist/storage/migrations/003_vector_embeddings.js.map +1 -0
  73. package/dist/storage/migrations/004_knowledge_graph.d.ts +3 -0
  74. package/dist/storage/migrations/004_knowledge_graph.d.ts.map +1 -0
  75. package/dist/storage/migrations/004_knowledge_graph.js +106 -0
  76. package/dist/storage/migrations/004_knowledge_graph.js.map +1 -0
  77. package/dist/types.d.ts +14 -0
  78. package/dist/types.d.ts.map +1 -1
  79. package/package.json +10 -3
@@ -0,0 +1,203 @@
1
+ /**
2
+ * useState, useEffect などのReact hooks・ノイズキーワードのストップリスト
3
+ */
4
+ const STOP_LIST = new Set([
5
+ "usestate",
6
+ "useeffect",
7
+ "usecontext",
8
+ "usereducer",
9
+ "usecallback",
10
+ "usememo",
11
+ "useref",
12
+ "console",
13
+ "process",
14
+ "module",
15
+ "exports",
16
+ "require",
17
+ "import",
18
+ "export",
19
+ "default",
20
+ "const",
21
+ "let",
22
+ "var",
23
+ "function",
24
+ "class",
25
+ "return",
26
+ "null",
27
+ "undefined",
28
+ "true",
29
+ "false",
30
+ "this",
31
+ "new",
32
+ "typeof",
33
+ "instanceof",
34
+ "string",
35
+ "number",
36
+ "boolean",
37
+ "object",
38
+ "array",
39
+ "any",
40
+ "void",
41
+ "never",
42
+ "unknown",
43
+ "error",
44
+ "promise",
45
+ "async",
46
+ "await",
47
+ "then",
48
+ "catch",
49
+ "finally",
50
+ "try",
51
+ ]);
52
+ /**
53
+ * ノートテキストからエンティティを抽出する。
54
+ */
55
+ export class EntityExtractor {
56
+ extract(content, frontmatter = {}) {
57
+ const results = [];
58
+ results.push(...this.extractFromFrontmatterTags(frontmatter));
59
+ results.push(...this.extractFromFrontmatterFields(frontmatter));
60
+ results.push(...this.extractImports(content));
61
+ results.push(...this.extractMarkdownLinks(content));
62
+ results.push(...this.extractInlineCode(content));
63
+ results.push(...this.extractMentions(content));
64
+ results.push(...this.extractOrgRepos(content));
65
+ return this.deduplicate(results);
66
+ }
67
+ extractFromFrontmatterTags(frontmatter) {
68
+ const results = [];
69
+ const tags = frontmatter["tags"];
70
+ if (!Array.isArray(tags))
71
+ return results;
72
+ for (const tag of tags) {
73
+ if (typeof tag !== "string" || tag.trim() === "")
74
+ continue;
75
+ const name = tag.trim().toLowerCase();
76
+ if (this.isStopWord(name))
77
+ continue;
78
+ results.push({ name, entityType: "technology", sourceType: "tag" });
79
+ }
80
+ return results;
81
+ }
82
+ extractFromFrontmatterFields(frontmatter) {
83
+ const results = [];
84
+ // author/reviewer → person
85
+ for (const field of ["author", "reviewer", "assignee"]) {
86
+ const val = frontmatter[field];
87
+ if (typeof val === "string" && val.trim()) {
88
+ results.push({
89
+ name: val.trim().toLowerCase(),
90
+ entityType: "person",
91
+ sourceType: "frontmatter",
92
+ });
93
+ }
94
+ else if (Array.isArray(val)) {
95
+ for (const v of val) {
96
+ if (typeof v === "string" && v.trim()) {
97
+ results.push({
98
+ name: v.trim().toLowerCase(),
99
+ entityType: "person",
100
+ sourceType: "frontmatter",
101
+ });
102
+ }
103
+ }
104
+ }
105
+ }
106
+ // project → project
107
+ const project = frontmatter["project"];
108
+ if (typeof project === "string" && project.trim()) {
109
+ results.push({
110
+ name: project.trim().toLowerCase(),
111
+ entityType: "project",
112
+ sourceType: "frontmatter",
113
+ });
114
+ }
115
+ return results;
116
+ }
117
+ extractImports(content) {
118
+ const results = [];
119
+ // import X from 'package' / import { X } from 'package' / require('package')
120
+ const importRe = /(?:import\s+(?:.*?\s+from\s+)?|require\s*\(\s*)['"]([^'"./][^'"]*)['"]/g;
121
+ let m;
122
+ while ((m = importRe.exec(content)) !== null) {
123
+ const pkg = m[1].split("/")[0]; // @scope/pkg → @scope/pkg, lodash/fp → lodash
124
+ if (!pkg || this.isStopWord(pkg))
125
+ continue;
126
+ // Exclude destructured (e.g., import { useState } from 'react' → react is fine, but not useState)
127
+ results.push({ name: pkg.toLowerCase(), entityType: "technology", sourceType: "import" });
128
+ }
129
+ return results;
130
+ }
131
+ extractMarkdownLinks(content) {
132
+ const results = [];
133
+ // [text](url) — internal links might be entities
134
+ const linkRe = /\[([^\]]+)\]\(([^)]+)\)/g;
135
+ let m;
136
+ while ((m = linkRe.exec(content)) !== null) {
137
+ const text = m[1].trim();
138
+ const url = m[2].trim();
139
+ // Only external URLs or paths with meaningful names
140
+ if (url.startsWith("http") && text && !this.isStopWord(text.toLowerCase())) {
141
+ // Skip very long link texts (likely sentences)
142
+ if (text.length <= 40 && !text.includes(" ")) {
143
+ results.push({ name: text.toLowerCase(), entityType: "technology", sourceType: "link" });
144
+ }
145
+ }
146
+ }
147
+ return results;
148
+ }
149
+ extractInlineCode(content) {
150
+ const results = [];
151
+ // `package-name` or `ClassName` patterns
152
+ const codeRe = /`([^`\s]{2,30})`/g;
153
+ let m;
154
+ while ((m = codeRe.exec(content)) !== null) {
155
+ const code = m[1].trim();
156
+ // Only include package-like names (kebab-case or single words)
157
+ if (/^[@a-z][\w/-]*$/.test(code) && !this.isStopWord(code.toLowerCase())) {
158
+ results.push({ name: code.toLowerCase(), entityType: "tool", sourceType: "code" });
159
+ }
160
+ }
161
+ return results;
162
+ }
163
+ extractMentions(content) {
164
+ const results = [];
165
+ // @username patterns
166
+ const mentionRe = /@([\w-]{2,30})/g;
167
+ let m;
168
+ while ((m = mentionRe.exec(content)) !== null) {
169
+ const username = m[1].trim().toLowerCase();
170
+ if (!this.isStopWord(username)) {
171
+ results.push({ name: username, entityType: "person", sourceType: "mention" });
172
+ }
173
+ }
174
+ return results;
175
+ }
176
+ extractOrgRepos(content) {
177
+ const results = [];
178
+ // org/repo patterns (e.g., facebook/react, microsoft/typescript)
179
+ const orgRepoRe = /\b([a-z][\w-]{1,30})\/([a-z][\w-]{1,30})\b/g;
180
+ let m;
181
+ while ((m = orgRepoRe.exec(content)) !== null) {
182
+ const fullName = `${m[1]}/${m[2]}`.toLowerCase();
183
+ if (!this.isStopWord(m[1]) && !this.isStopWord(m[2])) {
184
+ results.push({ name: fullName, entityType: "project", sourceType: "frontmatter" });
185
+ }
186
+ }
187
+ return results;
188
+ }
189
+ isStopWord(word) {
190
+ return STOP_LIST.has(word.toLowerCase());
191
+ }
192
+ deduplicate(entities) {
193
+ const seen = new Map();
194
+ for (const e of entities) {
195
+ const key = `${e.entityType}:${e.name}`;
196
+ if (!seen.has(key)) {
197
+ seen.set(key, e);
198
+ }
199
+ }
200
+ return Array.from(seen.values());
201
+ }
202
+ }
203
+ //# sourceMappingURL=entity-extractor.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"entity-extractor.js","sourceRoot":"","sources":["../../src/graph/entity-extractor.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC;IACxB,UAAU;IACV,WAAW;IACX,YAAY;IACZ,YAAY;IACZ,aAAa;IACb,SAAS;IACT,QAAQ;IACR,SAAS;IACT,SAAS;IACT,QAAQ;IACR,SAAS;IACT,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,OAAO;IACP,KAAK;IACL,KAAK;IACL,UAAU;IACV,OAAO;IACP,QAAQ;IACR,MAAM;IACN,WAAW;IACX,MAAM;IACN,OAAO;IACP,MAAM;IACN,KAAK;IACL,QAAQ;IACR,YAAY;IACZ,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,OAAO;IACP,KAAK;IACL,MAAM;IACN,OAAO;IACP,SAAS;IACT,OAAO;IACP,SAAS;IACT,OAAO;IACP,OAAO;IACP,MAAM;IACN,OAAO;IACP,SAAS;IACT,KAAK;CACN,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,OAAO,eAAe;IAC1B,OAAO,CAAC,OAAe,EAAE,cAAuC,EAAE;QAChE,MAAM,OAAO,GAAsB,EAAE,CAAC;QAEtC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,0BAA0B,CAAC,WAAW,CAAC,CAAC,CAAC;QAC9D,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,4BAA4B,CAAC,WAAW,CAAC,CAAC,CAAC;QAChE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;QAC9C,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC;QACpD,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;QACjD,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;QAC/C,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;QAE/C,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAEO,0BAA0B,CAAC,WAAoC;QACrE,MAAM,OAAO,GAAsB,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;QACjC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;YAAE,OAAO,OAAO,CAAC;QAEzC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE;gBAAE,SAAS;YAC3D,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YACtC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;gBAAE,SAAS;YACpC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QACtE,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,4BAA4B,CAAC,WAAoC;QACvE,MAAM,OAAO,GAAsB,EAAE,CAAC;QAEtC,2BAA2B;QAC3B,KAAK,MAAM,KAAK,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE,CAAC;YACvD,MAAM,GAAG,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;YAC/B,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC1C,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE;oBAC9B,UAAU,EAAE,QAAQ;oBACpB,UAAU,EAAE,aAAa;iBAC1B,CAAC,CAAC;YACL,CAAC;iBAAM,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC9B,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;oBACpB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;wBACtC,OAAO,CAAC,IAAI,CAAC;4BACX,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE;4BAC5B,UAAU,EAAE,QAAQ;4BACpB,UAAU,EAAE,aAAa;yBAC1B,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,oBAAoB;QACpB,MAAM,OAAO,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;QACvC,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YAClD,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE;gBAClC,UAAU,EAAE,SAAS;gBACrB,UAAU,EAAE,aAAa;aAC1B,CAAC,CAAC;QACL,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,cAAc,CAAC,OAAe;QACpC,MAAM,OAAO,GAAsB,EAAE,CAAC;QACtC,6EAA6E;QAC7E,MAAM,QAAQ,GAAG,yEAAyE,CAAC;QAC3F,IAAI,CAAyB,CAAC;QAC9B,OAAO,CAAC,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC7C,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,8CAA8C;YAC9E,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,SAAS;YAC3C,kGAAkG;YAClG,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,WAAW,EAAE,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC5F,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,oBAAoB,CAAC,OAAe;QAC1C,MAAM,OAAO,GAAsB,EAAE,CAAC;QACtC,iDAAiD;QACjD,MAAM,MAAM,GAAG,0BAA0B,CAAC;QAC1C,IAAI,CAAyB,CAAC;QAC9B,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC3C,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACxB,oDAAoD;YACpD,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;gBAC3E,+CAA+C;gBAC/C,IAAI,IAAI,CAAC,MAAM,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC7C,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;gBAC3F,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,iBAAiB,CAAC,OAAe;QACvC,MAAM,OAAO,GAAsB,EAAE,CAAC;QACtC,yCAAyC;QACzC,MAAM,MAAM,GAAG,mBAAmB,CAAC;QACnC,IAAI,CAAyB,CAAC;QAC9B,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC3C,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACzB,+DAA+D;YAC/D,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;gBACzE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;YACrF,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,eAAe,CAAC,OAAe;QACrC,MAAM,OAAO,GAAsB,EAAE,CAAC;QACtC,qBAAqB;QACrB,MAAM,SAAS,GAAG,iBAAiB,CAAC;QACpC,IAAI,CAAyB,CAAC;QAC9B,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC9C,MAAM,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC3C,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC/B,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;YAChF,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,eAAe,CAAC,OAAe;QACrC,MAAM,OAAO,GAAsB,EAAE,CAAC;QACtC,iEAAiE;QACjE,MAAM,SAAS,GAAG,6CAA6C,CAAC;QAChE,IAAI,CAAyB,CAAC;QAC9B,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC9C,MAAM,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC;YACjD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACrD,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC,CAAC;YACrF,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,UAAU,CAAC,IAAY;QAC7B,OAAO,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAC3C,CAAC;IAEO,WAAW,CAAC,QAA2B;QAC7C,MAAM,IAAI,GAAG,IAAI,GAAG,EAA2B,CAAC;QAChD,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YACxC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACnB,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACnC,CAAC;CACF"}
@@ -0,0 +1,63 @@
1
+ import type Database from "better-sqlite3";
2
+ import type { Entity, Relation, Observation, EntityType, EntityWithGraph } from "../types.js";
3
+ export declare class GraphRepository {
4
+ private db;
5
+ constructor(db: Database.Database);
6
+ createEntity(entity: Omit<Entity, "id">): number;
7
+ /**
8
+ * 名前を小文字正規化してupsert。同名・同タイプのエンティティは更新する。
9
+ */
10
+ upsertEntity(entity: Omit<Entity, "id">): number;
11
+ getEntityById(id: number): (Entity & {
12
+ id: number;
13
+ }) | undefined;
14
+ getEntityByName(name: string, entityType?: EntityType): (Entity & {
15
+ id: number;
16
+ }) | undefined;
17
+ /**
18
+ * FTS5 trigram検索。3文字未満はLIKEフォールバック。
19
+ */
20
+ searchEntities(query: string, limit?: number): Array<Entity & {
21
+ id: number;
22
+ }>;
23
+ deleteEntity(id: number): boolean;
24
+ createRelation(relation: Omit<Relation, "id">): number;
25
+ /**
26
+ * 同一 (from, to, type) のrelationが存在する場合はstrengthをMAXで更新。
27
+ */
28
+ upsertRelation(relation: Omit<Relation, "id">): number;
29
+ getRelationsByEntityId(entityId: number): Array<Relation & {
30
+ id: number;
31
+ }>;
32
+ deleteRelation(id: number): boolean;
33
+ createObservation(observation: Omit<Observation, "id">): number;
34
+ getObservationsByEntityId(entityId: number): Array<Observation & {
35
+ id: number;
36
+ }>;
37
+ deleteObservation(id: number): boolean;
38
+ linkEntityToNote(entityId: number, noteId: number): void;
39
+ getLinkedNotes(entityId: number): Array<{
40
+ entityId: number;
41
+ noteId: number;
42
+ }>;
43
+ getLinkedEntities(noteId: number): Array<Entity & {
44
+ id: number;
45
+ }>;
46
+ getEntityWithGraph(entityId: number): EntityWithGraph | undefined;
47
+ /**
48
+ * 幅優先探索でhops内の関連エンティティを取得。
49
+ * 循環グラフ対策: visitedセットで重複訪問を防ぐ。maxHops上限は3。
50
+ */
51
+ findRelatedEntities(entityId: number, maxHops?: number): Array<Entity & {
52
+ id: number;
53
+ hops: number;
54
+ }>;
55
+ getGraphStats(): {
56
+ totalEntities: number;
57
+ totalRelations: number;
58
+ totalObservations: number;
59
+ entitiesByType: Record<string, number>;
60
+ relationsByType: Record<string, number>;
61
+ };
62
+ }
63
+ //# sourceMappingURL=graph-repository.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"graph-repository.d.ts","sourceRoot":"","sources":["../../src/graph/graph-repository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EACV,MAAM,EACN,QAAQ,EACR,WAAW,EACX,UAAU,EAGV,eAAe,EAChB,MAAM,aAAa,CAAC;AA6ErB,qBAAa,eAAe;IACd,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAIzC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,MAAM;IAyBhD;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,MAAM;IA+BhD,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,CAAC,MAAM,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,SAAS;IAOhE,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,CAAC,MAAM,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,SAAS;IAc7F;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,KAAK,CAAC,MAAM,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IA8BzE,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAWjC,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,MAAM;IAwBtD;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,MAAM;IAuCtD,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,CAAC,QAAQ,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAS1E,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAWnC,iBAAiB,CAAC,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,GAAG,MAAM;IAwB/D,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,CAAC,WAAW,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAOhF,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAWtC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAUxD,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAO7E,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAejE,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAkHjE;;;OAGG;IACH,mBAAmB,CACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,MAAU,GAClB,KAAK,CAAC,MAAM,GAAG;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IA0C/C,aAAa,IAAI;QACf,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;QACvB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACvC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACzC;CA6BF"}