@gyoungwe/pi-knowledge

Knowledge and Vault tools for native Pi hosts

Packages

Package details

extensionskill

Install @gyoungwe/pi-knowledge from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@gyoungwe/pi-knowledge
Package
@gyoungwe/pi-knowledge
Version
0.2.1
Published
Oct 25, 2026
Downloads
9,679/mo · 179/wk
Author
gyoungwe
License
MIT
Types
extension, skill
Size
1.1 MB
Dependencies
1 dependency · 1 peer
Pi manifest JSON
{
  "skills": [
    "./skills/*"
  ],
  "extensions": [
    "./dist/index.mjs"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@gyoungwe/pi-knowledge

The first native Pi package in Drone. It exposes the knowledge/Vault extension through one installable Pi entry point. The published package contains a self-contained dist/index.mjs bundle and its package-local knowledge worker; it has no runtime dependency on a Drone checkout or private Drone package.

The package is intentionally honest on first run: knowledge_status returns { "status": "unconfigured", "next": "/drone-init" } until a Vault binding exists. The package does not create a Vault implicitly and does not change the existing .pi/ or Vault file formats.

Task authorization and progress tools (task_*, task-status and task-action) are provided by @gyoungwe/pi-core; this package registers only knowledge and research tools. The research-workflow skill is owned by @gyoungwe/pi-research and is intentionally not bundled here.

The bundle is produced by the host build and committed here as the release artifact. The external repository deliberately does not rebuild private Drone source; npm run build verifies the checked-in artifact and refreshes its content manifest, while npm run build:check is the CI freshness gate.

npm run smoke loads the packaged extension with the native registration contract, checks the first-run unconfigured response, and verifies that the dry-run tarball contains only publishable package files. Pi 1.1.0 can record a local .tgz as an extension path instead of unpacking it; install the unpacked package directory when using that host version.

0.2.1 source candidate

Knowledge category counts and recent-note groups now share one rule: explicit frontmatter type takes precedence, then the nearest recognized category directory, then filename keywords for untyped notes. A method named mapping-tools.md remains a method; a typed concept is not relabeled from its filename. This is a local source candidate, not an npm publication claim.