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.
Files changed (3) hide show
  1. package/CHANGELOG.md +6 -0
  2. package/README.md +25 -6
  3. 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
- **Vector knowledge base extension for Pi** — index any file, directory, or text into persistent, searchable knowledge bases with hybrid semantic + keyword search.
3
+ Local-first RAG knowledge base for Pi agents.
4
4
 
5
- Built as a native [Pi extension](https://pi.dev/docs/latest/extensions), deeply integrated with the agent lifecycle. Designed to match and exceed what kiro-cli's built-in knowledge tool offers, while being 100% local and provider-agnostic.
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
- ## Why
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
- Coding agents forget everything outside their context window. `pi-knowledge` gives Pi persistent, searchable long-term memory over your documentation, codebases, specs, and notes — across sessions, across projects.
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
- ## Features
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 | planned | N/A | ❌ |
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.1",
4
- "description": "Vector knowledge base extension for Pi — index files, hybrid search, local embeddings",
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
  ],