Skip to content
pi-subagent-models

Development

Package checks

Section titled “Package checks”

From the repository root:

npm test
npm pack --dry-run

npm test checks TypeScript syntax and runs the Node test suite. The pack dry run lists every file that would enter the npm tarball.

Wiki checks

Section titled “Wiki checks”

The wiki is an independent Astro project so its dependencies do not enter the plugin package:

npm ci --prefix wiki
npm run build --prefix wiki

The production build writes to wiki/dist/.

Integration invariants

Section titled “Integration invariants”

Keep these behaviors intact:

  • the parent Pi model never changes;
  • Default leaves native resolution unchanged;
  • forced overrides cover tool, slash, delegation, and RPC launches;
  • global state remains shared across processes;
  • session state follows the active branch;
  • management actions remain unmodified.

Pull requests

Section titled “Pull requests”

Read CONTRIBUTING.md before changing behavior or compatibility. Pull requests should include focused verification and no private prompts, credentials, sessions, logs, endpoints, or real configuration.