agent-knowledge 1.9.2 → 1.9.3
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/.claude-plugin/plugin.json +1 -1
- package/CHANGELOG.md +13 -0
- package/README.md +18 -16
- package/agent-desk-plugin.json +1 -1
- package/package.json +1 -1
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "agent-knowledge",
|
|
3
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.
|
|
4
|
+
"version": "1.9.3",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "keshrath"
|
|
7
7
|
},
|
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,18 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 1.9.3 (2026-04-19) — README showcase rewrite
|
|
4
|
+
|
|
5
|
+
### Changed
|
|
6
|
+
|
|
7
|
+
- **README no longer carries inline version markers** (`(v1.8)`, `(v1.8.1)`, `(v1.8 lifecycle integration)`). The feature list now describes the current state as a single coherent surface — version history lives in this CHANGELOG where it belongs. Moves the README from "changelog-in-bullet-points" to "how it works today".
|
|
8
|
+
- **Section renames to match**: `### Scored promoter (v1.8)` → `### Scored promoter`, `### Hooks (v1.8 lifecycle integration)` → `### Hooks`, `v1.8 search knobs:` → `Search knobs:`.
|
|
9
|
+
- **Wakeup bullet now names the token budget** — 800 default, overridable via `token_budget` param or `AGENT_KNOWLEDGE_WAKEUP_BUDGET` env var. The number was previously only in the env-var table.
|
|
10
|
+
- **Testing block refreshed** — stale `352 tests across 20 files` replaced with the real `558 tests across 35 files`; added `typecheck` and `check` script references so the documented workflow matches what `npm run check` actually runs.
|
|
11
|
+
|
|
12
|
+
### Tests
|
|
13
|
+
|
|
14
|
+
558/558 passing. Docs + metadata only — no source changes.
|
|
15
|
+
|
|
3
16
|
## 1.9.2 (2026-04-19) — doc/setup drift cleanup + HOOKS.md rename
|
|
4
17
|
|
|
5
18
|
### Fixed
|
package/README.md
CHANGED
|
@@ -51,17 +51,17 @@ No configuration needed. Additional session roots can be added via the `AGENT_KN
|
|
|
51
51
|
- **Host-agnostic session search** -- unified search across every major AI coding assistant (Claude Code, Cursor, Codex CLI, Aider, Continue.dev, Cline, OpenCode). No host name is baked into configuration — the adapter registry probes installed host roots at startup.
|
|
52
52
|
- **Hybrid search** -- semantic vector similarity blended with TF-IDF keyword ranking
|
|
53
53
|
- **Git-synced knowledge base** -- markdown vault with YAML frontmatter, auto commit and push on writes
|
|
54
|
-
- **Automatic staleness detection
|
|
55
|
-
- **Search-gap tracking
|
|
56
|
-
- **Section-priority context packer
|
|
57
|
-
- **Scored + gated promoter
|
|
54
|
+
- **Automatic staleness detection** -- `knowledge_analyze(action: "stale_by_code_activity")` cross-references file paths mentioned in each entry body against `filesModified` in recent session summaries. Pairs with a symbol-presence precision layer: identifiers the entry quotes (inline backticks + fenced blocks) are checked in the touched file; if they still exist, confidence downweights ×0.3. Entries with `evergreen: true` are exempt.
|
|
55
|
+
- **Search-gap tracking** -- `knowledge_analyze(action: "search_gaps")` surfaces zero-result queries over the last `since_days`, grouped by token-Jaccard similarity. The clearest signal for "what entries should I write next?".
|
|
56
|
+
- **Section-priority context packer** -- `knowledge(action: "wakeup")` assembles a multi-section bundle (`identity` → `active_tasks` → `recent_decisions` → `known_gotchas` → `last_session_summary` → `top_weighted` → `semantic_fallback`) within a token budget (default 800, override via `token_budget` or `AGENT_KNOWLEDGE_WAKEUP_BUDGET`). Unused section budget redistributes to later sections.
|
|
57
|
+
- **Scored + gated promoter** -- session insights promoted via a 6-signal weighted scorer with three independent gates (`minScore`, `minRecallCount`, `minUniqueQueries`). Runs automatically in background, on demand via `knowledge_admin(action: "promote")`, or benchable offline via `npm run bench:promote`. Emits an auditable `.dreams/YYYY-MM-DD.md` diary every run.
|
|
58
58
|
- **Pluggable adapter system** -- add support for new tools by implementing the `SessionAdapter` interface
|
|
59
59
|
- **Embeddings** -- local (Hugging Face), OpenAI, Claude/Voyage, or Gemini providers
|
|
60
60
|
- **Fuzzy matching** -- typo-tolerant search using Levenshtein distance
|
|
61
61
|
- **6 search scopes** -- errors, plans, configs, tools, files, decisions
|
|
62
62
|
- **6 MCP tools** -- consolidated action-based interface (`knowledge`, `knowledge_search`, `knowledge_session`, `knowledge_graph`, `knowledge_analyze`, `knowledge_admin`)
|
|
63
|
-
- **Evergreen entries
|
|
64
|
-
- **Author attribution
|
|
63
|
+
- **Evergreen entries** -- `evergreen: true` in frontmatter exempts an entry from decay in ranking AND makes it append-only under promotion. Dashboard renders a push-pin badge on these cards.
|
|
64
|
+
- **Author attribution** -- optional `author: <string>` frontmatter surfaces as a muted chip on each card.
|
|
65
65
|
- **Code graph resolution** -- `calls`, `imports`, `inherits` edge types for code structure; directed BFS traversal (`outbound`/`inbound`/`both`); `bulk_link` for efficient ingestion; `unlink_by_origin` for clearing stale code edges before re-ingest; `code:` prefixed node IDs distinguish code from knowledge
|
|
66
66
|
- **Temporal knowledge graph** -- edges support `valid_from` / `valid_to` validity windows; `as_of` queries return point-in-time snapshots; `invalidate` action marks facts as ended without deleting them
|
|
67
67
|
- **Hybrid scoring boosts** -- proper-noun and temporal-proximity boosts on top of TF-IDF + semantic blend, capped at +66.7%, short-circuit when no signals are present
|
|
@@ -81,8 +81,8 @@ No configuration needed. Additional session roots can be added via the `AGENT_KN
|
|
|
81
81
|
- **Knowledge brief** — `knowledge_analyze(action: "brief")` returns a cached ~200 token summary (core concepts, active projects, recent decisions, stale and gap counts) for session-start orientation
|
|
82
82
|
- **Edge provenance** — graph edges track `origin` (manual, auto-link, distill, reflect) so analysis can distinguish user judgment from automated heuristics
|
|
83
83
|
- **Deterministic pre-extraction in distillation** — session summaries now include git commits, error patterns, URLs accessed, and packages changed extracted via regex from bash/tool output (no LLM cost)
|
|
84
|
-
- **Freshness metadata on every search hit
|
|
85
|
-
- **Per-category decay windows
|
|
84
|
+
- **Freshness metadata on every search hit** — every knowledge result carries `freshness: { body_age_days, last_accessed, access_count, verified_at, verification_age_days, evergreen }`. Agent reads the trust signal and decides; we impose no policy demotion.
|
|
85
|
+
- **Per-category decay windows** — the "Unused" filter and bytype chart honor per-category thresholds (projects 180d, people 365d, decisions 90d, workflows 60d, notes 30d) so identity-shaped content doesn't look stale just because it isn't re-read weekly.
|
|
86
86
|
- **Lifecycle hooks** — `SessionStart` auto-wakeup + ingest-freshness check, `UserPromptSubmit` first-prompt targeted injection, `PreCompact` memory-flush nudge + distill, `SessionEnd` distill. Six hook scripts total, all fail-open, each toggleable via an `AGENT_KNOWLEDGE_*` env var. See [`docs/HOOKS.md`](docs/HOOKS.md).
|
|
87
87
|
- **Replaces host auto-memory** — on hosts with a per-session memory system (Claude Code's `~/.claude/projects/*/memory/`, similar in other IDEs), route durable user facts and feedback to agent-knowledge instead. Auto-memory is machine-local and invisible to other machines; agent-knowledge is git-synced, cross-machine, searchable, and surfaces in wakeup. See the Claude Code integration note in [`docs/USER-MANUAL.md`](docs/USER-MANUAL.md#persistent-memory--agent-knowledge-not-host-auto-memory).
|
|
88
88
|
|
|
@@ -163,10 +163,10 @@ Response shape: `{mode: "general" | "scoped", sessions, knowledge}`. Scoped mode
|
|
|
163
163
|
|
|
164
164
|
Scopes: `errors`, `plans`, `configs`, `tools`, `files`, `decisions`, `all`.
|
|
165
165
|
|
|
166
|
-
|
|
166
|
+
Search knobs:
|
|
167
167
|
|
|
168
168
|
- `mmr: true` applies Maximal Marginal Relevance re-ranking (kills near-duplicate clusters in top-K). `mmr_lambda` 0-1, default 0.7.
|
|
169
|
-
- `category_mode: "boost"` (default) gives matching-category entries a 1.25× score multiplier instead of dropping non-matches. Pass `"filter"` for
|
|
169
|
+
- `category_mode: "boost"` (default) gives matching-category entries a 1.25× score multiplier instead of dropping non-matches. Pass `"filter"` for hard-filter behavior.
|
|
170
170
|
- `explain: true` attaches `score_components: {bm25, decay, maturity, confidence, category_boost, mmr_penalty}` to every knowledge hit.
|
|
171
171
|
|
|
172
172
|
### Sessions
|
|
@@ -214,11 +214,11 @@ v1.8 search knobs:
|
|
|
214
214
|
| | `rebuild_embeddings` | Re-embed all knowledge entries (useful on provider switch) | -- |
|
|
215
215
|
| | `prune_orphans` | Delete embeddings for sessions no longer on disk | `vacuum?`, `force_vacuum?` |
|
|
216
216
|
| | `vacuum` | Reclaim free pages in the vector store | -- |
|
|
217
|
-
| | `promote` | Scored + gated promoter
|
|
217
|
+
| | `promote` | Scored + gated promoter | `promote_mode?` (`apply`\|`explain`), `min_score?`, `min_recall_count?`, `min_unique_queries?` |
|
|
218
218
|
|
|
219
|
-
### Scored promoter
|
|
219
|
+
### Scored promoter
|
|
220
220
|
|
|
221
|
-
|
|
221
|
+
Every project-level candidate is scored on six signals (relevance 0.30, frequency 0.24, query-diversity 0.15, recency 0.15, consolidation 0.10, conceptual-richness 0.06) and gated on `minScore ≥ 0.5`, `minRecallCount ≥ 2`, `minUniqueQueries ≥ 2`. All three gates must pass. Background auto-promotion is controlled by the same `auto_distill` config flag; invoke on demand with `knowledge_admin(action: "promote")`.
|
|
222
222
|
|
|
223
223
|
- `promote_mode: "explain"` (default) — score + gate candidates, write diary, DO NOT touch the KB.
|
|
224
224
|
- `promote_mode: "apply"` — promote candidates that pass, write diary, git-commit.
|
|
@@ -383,9 +383,11 @@ This enables HTTP-based writes from other services without an MCP connection.
|
|
|
383
383
|
## Testing
|
|
384
384
|
|
|
385
385
|
```bash
|
|
386
|
-
npm test #
|
|
386
|
+
npm test # 558 tests across 35 files
|
|
387
387
|
npm run test:watch # Watch mode
|
|
388
|
-
npm run lint #
|
|
388
|
+
npm run lint # ESLint on src/ and tests/
|
|
389
|
+
npm run typecheck # tsc --noEmit
|
|
390
|
+
npm run check # typecheck + lint + format + test
|
|
389
391
|
```
|
|
390
392
|
|
|
391
393
|
## Environment Variables
|
|
@@ -424,7 +426,7 @@ Project-scoped overrides win over the standard keys. Set either; the scoped form
|
|
|
424
426
|
| `AGENT_KNOWLEDGE_ANTHROPIC_API_KEY` | `ANTHROPIC_API_KEY` | Claude / Voyage embeddings |
|
|
425
427
|
| `AGENT_KNOWLEDGE_GEMINI_API_KEY` | `GEMINI_API_KEY` | Gemini embeddings |
|
|
426
428
|
|
|
427
|
-
### Hooks
|
|
429
|
+
### Hooks
|
|
428
430
|
|
|
429
431
|
| Variable | Default | Description |
|
|
430
432
|
| -------------------------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
package/agent-desk-plugin.json
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "agent-knowledge",
|
|
3
|
-
"version": "1.9.
|
|
3
|
+
"version": "1.9.3",
|
|
4
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",
|