@blackbelt-technology/pi-dashboard-kb-extension
v0.5.4
Published
Isolated pi extension: registers kb_search/kb_neighbors/kb_get tools and a tool_result hook that reindexes markdown on edit and (opt-in) nudges DOX AGENTS.md row upkeep.
Readme
@blackbelt-technology/pi-dashboard-kb-extension
Isolated pi extension for the markdown knowledge base. Not part of the dashboard bridge (src/extension/bridge.ts) — a standalone extension package.
What it does
- Registers native tools (
pi.registerTool):kb_search,kb_neighbors,kb_get— pull retrieval over the local SQLite/FTS5 KB. The agent calls them; nothing is auto-injected. tool_resulthook — Job 1 (always on): awrite/editto a.mdfile triggers a debounced, hash-gated incremental reindex. Editing anAGENTS.md/CLAUDE.mdalso acknowledges its DOX rows.tool_resulthook — Job 2 (opt-in,doxEnforcementdefault OFF): awrite/editto a non-md source file emits one bounded, deduped nudge to update the nearestAGENTS.mdrow (or points atkb dox initon a treeless path).tool_callhook — push mode (opt-in,directoryLevelAgents.enabled && mode:"push"): surfaces the nearestAGENTS.mdfor a touched path. Default off (context-cost caveats).
Install
Add to .pi/settings.json packages or extensions, or drop into ~/.pi/agent/extensions/. Requires @blackbelt-technology/pi-dashboard-kb and a configured .pi/dashboard/knowledge_base.json (run kb init).
Env
KB_DOX_ENFORCEMENT=1— force-enable DOX row enforcement.
