pi-knowledge 0.4.1 → 0.4.2
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/CHANGELOG.md +6 -0
- package/README.md +25 -6
- package/package.json +11 -2
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,11 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## [0.4.2] - 2026-06-18
|
|
4
|
+
|
|
5
|
+
### Changed
|
|
6
|
+
- Added the `pi-package` npm keyword so the published package can be discovered by Pi's package catalog.
|
|
7
|
+
- Published the updated product positioning metadata introduced after v0.4.1, including local-first RAG, hybrid code/doc search, reranking, diagnostics, and large-project indexing keywords.
|
|
8
|
+
|
|
3
9
|
## [0.4.1] - 2026-06-16
|
|
4
10
|
|
|
5
11
|
### Fixed
|
package/README.md
CHANGED
|
@@ -1,16 +1,33 @@
|
|
|
1
1
|
# pi-knowledge
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Local-first RAG knowledge base for Pi agents.
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
Index your codebase, docs, PDFs, URLs, and notes into persistent knowledge bases that Pi can search across sessions. `pi-knowledge` combines semantic embeddings, BM25 keyword search, code-aware chunking, reranking, diagnostics, and stable large-project indexing so agents can answer from your actual project knowledge instead of guessing.
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
Built as a native [Pi extension](https://pi.dev/docs/latest/extensions), deeply integrated with the agent lifecycle. Designed for local-first project memory, agentic code search, and retrieval-augmented development workflows.
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
## Why It Matters
|
|
10
|
+
|
|
11
|
+
Agents lose project context between sessions and cannot fit large repositories into one prompt. `pi-knowledge` gives Pi durable, searchable project memory:
|
|
12
|
+
|
|
13
|
+
- Search code and documentation by meaning, exact symbols, or both.
|
|
14
|
+
- Keep private source data local by default.
|
|
15
|
+
- Re-index changed files incrementally.
|
|
16
|
+
- Diagnose stale, stuck, or low-quality indexes.
|
|
17
|
+
- Handle large repositories with persisted progress instead of silent hangs.
|
|
10
18
|
|
|
11
19
|
Unlike `pi-memory` (which manages the agent's own notes), `pi-knowledge` indexes **your existing files** and makes them semantically searchable by the agent.
|
|
12
20
|
|
|
13
|
-
##
|
|
21
|
+
## Highlights
|
|
22
|
+
|
|
23
|
+
- **Local-first project memory**: stores indexes under `~/.pi/knowledge/`; no project files are modified.
|
|
24
|
+
- **Hybrid retrieval**: semantic vectors + BM25 keyword search + normalized weighted score fusion.
|
|
25
|
+
- **Code-aware indexing**: AST-aware chunking for TypeScript/JavaScript, Python, Go, Rust, and Java.
|
|
26
|
+
- **Better agent answers**: adaptive context windows, diversity reranking, optional cross-encoder reranking, and diagnostics.
|
|
27
|
+
- **Large-project stability**: persisted indexing progress, capped batches, streaming vector scans, and stuck-job detection.
|
|
28
|
+
- **Private by default**: local embeddings run without an API key.
|
|
29
|
+
|
|
30
|
+
## Feature Comparison
|
|
14
31
|
|
|
15
32
|
| Feature | pi-knowledge | kiro-cli knowledge | pi-memory |
|
|
16
33
|
|---------|:---:|:---:|:---:|
|
|
@@ -33,9 +50,11 @@ Unlike `pi-memory` (which manages the agent's own notes), `pi-knowledge` indexes
|
|
|
33
50
|
| Pi extension native | ✅ | N/A | ✅ |
|
|
34
51
|
| Context injection per turn | ✅ | ❌ | ✅ |
|
|
35
52
|
| Search result TUI rendering | ✅ | N/A | ❌ |
|
|
36
|
-
| Full tool TUI rendering |
|
|
53
|
+
| Full tool TUI rendering | partial | N/A | ❌ |
|
|
37
54
|
| RPC mode support | ✅ | N/A | N/A |
|
|
38
55
|
|
|
56
|
+
TUI rendering currently uses Pi's stable default tool rendering plus targeted result formatting. A fuller custom renderer is intentionally not enabled yet because custom renderers must be width-safe across terminal sizes and Pi TUI modes.
|
|
57
|
+
|
|
39
58
|
## Research-Backed Retrieval
|
|
40
59
|
|
|
41
60
|
`pi-knowledge` turns retrieval research into product behavior that agents can actually use:
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "pi-knowledge",
|
|
3
|
-
"version": "0.4.
|
|
4
|
-
"description": "
|
|
3
|
+
"version": "0.4.2",
|
|
4
|
+
"description": "Local-first RAG knowledge base for Pi agents with hybrid code/doc search, reranking, diagnostics, and large-project indexing",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "index.ts",
|
|
7
7
|
"pi": {
|
|
@@ -18,11 +18,20 @@
|
|
|
18
18
|
"LICENSE"
|
|
19
19
|
],
|
|
20
20
|
"keywords": [
|
|
21
|
+
"pi-package",
|
|
21
22
|
"pi",
|
|
22
23
|
"pi-extension",
|
|
24
|
+
"ai-agent",
|
|
25
|
+
"coding-agent",
|
|
23
26
|
"knowledge-base",
|
|
27
|
+
"local-first",
|
|
28
|
+
"retrieval-augmented-generation",
|
|
29
|
+
"hybrid-search",
|
|
30
|
+
"bm25",
|
|
24
31
|
"vector-search",
|
|
25
32
|
"semantic-search",
|
|
33
|
+
"code-search",
|
|
34
|
+
"developer-tools",
|
|
26
35
|
"rag",
|
|
27
36
|
"embeddings"
|
|
28
37
|
],
|