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
@@ -1,288 +0,0 @@
1
- /* agent-knowledge — knowledge tab rendering */
2
- (function () {
3
- 'use strict';
4
-
5
- const K = window.Knowledge;
6
-
7
- // ── Render knowledge grid ─────────────────────────────────────────────────
8
-
9
- function renderKnowledge(state, el) {
10
- const cat = state.knowledge.activeCategory;
11
- const filtered =
12
- cat === 'all'
13
- ? state.knowledge.entries
14
- : state.knowledge.entries.filter((e) => e.category === cat);
15
-
16
- if (filtered.length === 0) {
17
- K.morph(el.knowledgeGrid, '');
18
- el.knowledgeEmpty.classList.remove('hidden');
19
- return;
20
- }
21
-
22
- el.knowledgeEmpty.classList.add('hidden');
23
- K.morph(
24
- el.knowledgeGrid,
25
- filtered
26
- .map((entry) => {
27
- const cat = entry.category || 'notes';
28
- const catIcons = {
29
- projects: 'code',
30
- people: 'group',
31
- decisions: 'gavel',
32
- workflows: 'account_tree',
33
- notes: 'sticky_note_2',
34
- };
35
- const icon = catIcons[cat] || 'article';
36
- const title = entry.title || entry.path || entry.id || 'Untitled';
37
- const tags = (entry.tags || [])
38
- .slice(0, 3)
39
- .map((t) => `<span class="card-tag">${K.esc(t)}</span>`)
40
- .join('');
41
- const time = K.relativeTime(entry.updated || entry.created);
42
-
43
- const maturity = entry.maturity || 'candidate';
44
- const accessCount = entry.access_count || 0;
45
- const hasDuplicates = !!state.knowledge.duplicateClusters[entry.path || ''];
46
-
47
- return `<div class="knowledge-card${hasDuplicates ? ' has-duplicates' : ''}" data-path="${K.esc(entry.path || entry.id || '')}" tabindex="0" role="button">
48
- <div class="card-header-row">
49
- <span class="card-category" data-cat="${K.esc(cat)}">
50
- <span class="material-symbols-outlined" style="font-size:14px">${icon}</span>
51
- ${K.esc(cat)}
52
- </span>
53
- <div style="display:flex;align-items:center;gap:4px">
54
- ${hasDuplicates ? '<span class="material-symbols-outlined duplicate-warn" title="Potential duplicate detected" style="font-size:16px;color:var(--warning)">content_copy</span>' : ''}
55
- <span class="maturity-badge" data-maturity="${K.esc(maturity)}">${K.esc(maturity)}${accessCount > 0 ? ` <span class="maturity-reads">&middot; ${accessCount} reads</span>` : ''}</span>
56
- </div>
57
- </div>
58
- ${time ? `<span class="card-date">${time}</span>` : ''}
59
- <div class="card-title">${K.esc(title)}</div>
60
- ${tags ? `<div class="card-tags">${tags}</div>` : ''}
61
- </div>`;
62
- })
63
- .join(''),
64
- );
65
- }
66
-
67
- // ── Knowledge search ──────────────────────────────────────────────────────
68
-
69
- function createKnowledgeSearch(state, el) {
70
- return K.debounce(async () => {
71
- const q = (el.knowledgeSearchInput ? el.knowledgeSearchInput.value : '').trim();
72
- if (!q) {
73
- el.knowledgeSearchResults.style.display = 'none';
74
- el.knowledgeGrid.style.display = '';
75
- el.knowledgeEmpty.classList.add('hidden');
76
- K.renderKnowledge(state, el);
77
- return;
78
- }
79
- try {
80
- const params = new URLSearchParams({ q, max_results: '20' });
81
- const cat = state.knowledge.activeCategory;
82
- if (cat !== 'all') params.set('category', cat);
83
- const results = await K.api(`/knowledge/search?${params}`);
84
- renderKnowledgeSearchResults(Array.isArray(results) ? results : [], q, el);
85
- } catch (err) {
86
- K.toast(`Knowledge search failed: ${err.message}`, 'error');
87
- }
88
- }, 300);
89
- }
90
-
91
- function renderKnowledgeSearchResults(results, query, el) {
92
- if (results.length === 0) {
93
- el.knowledgeSearchResults.style.display = 'none';
94
- el.knowledgeGrid.style.display = 'none';
95
- el.knowledgeEmpty.classList.remove('hidden');
96
- el.knowledgeEmpty.querySelector('.empty-text').textContent = 'No results found';
97
- el.knowledgeEmpty.querySelector('.empty-hint').textContent =
98
- `No knowledge entries match "${query}"`;
99
- return;
100
- }
101
-
102
- el.knowledgeEmpty.classList.add('hidden');
103
- el.knowledgeGrid.style.display = 'none';
104
- el.knowledgeSearchResults.style.display = '';
105
- K.morph(
106
- el.knowledgeSearchResults,
107
- results
108
- .map((r) => {
109
- const title = r.title || r.path || '';
110
- const excerpt = r.excerpt || '';
111
- const score = r.score;
112
- const maturity = r.maturity || 'candidate';
113
- const accessCount = r.access_count || 0;
114
- const decayF = r.decay_factor;
115
- const matMult = r.maturity_multiplier;
116
- const path = r.path || '';
117
-
118
- let scoreBreakdown = '';
119
- if (score != null) {
120
- const parts = [];
121
- parts.push(`relevance: ${score.toFixed(2)}`);
122
- if (decayF != null) parts.push(`decay: ${decayF.toFixed(2)}`);
123
- if (matMult != null) parts.push(`maturity: x${matMult.toFixed(1)}`);
124
- const finalScore = score * (decayF || 1) * (matMult || 1);
125
- scoreBreakdown = `<div class="score-breakdown">Score: ${finalScore.toFixed(2)} (${parts.join(' \u00d7 ')})</div>`;
126
- }
127
-
128
- return `<div class="result-item knowledge-result-item" data-path="${K.esc(path)}" tabindex="0" role="button">
129
- <div class="result-meta">
130
- <span class="maturity-badge" data-maturity="${K.esc(maturity)}">${K.esc(maturity)}${accessCount > 0 ? ` <span class="maturity-reads">&middot; ${accessCount} reads</span>` : ''}</span>
131
- <span class="result-entry-title">${K.esc(title)}</span>
132
- ${score != null ? `<span class="score-container">${K.formatScore(score, {})}</span>` : ''}
133
- </div>
134
- <div class="result-excerpt">${K.highlightExcerpt(excerpt, query)}</div>
135
- ${scoreBreakdown}
136
- </div>`;
137
- })
138
- .join(''),
139
- );
140
- }
141
-
142
- // ── Load knowledge from API ───────────────────────────────────────────────
143
-
144
- async function loadKnowledge(state, el) {
145
- try {
146
- const data = await K.api('/knowledge');
147
- const entries = Array.isArray(data) ? data : data.entries || [];
148
- state.knowledge.entries = entries;
149
- state.stats.knowledgeCount = entries.length;
150
- K.updateStats(state, el);
151
- K.renderKnowledge(state, el);
152
- } catch (err) {
153
- K.toast(`Failed to load knowledge: ${err.message}`, 'error');
154
- }
155
- }
156
-
157
- // ── Open knowledge entry in panel ─────────────────────────────────────────
158
-
159
- async function openKnowledgePanel(path) {
160
- if (!path) return;
161
- try {
162
- const [entryRes, linksRes] = await Promise.allSettled([
163
- K.api(`/knowledge/${encodeURIComponent(path)}`),
164
- K.api(`/knowledge/${encodeURIComponent(path)}/links`),
165
- ]);
166
- const data = entryRes.status === 'fulfilled' ? entryRes.value : {};
167
- const links = linksRes.status === 'fulfilled' ? linksRes.value : [];
168
- const title = data.title || data.path || path;
169
- const content = data.content || data.body || '';
170
- K.openPanel('knowledge', { title, content, meta: data, links, entryPath: path });
171
- } catch (err) {
172
- K.toast(`Failed to load entry: ${err.message}`, 'error');
173
- }
174
- }
175
-
176
- // ── Consolidate (duplicates) ──────────────────────────────────────────────
177
-
178
- async function loadConsolidate(state, el) {
179
- try {
180
- K.toast('Scanning for duplicates...', 'info', 2000);
181
- const report = await K.api('/knowledge/consolidate');
182
- state.knowledge.duplicateClusters = {};
183
- if (report.clusters && report.clusters.length > 0) {
184
- for (const cluster of report.clusters) {
185
- for (const entry of cluster.entries) {
186
- state.knowledge.duplicateClusters[entry.path] = cluster;
187
- }
188
- }
189
- K.renderKnowledge(state, el);
190
- K.openPanel('consolidate', report);
191
- } else {
192
- K.toast('No duplicate clusters found', 'success');
193
- }
194
- } catch (err) {
195
- K.toast(`Consolidation failed: ${err.message}`, 'error');
196
- }
197
- }
198
-
199
- // ── Reflect (unconnected entries) ─────────────────────────────────────────
200
-
201
- async function loadReflect() {
202
- try {
203
- K.toast('Finding unconnected entries...', 'info', 2000);
204
- const result = await K.api('/knowledge/reflect');
205
- if (result.unconnectedEntries && result.unconnectedEntries.length > 0) {
206
- K.openPanel('reflect', result);
207
- } else {
208
- K.toast('All entries are connected in the graph', 'success');
209
- }
210
- } catch (err) {
211
- K.toast(`Reflect failed: ${err.message}`, 'error');
212
- }
213
- }
214
-
215
- // ── God Nodes ─────────────────────────────────────────────────────────────
216
-
217
- async function loadGodNodes() {
218
- try {
219
- K.toast('Finding most connected entries...', 'info', 2000);
220
- const result = await K.api('/knowledge/god-nodes');
221
- if (Array.isArray(result) && result.length > 0) {
222
- K.openPanel('god-nodes', result);
223
- } else {
224
- K.toast('No god nodes — graph has no edges yet', 'success');
225
- }
226
- } catch (err) {
227
- K.toast(`God nodes failed: ${err.message}`, 'error');
228
- }
229
- }
230
-
231
- // ── Bridges ───────────────────────────────────────────────────────────────
232
-
233
- async function loadBridges() {
234
- try {
235
- K.toast('Finding bridge entries...', 'info', 2000);
236
- const result = await K.api('/knowledge/bridges');
237
- if (Array.isArray(result) && result.length > 0) {
238
- K.openPanel('bridges', result);
239
- } else {
240
- K.toast('No bridges found — graph has no cross-category connections', 'success');
241
- }
242
- } catch (err) {
243
- K.toast(`Bridges failed: ${err.message}`, 'error');
244
- }
245
- }
246
-
247
- // ── Gaps ──────────────────────────────────────────────────────────────────
248
-
249
- async function loadGaps() {
250
- try {
251
- K.toast('Finding knowledge gaps...', 'info', 2000);
252
- const result = await K.api('/knowledge/gaps');
253
- if (Array.isArray(result) && result.length > 0) {
254
- K.openPanel('gaps', result);
255
- } else {
256
- K.toast('No gaps — all entries are well connected', 'success');
257
- }
258
- } catch (err) {
259
- K.toast(`Gaps failed: ${err.message}`, 'error');
260
- }
261
- }
262
-
263
- // ── Brief ─────────────────────────────────────────────────────────────────
264
-
265
- async function loadBrief() {
266
- try {
267
- const result = await K.api('/knowledge/brief');
268
- K.openPanel('brief', result);
269
- } catch (err) {
270
- K.toast(`Brief failed: ${err.message}`, 'error');
271
- }
272
- }
273
-
274
- // ── Export ──────────────────────────────────────────────────────────────────
275
-
276
- Object.assign(K, {
277
- renderKnowledge,
278
- createKnowledgeSearch,
279
- loadKnowledge,
280
- openKnowledgePanel,
281
- loadConsolidate,
282
- loadReflect,
283
- loadGodNodes,
284
- loadBridges,
285
- loadGaps,
286
- loadBrief,
287
- });
288
- })();