agent-knowledge 1.1.6 → 1.2.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.
package/dist/ui/app.js CHANGED
@@ -40,6 +40,8 @@
40
40
  knowledgeGrid: $('knowledge-grid'),
41
41
  knowledgeEmpty: $('knowledge-empty'),
42
42
  knowledgeCategories: $('knowledge-categories'),
43
+ knowledgeSearchInput: $('knowledge-search-input'),
44
+ knowledgeSearchResults: $('knowledge-search-results'),
43
45
  searchInput: $('search-input'),
44
46
  searchResults: $('search-results'),
45
47
  searchEmpty: $('search-empty'),
@@ -396,11 +398,17 @@
396
398
  .join('');
397
399
  const time = relativeTime(entry.updated || entry.created);
398
400
 
401
+ const maturity = entry.maturity || 'candidate';
402
+ const accessCount = entry.access_count || 0;
403
+
399
404
  return `<div class="knowledge-card" data-path="${esc(entry.path || entry.id || '')}" tabindex="0" role="button">
400
- <span class="card-category" data-cat="${esc(cat)}">
401
- <span class="material-symbols-outlined" style="font-size:14px">${icon}</span>
402
- ${esc(cat)}
403
- </span>
405
+ <div class="card-header-row">
406
+ <span class="card-category" data-cat="${esc(cat)}">
407
+ <span class="material-symbols-outlined" style="font-size:14px">${icon}</span>
408
+ ${esc(cat)}
409
+ </span>
410
+ <span class="maturity-badge" data-maturity="${esc(maturity)}">${esc(maturity)}${accessCount > 0 ? ` <span class="maturity-reads">&middot; ${accessCount} reads</span>` : ''}</span>
411
+ </div>
404
412
  ${time ? `<span class="card-date">${time}</span>` : ''}
405
413
  <div class="card-title">${esc(title)}</div>
406
414
  ${tags ? `<div class="card-tags">${tags}</div>` : ''}
@@ -419,15 +427,97 @@
419
427
  async function openKnowledgePanel(path) {
420
428
  if (!path) return;
421
429
  try {
422
- const data = await api(`/knowledge/${encodeURIComponent(path)}`);
430
+ const [entryRes, linksRes] = await Promise.allSettled([
431
+ api(`/knowledge/${encodeURIComponent(path)}`),
432
+ api(`/knowledge/${encodeURIComponent(path)}/links`),
433
+ ]);
434
+ const data = entryRes.status === 'fulfilled' ? entryRes.value : {};
435
+ const links = linksRes.status === 'fulfilled' ? linksRes.value : [];
423
436
  const title = data.title || data.path || path;
424
437
  const content = data.content || data.body || '';
425
- openPanel('knowledge', { title, content, meta: data });
438
+ openPanel('knowledge', { title, content, meta: data, links, entryPath: path });
426
439
  } catch (err) {
427
440
  toast(`Failed to load entry: ${err.message}`, 'error');
428
441
  }
429
442
  }
430
443
 
444
+ // ── Knowledge Search ───────────────────────────────────────────────────────
445
+
446
+ const doKnowledgeSearch = debounce(async () => {
447
+ const q = (el.knowledgeSearchInput ? el.knowledgeSearchInput.value : '').trim();
448
+ if (!q) {
449
+ el.knowledgeSearchResults.style.display = 'none';
450
+ el.knowledgeGrid.style.display = '';
451
+ el.knowledgeEmpty.classList.add('hidden');
452
+ renderKnowledge();
453
+ return;
454
+ }
455
+ try {
456
+ const params = new URLSearchParams({ q, max_results: '20' });
457
+ const cat = state.knowledge.activeCategory;
458
+ if (cat !== 'all') params.set('category', cat);
459
+ const results = await api(`/knowledge/search?${params}`);
460
+ renderKnowledgeSearchResults(Array.isArray(results) ? results : [], q);
461
+ } catch (err) {
462
+ toast(`Knowledge search failed: ${err.message}`, 'error');
463
+ }
464
+ }, 300);
465
+
466
+ function renderKnowledgeSearchResults(results, query) {
467
+ if (results.length === 0) {
468
+ el.knowledgeSearchResults.style.display = 'none';
469
+ el.knowledgeGrid.style.display = 'none';
470
+ el.knowledgeEmpty.classList.remove('hidden');
471
+ el.knowledgeEmpty.querySelector('.empty-text').textContent = 'No results found';
472
+ el.knowledgeEmpty.querySelector('.empty-hint').textContent =
473
+ `No knowledge entries match "${query}"`;
474
+ return;
475
+ }
476
+
477
+ el.knowledgeEmpty.classList.add('hidden');
478
+ el.knowledgeGrid.style.display = 'none';
479
+ el.knowledgeSearchResults.style.display = '';
480
+ el.knowledgeSearchResults.innerHTML = results
481
+ .map((r) => {
482
+ const title = r.title || r.path || '';
483
+ const excerpt = r.excerpt || '';
484
+ const score = r.score;
485
+ const maturity = r.maturity || 'candidate';
486
+ const accessCount = r.access_count || 0;
487
+ const decayF = r.decay_factor;
488
+ const matMult = r.maturity_multiplier;
489
+ const path = r.path || '';
490
+
491
+ let scoreBreakdown = '';
492
+ if (score != null) {
493
+ const parts = [];
494
+ parts.push(`relevance: ${score.toFixed(2)}`);
495
+ if (decayF != null) parts.push(`decay: ${decayF.toFixed(2)}`);
496
+ if (matMult != null) parts.push(`maturity: x${matMult.toFixed(1)}`);
497
+ const finalScore = score * (decayF || 1) * (matMult || 1);
498
+ scoreBreakdown = `<div class="score-breakdown">Score: ${finalScore.toFixed(2)} (${parts.join(' \u00d7 ')})</div>`;
499
+ }
500
+
501
+ return `<div class="result-item knowledge-result-item" data-path="${esc(path)}" tabindex="0" role="button">
502
+ <div class="result-meta">
503
+ <span class="maturity-badge" data-maturity="${esc(maturity)}">${esc(maturity)}${accessCount > 0 ? ` <span class="maturity-reads">&middot; ${accessCount} reads</span>` : ''}</span>
504
+ <span class="result-entry-title">${esc(title)}</span>
505
+ ${score != null ? `<span class="score-container">${formatScore(score, {})}</span>` : ''}
506
+ </div>
507
+ <div class="result-excerpt">${highlightExcerpt(excerpt, query)}</div>
508
+ ${scoreBreakdown}
509
+ </div>`;
510
+ })
511
+ .join('');
512
+
513
+ el.knowledgeSearchResults.querySelectorAll('.knowledge-result-item').forEach((card) => {
514
+ card.addEventListener('click', () => openKnowledgePanel(card.dataset.path));
515
+ card.addEventListener('keydown', (e) => {
516
+ if (e.key === 'Enter') openKnowledgePanel(card.dataset.path);
517
+ });
518
+ });
519
+ }
520
+
431
521
  // ── Search ─────────────────────────────────────────────────────────────────
432
522
 
433
523
  const doSearch = debounce(async () => {
@@ -720,17 +810,52 @@
720
810
  const category = entry.category || meta.category || '';
721
811
  const tags = entry.tags || meta.tags || [];
722
812
  const updated = entry.updated || meta.updated || '';
813
+ const maturity = meta.maturity || 'candidate';
814
+ const accessCount = meta.access_count || 0;
723
815
 
724
816
  let metaHtml = '<div class="panel-meta">';
725
817
  if (category)
726
818
  metaHtml += `<span class="card-category" data-cat="${esc(category)}">${esc(category)}</span>`;
819
+ metaHtml += `<span class="maturity-badge" data-maturity="${esc(maturity)}">${esc(maturity)}${accessCount > 0 ? ` <span class="maturity-reads">&middot; ${accessCount} reads</span>` : ''}</span>`;
727
820
  if (tags.length)
728
821
  metaHtml += tags.map((t) => `<span class="card-tag">${esc(t)}</span>`).join('');
729
822
  if (updated) metaHtml += `<span class="panel-meta-date">${esc(updated)}</span>`;
730
823
  metaHtml += '</div>';
731
824
 
732
825
  const body = stripFrontmatter(data.content);
733
- el.panelBody.innerHTML = metaHtml + `<div class="prose">${renderMd(body)}</div>`;
826
+ let html = metaHtml + `<div class="prose">${renderMd(body)}</div>`;
827
+
828
+ // Related entries section
829
+ const links = data.links || [];
830
+ if (links.length > 0) {
831
+ const entryPath = data.entryPath || '';
832
+ html += '<div class="panel-section related-section">';
833
+ html +=
834
+ '<h4 class="panel-section-title"><span class="material-symbols-outlined" style="font-size:16px;vertical-align:middle;margin-right:4px">hub</span>Related</h4>';
835
+ html += '<div class="related-entries">';
836
+ links.forEach((link) => {
837
+ const linkedPath = link.source === entryPath ? link.target : link.source;
838
+ const relType = link.rel_type || 'related_to';
839
+ const strength = link.strength != null ? link.strength : 0.5;
840
+ const linkedTitle = linkedPath.split('/').pop().replace(/\.md$/, '').replace(/[-_]/g, ' ');
841
+ html += `<div class="related-entry" data-path="${esc(linkedPath)}" tabindex="0" role="button">
842
+ <span class="rel-type-pill" data-rel="${esc(relType)}">${esc(relType.replace(/_/g, ' '))}</span>
843
+ <span class="related-entry-title">${esc(linkedTitle)}</span>
844
+ <span class="related-entry-strength" title="Strength: ${strength.toFixed(2)}">${(strength * 100).toFixed(0)}%</span>
845
+ </div>`;
846
+ });
847
+ html += '</div></div>';
848
+ }
849
+
850
+ el.panelBody.innerHTML = html;
851
+
852
+ // Bind click handlers on related entries
853
+ el.panelBody.querySelectorAll('.related-entry').forEach((entryEl) => {
854
+ entryEl.addEventListener('click', () => openKnowledgePanel(entryEl.dataset.path));
855
+ entryEl.addEventListener('keydown', (e) => {
856
+ if (e.key === 'Enter') openKnowledgePanel(entryEl.dataset.path);
857
+ });
858
+ });
734
859
  }
735
860
 
736
861
  function renderSessionPanel(data) {
@@ -859,6 +984,13 @@
859
984
  renderKnowledge();
860
985
  });
861
986
 
987
+ // Knowledge search input
988
+ if (el.knowledgeSearchInput) {
989
+ el.knowledgeSearchInput.addEventListener('input', () => {
990
+ doKnowledgeSearch();
991
+ });
992
+ }
993
+
862
994
  // Search input
863
995
  el.searchInput.addEventListener('input', () => {
864
996
  state.search.query = el.searchInput.value;
@@ -140,6 +140,18 @@
140
140
  <span class="material-symbols-outlined chip-icon">sticky_note_2</span>Notes
141
141
  </button>
142
142
  </div>
143
+ <div class="search-bar knowledge-search-bar">
144
+ <span class="material-symbols-outlined search-input-icon">search</span>
145
+ <input
146
+ type="search"
147
+ id="knowledge-search-input"
148
+ class="search-input"
149
+ placeholder="Search knowledge entries..."
150
+ autocomplete="off"
151
+ aria-label="Search knowledge entries"
152
+ />
153
+ </div>
154
+ <div id="knowledge-search-results" class="results-list" style="display: none"></div>
143
155
  <div id="knowledge-grid" class="card-grid"></div>
144
156
  <div id="knowledge-empty" class="empty-state hidden">
145
157
  <span class="material-symbols-outlined empty-icon">folder_off</span>
@@ -1493,6 +1493,176 @@ h1 {
1493
1493
  color: var(--text-secondary);
1494
1494
  }
1495
1495
 
1496
+ /* ── Maturity Badge ───────────────────────────────────────────────────── */
1497
+ .maturity-badge {
1498
+ display: inline-flex;
1499
+ align-items: center;
1500
+ gap: 2px;
1501
+ font-size: 10px;
1502
+ font-weight: 600;
1503
+ padding: 2px 8px;
1504
+ border-radius: 10px;
1505
+ text-transform: uppercase;
1506
+ letter-spacing: 0.3px;
1507
+ }
1508
+
1509
+ .maturity-badge[data-maturity='candidate'] {
1510
+ background: var(--bg-hover);
1511
+ color: var(--text-muted);
1512
+ }
1513
+
1514
+ .maturity-badge[data-maturity='established'] {
1515
+ background: var(--blue-dim);
1516
+ color: var(--blue);
1517
+ }
1518
+
1519
+ .maturity-badge[data-maturity='proven'] {
1520
+ background: var(--green-dim);
1521
+ color: var(--green);
1522
+ }
1523
+
1524
+ .maturity-reads {
1525
+ font-weight: 500;
1526
+ font-size: 10px;
1527
+ opacity: 0.8;
1528
+ }
1529
+
1530
+ .card-header-row {
1531
+ display: flex;
1532
+ align-items: center;
1533
+ justify-content: space-between;
1534
+ gap: 6px;
1535
+ margin-bottom: 8px;
1536
+ }
1537
+
1538
+ /* ── Related Entries ──────────────────────────────────────────────────── */
1539
+ .related-section {
1540
+ margin-top: 20px;
1541
+ border-top: 1px solid var(--border-light);
1542
+ padding-top: 16px;
1543
+ }
1544
+
1545
+ .related-entries {
1546
+ display: flex;
1547
+ flex-direction: column;
1548
+ gap: 6px;
1549
+ }
1550
+
1551
+ .related-entry {
1552
+ display: flex;
1553
+ align-items: center;
1554
+ gap: 8px;
1555
+ padding: 8px 12px;
1556
+ background: var(--bg-elevated);
1557
+ border: 1px solid transparent;
1558
+ border-radius: var(--radius-sm);
1559
+ cursor: pointer;
1560
+ transition:
1561
+ background var(--transition-fast),
1562
+ border-color var(--transition-fast);
1563
+ }
1564
+
1565
+ .related-entry:hover {
1566
+ background: var(--bg-hover);
1567
+ border-color: var(--accent);
1568
+ }
1569
+
1570
+ .related-entry:focus-visible {
1571
+ outline: 2px solid var(--accent);
1572
+ outline-offset: 1px;
1573
+ }
1574
+
1575
+ .rel-type-pill {
1576
+ display: inline-flex;
1577
+ align-items: center;
1578
+ font-size: 10px;
1579
+ font-weight: 600;
1580
+ padding: 2px 8px;
1581
+ border-radius: 10px;
1582
+ text-transform: uppercase;
1583
+ letter-spacing: 0.3px;
1584
+ white-space: nowrap;
1585
+ flex-shrink: 0;
1586
+ }
1587
+
1588
+ .rel-type-pill[data-rel='related_to'] {
1589
+ background: var(--accent-dim);
1590
+ color: var(--accent);
1591
+ }
1592
+
1593
+ .rel-type-pill[data-rel='depends_on'] {
1594
+ background: var(--orange-dim);
1595
+ color: var(--orange);
1596
+ }
1597
+
1598
+ .rel-type-pill[data-rel='supersedes'] {
1599
+ background: var(--red-dim);
1600
+ color: var(--red);
1601
+ }
1602
+
1603
+ .rel-type-pill[data-rel='contradicts'] {
1604
+ background: var(--red-dim);
1605
+ color: var(--red);
1606
+ }
1607
+
1608
+ .rel-type-pill[data-rel='specializes'] {
1609
+ background: var(--purple-dim);
1610
+ color: var(--purple);
1611
+ }
1612
+
1613
+ .rel-type-pill[data-rel='part_of'] {
1614
+ background: var(--blue-dim);
1615
+ color: var(--blue);
1616
+ }
1617
+
1618
+ .rel-type-pill[data-rel='alternative_to'] {
1619
+ background: var(--yellow-dim);
1620
+ color: var(--yellow);
1621
+ }
1622
+
1623
+ .rel-type-pill[data-rel='builds_on'] {
1624
+ background: var(--green-dim);
1625
+ color: var(--green);
1626
+ }
1627
+
1628
+ .related-entry-title {
1629
+ font-size: 13px;
1630
+ font-weight: 500;
1631
+ color: var(--text);
1632
+ flex: 1;
1633
+ overflow: hidden;
1634
+ text-overflow: ellipsis;
1635
+ white-space: nowrap;
1636
+ }
1637
+
1638
+ .related-entry-strength {
1639
+ font-size: 10px;
1640
+ font-weight: 600;
1641
+ font-family: var(--font-mono);
1642
+ color: var(--text-dim);
1643
+ flex-shrink: 0;
1644
+ }
1645
+
1646
+ /* ── Score Breakdown ──────────────────────────────────────────────────── */
1647
+ .score-breakdown {
1648
+ font-size: 11px;
1649
+ font-family: var(--font-mono);
1650
+ color: var(--text-dim);
1651
+ margin-top: 4px;
1652
+ padding: 2px 0;
1653
+ }
1654
+
1655
+ .result-entry-title {
1656
+ font-size: 13px;
1657
+ font-weight: 600;
1658
+ color: var(--text);
1659
+ }
1660
+
1661
+ /* ── Knowledge Search Bar ─────────────────────────────────────────────── */
1662
+ .knowledge-search-bar {
1663
+ margin-bottom: 16px;
1664
+ }
1665
+
1496
1666
  /* ── Responsive ────────────────────────────────────────────────────────── */
1497
1667
  @media (max-width: 1024px) {
1498
1668
  .side-panel.open {
@@ -40,13 +40,15 @@ graph TB
40
40
  ```
41
41
  src/
42
42
  index.ts Entry point — MCP stdio + dashboard auto-start
43
- server.ts 12 tool definitions, request routing, error handling
43
+ server.ts 16 tool definitions, request routing, error handling
44
44
  dashboard.ts HTTP + WebSocket server, REST API, file watcher
45
45
  types.ts KnowledgeConfig interface, getConfig()
46
46
  knowledge/
47
47
  store.ts CRUD for markdown entries with YAML frontmatter
48
48
  search.ts TF-IDF search over knowledge entries
49
49
  git.ts git pull/push/sync with execSync + timeouts
50
+ graph.ts Knowledge graph — edges table, link/unlink/BFS traversal
51
+ scoring.ts Confidence/decay scoring — entry_scores table, auto-promotion
50
52
  sessions/
51
53
  parser.ts Multi-format parsing with mtime cache + adapter dispatch
52
54
  search.ts TF-IDF ranked search with 60s global index cache
@@ -92,6 +94,69 @@ Wraps `execSync` for git operations with timeouts:
92
94
 
93
95
  Builds a TF-IDF index from all knowledge entries, searches with ranking, falls back to regex for exact phrases.
94
96
 
97
+ ## Knowledge Graph
98
+
99
+ ### graph.ts
100
+
101
+ Manages typed, weighted edges between knowledge entries in a dedicated `edges` SQLite table.
102
+
103
+ **Schema**:
104
+
105
+ ```sql
106
+ CREATE TABLE edges (
107
+ source TEXT NOT NULL,
108
+ target TEXT NOT NULL,
109
+ rel_type TEXT NOT NULL,
110
+ strength REAL DEFAULT 1.0,
111
+ created TEXT NOT NULL,
112
+ PRIMARY KEY (source, target, rel_type)
113
+ );
114
+ ```
115
+
116
+ **8 relationship types**: `related_to`, `supersedes`, `depends_on`, `contradicts`, `specializes`, `part_of`, `alternative_to`, `builds_on`.
117
+
118
+ **Operations**:
119
+
120
+ - **link()** — upsert an edge (INSERT OR REPLACE), validates rel_type against allowed set
121
+ - **unlink()** — delete edges, optionally filtered by rel_type
122
+ - **links()** — list edges for a given entry or rel_type
123
+ - **traverse()** — BFS from a starting entry to configurable depth, returns nodes and edges visited
124
+
125
+ **Auto-linking**: On `knowledge_write`, the top-3 most similar existing entries are found via cosine similarity against the vector store. Entries with similarity > 0.7 get automatic `related_to` edges created.
126
+
127
+ ## Confidence & Decay Scoring
128
+
129
+ ### scoring.ts
130
+
131
+ Tracks access frequency and recency for search result ranking via an `entry_scores` SQLite table.
132
+
133
+ **Schema**:
134
+
135
+ ```sql
136
+ CREATE TABLE entry_scores (
137
+ path TEXT PRIMARY KEY,
138
+ access_count INTEGER DEFAULT 0,
139
+ last_accessed TEXT NOT NULL,
140
+ maturity TEXT DEFAULT 'candidate'
141
+ );
142
+ ```
143
+
144
+ **Scoring formula**:
145
+
146
+ ```
147
+ finalScore = baseRelevance * 0.5^(daysSinceLastAccess / 90) * maturityMultiplier
148
+ ```
149
+
150
+ **Maturity auto-promotion**:
151
+
152
+ | Stage | Accesses | Multiplier |
153
+ | ------------- | -------- | ---------- |
154
+ | `candidate` | < 5 | 0.5x |
155
+ | `established` | 5-19 | 1.0x |
156
+ | `proven` | 20+ | 1.5x |
157
+
158
+ Access count increments on `knowledge_read`. Maturity transitions happen automatically when thresholds are crossed. Search results from `knowledge_search` apply the decay formula to blend relevance with freshness and confidence.
159
+
95
160
  ## Session Module
96
161
 
97
162
  ### Multi-Source Architecture
package/docs/DASHBOARD.md CHANGED
@@ -16,12 +16,15 @@ The dashboard runs at **http://localhost:3423** and auto-starts with the MCP ser
16
16
  Card grid of knowledge entries. Each card shows:
17
17
 
18
18
  - Category badge with color: projects (blue), people (purple), decisions (orange), workflows (green), notes (yellow)
19
+ - **Maturity badge**: candidate (gray), established (blue), proven (green) — based on access frequency
19
20
  - Title and tag pills
20
21
  - Last updated date
21
22
 
22
- Category filter chips at the top: All, Projects, People, Decisions, Workflows, Notes.
23
+ ![Knowledge entries with maturity badges](assets/knowledge-maturity.png)
23
24
 
24
- Click a card to open the side panel with rendered markdown content.
25
+ Category filter chips at the top: All, Projects, People, Decisions, Workflows, Notes. Search bar for filtering entries by title.
26
+
27
+ Click a card to open the side panel with rendered markdown content, score details, and related entries.
25
28
 
26
29
  ## Search Tab
27
30
 
@@ -78,6 +81,8 @@ Results use the same format as the Search tab.
78
81
  - Width: 560px, resizable by dragging the left edge
79
82
  - Close: X button or press Escape
80
83
  - Knowledge entries: rendered as markdown via marked + DOMPurify + highlight.js
84
+ - **Related entries**: linked entries shown with colored relationship-type pills (related_to, depends_on, supersedes, etc.) — clickable to navigate
85
+ - **Score details**: maturity level, access count, decay factor, and maturity multiplier
81
86
  - Sessions: chat bubbles (user = right/accent, assistant = left/surface)
82
87
 
83
88
  ## Theming
@@ -100,17 +105,18 @@ File watcher monitors `src/ui/` for `.html`, `.css`, `.js` changes. On change, b
100
105
 
101
106
  ## REST API
102
107
 
103
- | Method | Endpoint | Description |
104
- | ------ | --------------------------------------- | ---------------- |
105
- | GET | `/api/knowledge` | List entries |
106
- | GET | `/api/knowledge/search?q=` | Search knowledge |
107
- | GET | `/api/knowledge/:path` | Read entry |
108
- | GET | `/api/sessions` | List sessions |
109
- | GET | `/api/sessions/search?q=&role=&ranked=` | Search sessions |
110
- | GET | `/api/sessions/recall?scope=&q=` | Scoped recall |
111
- | GET | `/api/sessions/:id` | Read session |
112
- | GET | `/api/sessions/:id/summary` | Session summary |
113
- | GET | `/health` | Health check |
108
+ | Method | Endpoint | Description |
109
+ | ------ | --------------------------------------- | ---------------------------- |
110
+ | GET | `/api/knowledge` | List entries |
111
+ | GET | `/api/knowledge/search?q=` | Search knowledge |
112
+ | GET | `/api/knowledge/:path` | Read entry (with score data) |
113
+ | GET | `/api/knowledge/:path/links` | Graph edges for entry |
114
+ | GET | `/api/sessions` | List sessions |
115
+ | GET | `/api/sessions/search?q=&role=&ranked=` | Search sessions |
116
+ | GET | `/api/sessions/recall?scope=&q=` | Scoped recall |
117
+ | GET | `/api/sessions/:id` | Read session |
118
+ | GET | `/api/sessions/:id/summary` | Session summary |
119
+ | GET | `/health` | Health check |
114
120
 
115
121
  ## WebSocket
116
122
 
package/docs/SETUP.md CHANGED
@@ -174,9 +174,9 @@ Hooks announce the dashboard URL on session start. Support varies by client.
174
174
 
175
175
  ### Claude Code Hooks
176
176
 
177
- #### SessionStart (`scripts/hooks/session-start.js`)
177
+ #### SessionStart + SubagentStart (`scripts/hooks/session-start.js`)
178
178
 
179
- Announces the knowledge dashboard URL on session start.
179
+ Announces the knowledge dashboard URL on session start. Also fires for subagents via `SubagentStart`, ensuring spawned agents know about the knowledge base.
180
180
 
181
181
  Add to `~/.claude/settings.json`:
182
182
 
@@ -193,6 +193,17 @@ Add to `~/.claude/settings.json`:
193
193
  }
194
194
  ]
195
195
  }
196
+ ],
197
+ "SubagentStart": [
198
+ {
199
+ "hooks": [
200
+ {
201
+ "type": "command",
202
+ "command": "node \"/path/to/agent-knowledge/scripts/hooks/session-start.js\"",
203
+ "timeout": 5
204
+ }
205
+ ]
206
+ }
196
207
  ]
197
208
  }
198
209
  }
@@ -236,12 +247,15 @@ Add these instructions:
236
247
  You have access to agent-knowledge MCP tools — a shared knowledge base synced via git.
237
248
 
238
249
  Available tools: knowledge_list, knowledge_read, knowledge_write, knowledge_search,
239
- knowledge_recall, knowledge_sessions, knowledge_config, knowledge_sync
250
+ knowledge_recall, knowledge_sessions, knowledge_config, knowledge_sync,
251
+ knowledge_link, knowledge_unlink, knowledge_links, knowledge_graph
240
252
 
241
253
  Categories: projects, people, decisions, workflows, notes
242
254
 
243
255
  Use knowledge_search for semantic + keyword search across all entries.
244
256
  Use knowledge_recall for scoped search (errors, plans, configs, tools, files, decisions).
257
+ Use knowledge_link/knowledge_unlink to manage relationships between entries.
258
+ Use knowledge_graph to explore connections from any entry via BFS traversal.
245
259
 
246
260
  Dashboard: http://localhost:3423
247
261
  ```
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "agent-knowledge",
3
- "version": "1.1.6",
4
- "description": "Cross-session memory and recall for AI agents — git-synced knowledge base, hybrid semantic+TF-IDF search, auto-distillation with secrets scrubbing",
3
+ "version": "1.2.0",
4
+ "description": "Cross-session memory and recall for AI agents — git-synced knowledge base, knowledge graph, confidence scoring, hybrid semantic+TF-IDF search, auto-distillation with secrets scrubbing",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
7
7
  "bin": {