agent-knowledge 1.9.8 → 2.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 (98) hide show
  1. package/CHANGELOG.md +34 -0
  2. package/README.md +39 -41
  3. package/dist/events.d.ts +10 -0
  4. package/dist/events.d.ts.map +1 -0
  5. package/dist/events.js +23 -0
  6. package/dist/events.js.map +1 -0
  7. package/dist/index.js +19 -13
  8. package/dist/index.js.map +1 -1
  9. package/dist/knowledge/consolidate.d.ts +2 -2
  10. package/dist/knowledge/consolidate.js +2 -2
  11. package/dist/knowledge/freshness.js +1 -1
  12. package/dist/knowledge/freshness.js.map +1 -1
  13. package/dist/knowledge/git.d.ts.map +1 -1
  14. package/dist/knowledge/git.js +2 -3
  15. package/dist/knowledge/git.js.map +1 -1
  16. package/dist/knowledge/promote.js +1 -1
  17. package/dist/knowledge/promote.js.map +1 -1
  18. package/dist/knowledge/reflect.js +2 -2
  19. package/dist/knowledge/reflect.js.map +1 -1
  20. package/dist/knowledge/search.d.ts +6 -0
  21. package/dist/knowledge/search.d.ts.map +1 -1
  22. package/dist/knowledge/search.js +49 -3
  23. package/dist/knowledge/search.js.map +1 -1
  24. package/dist/knowledge/store.d.ts +3 -1
  25. package/dist/knowledge/store.d.ts.map +1 -1
  26. package/dist/knowledge/store.js +2 -5
  27. package/dist/knowledge/store.js.map +1 -1
  28. package/dist/lib.d.ts +1 -1
  29. package/dist/lib.d.ts.map +1 -1
  30. package/dist/lib.js.map +1 -1
  31. package/dist/package-meta.d.ts +4 -1
  32. package/dist/package-meta.d.ts.map +1 -1
  33. package/dist/package-meta.js +18 -9
  34. package/dist/package-meta.js.map +1 -1
  35. package/dist/rest-server.d.ts +21 -0
  36. package/dist/rest-server.d.ts.map +1 -0
  37. package/dist/rest-server.js +77 -0
  38. package/dist/rest-server.js.map +1 -0
  39. package/dist/server.d.ts +1 -5
  40. package/dist/server.d.ts.map +1 -1
  41. package/dist/server.js +1 -8
  42. package/dist/server.js.map +1 -1
  43. package/dist/sessions/indexer.d.ts +4 -0
  44. package/dist/sessions/indexer.d.ts.map +1 -1
  45. package/dist/sessions/indexer.js +6 -1
  46. package/dist/sessions/indexer.js.map +1 -1
  47. package/dist/sessions/parser.d.ts.map +1 -1
  48. package/dist/sessions/parser.js +32 -2
  49. package/dist/sessions/parser.js.map +1 -1
  50. package/dist/sessions/summary.d.ts.map +1 -1
  51. package/dist/sessions/summary.js +16 -1
  52. package/dist/sessions/summary.js.map +1 -1
  53. package/dist/transport/guard.d.ts +5 -0
  54. package/dist/transport/guard.d.ts.map +1 -0
  55. package/dist/transport/guard.js +51 -0
  56. package/dist/transport/guard.js.map +1 -0
  57. package/dist/transport/http.d.ts +17 -0
  58. package/dist/transport/http.d.ts.map +1 -0
  59. package/dist/transport/http.js +97 -0
  60. package/dist/transport/http.js.map +1 -0
  61. package/dist/transport/rest.d.ts +4 -0
  62. package/dist/transport/rest.d.ts.map +1 -0
  63. package/dist/transport/rest.js +307 -0
  64. package/dist/transport/rest.js.map +1 -0
  65. package/docs/ARCHITECTURE.md +23 -34
  66. package/docs/HOOKS.md +16 -16
  67. package/docs/INGEST.md +1 -1
  68. package/docs/SETUP.md +31 -26
  69. package/docs/USER-MANUAL.md +150 -89
  70. package/package.json +17 -14
  71. package/{skills → plugin/skills}/knowledge-ingest/SKILL.md +1 -1
  72. package/scripts/hooks/session-start.js +6 -7
  73. package/scripts/hooks/sessionend-distill.mjs +5 -5
  74. package/scripts/plugins/opencode/agent-knowledge.ts +6 -6
  75. package/scripts/setup.js +8 -7
  76. package/.claude-plugin/marketplace.json +0 -19
  77. package/.claude-plugin/plugin.json +0 -12
  78. package/.mcp.json +0 -8
  79. package/agent-desk-plugin.json +0 -20
  80. package/dist/dashboard.d.ts +0 -5
  81. package/dist/dashboard.d.ts.map +0 -1
  82. package/dist/dashboard.js +0 -666
  83. package/dist/dashboard.js.map +0 -1
  84. package/dist/ui/app.js +0 -1013
  85. package/dist/ui/index.html +0 -460
  86. package/dist/ui/morphdom.min.js +0 -1
  87. package/dist/ui/render-graph.js +0 -482
  88. package/dist/ui/render-knowledge.js +0 -288
  89. package/dist/ui/render-panel.js +0 -475
  90. package/dist/ui/render-search.js +0 -105
  91. package/dist/ui/render-sessions.js +0 -237
  92. package/dist/ui/styles.css +0 -2322
  93. package/dist/ui/template.js +0 -173
  94. package/dist/ui/ui-utils.js +0 -217
  95. package/dist/ui/vis-network.min.js +0 -34
  96. package/docs/DASHBOARD.md +0 -191
  97. package/scripts/copy-ui.js +0 -14
  98. /package/{skills → plugin/skills}/knowledge-ingest/scripts/validate.mjs +0 -0
@@ -0,0 +1,307 @@
1
+ // =============================================================================
2
+ // agent-knowledge — REST routes
3
+ //
4
+ // What the /knowledge pane, the hook scripts, the opencode plugin and
5
+ // agent-tasks' KnowledgeBridge call. JSON only; the request guard in
6
+ // rest-server.ts runs before every route.
7
+ // =============================================================================
8
+ import { existsSync } from 'node:fs';
9
+ import { join } from 'node:path';
10
+ import { deleteEntry, getAllFiles, listEntries, readEntry, writeEntry, } from '../knowledge/store.js';
11
+ import { searchKnowledge, invalidateKnowledgeIndexCache } from '../knowledge/search.js';
12
+ import { getEntryScoring, decayFactor, maturityMultiplier } from '../knowledge/scoring.js';
13
+ import { getKnowledgeGraph } from '../knowledge/graph.js';
14
+ import { gaps, godNodes, invalidateBriefCache } from '../knowledge/analyze.js';
15
+ import { checkDuplicates } from '../knowledge/consolidate.js';
16
+ import { gitPull, gitPush, gitSync } from '../knowledge/git.js';
17
+ import { getVectorStore, indexKnowledgeEntry } from '../sessions/indexer.js';
18
+ import { searchSessions } from '../sessions/search.js';
19
+ import { listSessions, getSessionSummary } from '../sessions/summary.js';
20
+ import { getProjectDirs, getSessionFiles } from '../sessions/parser.js';
21
+ import { recentEvents, recordEvent } from '../events.js';
22
+ import { getConfig } from '../types.js';
23
+ import { getVersion } from '../version.js';
24
+ import { HttpError, json, readBody, Router } from './http.js';
25
+ const CATEGORIES = new Set(['projects', 'people', 'decisions', 'workflows', 'notes']);
26
+ function urlOf(req) {
27
+ return new URL(req.url ?? '/', 'http://localhost');
28
+ }
29
+ function intParam(url, name, fallback) {
30
+ const n = parseInt(url.searchParams.get(name) ?? '', 10);
31
+ return Number.isFinite(n) ? n : fallback;
32
+ }
33
+ /** An entry's live scoring next to its stored fields. */
34
+ function withScores(entries) {
35
+ const scores = getEntryScoring().getScores(entries.map((e) => e.path));
36
+ return entries.map((e) => {
37
+ const score = scores.get(e.path);
38
+ return {
39
+ ...e,
40
+ evergreen: e.evergreen === true,
41
+ author: e.author ?? null,
42
+ maturity: score?.maturity ?? 'candidate',
43
+ access_count: score?.access_count ?? 0,
44
+ last_accessed: score?.last_accessed ?? null,
45
+ };
46
+ });
47
+ }
48
+ /** readEntry's errors as the status they mean. */
49
+ function readOr404(entryPath) {
50
+ try {
51
+ return readEntry(getConfig().memoryDir, entryPath);
52
+ }
53
+ catch (e) {
54
+ const message = e instanceof Error ? e.message : String(e);
55
+ throw new HttpError(message.startsWith('File not found') ? 404 : 400, message);
56
+ }
57
+ }
58
+ const healthRoute = (_req, res) => {
59
+ json(res, {
60
+ status: 'ok',
61
+ version: getVersion(),
62
+ uptime: process.uptime(),
63
+ knowledge_entries: listEntries(getConfig().memoryDir).length,
64
+ });
65
+ };
66
+ const knowledgeListRoute = (req, res) => {
67
+ const url = urlOf(req);
68
+ const entries = listEntries(getConfig().memoryDir, url.searchParams.get('category') || undefined, url.searchParams.get('tag') || undefined);
69
+ json(res, withScores(entries));
70
+ };
71
+ const knowledgeSearchRoute = (req, res) => {
72
+ const url = urlOf(req);
73
+ const results = searchKnowledge(getConfig().memoryDir, url.searchParams.get('q') || '', {
74
+ category: url.searchParams.get('category') || undefined,
75
+ maxResults: url.searchParams.has('max_results') ? intParam(url, 'max_results', 20) : undefined,
76
+ });
77
+ const scores = getEntryScoring().getScores(results.map((r) => r.entry.path));
78
+ json(res, results.map((r) => {
79
+ const score = scores.get(r.entry.path);
80
+ return {
81
+ ...r,
82
+ maturity: score?.maturity ?? 'candidate',
83
+ access_count: score?.access_count ?? 0,
84
+ decay_factor: score?.last_accessed ? decayFactor(score.last_accessed) : 1,
85
+ maturity_multiplier: maturityMultiplier(score?.maturity ?? 'candidate'),
86
+ };
87
+ }));
88
+ };
89
+ const knowledgeEntryRoute = (_req, res, params) => {
90
+ const entry = readOr404(params.entryPath);
91
+ const score = getEntryScoring().getScore(params.entryPath);
92
+ json(res, {
93
+ ...entry,
94
+ maturity: score?.maturity ?? 'candidate',
95
+ access_count: score?.access_count ?? 0,
96
+ last_accessed: score?.last_accessed ?? null,
97
+ decay_factor: score?.last_accessed ? decayFactor(score.last_accessed) : 1,
98
+ maturity_multiplier: maturityMultiplier(score?.maturity ?? 'candidate'),
99
+ });
100
+ };
101
+ /** An entry's title, or null when the file is gone (an edge can outlive its entry). */
102
+ function titleOf(dir, entryPath) {
103
+ try {
104
+ return readEntry(dir, entryPath).entry.title || null;
105
+ }
106
+ catch {
107
+ return null;
108
+ }
109
+ }
110
+ /** GET /api/knowledge/:path/links: its edges, each with the title of the entry at the other end. */
111
+ const knowledgeLinksRoute = (_req, res, params) => {
112
+ const dir = getConfig().memoryDir;
113
+ const self = params.entryPath;
114
+ json(res, getKnowledgeGraph()
115
+ .links(self)
116
+ .map((e) => ({ ...e, title: titleOf(dir, e.source === self ? e.target : e.source) })));
117
+ };
118
+ const sessionsListRoute = (req, res) => {
119
+ const url = urlOf(req);
120
+ const all = listSessions(url.searchParams.get('project') || undefined);
121
+ const offset = Math.max(0, intParam(url, 'offset', 0));
122
+ const limit = Math.min(Math.max(0, intParam(url, 'limit', 50)), 500);
123
+ json(res, { sessions: all.slice(offset, offset + limit), total: all.length });
124
+ };
125
+ const sessionsSearchRoute = async (req, res) => {
126
+ const url = urlOf(req);
127
+ const role = url.searchParams.get('role');
128
+ json(res, await searchSessions(url.searchParams.get('q') || '', {
129
+ role: role === 'user' || role === 'assistant' ? role : 'all',
130
+ maxResults: intParam(url, 'max_results', 20),
131
+ ranked: url.searchParams.get('ranked') !== 'false',
132
+ semantic: url.searchParams.get('semantic') === 'true',
133
+ project: url.searchParams.get('project') || undefined,
134
+ }));
135
+ };
136
+ const sessionSummaryRoute = (req, res, params) => {
137
+ const summary = getSessionSummary(params.sessionId, urlOf(req).searchParams.get('project') || undefined);
138
+ if (!summary)
139
+ throw new HttpError(404, `Session ${params.sessionId} not found`);
140
+ json(res, summary);
141
+ };
142
+ /** POST /api/events { kind, message }: a hook's receipt for the pane to show. */
143
+ const eventsRoute = async (req, res) => {
144
+ const body = await readBody(req, 4_096);
145
+ const kind = typeof body.kind === 'string' ? body.kind.trim() : '';
146
+ const message = typeof body.message === 'string' ? body.message.trim() : '';
147
+ if (!kind || !message)
148
+ throw new HttpError(422, 'Required fields: kind, message');
149
+ if (kind.length > 64 || message.length > 512) {
150
+ throw new HttpError(422, 'kind <= 64 chars, message <= 512 chars');
151
+ }
152
+ const evt = recordEvent(kind, message);
153
+ json(res, { id: evt.id, ts: evt.ts }, 201);
154
+ };
155
+ /**
156
+ * POST /api/knowledge { category, filename, content }: the MCP knowledge(action=write)
157
+ * pipeline (write, index, auto-link, git push) for HTTP callers such as agent-tasks.
158
+ */
159
+ const knowledgeWriteRoute = async (req, res) => {
160
+ const config = getConfig();
161
+ const body = await readBody(req, 1_048_576);
162
+ const category = typeof body.category === 'string' ? body.category.trim() : '';
163
+ const filename = typeof body.filename === 'string' ? body.filename.trim() : '';
164
+ const content = typeof body.content === 'string' ? body.content : '';
165
+ if (!category || !filename || !content) {
166
+ throw new HttpError(422, 'Required fields: category, filename, content');
167
+ }
168
+ if (!CATEGORIES.has(category)) {
169
+ throw new HttpError(422, `Invalid category. Must be one of: ${[...CATEGORIES].join(', ')}`);
170
+ }
171
+ await gitPull(config.memoryDir);
172
+ const filePath = writeEntry(config.memoryDir, category, filename, content);
173
+ invalidateKnowledgeIndexCache();
174
+ invalidateBriefCache();
175
+ invalidateOverview();
176
+ const pushResult = await gitPush(config.memoryDir);
177
+ const autoLinks = [];
178
+ try {
179
+ await indexKnowledgeEntry(filePath, content);
180
+ const { getEmbeddingProvider } = await import('../embeddings/index.js');
181
+ const provider = await getEmbeddingProvider();
182
+ if (provider) {
183
+ const queryVector = await provider.embedOne(content.slice(0, 2000));
184
+ const similar = getVectorStore().searchBySource(queryVector, 'knowledge', 4);
185
+ const graph = getKnowledgeGraph();
186
+ for (const hit of similar) {
187
+ if (hit.sourceId === filePath)
188
+ continue;
189
+ if (hit.score > 0.7) {
190
+ graph.link(filePath, hit.sourceId, 'related_to', hit.score, null, null, 'auto-link');
191
+ autoLinks.push({ target: hit.sourceId, similarity: Math.round(hit.score * 100) / 100 });
192
+ }
193
+ if (autoLinks.length >= 3)
194
+ break;
195
+ }
196
+ }
197
+ }
198
+ catch (linkErr) {
199
+ console.error('[knowledge] Auto-link failed:', linkErr);
200
+ }
201
+ let duplicateWarnings = [];
202
+ try {
203
+ duplicateWarnings = checkDuplicates(config.memoryDir, filePath, content);
204
+ }
205
+ catch (dupErr) {
206
+ console.error('[knowledge] Duplicate check failed:', dupErr);
207
+ }
208
+ const response = { path: filePath, git: pushResult };
209
+ if (autoLinks.length > 0)
210
+ response.autoLinks = autoLinks;
211
+ if (duplicateWarnings.length > 0)
212
+ response.duplicateWarnings = duplicateWarnings;
213
+ json(res, response, 201);
214
+ };
215
+ // ── The /knowledge pane ──────────────────────────────────────────────────────
216
+ /**
217
+ * The counts the pane polls every few seconds, from file names alone (parsing every entry
218
+ * takes a second on a large base); kept for OVERVIEW_TTL, and a write through this server
219
+ * drops them at once.
220
+ */
221
+ const OVERVIEW_TTL = 10_000;
222
+ let counted = null;
223
+ export function invalidateOverview() {
224
+ counted = null;
225
+ }
226
+ function countAll() {
227
+ if (counted && Date.now() - counted.at < OVERVIEW_TTL)
228
+ return counted.data;
229
+ const config = getConfig();
230
+ const categories = {};
231
+ const paths = getAllFiles(config.memoryDir);
232
+ for (const p of paths) {
233
+ const c = p.includes('/') ? p.split('/')[0] : 'other';
234
+ categories[c] = (categories[c] ?? 0) + 1;
235
+ }
236
+ let sessions = 0;
237
+ for (const p of getProjectDirs())
238
+ sessions += getSessionFiles(p.path).length;
239
+ const vectors = getVectorStore().stats();
240
+ const data = {
241
+ version: getVersion(),
242
+ entries: paths.length,
243
+ categories,
244
+ sessions,
245
+ vectors: vectors.totalEntries,
246
+ provider: vectors.provider,
247
+ memory_dir: config.memoryDir,
248
+ has_git: existsSync(join(config.memoryDir, '.git')),
249
+ };
250
+ counted = { at: Date.now(), data };
251
+ return data;
252
+ }
253
+ /** GET /api/overview: the counts and the live events, in one cheap call. */
254
+ const overviewRoute = (_req, res) => {
255
+ json(res, { ...countAll(), events: recentEvents() });
256
+ };
257
+ /** DELETE /api/knowledge/:entryPath: the MCP knowledge(action=delete) pipeline. */
258
+ const knowledgeDeleteRoute = async (_req, res, params) => {
259
+ const dir = getConfig().memoryDir;
260
+ await gitPull(dir);
261
+ let deleted;
262
+ try {
263
+ deleted = deleteEntry(dir, params.entryPath);
264
+ }
265
+ catch (e) {
266
+ throw new HttpError(400, e instanceof Error ? e.message : String(e));
267
+ }
268
+ if (!deleted)
269
+ throw new HttpError(404, `File not found: ${params.entryPath}`);
270
+ invalidateKnowledgeIndexCache();
271
+ invalidateBriefCache();
272
+ invalidateOverview();
273
+ json(res, { deleted, git: await gitPush(dir) });
274
+ };
275
+ /** POST /api/knowledge/sync: git pull then push, as knowledge(action=sync). */
276
+ const syncRoute = async (_req, res) => {
277
+ const result = await gitSync(getConfig().memoryDir);
278
+ invalidateKnowledgeIndexCache();
279
+ invalidateOverview();
280
+ json(res, result);
281
+ };
282
+ /**
283
+ * GET /api/analysis: the most linked entries (two links or more) and the ones with one link
284
+ * or none, so no entry is in both.
285
+ */
286
+ const analysisRoute = (_req, res) => {
287
+ const dir = getConfig().memoryDir;
288
+ json(res, { hubs: godNodes(dir, 5).filter((n) => n.degree >= 2), sparse: gaps(dir, 30) });
289
+ };
290
+ export function createRouter() {
291
+ return new Router()
292
+ .route('GET', '/health', healthRoute)
293
+ .route('GET', '/api/knowledge', knowledgeListRoute)
294
+ .route('GET', '/api/knowledge/search', knowledgeSearchRoute)
295
+ .route('GET', '/api/knowledge/:entryPath/links', knowledgeLinksRoute)
296
+ .route('GET', '/api/knowledge/:entryPath', knowledgeEntryRoute)
297
+ .route('DELETE', '/api/knowledge/:entryPath', knowledgeDeleteRoute)
298
+ .route('POST', '/api/knowledge/sync', syncRoute)
299
+ .route('POST', '/api/knowledge', knowledgeWriteRoute)
300
+ .route('GET', '/api/overview', overviewRoute)
301
+ .route('GET', '/api/analysis', analysisRoute)
302
+ .route('GET', '/api/sessions', sessionsListRoute)
303
+ .route('GET', '/api/sessions/search', sessionsSearchRoute)
304
+ .route('GET', '/api/sessions/:sessionId/summary', sessionSummaryRoute)
305
+ .route('POST', '/api/events', eventsRoute);
306
+ }
307
+ //# sourceMappingURL=rest.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rest.js","sourceRoot":"","sources":["../../src/transport/rest.ts"],"names":[],"mappings":"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"}
@@ -27,23 +27,25 @@ graph TB
27
27
  Adapters --> ContinueDev[(Continue.dev<br/>JSON)]
28
28
  Adapters --> Aider[(Aider<br/>MD / JSONL)]
29
29
 
30
- Server --> Dashboard[dashboard.ts — :3423]
31
- Dashboard --> HTTP[REST API]
32
- Dashboard --> WS[WebSocket]
33
- Dashboard --> Watcher[File Watcher]
34
- HTTP --> Browser[Browser UI]
35
- WS --> Browser
30
+ Index[index.ts] --> Server
31
+ Index --> Rest[rest-server.ts — 127.0.0.1:3423]
32
+ Rest --> Guard[transport/guard.ts]
33
+ Guard --> Routes[transport/rest.ts]
34
+ Routes --> Pane["/knowledge pane (plugin/)"]
35
+ Routes --> Hooks[hooks, opencode plugin, agent-tasks]
36
36
  ```
37
37
 
38
38
  ## File Structure
39
39
 
40
40
  ```
41
41
  src/
42
- index.ts Entry point — MCP stdio + dashboard auto-start
42
+ index.ts Entry point — MCP stdio; the REST port holder also runs the background indexer
43
43
  server.ts 6 tool definitions, request routing, error handling
44
44
  tool-handlers.ts Action dispatch for each MCP tool + the v1.8 `promote` action
45
- dashboard.ts HTTP + WebSocket server, REST API, file watcher
46
- package-meta.ts Cached name/version from package.json (used by getVersion / MCP / dashboard)
45
+ rest-server.ts REST server on 127.0.0.1 — startRestServer, serveRestWhenFree (leader election + takeover)
46
+ transport/ rest.ts (routes), http.ts (json, readBody, Router), guard.ts (Host / Origin / Content-Type)
47
+ events.ts Live event ring (POST /api/events, read by the pane)
48
+ package-meta.ts Cached name/version from package.json (used by getVersion / MCP / REST)
47
49
  types.ts KnowledgeConfig interface, getConfig(), getVersion()
48
50
  wakeup.ts Token-budgeted L0 identity + L1 top-weighted entry renderer
49
51
  knowledge/
@@ -79,14 +81,12 @@ src/
79
81
  types.ts SearchResult, SearchOptions interfaces
80
82
  vectorstore/ sqlite-vec wrapper + chunker
81
83
  embeddings/ Pluggable embedding providers (openai / claude / gemini / local)
82
- ui/
83
- index.html Dashboard SPA
84
- styles.css MD3 design tokens (light + dark)
85
- app.js Client-side JS (WebSocket, tabs, rendering)
84
+
85
+ plugin/ Claude Code plugin — .mcp.json, skills/knowledge-ingest, the /knowledge pane mod (hooks/)
86
86
 
87
87
  scripts/
88
88
  hooks/
89
- session-start.js SessionStart — dashboard URL + auto-wakeup injection
89
+ session-start.js SessionStart — names the /knowledge pane + L0 identity injection
90
90
  first-prompt-inject.mjs UserPromptSubmit — v1.8 query-targeted knowledge inject on the first real prompt
91
91
  precompact-flush.mjs PreCompact — disk dump + save-unsaved-context nudge
92
92
  precompact-distill.mjs PreCompact — lightweight user-prompt snapshot
@@ -252,7 +252,7 @@ Detects near-duplicate knowledge entries using TF-IDF similarity scoring.
252
252
 
253
253
  **`checkDuplicates()`** — called after `knowledge { action: "write" }`. Builds a TF-IDF index from all entries, queries with the written content, and returns entries exceeding a configurable similarity threshold (default: 0.6). Warnings are included in the write response.
254
254
 
255
- **`consolidate()`** — batch scan for `knowledge_consolidate`. Computes pairwise TF-IDF similarities for all entries in a category (or globally), groups entries above threshold (default: 0.5) into clusters using union-find, and returns clusters with representative entries and pairwise similarity scores.
255
+ **`consolidate()`** — batch scan for `knowledge_analyze` action `consolidate`. Computes pairwise TF-IDF similarities for all entries in a category (or globally), groups entries above threshold (default: 0.5) into clusters using union-find, and returns clusters with representative entries and pairwise similarity scores.
256
256
 
257
257
  ## Reflection Cycle
258
258
 
@@ -264,7 +264,7 @@ Surfaces unconnected knowledge entries and prepares structured prompts for agent
264
264
 
265
265
  1. Unconnected entries with titles, categories, tags, and 300-char content summaries
266
266
  2. Connected entries as potential link targets
267
- 3. Instructions for the agent to call `knowledge_link` with suggested relationships
267
+ 3. Instructions for the agent to call `knowledge_graph` action `link` with suggested relationships
268
268
 
269
269
  Does NOT call an LLM — the calling agent processes the prompt in its own context and makes `knowledge_graph(action: "link")` calls based on its analysis.
270
270
 
@@ -409,26 +409,15 @@ The `1 +` in IDF ensures single-document results still get a positive score.
409
409
 
410
410
  Levenshtein edit distance with two-row DP (O(n\*m) time, O(m) space). Fuzzy matching uses a sliding window of varying size to find approximate substring matches.
411
411
 
412
- ## Dashboard
413
-
414
- ### dashboard.ts
415
-
416
- Single HTTP server handles REST API, write endpoint, and static files:
417
-
418
- - **Static serving**: resolves UI directory (checks `src/ui/` then `dist/ui/`), serves with MIME detection and CSP headers
419
- - **REST API (GET)**: routes for knowledge search, session list/search/recall/get/summary, health, graph analysis
420
- - **REST API (POST)**: `POST /api/knowledge` — write entry with full pipeline (git pull, write, embed, auto-link, git push). POST restricted to `/api/` paths.
421
- - **WebSocket**: `ws` library with `noServer` mode, heartbeat every 30s, initial state snapshot on connect
422
- - **File watcher**: `fs.watch` on UI directory, debounced 200ms, broadcasts `{type: "reload"}` to all WS clients
412
+ ## REST server
423
413
 
424
- ### UI Architecture
414
+ ### rest-server.ts
425
415
 
426
- Vanilla JS SPA (no framework, no build step):
416
+ One process serves the REST API: the first MCP process to bind `127.0.0.1:AGENT_KNOWLEDGE_PORT` (default 3423). The others retry every 5 s (`serveRestWhenFree`), so one of them takes over when the serving session exits; the holder also starts the background session indexer. There is no web UI and no WebSocket (removed in 2.0); the `/knowledge` pane in `plugin/` polls the routes.
427
417
 
428
- - WebSocket connects on load, handles `state` and `reload` messages
429
- - 4 tabs with lazy data loading
430
- - `marked` + `DOMPurify` + `highlight.js` for markdown rendering
431
- - Theme persisted in `localStorage('agent-knowledge-theme')`
418
+ - **Guard** (`transport/guard.ts`, every request): `Host` must be a loopback name with the port (defeats DNS rebinding), any `Origin` is refused (no browser is a caller), a body on POST/PUT/PATCH/DELETE must be `application/json`. No CORS headers.
419
+ - **Routes** (`transport/rest.ts`): health, overview, entry list/read/links/delete/write/sync, search, analysis, sessions list/search/summary, events. `POST /api/knowledge` runs the full write pipeline (git pull, write, embed, auto-link, git push).
420
+ - **No rate limiter**: every caller shares the loopback address, so one bucket would throttle every pane and hook at once; any local process can read the files anyway.
432
421
 
433
422
  ## Caching Strategy
434
423
 
@@ -501,7 +490,7 @@ Two write paths exist — MCP (stdio) and REST (HTTP). Both run the same pipelin
501
490
  sequenceDiagram
502
491
  participant C as Agent Session
503
492
  participant S as MCP Server
504
- participant D as Dashboard (REST)
493
+ participant D as REST server
505
494
  participant G as Git
506
495
  participant F as File System
507
496
  participant V as Vector Store
package/docs/HOOKS.md CHANGED
@@ -9,7 +9,7 @@ returns an empty JSON object so the user is never blocked.
9
9
 
10
10
  | Script | Event | Purpose |
11
11
  | -------------------------- | ---------------- | ------------------------------------------------------------------------ |
12
- | `session-start.js` | SessionStart | Announces dashboard URL + auto-loads wakeup payload into context |
12
+ | `session-start.js` | SessionStart | Names the `/knowledge` pane + auto-loads the L0 identity into context |
13
13
  | `session-start-ingest.mjs` | SessionStart | Detects project + reports knowledge-ingest cache drift via SHA256 diff |
14
14
  | `first-prompt-inject.mjs` | UserPromptSubmit | Injects query-targeted knowledge hits on the session's first real prompt |
15
15
  | `precompact-flush.mjs` | PreCompact | Rich session summary on disk + save-unsaved-context nudge into context |
@@ -20,8 +20,9 @@ returns an empty JSON object so the user is never blocked.
20
20
 
21
21
  Four jobs:
22
22
 
23
- 1. Prints the dashboard URL (`http://localhost:3423` by default, override via
24
- `AGENT_KNOWLEDGE_PORT`) and injects it into SessionStart `additionalContext`.
23
+ 1. Says where the person browses the knowledge base (the `/knowledge` pane of
24
+ the agent-knowledge plugin), in the `systemMessage` and in SessionStart
25
+ `additionalContext`.
25
26
  2. Auto-loads the **L0 identity** section (who the user is — query-agnostic
26
27
  facts from `~/agent-knowledge/identity.md`) into the same
27
28
  `additionalContext`, so every session starts with that context without a
@@ -49,17 +50,17 @@ still call `knowledge(action="wakeup")` manually, or flip
49
50
  Also emits a user-visible `systemMessage` on every session start with a
50
51
  status suffix so the user can always tell the hook ran:
51
52
 
52
- - `agent-knowledge: http://localhost:3423 | identity: 312 chars` — when a
53
+ - `agent-knowledge: /knowledge | identity: 312 chars` — when a
53
54
  user-authored `identity.md` was loaded.
54
- - `agent-knowledge: http://localhost:3423 | identity: onboarding pending` —
55
+ - `agent-knowledge: /knowledge | identity: onboarding pending` —
55
56
  when no identity file exists and onboarding is queued (agent will ask
56
57
  the user on the next prompt).
57
- - `agent-knowledge: http://localhost:3423 | identity: declined (delete ~/agent-knowledge/.identity-declined to redo)` —
58
+ - `agent-knowledge: /knowledge | identity: declined (delete ~/agent-knowledge/.identity-declined to redo)` —
58
59
  when the user previously opted out.
59
- - `agent-knowledge: http://localhost:3423 | identity: placeholder (no identity.md) · inject rearmed` —
60
+ - `agent-knowledge: /knowledge | identity: placeholder (no identity.md) · inject rearmed` —
60
61
  fallback for edge cases (e.g. stat errors), with `· inject rearmed` when
61
62
  the first-prompt-inject marker was cleared.
62
- - `agent-knowledge: http://localhost:3423 | autowake off · resume` — when
63
+ - `agent-knowledge: /knowledge | autowake off · resume` — when
63
64
  `AGENT_KNOWLEDGE_AUTOWAKE=0` disables auto-injection.
64
65
 
65
66
  The model-facing context and the user-facing line are separate channels —
@@ -70,12 +71,11 @@ pre-loaded and whether the next prompt will trigger query-targeted injection.
70
71
 
71
72
  | Variable | Default | Description |
72
73
  | ------------------------------- | ------- | ------------------------------------------------------- |
73
- | `AGENT_KNOWLEDGE_PORT` | `3423` | Dashboard port announced in the context line |
74
74
  | `AGENT_KNOWLEDGE_AUTOWAKE` | `1` | Set `0` / `false` to skip the identity auto-injection |
75
75
  | `AGENT_KNOWLEDGE_WAKEUP_BUDGET` | `200` | Max tokens (chars/4 estimate) for the L0 identity slice |
76
76
 
77
77
  Requires `npm run build` to have succeeded — if `dist/wakeup.js` is missing,
78
- only the dashboard-URL line is emitted (fail-open).
78
+ only the `/knowledge` line is emitted (fail-open).
79
79
 
80
80
  ## session-start-ingest.mjs
81
81
 
@@ -170,12 +170,12 @@ A one-line breadcrumb is appended to
170
170
  the receipt is durable even when the host tears the transcript down
171
171
  before painting the message.
172
172
 
173
- On a successful distill the hook also POSTs the receipt to the dashboard's
174
- `POST /api/events` endpoint (port from `AGENT_KNOWLEDGE_PORT`, default
175
- 3423). If the dashboard is open, a live toast appears top-right the moment
176
- the session ends — covers hosts (like Claude Code `/exit`) that swallow
177
- `systemMessage` on SessionEnd. Fails open on ECONNREFUSED / timeout; set
178
- `AGENT_KNOWLEDGE_DASHBOARD_EVENTS=0` to suppress the POST entirely.
173
+ On a successful distill the hook also POSTs the receipt to the REST
174
+ server's `POST /api/events` (port from `AGENT_KNOWLEDGE_PORT`, default
175
+ 3423), where the `/knowledge` pane picks it up — covers hosts (like Claude
176
+ Code `/exit`) that swallow `systemMessage` on SessionEnd. Fails open on
177
+ ECONNREFUSED / timeout; set `AGENT_KNOWLEDGE_EVENTS=0` to suppress the POST
178
+ entirely.
179
179
 
180
180
  ## Manual configuration
181
181
 
package/docs/INGEST.md CHANGED
@@ -239,7 +239,7 @@ Installs to both `~/.claude/skills/knowledge-ingest/` and `~/.agents/skills/know
239
239
 
240
240
  ### Manual
241
241
 
242
- Copy `skills/knowledge-ingest/SKILL.md` to either location:
242
+ Copy `plugin/skills/knowledge-ingest/SKILL.md` to either location:
243
243
 
244
244
  ```bash
245
245
  ~/.claude/skills/knowledge-ingest/SKILL.md # Claude Code, OpenCode, Cursor