agent-knowledge 1.9.8 → 3.0.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 (179) hide show
  1. package/CHANGELOG.md +82 -0
  2. package/README.md +53 -52
  3. package/dist/events.d.ts +16 -0
  4. package/dist/events.d.ts.map +1 -0
  5. package/dist/events.js +31 -0
  6. package/dist/events.js.map +1 -0
  7. package/dist/index.js +31 -13
  8. package/dist/index.js.map +1 -1
  9. package/dist/knowledge/analyze.d.ts.map +1 -1
  10. package/dist/knowledge/analyze.js +18 -11
  11. package/dist/knowledge/analyze.js.map +1 -1
  12. package/dist/knowledge/consolidate.d.ts +2 -2
  13. package/dist/knowledge/consolidate.js +2 -2
  14. package/dist/knowledge/distill.d.ts.map +1 -1
  15. package/dist/knowledge/distill.js +28 -16
  16. package/dist/knowledge/distill.js.map +1 -1
  17. package/dist/knowledge/freshness.js +1 -1
  18. package/dist/knowledge/freshness.js.map +1 -1
  19. package/dist/knowledge/git.d.ts +3 -4
  20. package/dist/knowledge/git.d.ts.map +1 -1
  21. package/dist/knowledge/git.js +62 -49
  22. package/dist/knowledge/git.js.map +1 -1
  23. package/dist/knowledge/graph.d.ts +2 -0
  24. package/dist/knowledge/graph.d.ts.map +1 -1
  25. package/dist/knowledge/graph.js +8 -0
  26. package/dist/knowledge/graph.js.map +1 -1
  27. package/dist/knowledge/ingest-freshness.d.ts +22 -0
  28. package/dist/knowledge/ingest-freshness.d.ts.map +1 -0
  29. package/dist/knowledge/ingest-freshness.js +93 -0
  30. package/dist/knowledge/ingest-freshness.js.map +1 -0
  31. package/dist/knowledge/promote.js +1 -1
  32. package/dist/knowledge/promote.js.map +1 -1
  33. package/dist/knowledge/reflect.js +2 -2
  34. package/dist/knowledge/reflect.js.map +1 -1
  35. package/dist/knowledge/remove.d.ts +11 -0
  36. package/dist/knowledge/remove.d.ts.map +1 -0
  37. package/dist/knowledge/remove.js +24 -0
  38. package/dist/knowledge/remove.js.map +1 -0
  39. package/dist/knowledge/search.d.ts +76 -4
  40. package/dist/knowledge/search.d.ts.map +1 -1
  41. package/dist/knowledge/search.js +364 -37
  42. package/dist/knowledge/search.js.map +1 -1
  43. package/dist/knowledge/similar.d.ts +7 -0
  44. package/dist/knowledge/similar.d.ts.map +1 -0
  45. package/dist/knowledge/similar.js +51 -0
  46. package/dist/knowledge/similar.js.map +1 -0
  47. package/dist/knowledge/store.d.ts +20 -1
  48. package/dist/knowledge/store.d.ts.map +1 -1
  49. package/dist/knowledge/store.js +119 -84
  50. package/dist/knowledge/store.js.map +1 -1
  51. package/dist/lib.d.ts +1 -1
  52. package/dist/lib.d.ts.map +1 -1
  53. package/dist/lib.js.map +1 -1
  54. package/dist/package-meta.d.ts +4 -1
  55. package/dist/package-meta.d.ts.map +1 -1
  56. package/dist/package-meta.js +18 -9
  57. package/dist/package-meta.js.map +1 -1
  58. package/dist/rest-server.d.ts +31 -0
  59. package/dist/rest-server.d.ts.map +1 -0
  60. package/dist/rest-server.js +142 -0
  61. package/dist/rest-server.js.map +1 -0
  62. package/dist/search/bm25.d.ts +8 -0
  63. package/dist/search/bm25.d.ts.map +1 -1
  64. package/dist/search/bm25.js +32 -20
  65. package/dist/search/bm25.js.map +1 -1
  66. package/dist/search/excerpt.d.ts +1 -1
  67. package/dist/search/excerpt.d.ts.map +1 -1
  68. package/dist/search/excerpt.js +19 -1
  69. package/dist/search/excerpt.js.map +1 -1
  70. package/dist/search/lexicon.d.ts +37 -0
  71. package/dist/search/lexicon.d.ts.map +1 -0
  72. package/dist/search/lexicon.js +83 -0
  73. package/dist/search/lexicon.js.map +1 -0
  74. package/dist/search/mmr.d.ts +9 -3
  75. package/dist/search/mmr.d.ts.map +1 -1
  76. package/dist/search/mmr.js +21 -7
  77. package/dist/search/mmr.js.map +1 -1
  78. package/dist/search/types.d.ts +2 -0
  79. package/dist/search/types.d.ts.map +1 -1
  80. package/dist/server.d.ts +1 -5
  81. package/dist/server.d.ts.map +1 -1
  82. package/dist/server.js +1 -13
  83. package/dist/server.js.map +1 -1
  84. package/dist/sessions/human.d.ts +12 -0
  85. package/dist/sessions/human.d.ts.map +1 -0
  86. package/dist/sessions/human.js +52 -0
  87. package/dist/sessions/human.js.map +1 -0
  88. package/dist/sessions/indexer.d.ts +4 -0
  89. package/dist/sessions/indexer.d.ts.map +1 -1
  90. package/dist/sessions/indexer.js +6 -1
  91. package/dist/sessions/indexer.js.map +1 -1
  92. package/dist/sessions/parser.d.ts +39 -0
  93. package/dist/sessions/parser.d.ts.map +1 -1
  94. package/dist/sessions/parser.js +169 -15
  95. package/dist/sessions/parser.js.map +1 -1
  96. package/dist/sessions/search.d.ts +2 -0
  97. package/dist/sessions/search.d.ts.map +1 -1
  98. package/dist/sessions/search.js +147 -67
  99. package/dist/sessions/search.js.map +1 -1
  100. package/dist/sessions/snapshot.d.ts +19 -0
  101. package/dist/sessions/snapshot.d.ts.map +1 -0
  102. package/dist/sessions/snapshot.js +118 -0
  103. package/dist/sessions/snapshot.js.map +1 -0
  104. package/dist/sessions/summary.d.ts +24 -5
  105. package/dist/sessions/summary.d.ts.map +1 -1
  106. package/dist/sessions/summary.js +122 -146
  107. package/dist/sessions/summary.js.map +1 -1
  108. package/dist/slice.d.ts +5 -0
  109. package/dist/slice.d.ts.map +1 -0
  110. package/dist/slice.js +28 -0
  111. package/dist/slice.js.map +1 -0
  112. package/dist/text.d.ts +9 -0
  113. package/dist/text.d.ts.map +1 -0
  114. package/dist/text.js +16 -0
  115. package/dist/text.js.map +1 -0
  116. package/dist/tool-handlers.d.ts.map +1 -1
  117. package/dist/tool-handlers.js +6 -10
  118. package/dist/tool-handlers.js.map +1 -1
  119. package/dist/transport/guard.d.ts +5 -0
  120. package/dist/transport/guard.d.ts.map +1 -0
  121. package/dist/transport/guard.js +51 -0
  122. package/dist/transport/guard.js.map +1 -0
  123. package/dist/transport/http.d.ts +17 -0
  124. package/dist/transport/http.d.ts.map +1 -0
  125. package/dist/transport/http.js +97 -0
  126. package/dist/transport/http.js.map +1 -0
  127. package/dist/transport/rest.d.ts +4 -0
  128. package/dist/transport/rest.d.ts.map +1 -0
  129. package/dist/transport/rest.js +424 -0
  130. package/dist/transport/rest.js.map +1 -0
  131. package/dist/vectorstore/store.d.ts +9 -0
  132. package/dist/vectorstore/store.d.ts.map +1 -1
  133. package/dist/vectorstore/store.js +23 -0
  134. package/dist/vectorstore/store.js.map +1 -1
  135. package/dist/wakeup.d.ts +5 -0
  136. package/dist/wakeup.d.ts.map +1 -1
  137. package/dist/wakeup.js +10 -1
  138. package/dist/wakeup.js.map +1 -1
  139. package/docs/ARCHITECTURE.md +25 -39
  140. package/docs/HOOKS.md +138 -237
  141. package/docs/INGEST.md +1 -1
  142. package/docs/SETUP.md +87 -143
  143. package/docs/USER-MANUAL.md +169 -100
  144. package/package.json +20 -17
  145. package/{skills → plugin/skills}/knowledge-ingest/SKILL.md +1 -1
  146. package/{skills → plugin/skills}/knowledge-ingest/scripts/validate.mjs +2 -2
  147. package/scripts/plugins/opencode/agent-knowledge.ts +37 -86
  148. package/scripts/setup.js +80 -146
  149. package/scripts/source-walk.d.mts +12 -0
  150. package/scripts/source-walk.mjs +94 -0
  151. package/scripts/tree-sitter-extract.mjs +10 -76
  152. package/.claude-plugin/marketplace.json +0 -19
  153. package/.claude-plugin/plugin.json +0 -12
  154. package/.mcp.json +0 -8
  155. package/agent-desk-plugin.json +0 -20
  156. package/dist/dashboard.d.ts +0 -5
  157. package/dist/dashboard.d.ts.map +0 -1
  158. package/dist/dashboard.js +0 -666
  159. package/dist/dashboard.js.map +0 -1
  160. package/dist/ui/app.js +0 -1013
  161. package/dist/ui/index.html +0 -460
  162. package/dist/ui/morphdom.min.js +0 -1
  163. package/dist/ui/render-graph.js +0 -482
  164. package/dist/ui/render-knowledge.js +0 -288
  165. package/dist/ui/render-panel.js +0 -475
  166. package/dist/ui/render-search.js +0 -105
  167. package/dist/ui/render-sessions.js +0 -237
  168. package/dist/ui/styles.css +0 -2322
  169. package/dist/ui/template.js +0 -173
  170. package/dist/ui/ui-utils.js +0 -217
  171. package/dist/ui/vis-network.min.js +0 -34
  172. package/docs/DASHBOARD.md +0 -191
  173. package/scripts/copy-ui.js +0 -14
  174. package/scripts/hooks/first-prompt-inject.mjs +0 -242
  175. package/scripts/hooks/precompact-distill.mjs +0 -105
  176. package/scripts/hooks/precompact-flush.mjs +0 -192
  177. package/scripts/hooks/session-start-ingest.mjs +0 -238
  178. package/scripts/hooks/session-start.js +0 -212
  179. package/scripts/hooks/sessionend-distill.mjs +0 -198
@@ -17,45 +17,18 @@
17
17
  // --json Pretty-print JSON output (default: compact)
18
18
  // =============================================================================
19
19
 
20
- import { readFileSync, readdirSync, statSync } from 'fs';
21
- import { join, extname, relative, resolve, dirname } from 'path';
20
+ import { readFileSync } from 'fs';
21
+ import { join, relative, resolve, dirname } from 'path';
22
22
  import { createHash } from 'crypto';
23
23
  import { fileURLToPath } from 'url';
24
24
  import { createRequire } from 'module';
25
- import { LANGUAGE_CONFIG, RATIONALE_PATTERNS, buildExtensionMap } from './tree-sitter-lang.mjs';
25
+ import { LANGUAGE_CONFIG, RATIONALE_PATTERNS } from './tree-sitter-lang.mjs';
26
+ import { DEFAULT_EXCLUDE, DEFAULT_MAX_FILES, EXTENSIONS, walkSources } from './source-walk.mjs';
26
27
 
27
28
  const __filename = fileURLToPath(import.meta.url);
28
29
  const __dirname = dirname(__filename);
29
30
  const require = createRequire(import.meta.url);
30
31
 
31
- // ---- Defaults ----
32
-
33
- const DEFAULT_EXCLUDE = [
34
- 'node_modules',
35
- '.git',
36
- 'dist',
37
- 'build',
38
- 'target',
39
- 'vendor',
40
- '__pycache__',
41
- '.venv',
42
- 'venv',
43
- '.tox',
44
- '.mypy_cache',
45
- '.next',
46
- '.nuxt',
47
- 'coverage',
48
- '.pytest_cache',
49
- '.cargo',
50
- 'bin',
51
- 'obj',
52
- '.gradle',
53
- '.idea',
54
- '.vscode',
55
- ];
56
-
57
- const DEFAULT_MAX_FILES = 2000;
58
-
59
32
  // ---- CLI argument parsing ----
60
33
 
61
34
  function parseArgs(argv) {
@@ -92,47 +65,6 @@ function parseArgs(argv) {
92
65
  return args;
93
66
  }
94
67
 
95
- // ---- File discovery ----
96
-
97
- function walkDir(dir, exclude, extMap, includeExts, maxFiles) {
98
- const files = [];
99
-
100
- function walk(currentDir) {
101
- if (files.length >= maxFiles) return;
102
- let entries;
103
- try {
104
- entries = readdirSync(currentDir, { withFileTypes: true });
105
- } catch {
106
- return;
107
- }
108
- for (const entry of entries) {
109
- if (files.length >= maxFiles) return;
110
- const name = entry.name;
111
- if (exclude.some((ex) => name === ex || name.startsWith(ex + '/'))) continue;
112
- const fullPath = join(currentDir, name);
113
- if (entry.isDirectory()) {
114
- walk(fullPath);
115
- } else if (entry.isFile()) {
116
- const ext = extname(name).toLowerCase();
117
- if (!extMap.has(ext)) continue;
118
- if (includeExts.length > 0 && !includeExts.some((ie) => name.endsWith(ie) || ext === ie))
119
- continue;
120
- let mtime;
121
- try {
122
- mtime = statSync(fullPath).mtimeMs;
123
- } catch {
124
- continue;
125
- }
126
- files.push({ fullPath, ext, mtime });
127
- }
128
- }
129
- }
130
-
131
- walk(dir);
132
- files.sort((a, b) => b.mtime - a.mtime);
133
- return files.slice(0, maxFiles);
134
- }
135
-
136
68
  // ---- Tree-sitter initialization ----
137
69
 
138
70
  let TreeSitter;
@@ -396,15 +328,17 @@ function buildDependencyGraph(files, rootPath) {
396
328
 
397
329
  async function main() {
398
330
  const args = parseArgs(process.argv);
399
- const extMap = buildExtensionMap();
400
-
401
- const discovered = walkDir(args.path, args.exclude, extMap, args.include, args.maxFiles);
331
+ const discovered = walkSources(args.path, {
332
+ exclude: args.exclude,
333
+ includeExts: args.include,
334
+ maxFiles: args.maxFiles,
335
+ });
402
336
 
403
337
  await initTreeSitter();
404
338
 
405
339
  const fileResults = [];
406
340
  for (const file of discovered) {
407
- const langName = extMap.get(file.ext);
341
+ const langName = EXTENSIONS.get(file.ext);
408
342
  let source;
409
343
  try {
410
344
  source = readFileSync(file.fullPath, 'utf-8');
@@ -1,19 +0,0 @@
1
- {
2
- "name": "agent-knowledge",
3
- "owner": {
4
- "name": "keshrath"
5
- },
6
- "metadata": {
7
- "description": "Cross-session memory for AI coding agents.",
8
- "version": "1.0.0"
9
- },
10
- "plugins": [
11
- {
12
- "name": "agent-knowledge",
13
- "source": "./",
14
- "description": "Cross-session memory for AI coding agents. Git-synced Markdown knowledge base with hybrid semantic + TF-IDF search, typed knowledge graph, confidence/decay scoring, and session auto-distillation with secrets scrubbing. Reads sessions from Claude Code, Cursor, and OpenCode. Dashboard on :3423.",
15
- "category": "workflow",
16
- "tags": ["mcp", "memory", "knowledge-graph", "semantic-search"]
17
- }
18
- ]
19
- }
@@ -1,12 +0,0 @@
1
- {
2
- "name": "agent-knowledge",
3
- "description": "Cross-session memory for AI coding agents. Git-synced Markdown knowledge base with hybrid semantic + TF-IDF search, typed knowledge graph, and session auto-distillation with secrets scrubbing.",
4
- "version": "1.9.8",
5
- "author": {
6
- "name": "keshrath"
7
- },
8
- "homepage": "https://github.com/keshrath/agent-knowledge",
9
- "repository": "https://github.com/keshrath/agent-knowledge",
10
- "license": "MIT",
11
- "keywords": ["mcp", "memory", "knowledge-graph", "semantic-search", "claude-code"]
12
- }
package/.mcp.json DELETED
@@ -1,8 +0,0 @@
1
- {
2
- "mcpServers": {
3
- "agent-knowledge": {
4
- "command": "npx",
5
- "args": ["-y", "agent-knowledge@^1.8.0"]
6
- }
7
- }
8
- }
@@ -1,20 +0,0 @@
1
- {
2
- "id": "agent-knowledge",
3
- "name": "Knowledge",
4
- "icon": "psychology",
5
- "version": "1.9.8",
6
- "description": "Knowledge base — entries, sessions, search, graph relationships",
7
- "ui": "./dist/ui/app.js",
8
- "css": "./dist/ui/styles.css",
9
- "uiFiles": [
10
- "ui-utils.js",
11
- "render-knowledge.js",
12
- "render-search.js",
13
- "render-sessions.js",
14
- "render-graph.js",
15
- "render-panel.js",
16
- "template.js",
17
- "app.js"
18
- ],
19
- "position": 3
20
- }
@@ -1,5 +0,0 @@
1
- import http from 'http';
2
- import { serveStatic } from 'agent-common';
3
- export declare function startDashboard(port?: number): Promise<http.Server>;
4
- export { serveStatic };
5
- //# sourceMappingURL=dashboard.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../src/dashboard.ts"],"names":[],"mappings":"AASA,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB,OAAO,EAIL,WAAW,EAIZ,MAAM,cAAc,CAAC;AAkqBtB,wBAAgB,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAqFlE;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}