2.3 KiB
Bun workspace packages and Gitea npm publishing
The repository uses Bun workspaces under extensions/*. External dependency versions live in the root package.json catalog; repository-owned dependencies use workspace:^.
Publishable packages include the repository-native extensions plus the imported @jbcode/pi-interactive-subagents, @jbcode/pi-native-hooks, and @jbcode/pi-todo-herdr snapshots. config/imported-packages.json records their source main commits; use bun run imports:check to detect upstream movement.
Install and verify
bun install --frozen-lockfile
bun run typecheck
bun run test
Use plain bun install when intentionally updating bun.lock.
Registry configuration
The tracked .npmrc routes only the @jbcode scope:
@jbcode:registry=https://git.jb.codes/api/packages/jb/npm/
Configure a Gitea personal access token with package permissions outside the repository:
//git.jb.codes/api/packages/jb/npm/:_authToken=${GITEA_NPM_TOKEN}
The token line may live in ~/.npmrc, or GITEA_NPM_TOKEN may be supplied by the publishing environment. Never commit a token.
Pack and publish
Bun must resolve catalog: and workspace: references before publication. From a publishable workspace:
cd extensions/shared
bun pm pack --destination ../../dist
bun publish
Publish @jbcode/pi-shared before a new version of any extension that depends on it. Gitea rejects republishing an existing name/version, so bump the changed package version first.
extensions/workflow is intentionally private until the _workflows reference dependencies are merged into that package. extensions/_workflows must not be published.
Install with Pi
After configuring the same scope and token in the npm configuration visible to Pi, install the currently deployed release set with exact version pins:
pi install npm:@jbcode/pi-dictate@0.2.0
pi install npm:@jbcode/pi-effort-controls@0.1.0
pi install npm:@jbcode/pi-prompt-snippets@0.1.0
pi install npm:@jbcode/pi-interactive-subagents@3.7.3
pi install npm:@jbcode/pi-todo-herdr@0.2.5
Pi installs runtime dependencies from the same scoped registry. config/pi-links.json deliberately exposes no extension symlinks, preventing duplicate local and published copies.